Class: RangeSelection

lexical.RangeSelection

Implements

• BaseSelection

Constructors

constructor

• new RangeSelection(anchor, focus, format, style)

Parameters

Name	Type
anchor	PointType
focus	PointType
format	number
style	string

Defined in

lexical/src/LexicalSelection.ts:672

Properties

_cachedNodes

• _cachedNodes: null | LexicalNode[]

Defined in

lexical/src/LexicalSelection.ts:670

---

anchor

• anchor: PointType

Defined in

lexical/src/LexicalSelection.ts:665

---

dirty

• dirty: boolean

Implementation of

BaseSelection.dirty

Defined in

lexical/src/LexicalSelection.ts:667

---

focus

• focus: PointType

Defined in

lexical/src/LexicalSelection.ts:666

---

format

• format: number

Defined in

lexical/src/LexicalSelection.ts:668

---

style

• style: string

Defined in

lexical/src/LexicalSelection.ts:669

Methods

applyDOMRange

▸ applyDOMRange(range): void

Attempts to map a DOM selection range onto this Lexical Selection, setting the anchor, focus, and type accordingly

Parameters

Name	Type	Description
range	StaticRange	a DOM Selection range conforming to the StaticRange interface.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:878

---

clone

▸ clone(): RangeSelection

Creates a new RangeSelection, copying over all the property values from this one.

Returns

RangeSelection

a new RangeSelection with the same property values as this one.

Implementation of

BaseSelection.clone

Defined in

lexical/src/LexicalSelection.ts:914

---

deleteCharacter

▸ deleteCharacter(isBackward): void

Performs one logical character deletion operation on the EditorState based on the current Selection. Handles different node types.

Parameters

Name	Type	Description
isBackward	boolean	whether or not the selection is backwards.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:2185

---

deleteLine

▸ deleteLine(isBackward): void

Performs one logical line deletion operation on the EditorState based on the current Selection. Handles different node types.

Parameters

Name	Type	Description
isBackward	boolean	whether or not the selection is backwards.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:2305

---

deleteWord

▸ deleteWord(isBackward): void

Performs one logical word deletion operation on the EditorState based on the current Selection. Handles different node types.

Parameters

Name	Type	Description
isBackward	boolean	whether or not the selection is backwards.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:2328

---

extract

▸ extract(): LexicalNode[]

Extracts the nodes in the Selection, splitting nodes where necessary to get offset-level precision.

Returns

LexicalNode[]

The nodes in the Selection

Implementation of

BaseSelection.extract

Defined in

lexical/src/LexicalSelection.ts:1979

---

formatText

▸ formatText(formatType): void

Applies the provided format to the TextNodes in the Selection, splitting or merging nodes as necessary.

Parameters

Name	Type	Description
formatType	TextFormatType	the format type to apply to the nodes in the Selection.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:1319

---

getCharacterOffsets

▸ getCharacterOffsets(): [number, number]

Returns the character-based offsets of the Selection, accounting for non-text Points by using the children size or text content.

Returns

[number, number]

the character offsets for the Selection

Defined in

lexical/src/LexicalSelection.ts:1969

---

getNodes

▸ getNodes(): LexicalNode[]

Gets all the nodes in the Selection. Uses caching to make it generally suitable for use in hot paths.

Returns

LexicalNode[]

an Array containing all the nodes in the Selection

Implementation of

BaseSelection.getNodes

Defined in

lexical/src/LexicalSelection.ts:733

---

getTextContent

▸ getTextContent(): string

Gets the (plain) text content of all the nodes in the selection.

Returns

string

a string representing the text content of all the nodes in the Selection

Implementation of

BaseSelection.getTextContent

Defined in

lexical/src/LexicalSelection.ts:810

---

hasFormat

▸ hasFormat(type): boolean

Returns whether the provided TextFormatType is present on the Selection. This will be true if any node in the Selection has the specified format.

Parameters

Name	Type	Description
type	TextFormatType	the TextFormatType to check for.

Returns

boolean

true if the provided format is currently toggled on on the Selection, false otherwise.

Defined in

lexical/src/LexicalSelection.ts:953

---

insertLineBreak

▸ insertLineBreak(selectStart?): void

Inserts a logical linebreak, which may be a new LineBreakNode or a new ParagraphNode, into the EditorState at the current Selection.

