CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Class

NodeList (engine/model)

@ckeditor/ckeditor5-engine/src/model/nodelist

class
See source

Provides an interface to operate on a list of nodes. NodeList is used internally in classes like Element or DocumentFragment.

Filtering

Properties

  • readonly

    length : Number

    See source

    Number of nodes contained inside this node list.

  • readonly

    maxOffset : Number

    See source

    Sum of offset sizes of all nodes contained inside this node list.

  • private

    _nodes : Array.<Node>

    See source

    Nodes contained in this node list.

Methods

  • protected

    constructor( nodes )

    See source

    Creates an empty node list.

    Parameters

    nodes : Iterable.<Node>

    Nodes contained in this node list.

  • Symbol.iterator() → Iterable.<Node>

    See source

    Iterable interface.

    Iterates over all nodes contained inside this node list.

    Returns

    Iterable.<Node>

  • getNode( index ) → Node | null

    See source

    Gets the node at the given index. Returns null if incorrect index was passed.

    Parameters

    index : Number

    Index of node.

    Returns

    Node | null

    Node at given index.

  • getNodeIndex( node ) → Number | null

    See source

    Returns an index of the given node. Returns null if given node is not inside this node list.

    Parameters

    node : Node

    Child node to look for.

    Returns

    Number | null

    Child node's index.

  • getNodeStartOffset( node ) → Number | null

    See source

    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

    Node to look for.

    Returns

    Number | null

    Node's starting offset.

  • indexToOffset( index ) → Number

    See source

    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 than 0 or more than length.

    Parameters

    index : Number

    Node's index.

    Returns

    Number

    Node's starting offset.

  • offsetToIndex( offset ) → Number

    See source

    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 than 0 or more than maxOffset.

    Parameters

    offset : Number

    Offset to look for.

    Returns

    Number

    Index of a node that occupies given offset.

  • toJSON() → Array.<Node>

    See source

    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

    Array.<Node>

    NodeList instance converted to Array.

  • protected

    _insertNodes( index, nodes )

    See source

    Inserts given nodes at given index.

    Parameters

    index : Number

    Index at which nodes should be inserted.

    nodes : Iterable.<Node>

    Nodes to be inserted.

  • protected

    _removeNodes( indexStart, [ howMany ] ) → Array.<Node>

    See source

    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.