XmlElement | xmlcreate

Represents an XML element.

A sample XML element is structured as follows, where {name} is the name of the element:

<{name} attname="attvalue">
    <subelem/>
    <?pitarget picontent?>
    text
</{name}></pre>

The {name} value is a property of the node, while the attributes and children of the element (such as other elements, processing instructions, and text) are children of this node.

XmlElement nodes can have an unlimited number of XmlAttribute, XmlCdata, XmlCharRef, XmlComment, XmlElement, XmlEntityRef, XmlProcInst, or XmlText nodes as children.

Hierarchy

XmlNode
- XmlElement

Index

Constructors

constructor

Properties

Accessors

name
parent

Methods

Constructors

constructor

new XmlElement(name: string): XmlElement

Overwrites XmlNode.constructor
- Defined in nodes/XmlElement.ts:53
Initializes a new instance of the XmlElement class.

Parameters
- name: string
  
  The name of the element.
Returns XmlElement

Properties

Protected _children

_children: XmlNode[]

Private _name

_name: string

Accessors

name

get name(): string
set name(name: string): void

- Defined in nodes/XmlElement.ts:70
Gets the name of the element.

Returns string

The name of the element.
- Defined in nodes/XmlElement.ts:79
Sets the name of the element.

Parameters
- name: string
  
  The name of the element.
Returns void

The name of the element.

parent

get parent(): XmlNode

Inherited from XmlNode.parent
- Defined in nodes/XmlNode.ts:45
Gets the parent of this node.

Returns XmlNode

The parent of this node.

Methods

attribute

attribute(name: string, value: string | XmlNode | string | XmlNode, index?: number): XmlAttribute

- Defined in nodes/XmlElement.ts:105
Inserts an new attribute at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- name: string
```
   The name of the attribute.
```
- value: string | XmlNode | string | XmlNode
```
   The value of the attribute. Strings are converted to XmlText
   nodes.
```
- Optional index: number
Returns XmlAttribute

The newly created attribute.

attributes

attributes(): XmlAttribute[]

- Defined in nodes/XmlElement.ts:133
Returns an array containing all of the children of this node that are instances of XmlAttribute.

Returns XmlAttribute[]

An array containing all of the children of this node that are instances of XmlAttribute.

cdata

cdata(content: string, index?: number): XmlCdata

- Defined in nodes/XmlElement.ts:149
Inserts a new CDATA section at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- content: string
  
  The data of the CDATA section.
- Optional index: number
Returns XmlCdata

The newly created CDATA section.

charRef

charRef(char: string, hex?: boolean, index?: number): XmlCharRef

- Defined in nodes/XmlElement.ts:169
Inserts a new character reference at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- char: string
  
  The character to represent using the reference.
- Optional hex: boolean
- Optional index: number
Returns XmlCharRef

The newly created character reference.

children

children(): XmlNode[]

Inherited from XmlNode.children
- Defined in nodes/XmlNode.ts:57
Gets this node's children.

Throws an exception if this node cannot have any children. Consult the appropriate subclass documentation for more details.

Returns XmlNode[]

This node's children.

comment

comment(content: string, index?: number): XmlComment

- Defined in nodes/XmlElement.ts:186
Inserts a new comment at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- content: string
  
  The data of the comment.
- Optional index: number
Returns XmlComment

The newly created comment.

element

element(name: string, index?: number): XmlElement

- Defined in nodes/XmlElement.ts:203
Inserts a new element at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- name: string
  
  The name of the element.
- Optional index: number
Returns XmlElement

The newly created element.

entityRef

entityRef(entity: string, index?: number): XmlEntityRef

- Defined in nodes/XmlElement.ts:220
Inserts a new entity reference at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- entity: string
  
  The entity to be referenced.
- Optional index: number
Returns XmlEntityRef

The newly created entity reference.

insertChild

insertChild(node: XmlNode, index?: number): XmlNode

Overwrites XmlNode.insertChild
- Defined in nodes/XmlElement.ts:245
Inserts the specified node into this node's children at the specified index. The node is not inserted if it is already present. If this node already has a parent, it is removed from that parent.

Note that only XmlAttribute, XmlCdata, XmlCharRef, XmlComment, XmlElement, XmlEntityRef, XmlProcInst, or XmlText nodes can be inserted; otherwise, an exception will be thrown.

