Type Editor / @type-editor/state / selection/AllSelection / AllSelection

Class: AllSelection

Defined in: state/src/selection/AllSelection.ts:17

A selection type that represents selecting the whole document (which can not necessarily be expressed with a text selection, when there are for example leaf block nodes at the start or end of the document).

This selection type is useful when you need to select all content, including non-inline elements that cannot be part of a text selection.

Extends

Selection

Implements

PmSelection

Constructors

Constructor

new AllSelection(doc): AllSelection;

Defined in: state/src/selection/AllSelection.ts:36

Create an all-selection over the given document. The selection spans from position 0 to the end of the document content.

Parameters

Parameter	Type	Description
`doc`	`Node_2`	The document node to select in its entirety

Returns

AllSelection

Overrides

Selection.constructor

Properties

Property	Modifier	Type	Default value	Description	Inherited from	Defined in
`anchorPos`	`readonly`	`ResolvedPos`	`undefined`	The resolved position of the selection's anchor (the immobile end).	`Selection`.`anchorPos`	state/src/selection/Selection.ts:92
`headPos`	`readonly`	`ResolvedPos`	`undefined`	The resolved position of the selection's head (the mobile end).	`Selection`.`headPos`	state/src/selection/Selection.ts:98
`isVisible`	`protected`	`boolean`	`true`	Controls whether the selection should be visible in the browser. Some selection types (like node selections) may be invisible.	`Selection`.`isVisible`	state/src/selection/Selection.ts:105
`selectionRanges`	`readonly`	readonly `PmSelectionRange`[]	`undefined`	The array of selection ranges covered by this selection. Most selections have a single range, but some may span multiple ranges.	`Selection`.`selectionRanges`	state/src/selection/Selection.ts:86

Accessors

$anchor

Get Signature

get $anchor(): ResolvedPos;

Defined in: state/src/selection/Selection.ts:167

The resolved anchor position of the selection. The anchor is the immobile end of the selection - it stays in place when the user extends the selection by moving the head.

Returns

ResolvedPos

The resolved anchor position

Implementation of

PmSelection.$anchor;

Inherited from

Selection.$anchor

$cursor

Get Signature

get $cursor(): ResolvedPos;

Defined in: state/src/selection/Selection.ts:138

The cursor position if this is an empty text selection, null otherwise

Returns

ResolvedPos

Implementation of

PmSelection.$cursor;

Inherited from

Selection.$cursor

$from

Get Signature

get $from(): ResolvedPos;

Defined in: state/src/selection/Selection.ts:234

The resolved lower bound of the selection's main range. This provides access to the document structure at the start of the selection, allowing you to query the context and perform position-based operations.

Throws

If the selection has no ranges

Returns

ResolvedPos

The resolved starting position

Implementation of

PmSelection.$from;

Inherited from

Selection.$from

$head

Get Signature

get $head(): ResolvedPos;

Defined in: state/src/selection/Selection.ts:178

The resolved head position of the selection. The head is the mobile end of the selection - it moves when the user extends or modifies the selection.

Returns

ResolvedPos

The resolved head position

Implementation of

PmSelection.$head;

Inherited from

Selection.$head

$to

Get Signature

get $to(): ResolvedPos;

Defined in: state/src/selection/Selection.ts:249

The resolved upper bound of the selection's main range. This provides access to the document structure at the end of the selection, allowing you to query the context and perform position-based operations.

Throws

If the selection has no ranges

Returns

ResolvedPos

The resolved ending position

Implementation of

PmSelection.$to;

Inherited from

Selection.$to

anchor

Get Signature

get anchor(): number;

Defined in: state/src/selection/Selection.ts:189

The selection's anchor, as an unresolved position. This is the integer position in the document where the anchor is located. The anchor is the immobile end of the selection.

Returns

number

The anchor position as a number

Implementation of

PmSelection.anchor;

Inherited from

Selection.anchor

empty

Get Signature

get empty(): boolean;

Defined in: state/src/selection/Selection.ts:263

Indicates whether the selection contains any content. A selection is empty when all its ranges have identical from and to positions, which typically represents a cursor position rather than a content selection.

Returns

boolean

True if the selection is empty (cursor), false if it spans content

Implementation of

PmSelection.empty;

Inherited from

Selection.empty

from

Get Signature

get from(): number;

Defined in: state/src/selection/Selection.ts:211

The lower bound of the selection's main range. This is always the smaller position value, regardless of which end is the anchor or head. For a cursor selection, this equals to.

Returns

number

The starting position of the selection

Implementation of

PmSelection.from;

Inherited from

Selection.from

head

Get Signature

get head(): number;

Defined in: state/src/selection/Selection.ts:200

