eu.cdevreeze.yaidom.dom

DomElem

final class DomElem extends DomParentNode with ScopedElemLike[DomElem] with IsNavigable[DomElem] with HasParent[DomElem]

Wrapper around org.w3c.dom.Element, conforming to the eu.cdevreeze.yaidom.queryapi.ElemLike API.

See the documentation of the mixed-in query API trait(s) for more details on the uniform query API offered by this class.

By design the only state of the DomElem is the wrapped element. Otherwise it would be easy to cause any inconsistency between this wrapper element and the wrapped element. The down-side is that computing the resolved name or resolved attributes is expensive, because on each call first the in-scope namespaces are computed (by following namespace declarations in the ancestry and in the element itself). This is done for reliable namespace support, independent of namespace-awareness of the underlying element's document.

This choice for reliable namespace support (see the documented properties of ScopedElemApi) and defensive handling of mutable state makes this DomElem slower (when querying for resolved names or attributes) than other wrapper element implementations, such as ScalaXmlElem. On the other hand, if the use of org.w3c.dom is a given, then this DomElem makes namespace-aware querying of DOM elements far easier than direct querying of DOM elements.

Self Type
DomElem
Linear Supertypes
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. DomElem
  2. HasParent
  3. HasParentApi
  4. IsNavigable
  5. IsNavigableApi
  6. ScopedElemLike
  7. HasText
  8. HasEName
  9. ElemLike
  10. ScopedElemApi
  11. HasTextApi
  12. HasScopeApi
  13. HasQNameApi
  14. HasENameApi
  15. ElemApi
  16. DomParentNode
  17. DomNode
  18. AnyRef
  19. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new DomElem(wrappedNode: Element)

Type Members

  1. type DomType = Element

    Definition Classes
    DomElemDomNode