Parameters

Name	Type	Description
selectStart?	boolean	whether or not to select the start of the insertion range after the operation completes.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:1945

---

insertNodes

▸ insertNodes(nodes, selectStart?): boolean

Attempts to "intelligently" insert an arbitrary list of Lexical nodes into the EditorState at the current Selection according to a set of heuristics that determine how surrounding nodes should be changed, replaced, or moved to accomodate the incoming ones.

Parameters

Name	Type	Description
nodes	LexicalNode[]	the nodes to insert
selectStart?	boolean	whether or not to select the start after the insertion.

Returns

boolean

true if the nodes were inserted successfully, false otherwise.

Defined in

lexical/src/LexicalSelection.ts:1452

---

insertParagraph

▸ insertParagraph(): void

Inserts a new ParagraphNode into the EditorState at the current Selection

Returns

void

Defined in

lexical/src/LexicalSelection.ts:1829

---

insertRawText

▸ insertRawText(text): void

Attempts to insert the provided text into the EditorState at the current Selection. converts tabs, newlines, and carriage returns into LexicalNodes.

Parameters

Name	Type	Description
text	string	the text to insert into the Selection

Returns

void

Implementation of

BaseSelection.insertRawText

Defined in

lexical/src/LexicalSelection.ts:964

---

insertText

▸ insertText(text): void

Attempts to insert the provided text into the EditorState at the current Selection as a new Lexical TextNode, according to a series of insertion heuristics based on the selection type and position.

Parameters

Name	Type	Description
text	string	the text to insert into the Selection

Returns

void

Defined in

lexical/src/LexicalSelection.ts:987

---

is

▸ is(selection): boolean

Used to check if the provided selections is equal to this one by value, inluding anchor, focus, format, and style properties.

Parameters

Name	Type	Description
selection	null | RangeSelection | NodeSelection | GridSelection	the Selection to compare this one to.

Returns

boolean

true if the Selections are equal, false otherwise.

Implementation of

BaseSelection.is

Defined in

lexical/src/LexicalSelection.ts:694

---

isBackward

▸ isBackward(): boolean

Returns whether the Selection is "backwards", meaning the focus logically precedes the anchor in the EditorState.

Returns

boolean

true if the Selection is backwards, false otherwise.

Defined in

lexical/src/LexicalSelection.ts:713

---

isCollapsed

▸ isCollapsed(): boolean

Returns whether the Selection is "collapsed", meaning the anchor and focus are the same node and have the same offset.

Returns

boolean

true if the Selection is collapsed, false otherwise.

Defined in

lexical/src/LexicalSelection.ts:723

---

modify

▸ modify(alter, isBackward, granularity): void

Modifies the Selection according to the parameters and a set of heuristics that account for various node types. Can be used to safely move or extend selection by one logical "unit" without dealing explicitly with all the possible node types.

Parameters

Name	Type	Description
alter	"move" | "extend"	the type of modification to perform
isBackward	boolean	whether or not selection is backwards
granularity	"character" | "word" | "lineboundary"	the granularity at which to apply the modification

Returns

void

Defined in

lexical/src/LexicalSelection.ts:2037

---

removeText

▸ removeText(): void

Removes the text in the Selection, adjusting the EditorState accordingly.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:1309

---

setStyle

▸ setStyle(style): void

Sets the value of the style property on the Selection

Parameters

Name	Type	Description
style	string	the style to set at the value of the style property.

Returns

void

Defined in

lexical/src/LexicalSelection.ts:941

---

setTextNodeRange

▸ setTextNodeRange(anchorNode, anchorOffset, focusNode, focusOffset): void

Sets this Selection to be of type "text" at the provided anchor and focus values.

Parameters

Name	Type	Description
anchorNode	TextNode	the anchor node to set on the Selection
anchorOffset	number	the offset to set on the Selection
focusNode	TextNode	the focus node to set on the Selection
focusOffset	number	the focus offset to set on the Selection

Returns

void

Defined in

lexical/src/LexicalSelection.ts:793

---

toggleFormat

▸ toggleFormat(format): void

Toggles the provided format on all the TextNodes in the Selection.

Parameters

Name	Type	Description
format	TextFormatType	a string TextFormatType to toggle on the TextNodes in the selection

Returns

void

Defined in

lexical/src/LexicalSelection.ts:931