@lexical/selection

@lexical/selection

This package contains selection helpers for Lexical.

Methods

getStyleObjectFromCSS

Given a CSS string, returns an object from the style cache.

export function getStyleObjectFromCSS(css: string): {
  [key: string]: string;
} | null;

$patchStyleText

Applies the provided styles to the TextNodes in the provided Selection. Key names in the patch argument should be the valid CSS properties (i.e., kebab-case).

export function $patchStyleText(
  selection: RangeSelection | GridSelection,
  patch: {
    [key: string]: string;
  },
): void;

$getSelectionStyleValueForProperty

Given a selection and a valid CSS property name, returns the current value of that property for TextNodes in the Selection, if set. If not set, it returns the defaultValue. If all TextNodes do not have the same value, it returns an empty string.

export function $getSelectionStyleValueForProperty(
  selection: RangeSelection,
  styleProperty: string,
  defaultValue: string,
): string;

$moveCaretSelection

Moves the selection according to the arguments.

export function $moveCaretSelection(
  selection: RangeSelection,
  isHoldingShift: boolean,
  isBackward: boolean,
  granularity: 'character' | 'word' | 'lineboundary',
): void;

$isParentElementRTL

Returns true if the parent of the Selection anchor node is in Right-To-Left mode, false if not.

export function $isParentElementRTL(selection: RangeSelection): boolean;

$moveCharacter

Wraps $moveCaretSelection, using character granularity and accounting for RTL mode.

export function $moveCharacter(
  selection: RangeSelection,
  isHoldingShift: boolean,
  isBackward: boolean,
): void;

$selectAll

Expands the current Selection to cover all of the content in the editor.

export function $selectAll(selection: RangeSelection): void;

$setBlocksType_experimental

Converts all nodes in the selection that are of one block type to another specified by parameter

export function $setBlocksType_experimental(
  selection: RangeSelection,
  createElement: () => ElementNode,
): void;

$isAtNodeEnd

Returns true if the provided point offset is in the last possible position.

export function $isAtNodeEnd(point: Point): boolean;

$shouldOverrideDefaultCharacterSelection

Returns true if default character selection should be overridden, false if not. Used with DecoratorNodes

export function $shouldOverrideDefaultCharacterSelection(
  selection: RangeSelection,
  isBackward: boolean,
): boolean;

Changelog

v0.7.6 (2023-01-10)

• Fix typo in LexicalAutoLinkPlugin code example (#3685) Lorenzo
• updated typo (#3697) Christopher Tran
• Add width and height to serialized image nodes (#3684) Ebad
• fix: force to set TextNode's content when compositionKey is invalid (#3679) Conatus
• Fix: convert html 's' tag to node for strickethrough format is missing (#3673) hun
• Fix bug with ArrowDown/ArrowUp in RichTextPlugin (#3676) Dominic Gannaway
• Remove ts-ignore for createContext (#3671) yf-yang
• Fix bug in reconciler sub-tree text content cache (#3669) Dominic Gannaway
• Hide commenting controls on mobile screen sizes (#3667) Dominic Gannaway
• Fix theming docs (#3668) Dominic Gannaway
• update: change character_limit to be passed as a props( maxlength) (#3649) 0x harry
• Add TabIndentationPlugin to playground. (#3632) Acy Watson