Value Members

  1. final def !=(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  4. final def \(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Shorthand for filterChildElems(p).

    Shorthand for filterChildElems(p). Use this shorthand only if the predicate is a short expression.

    Definition Classes
    ElemLikeElemApi
  5. final def \@(expandedName: EName): Option[String]

    Shorthand for attributeOption(expandedName).

    Shorthand for attributeOption(expandedName).

    Definition Classes
    HasENameHasENameApi
  6. final def \\(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Shorthand for filterElemsOrSelf(p).

    Shorthand for filterElemsOrSelf(p). Use this shorthand only if the predicate is a short expression.

    Definition Classes
    ElemLikeElemApi
  7. final def \\!(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Shorthand for findTopmostElemsOrSelf(p).

    Shorthand for findTopmostElemsOrSelf(p). Use this shorthand only if the predicate is a short expression.

    Definition Classes
    ElemLikeElemApi
  8. final def ancestors: IndexedSeq[DomElem]

    Returns ancestorsOrSelf.drop(1)

    Returns ancestorsOrSelf.drop(1)

    Definition Classes
    HasParentHasParentApi
  9. final def ancestorsOrSelf: IndexedSeq[DomElem]

    Returns all ancestor elements or self

    Returns all ancestor elements or self

    Definition Classes
    HasParentHasParentApi
  10. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  11. final def attribute(expandedName: EName): String

    Returns the value of the attribute with the given expanded name, and throws an exception otherwise.

    Returns the value of the attribute with the given expanded name, and throws an exception otherwise.

    Definition Classes
    HasENameHasENameApi
  12. final def attributeAsQName(expandedName: EName): QName

    Returns the QName value of the attribute with the given expanded name, and throws an exception otherwise

    Returns the QName value of the attribute with the given expanded name, and throws an exception otherwise

    Definition Classes
    ScopedElemLikeScopedElemApi
  13. final def attributeAsQNameOption(expandedName: EName): Option[QName]

    Returns the QName value of the attribute with the given expanded name, if any, wrapped in an Option.

    Returns the QName value of the attribute with the given expanded name, if any, wrapped in an Option. If the attribute exists, but its value is not a QName, an exception is thrown.

    Definition Classes
    ScopedElemLikeScopedElemApi
  14. final def attributeAsResolvedQName(expandedName: EName): EName

    Returns the resolved QName value (as EName) of the attribute with the given expanded name, and throws an exception otherwise

    Returns the resolved QName value (as EName) of the attribute with the given expanded name, and throws an exception otherwise

    Definition Classes
    ScopedElemLikeScopedElemApi
  15. final def attributeAsResolvedQNameOption(expandedName: EName): Option[EName]

    Returns the resolved QName value (as EName) of the attribute with the given expanded name, if any, wrapped in an Option.

    Returns the resolved QName value (as EName) of the attribute with the given expanded name, if any, wrapped in an Option. None is returned if the attribute does not exist. If the QName value cannot be resolved given the scope of the element, an exception is thrown.

    Definition Classes
    ScopedElemLikeScopedElemApi
  16. final def attributeOption(expandedName: EName): Option[String]

    Returns the value of the attribute with the given expanded name, if any, wrapped in an Option.

    Returns the value of the attribute with the given expanded name, if any, wrapped in an Option.

    Definition Classes
    HasENameHasENameApi
  17. def attributeScope: Scope

    The attribute Scope, which is the same Scope but without the default namespace (which is not used for attributes)

  18. def attributes: IndexedSeq[(QName, String)]

    The attributes of the element as mapping from QNames to values

    The attributes of the element as mapping from QNames to values

    Definition Classes
    DomElemHasQNameApi
  19. final def children: IndexedSeq[DomNode]

    Definition Classes
    DomParentNode
  20. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  21. def commentChildren: IndexedSeq[DomComment]

    Returns the comment children

  22. def declarations: Declarations

  23. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  24. def equals(obj: Any): Boolean

    Definition Classes
    DomElem → AnyRef → Any
  25. final def filterChildElems(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Returns the child elements obeying the given predicate.

    Returns the child elements obeying the given predicate. This method could be defined as:

    def filterChildElems(p: E => Boolean): immutable.IndexedSeq[E] =
      this.findAllChildElems.filter(p)
    Definition Classes
    ElemLikeElemApi
  26. final def filterElems(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Returns the descendant elements obeying the given predicate.

    Returns the descendant elements obeying the given predicate. This method could be defined as:

    this.findAllChildElems flatMap (_.filterElemsOrSelf(p))
    Definition Classes
    ElemLikeElemApi
  27. final def filterElemsOrSelf(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Returns the descendant-or-self elements obeying the given predicate.

    Returns the descendant-or-self elements obeying the given predicate. This method could be defined as:

    def filterElemsOrSelf(p: E => Boolean): immutable.IndexedSeq[E] =
      Vector(this).filter(p) ++ (this.findAllChildElems flatMap (_.filterElemsOrSelf(p)))

    It can be proven that the result is equivalent to findAllElemsOrSelf filter p.

    Definition Classes
    ElemLikeElemApi
  28. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  29. def findAllChildElems: IndexedSeq[DomElem]

    Returns the element children

    Returns the element children

    Definition Classes
    DomElemElemLikeElemApi
  30. final def findAllElems: IndexedSeq[DomElem]

    Returns all descendant elements (not including this element).

    Returns all descendant elements (not including this element). This method could be defined as filterElems { e => true }. Equivalent to findAllElemsOrSelf.drop(1).

    Definition Classes
    ElemLikeElemApi
  31. final def findAllElemsOrSelf: IndexedSeq[DomElem]

    Returns this element followed by all descendant elements (that is, the descendant-or-self elements).

    Returns this element followed by all descendant elements (that is, the descendant-or-self elements). This method could be defined as filterElemsOrSelf { e => true }.

    Definition Classes
    ElemLikeElemApi
  32. final def findAncestor(p: (DomElem) ⇒ Boolean): Option[DomElem]

    Returns the first found ancestor element obeying the given predicate, if any, wrapped in an Option

    Returns the first found ancestor element obeying the given predicate, if any, wrapped in an Option

    Definition Classes
    HasParentHasParentApi
  33. final def findAncestorOrSelf(p: (DomElem) ⇒ Boolean): Option[DomElem]

    Returns the first found ancestor-or-self element obeying the given predicate, if any, wrapped in an Option

    Returns the first found ancestor-or-self element obeying the given predicate, if any, wrapped in an Option

    Definition Classes
    HasParentHasParentApi
    Annotations
    @tailrec()
  34. final def findAttributeByLocalName(localName: String): Option[String]

    Returns the first found attribute value of an attribute with the given local name, if any, wrapped in an Option.

    Returns the first found attribute value of an attribute with the given local name, if any, wrapped in an Option. Because of differing namespaces, it is possible that more than one such attribute exists, although this is not often the case.

    Definition Classes
    HasENameHasENameApi
  35. final def findChildElem(p: (DomElem) ⇒ Boolean): Option[DomElem]

    Returns the first found child element obeying the given predicate, if any, wrapped in an Option.

    Returns the first found child element obeying the given predicate, if any, wrapped in an Option. This method could be defined as filterChildElems(p).headOption.

    Definition Classes
    ElemLikeElemApi
  36. def findChildElemByPathEntry(entry: Entry): Option[DomElem]

    Finds the child element with the given Path.Entry (where this element is the root), if any, wrapped in an Option.

    Finds the child element with the given Path.Entry (where this element is the root), if any, wrapped in an Option.

    Definition Classes
    DomElemIsNavigableIsNavigableApi
  37. final def findElem(p: (DomElem) ⇒ Boolean): Option[DomElem]

    Returns the first found (topmost) descendant element obeying the given predicate, if any, wrapped in an Option.

    Returns the first found (topmost) descendant element obeying the given predicate, if any, wrapped in an Option. This method could be defined as filterElems(p).headOption.

    Definition Classes
    ElemLikeElemApi
  38. final def findElemOrSelf(p: (DomElem) ⇒ Boolean): Option[DomElem]

    Returns the first found (topmost) descendant-or-self element obeying the given predicate, if any, wrapped in an Option.

    Returns the first found (topmost) descendant-or-self element obeying the given predicate, if any, wrapped in an Option. This method could be defined as filterElemsOrSelf(p).headOption.

    Definition Classes
    ElemLikeElemApi
  39. final def findElemOrSelfByPath(path: Path): Option[DomElem]

    Finds the element with the given Path (where this element is the root), if any, wrapped in an Option.

    Finds the element with the given Path (where this element is the root), if any, wrapped in an Option. This method must be very efficient, which depends on the efficiency of method findChildElemByPathEntry.

    Definition Classes
    IsNavigableIsNavigableApi
  40. final def findTopmostElems(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Returns the descendant elements obeying the given predicate that have no ancestor obeying the predicate.

    Returns the descendant elements obeying the given predicate that have no ancestor obeying the predicate. This method could be defined as:

    this.findAllChildElems flatMap (_.findTopmostElemsOrSelf(p))
    Definition Classes
    ElemLikeElemApi
  41. final def findTopmostElemsOrSelf(p: (DomElem) ⇒ Boolean): IndexedSeq[DomElem]

    Returns the descendant-or-self elements obeying the given predicate, such that no ancestor obeys the predicate.

    Returns the descendant-or-self elements obeying the given predicate, such that no ancestor obeys the predicate. This method could be defined as:

    def findTopmostElemsOrSelf(p: E => Boolean): immutable.IndexedSeq[E] =
      if (p(this)) Vector(this)
      else (this.findAllChildElems flatMap (_.findTopmostElemsOrSelf(p)))
    Definition Classes
    ElemLikeElemApi
  42. final def getChildElem(p: (DomElem) ⇒ Boolean): DomElem

    Returns the single child element obeying the given predicate, and throws an exception otherwise.

    Returns the single child element obeying the given predicate, and throws an exception otherwise. This method could be defined as findChildElem(p).get.

    Definition Classes
    ElemLikeElemApi
  43. final def getChildElemByPathEntry(entry: Entry): DomElem

    Returns (the equivalent of) findChildElemByPathEntry(entry).get

    Returns (the equivalent of) findChildElemByPathEntry(entry).get

    Definition Classes
    IsNavigableIsNavigableApi
  44. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  45. final def getElemOrSelfByPath(path: Path): DomElem

    Returns (the equivalent of) findElemOrSelfByPath(path).get

    Returns (the equivalent of) findElemOrSelfByPath(path).get

    Definition Classes
    IsNavigableIsNavigableApi
  46. def hashCode(): Int

    Definition Classes
    DomElem → AnyRef → Any
  47. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  48. final def localName: String

    The local name, that is, the local part of the EName

    The local name, that is, the local part of the EName

    Definition Classes
    HasENameHasENameApi
  49. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  50. final def normalizedText: String

    Returns XmlStringUtils.normalizeString(text).

    Returns XmlStringUtils.normalizeString(text).

    Definition Classes
    HasTextHasTextApi
  51. final def notify(): Unit

    Definition Classes
    AnyRef
  52. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  53. final def parent: DomElem

    Returns the equivalent parentOption.get, throwing an exception if this is the root element

    Returns the equivalent parentOption.get, throwing an exception if this is the root element

    Definition Classes
    HasParentHasParentApi
  54. def parentOption: Option[DomElem]

    Returns the parent element, if any, wrapped in an Option

    Returns the parent element, if any, wrapped in an Option

    Definition Classes
    DomElemHasParentApi
  55. def qname: QName

    The QName of the element

    The QName of the element

    Definition Classes
    DomElemHasQNameApi
  56. def resolvedAttributes: IndexedSeq[(EName, String)]

    The attributes as an ordered mapping from ENames (instead of QNames) to values, obtained by resolving attribute QNames against the attribute scope

    The attributes as an ordered mapping from ENames (instead of QNames) to values, obtained by resolving attribute QNames against the attribute scope

    Definition Classes
    DomElemHasENameApi
  57. def resolvedName: EName

    The EName of the element

    The EName of the element

    Definition Classes
    DomElemHasENameApi
  58. def scope: Scope

    The Scope stored with the element

    The Scope stored with the element

    Definition Classes
    DomElemHasScopeApi
  59. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  60. def text: String

    Returns the concatenation of the texts of text children, including whitespace and CData.

    Returns the concatenation of the texts of text children, including whitespace and CData. Non-text children are ignored. If there are no text children, the empty string is returned.

    Definition Classes
    DomElemHasTextApi
  61. final def textAsQName: QName

    Returns QName(text.trim)

    Returns QName(text.trim)

    Definition Classes
    ScopedElemLikeScopedElemApi
  62. final def textAsResolvedQName: EName

    Returns the equivalent of scope.resolveQNameOption(textAsQName).get

    Returns the equivalent of scope.resolveQNameOption(textAsQName).get

    Definition Classes
    ScopedElemLikeScopedElemApi
  63. def textChildren: IndexedSeq[DomText]

    Returns the text children

  64. final def toString(): String

    Definition Classes
    DomNode → AnyRef → Any
  65. final def trimmedText: String

    Returns text.trim.

    Returns text.trim.

    Definition Classes
    HasTextHasTextApi
  66. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  67. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  68. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  69. val wrappedNode: Element

    Definition Classes
    DomElemDomNode

Inherited from HasParent[DomElem]

Inherited from HasParentApi[DomElem]

Inherited from IsNavigable[DomElem]

Inherited from IsNavigableApi[DomElem]

Inherited from ScopedElemLike[DomElem]

Inherited from HasText

Inherited from HasEName

Inherited from ElemLike[DomElem]

Inherited from ScopedElemApi[DomElem]

Inherited from HasTextApi

Inherited from HasScopeApi

Inherited from HasQNameApi

Inherited from HasENameApi

Inherited from ElemApi[DomElem]

Inherited from DomParentNode

Inherited from DomNode

Inherited from AnyRef

Inherited from Any

Ungrouped