NodeList (engine/model)
@ckeditor/ckeditor5-engine/src/model/nodelist
Provides an interface to operate on a list of nodes. NodeList
is used internally
in classes like Element
or DocumentFragment.
Filtering
Properties
-
Number of nodes contained inside this node list.
-
Sum of offset sizes of all nodes contained inside this node list.
-
Nodes contained in this node list.
Methods
-
Creates an empty node list.
Parameters
[ nodes ] : Iterable<Node>
Nodes contained in this node list.
-
Symbol.iterator() → IterableIterator<Node>
module:engine/model/nodelist~NodeList#Symbol.iterator
Iterable interface.
Iterates over all nodes contained inside this node list.
Returns
IterableIterator<Node>
-
Gets the node at the given index. Returns
null
if incorrect index was passed.Parameters
index : number
Returns
null | Node
-
getNodeIndex( node ) → null | number
module:engine/model/nodelist~NodeList#getNodeIndex
Returns an index of the given node. Returns
null
if given node is not inside this node list.Parameters
node : Node
Returns
null | number
-
getNodeStartOffset( node ) → null | number
module:engine/model/nodelist~NodeList#getNodeStartOffset
Returns the starting offset of given node. Starting offset is equal to the sum of offset sizes of all nodes that are before this node in this node list.
Parameters
node : Node
Returns
null | number
-
indexToOffset( index ) → number
module:engine/model/nodelist~NodeList#indexToOffset
Converts index to offset in node list.
Returns starting offset of a node that is at given index. Throws CKEditorError
model-nodelist-index-out-of-bounds
if given index is less than0
or more thanlength
.Parameters
index : number
Returns
number
-
offsetToIndex( offset ) → number
module:engine/model/nodelist~NodeList#offsetToIndex
Converts offset in node list to index.
Returns index of a node that occupies given offset. Throws CKEditorError
model-nodelist-offset-out-of-bounds
if given offset is less than0
or more thanmaxOffset
.Parameters
offset : number
Returns
number
-
toJSON() → unknown
module:engine/model/nodelist~NodeList#toJSON
Converts
NodeList
instance to an array containing nodes that were inserted in the node list. Nodes are also converted to their plain object representation.Returns
unknown
NodeList
instance converted toArray
.
-
Inserts given nodes at given index.
Parameters
index : number
Index at which nodes should be inserted.
nodes : Iterable<Node>
Nodes to be inserted.
Returns
void
-
internal
_removeNodes( indexStart, howMany ) → Array<Node>
module:engine/model/nodelist~NodeList#_removeNodes
Removes one or more nodes starting at the given index.
Parameters
indexStart : number
Index of the first node to remove.
howMany : number
Number of nodes to remove.
Defaults to
1
Returns
Array<Node>
Array containing removed nodes.
Every day, we work hard to keep our documentation complete. Have you spotted outdated information? Is something missing? Please report it via our issue tracker.
With the release of version 42.0.0, we have rewritten much of our documentation to reflect the new import paths and features. We appreciate your feedback to help us ensure its accuracy and completeness.