The selection's head, as an unresolved position. This is the integer position in the document where the head is located. The head is the mobile end of the selection that moves when extending it.

Returns

number

The head position as a number

Implementation of

PmSelection.head;

Inherited from

Selection.head

node

Get Signature

get node(): Node_2;

Defined in: state/src/selection/Selection.ts:145

The selected node if this is a node selection, null otherwise

Returns

Node_2

Implementation of

PmSelection.node;

Inherited from

Selection.node

ranges

Get Signature

get ranges(): readonly SelectionRange[];

Defined in: state/src/selection/Selection.ts:156

The ranges covered by the selection. For most selections, this will be a single range. Multiple ranges are used for selections that span non-contiguous parts of the document.

Returns

readonly SelectionRange[]

A readonly array of selection ranges

Implementation of

PmSelection.ranges;

Inherited from

Selection.ranges

to

Get Signature

get to(): number;

Defined in: state/src/selection/Selection.ts:222

The upper bound of the selection's main range. This is always the larger position value, regardless of which end is the anchor or head. For a cursor selection, this equals from.

Returns

number

The ending position of the selection

Implementation of

PmSelection.to;

Inherited from

Selection.to

type

Get Signature

get type(): string;

Defined in: state/src/selection/AllSelection.ts:45

The type identifier for this selection.

Returns

string

Always returns SelectionType.ALL

Implementation of

PmSelection.type;

Overrides

Selection.type

visible

Get Signature

get visible(): boolean;

Defined in: state/src/selection/Selection.ts:274

Controls whether the selection should be visible to the user in the browser. Most selections are visible (highlighted), but some selection types like node selections may choose to be invisible.

Returns

boolean

True if the selection should be visible, false otherwise

Set Signature

set visible(isVisible): void;

Defined in: state/src/selection/Selection.ts:283

Sets whether the selection should be visible to the user in the browser.

Parameters

Parameter	Type	Description
`isVisible`	`boolean`	True to make the selection visible, false to hide it

Returns

void

Implementation of

PmSelection.visible;

Inherited from

Selection.visible

Methods

content()

content(): Slice;

Defined in: state/src/selection/Selection.ts:601

Get the content of this selection as a slice. This extracts the document fragment that falls within the selection's range, preserving the structure and allowing it to be inserted elsewhere.

Returns

Slice

A slice containing the selected content

Implementation of

PmSelection.content;

Inherited from

Selection.content

eq()

eq(other): boolean;

Defined in: state/src/selection/AllSelection.ts:76

Test whether this selection is equal to another selection. AllSelections are considered equal if the other is also an AllSelection, regardless of document content.

Parameters

Parameter	Type	Description
`other`	`PmSelection`	The selection to compare with

Returns

boolean

True if the other selection is also an AllSelection

Implementation of

PmSelection.eq;

Overrides

Selection.eq

getBookmark()

getBookmark(): SelectionBookmark;

Defined in: state/src/selection/AllSelection.ts:86

Create a bookmark for this selection. The bookmark can be used to restore this selection after document changes.

Returns

SelectionBookmark

An AllBookmark instance

Implementation of

PmSelection.getBookmark;

Overrides

Selection.getBookmark

isAllSelection()

isAllSelection(): boolean;

Defined in: state/src/selection/Selection.ts:590

Check if this is an all selection.

Returns

boolean

True if this is an AllSelection instance

Implementation of

PmSelection.isAllSelection;

Inherited from

Selection.isAllSelection

isNodeSelection()

isNodeSelection(): boolean;

Defined in: state/src/selection/Selection.ts:581

Check if this is a node selection.

Returns

boolean

True if this is a NodeSelection instance

Implementation of

PmSelection.isNodeSelection;

Inherited from

Selection.isNodeSelection

isTextSelection()

isTextSelection(): boolean;

Defined in: state/src/selection/Selection.ts:572

Check if this is a text selection.

Returns

boolean

True if this is a TextSelection instance

Implementation of

PmSelection.isTextSelection;

Inherited from

Selection.isTextSelection

map()

map(doc, mapping): Selection;

Defined in: state/src/selection/Selection.ts:640

Map this selection through a mappable transformation. This updates the selection to reflect changes made to the document, adjusting positions and potentially changing the selection type if the mapped positions are no longer valid for the current type.

For example, if a text selection's positions are mapped to non-inline content, this will find a nearby valid selection instead.

Parameters

Parameter	Type	Description
`doc`	`Node_2`	The new document after the transformation
`mapping`	`Mappable`	The mappable transformation (e.g., from a transaction)

Returns

Selection

A new selection mapped to the new document

Implementation of

PmSelection.map;

Inherited from

