Skip to main content

Class: ListNode

@lexical/list.ListNode

Hierarchy

Constructors

constructor

new ListNode(listType, start, key?): ListNode

Parameters

NameType
listTypeListType
startnumber
key?string

Returns

ListNode

Overrides

ElementNode.constructor

Defined in

packages/lexical-list/src/LexicalListNode.ts:72

Methods

append

append(...nodesToAppend): this

Parameters

NameType
...nodesToAppendLexicalNode[]

Returns

this

Overrides

ElementNode.append

Defined in

packages/lexical-list/src/LexicalListNode.ts:191


canBeEmpty

canBeEmpty(): false

Returns

false

Overrides

ElementNode.canBeEmpty

Defined in

packages/lexical-list/src/LexicalListNode.ts:183


canIndent

canIndent(): false

Returns

false

Overrides

ElementNode.canIndent

Defined in

packages/lexical-list/src/LexicalListNode.ts:187


createDOM

createDOM(config, _editor?): HTMLElement

Called during the reconciliation process to determine which nodes to insert into the DOM for this Lexical Node.

This method must return exactly one HTMLElement. Nested elements are not supported.

Do not attempt to update the Lexical EditorState during this phase of the update lifecyle.

Parameters

NameTypeDescription
configEditorConfigallows access to things like the EditorTheme (to apply classes) during reconciliation.
_editor?LexicalEditorallows access to the editor for context during reconciliation.

Returns

HTMLElement

Overrides

ElementNode.createDOM

Defined in

packages/lexical-list/src/LexicalListNode.ts:100


exportDOM

exportDOM(editor): DOMExportOutput

Controls how the this node is serialized to HTML. This is important for copy and paste between Lexical and non-Lexical editors, or Lexical editors with different namespaces, in which case the primary transfer format is HTML. It's also important if you're serializing to HTML for any other reason via $generateHtmlFromNodes. You could also use this method to build your own HTML renderer.

Parameters

NameType
editorLexicalEditor

Returns

DOMExportOutput

Overrides

ElementNode.exportDOM

Defined in

packages/lexical-list/src/LexicalListNode.ts:157


exportJSON

exportJSON(): SerializedListNode

Controls how the this node is serialized to JSON. This is important for copy and paste between Lexical editors sharing the same namespace. It's also important if you're serializing to JSON for persistent storage somewhere. See Serialization & Deserialization.

Returns

SerializedListNode

Overrides

ElementNode.exportJSON

Defined in

packages/lexical-list/src/LexicalListNode.ts:172


extractWithChild

extractWithChild(child): boolean

Parameters

NameType
childLexicalNode

Returns

boolean

Overrides

ElementNode.extractWithChild

Defined in

packages/lexical-list/src/LexicalListNode.ts:218


getListType

getListType(): ListType

Returns

ListType

Defined in

packages/lexical-list/src/LexicalListNode.ts:90


getStart

getStart(): number

Returns

number

Defined in

packages/lexical-list/src/LexicalListNode.ts:94


getTag

getTag(): ListNodeTagType

Returns

ListNodeTagType

Defined in

packages/lexical-list/src/LexicalListNode.ts:80


setListType

setListType(type): void

Parameters

NameType
typeListType

Returns

void

Defined in

packages/lexical-list/src/LexicalListNode.ts:84


updateDOM

updateDOM(prevNode, dom, config): boolean

Called when a node changes and should update the DOM in whatever way is necessary to make it align with any changes that might have happened during the update.

Returning "true" here will cause lexical to unmount and recreate the DOM node (by calling createDOM). You would need to do this if the element tag changes, for instance.

Parameters

NameType
prevNodeListNode
domHTMLElement
configEditorConfig

Returns

boolean

Overrides

ElementNode.updateDOM

Defined in

packages/lexical-list/src/LexicalListNode.ts:114


clone

clone(node): ListNode

Clones this node, creating a new node with a different key and adding it to the EditorState (but not attaching it anywhere!). All nodes must implement this method.

Parameters

NameType
nodeListNode

Returns

ListNode

Overrides

ElementNode.clone

Defined in

packages/lexical-list/src/LexicalListNode.ts:66


getType

getType(): string

Returns the string type of this node. Every node must implement this and it MUST BE UNIQUE amongst nodes registered on the editor.

Returns

string

Overrides

ElementNode.getType

Defined in

packages/lexical-list/src/LexicalListNode.ts:62


importDOM

importDOM(): null | DOMConversionMap

Returns

null | DOMConversionMap

Overrides

ElementNode.importDOM

Defined in

packages/lexical-list/src/LexicalListNode.ts:136


importJSON

importJSON(serializedNode): ListNode

Controls how the this node is deserialized from JSON. This is usually boilerplate, but provides an abstraction between the node implementation and serialized interface that can be important if you ever make breaking changes to a node schema (by adding or removing properties). See Serialization & Deserialization.

Parameters

NameType
serializedNodeSerializedListNode

Returns

ListNode

Overrides

ElementNode.importJSON

Defined in

packages/lexical-list/src/LexicalListNode.ts:149


transform

transform(): (node: LexicalNode) => void

Registers the returned function as a transform on the node during Editor initialization. Most such use cases should be addressed via the LexicalEditor.registerNodeTransform API.

Experimental - use at your own risk.

Returns

fn

▸ (node): void

Parameters
NameType
nodeLexicalNode
Returns

void

Overrides

ElementNode.transform

Defined in

packages/lexical-list/src/LexicalListNode.ts:128