@lexical/link

What is @lexical/link?

@lexical/link is a plugin for the Lexical framework that provides functionality for handling links within a Lexical editor. It allows users to insert, edit, and manage hyperlinks in their text content.

What are @lexical/link's main functionalities?

Insert Link

This feature allows you to insert a hyperlink into the editor. The code sample demonstrates how to create a link node and insert it into the current selection.

import { $createLinkNode } from '@lexical/link';

const linkNode = $createLinkNode('https://example.com');
editor.update(() => {
  const selection = $getSelection();
  if ($isRangeSelection(selection)) {
    selection.insertNodes([linkNode]);
  }
});

Edit Link

This feature allows you to edit an existing hyperlink in the editor. The code sample shows how to update the URL of a link node within the current selection.

import { $getSelection, $isRangeSelection } from 'lexical';
import { $isLinkNode } from '@lexical/link';

editor.update(() => {
  const selection = $getSelection();
  if ($isRangeSelection(selection)) {
    const nodes = selection.getNodes();
    nodes.forEach(node => {
      if ($isLinkNode(node)) {
        node.setURL('https://new-url.com');
      }
    });
  }
});

Remove Link

This feature allows you to remove a hyperlink from the editor. The code sample demonstrates how to replace a link node with its text content, effectively removing the link.

import { $getSelection, $isRangeSelection } from 'lexical';
import { $isLinkNode } from '@lexical/link';

editor.update(() => {
  const selection = $getSelection();
  if ($isRangeSelection(selection)) {
    const nodes = selection.getNodes();
    nodes.forEach(node => {
      if ($isLinkNode(node)) {
        node.replace(node.getTextContent());
      }
    });
  }
});

Other packages similar to @lexical/link

draft-js

Draft.js is a rich text editor framework for React. It provides extensive support for handling links, including inserting, editing, and removing links. Compared to @lexical/link, Draft.js offers a more comprehensive set of features for building rich text editors but may have a steeper learning curve.

slate

Slate is another popular framework for building rich text editors in React. It offers similar functionalities for managing links, such as inserting, editing, and removing links. Slate is highly customizable and flexible, making it a strong alternative to @lexical/link.

quill

Quill is a powerful, open-source WYSIWYG editor that provides built-in support for links. It allows users to easily insert and manage hyperlinks within the editor. Quill is known for its ease of use and extensive documentation, making it a good option for developers looking for a straightforward solution.

README

@lexical/link

This package contains the functionality for Lexical links.

More documentation coming soon.

Changelog

v0.8.0 (2023-02-09)

This release includes some breaking changes, including: - Remove of indentList and outdentList from @lexical/list. - Refactor of the LexicalContentEditable types from @lexical/react to make them more accurate with HTMLDivElement attributes.

This release adds functionality to apply node transforms to node replacements, it allows users to specify tab indentation sizes, and improved support for tracking the origin of YJS updates for collaborative editing.

• Ensure deletions capture existing formatting (#3867) Dominic Gannaway
• Add style properties to RangeSelection (#3863) Dominic Gannaway
• List indentation simplified (#3809) EgonBolton
• Update ContentEditable types (#3580) John Flockton
• Allow the format property to be omitted (#3812) Karibash
• Allow users to customise the indentation of tabs (#3802) John Flockton
• Apply node transform not only to the original node but also to the overriding node (#3639) mizuno
• feat: set the update tag from yjs based on the origin (#3608) El-Hussein Abdelraouf