Parameters
- node: XmlNode
  
  The node to insert.
- Optional index: number
Returns XmlNode

The node inserted into this node's children, or undefined if no node was inserted.

next(): XmlNode

Inherited from XmlNode.next
- Defined in nodes/XmlNode.ts:109
Gets the node that follows this one, or undefined if no such node exists or if this node has no parent.

Returns XmlNode

The node that follows this one, or undefined if no such node exists or if this node has no parent.

prev(): XmlNode

Inherited from XmlNode.prev
- Defined in nodes/XmlNode.ts:128
Gets the node that is previous to this one, or undefined if no such node exists or if this node has no parent.

Returns XmlNode

The node that is previous to this one, or undefined if no such node exists or if this node has no parent.

procInst

procInst(target: string, content?: string, index?: number): XmlProcInst

- Defined in nodes/XmlElement.ts:289
Inserts a new processing instruction at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- target: string
  
  The target of the processing instruction.
- Optional content: string
- Optional index: number
Returns XmlProcInst

The newly created processing instruction.

remove

remove(): XmlNode

Inherited from XmlNode.remove
- Defined in nodes/XmlNode.ts:143
Removes this node from its parent if this node has a parent.

Returns XmlNode

This node's parent, or undefined if it has no parent.

removeChild

removeChild(node: XmlNode): boolean

Inherited from XmlNode.removeChild
- Defined in nodes/XmlNode.ts:163
Removes the specified node from this node's children.

Throws an exception if this node cannot have any children, or if the specified node cannot be removed. Consult the appropriate subclass documentation for more details.

Parameters
- node: XmlNode
  
  The node to remove.
Returns boolean

Whether a node was removed.

removeChildAtIndex

removeChildAtIndex(index: number): XmlNode

Inherited from XmlNode.removeChildAtIndex
- Defined in nodes/XmlNode.ts:190
Removes the node at the specified index from this node's children.

Throws an exception if this node cannot have any children, or if the node at the specified index cannot be removed. Consult the appropriate subclass documentation for more details.

Parameters
- index: number
  
  The index at which the node to be removed is located.
Returns XmlNode

The node that was removed, or undefined if no node was removed.

text

text(text: string, index?: number): XmlText

- Defined in nodes/XmlElement.ts:308
Inserts some new text at the specified index. If no index is specified, the node is inserted at the end of this node's children.

Parameters
- text: string
  
  Arbitrary character data.
- Optional index: number
Returns XmlText

The newly created text node.

toString

toString(options?: IStringOptions): string

Overwrites XmlNode.toString
- Defined in nodes/XmlElement.ts:322
Returns an XML string representation of this node.

Parameters
- Default value options: IStringOptions = {}
Returns string

An XML string representation of this node.

top

top(): XmlNode

Inherited from XmlNode.top
- Defined in nodes/XmlNode.ts:221
Returns the root node of the current hierarchy. If this node has no parent, this node itself is returned.

Returns XmlNode

The root node of the current hierarchy.

up

up(): XmlNode

Inherited from XmlNode.up
- Defined in nodes/XmlNode.ts:234
Gets the parent of this node.

Returns XmlNode

The parent of this node.

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

name: string

Returns XmlElement

Properties

Protected _children

Private _name

Accessors

name

Returns string

Parameters

name: string

Returns void

parent

Returns XmlNode

Methods

attribute

Parameters

name: string

value: string | XmlNode | string | XmlNode

Optional index: number

Returns XmlAttribute

attributes

Returns XmlAttribute[]

cdata

Parameters

content: string

Optional index: number

Returns XmlCdata

charRef

Parameters

char: string

Optional hex: boolean

Optional index: number

Returns XmlCharRef

children

Returns XmlNode[]

comment

Parameters

content: string

Optional index: number

Returns XmlComment

element

Parameters

name: string

Optional index: number

Returns XmlElement

entityRef

Parameters

entity: string

Optional index: number

Returns XmlEntityRef

insertChild

Parameters

node: XmlNode

Optional index: number

Returns XmlNode

next

Returns XmlNode

prev

Returns XmlNode

procInst

Parameters

target: string

Optional content: string

Optional index: number

Returns XmlProcInst

remove

Returns XmlNode

removeChild

Parameters

node: XmlNode

Returns boolean