engine/model/position

Returns the node after the given position.

This is a helper function optimized to reuse the position parent instance and the calculation of the text node at the specific position for performance reasons.

Normally, you should use Position#nodeAfter. If you start hitting performance issues with Position#parent and/or Position#textNode check if your algorithm does not access those properties multiple times (which can happen directly or indirectly via other position properties).

See https://github.com/ckeditor/ckeditor5/issues/6579 and https://github.com/ckeditor/ckeditor5/issues/6582.

See also:

• getTextNodeAtPosition
• getNodeBeforePosition

Parameters

position : ModelPosition

Position to check.

positionParent : ModelElement | ModelDocumentFragment

The parent of the given position.

textNode : null | ModelText

Text node at the given position.

Returns

null | ModelNode

Returns the node before the given position.

Refer to getNodeBeforePosition for documentation on when to use this util method.

See also:

• getTextNodeAtPosition
• getNodeAfterPosition

Parameters

position : ModelPosition

Position to check.

positionParent : ModelElement | ModelDocumentFragment

The parent of the given position.

textNode : null | ModelText

Text node at the given position.

Returns

null | ModelNode

Returns a text node at the given position.

This is a helper function optimized to reuse the position parent instance for performance reasons.

Normally, you should use Position#textNode. If you start hitting performance issues with Position#parent check if your algorithm does not access it multiple times (which can happen directly or indirectly via other position properties).

See https://github.com/ckeditor/ckeditor5/issues/6579.

See also:

• getNodeAfterPosition
• getNodeBeforePosition

Parameters

position : ModelPosition

positionParent : ModelElement | ModelDocumentFragment

The parent of the given position.

Returns

null | ModelText