Selection.map

replace()

replace(transaction, content?): void;

Defined in: state/src/selection/Selection.ts:672

Replace the selection with a slice or, if no slice is given, delete the selection. Will append to the given transaction.

Parameters

Parameter	Type	Default value
`transaction`	`PmTransaction`	`undefined`
`content`	`Slice`	`Slice.empty`

Returns

void

Implementation of

PmSelection.replace;

Inherited from

Selection.replace

replaceWith()

replaceWith(transaction, node): void;

Defined in: state/src/selection/Selection.ts:754

Replace the selection with the given node, appending the changes to the given transaction.

For multi-range selections, the first range is replaced with the node, and subsequent ranges are deleted. The selection is then positioned after the inserted node.

Parameters

Parameter	Type	Description
`transaction`	`PmTransaction`	The transaction to append the replacement to
`node`	`Node_2`	The node to insert in place of the selection

Returns

void

Implementation of

PmSelection.replaceWith;

Inherited from

Selection.replaceWith

toJSON()

toJSON(): SelectionJSON;

Defined in: state/src/selection/AllSelection.ts:64

Convert this selection to a JSON-serializable representation.

Returns

SelectionJSON

A JSON object with the selection type

Implementation of

PmSelection.toJSON;

Overrides

Selection.toJSON

atEnd()

static atEnd(doc): Selection;

Defined in: state/src/selection/Selection.ts:335

Find the cursor or leaf node selection closest to the end of the given document. Will return an AllSelection if no valid position exists.

This is commonly used to position the cursor at the end of a document.

Parameters

Parameter	Type	Description
`doc`	`Node_2`	The document node to find a selection in

Returns

Selection

A selection at the end of the document

Inherited from

Selection.atEnd

atStart()

static atStart(doc): Selection;

Defined in: state/src/selection/Selection.ts:320

Find the cursor or leaf node selection closest to the start of the given document. Will return an AllSelection if no valid position exists.

This is commonly used to position the cursor at the beginning of a document.

Parameters

Parameter	Type	Description
`doc`	`Node_2`	The document node to find a selection in

Returns

Selection

A selection at the start of the document

Inherited from

Selection.atStart

between()

static between(
   $anchor,
   $head,
   bias?): Selection;

Defined in: state/src/selection/Selection.ts:412

Parameters

Parameter	Type
`$anchor`	`ResolvedPos`
`$head`	`ResolvedPos`
`bias?`	`number`

Returns

Selection

Inherited from

Selection.between

createAllSelection()

static createAllSelection(document): AllSelection;

Defined in: state/src/selection/AllSelection.ts:98

Create an all-selection that spans the entire document. This selection type is useful when you need to select all content, including non-inline elements that cannot be part of a text selection.

Parameters

Parameter	Type	Description
`document`	`Node_2`	The document node to select in its entirety

Returns

AllSelection

A new EditorSelection wrapping an AllSelection

findFrom()

static findFrom(
   $pos,
   dir,
   textOnly?): Selection;

Defined in: state/src/selection/Selection.ts:354

Find a valid cursor or leaf node selection starting at the given position and searching in the specified direction. When textOnly is true, only consider cursor selections (no node selections). Will return null when no valid selection position is found.

This method searches both within the current parent node and up the document tree to find a valid selection position.

Parameters

Parameter	Type	Default value	Description
`$pos`	`ResolvedPos`	`undefined`	The resolved position to start searching from
`dir`	`number`	`undefined`	The search direction: negative for backward, positive for forward
`textOnly`	`boolean`	`false`	If true, only return text/cursor selections (default: false)

Returns

Selection

A valid selection, or null if none found

Inherited from

Selection.findFrom

fromJSON()

static fromJSON(doc): AllSelection;

Defined in: state/src/selection/AllSelection.ts:55

Deserialize an all-selection from its JSON representation.

Parameters

Parameter	Type	Description
`doc`	`Node_2`	The document node in which to create the selection

Returns

AllSelection

A new AllSelection instance spanning the entire document

Overrides

Selection.fromJSON

isNodeSelectable()

static isNodeSelectable(node): boolean;

Defined in: state/src/selection/Selection.ts:384

Determines whether the given node may be selected as a node selection. A node is selectable if it's not a text node and its type specification has not explicitly set selectable to false.

Parameters

Parameter	Type	Description
`node`	`Node_2`	The node to check for selectability

Returns

boolean

True if the node can be selected as a node selection, false otherwise

Inherited from

Selection.isNodeSelectable

jsonID()

static jsonID(jsonId, jsonDeserializerClass): void;

Defined in: state/src/selection/Selection.ts:72

Parameters

Parameter	Type
`jsonId`	`string`
`jsonDeserializerClass`	`JSONToSelectionDeserializer`

Returns

void

Inherited from

Selection.jsonID

near()

static near($pos, bias?): Selection;

Defined in: state/src/selection/Selection.ts:303

Find a valid cursor or leaf node selection near the given position. Searches in the direction specified by bias first, then tries the opposite direction if nothing is found. Falls back to an all-selection if no valid position exists.

This is useful for finding a valid selection position after document changes that may have invalidated the previous selection.

Parameters

Parameter	Type	Default value	Description
`$pos`	`ResolvedPos`	`undefined`	The resolved position to search from
`bias`	`number`	`1`	The search direction bias: 1 for forward (default), -1 for backward

Returns

Selection

A valid selection near the given position, or an all-selection

Inherited from

Selection.near

registerAllSelectionHandler()

protected static registerAllSelectionHandler(handler): void;

Defined in: state/src/selection/Selection.ts:68

Parameters

Parameter	Type
`handler`	(...`param`) => `PmSelection`

Returns

void

Inherited from

Selection.registerAllSelectionHandler

registerJsonDeserializerClass()

static registerJsonDeserializerClass(jsonId, jsonDeserializerClass): void;

Defined in: state/src/selection/Selection.ts:76

Parameters

Parameter	Type
`jsonId`	`string`
`jsonDeserializerClass`	`JSONToSelectionDeserializer`

Returns

void

Inherited from

Selection.registerJsonDeserializerClass

registerNodeSelectionHandler()

protected static registerNodeSelectionHandler(handler): void;

Defined in: state/src/selection/Selection.ts:63

Parameters

Parameter	Type
`handler`	(...`param`) => `PmSelection`

Returns

void

Inherited from

Selection.registerNodeSelectionHandler

registerTextSelectionHandler()

protected static registerTextSelectionHandler(handler): void;

Defined in: state/src/selection/Selection.ts:58

Parameters

Parameter	Type
`handler`	(...`param`) => `PmSelection`

Returns

void

Inherited from

Selection.registerTextSelectionHandler

textSelectionBetween()

static textSelectionBetween(
   $anchor,
   $head,
   bias?): Selection;

Defined in: state/src/selection/Selection.ts:432

Return a text selection that spans the given positions or, if they aren't text positions, find a text selection near them. bias determines whether the method searches forward (default) or backwards (negative number) first. Will fall back to calling Selection.near when the document doesn't contain a valid text position.

This method ensures that both anchor and head are positioned in inline content, adjusting them if necessary while maintaining the intended selection direction.

Parameters

Parameter	Type	Description
`$anchor`	`ResolvedPos`	The desired anchor position (may be adjusted if not in inline content)
`$head`	`ResolvedPos`	The desired head position (may be adjusted if not in inline content)
`bias?`	`number`	Optional search direction bias: positive for forward, negative for backward

Returns

Selection

A text selection between valid positions

Inherited from

Selection.textSelectionBetween

Class: AllSelection ​

Extends ​

Implements ​

Constructors ​

Constructor ​

Parameters ​

Returns ​

Overrides ​

Properties ​

Accessors ​

$anchor ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

$cursor ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

$from ​

Get Signature ​

Throws ​

Returns ​

Implementation of ​

Inherited from ​

$head ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

$to ​

Get Signature ​

Throws ​

Returns ​

Implementation of ​

Inherited from ​

anchor ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

empty ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

from ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

head ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

node ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

ranges ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

to ​

Get Signature ​

Returns ​

Implementation of ​

Inherited from ​

type ​

Get Signature ​

Returns ​

Implementation of ​

Overrides ​

visible ​

Get Signature ​

Returns ​

Class: AllSelection

Extends

Implements

Constructors

Constructor

Parameters

Returns

Overrides

Properties

Accessors

$anchor

Get Signature

Returns

Implementation of

Inherited from

$cursor

Get Signature

Returns

Implementation of

Inherited from

$from

Get Signature

Throws

Returns

Implementation of

Inherited from

$head

Get Signature

Returns

Implementation of

Inherited from

$to

Get Signature

Throws

Returns

Implementation of

Inherited from

anchor

Get Signature

Returns

Implementation of

Inherited from

empty

Get Signature

Returns

Implementation of

Inherited from

from

Get Signature

Returns

Implementation of

Inherited from

head

Get Signature

Returns

Implementation of

Inherited from

node

Get Signature

Returns

Implementation of

Inherited from

ranges

Get Signature

Returns

Implementation of

Inherited from

to

Get Signature

Returns

Implementation of

Inherited from

type

Get Signature

Returns

Implementation of

Overrides

visible

Get Signature

Returns