Skip to content

Extends payload CMS with Meta's lexical RichText editor - a much more advanced and customizable richtext editor

License

Notifications You must be signed in to change notification settings

AlessioGr/payload-plugin-lexical

Repository files navigation

Payload Lexical Plugin GitHub Repo stars

npm npm NPM

A plugin for Payload CMS whichs adds a lexical-based richtext editor. Lexical is a lot nicer to use than Slate & more modern - it's also maintained by Meta.

This plugin already comes packed with a ton of features which the original editor doesn't have (from tables & markdown to stuff like speech-to-tech) - all customizable. It's also a lot easier to extend this editor and add new stuff to it!

Installation / How to use

Install the plugin using yarn add payload-plugin-lexical. You can find examples of how to use it below.

Minimum required payload version: 1.6.32

Screenshots

203127349-2be29de4-aff3-4e13-9ebe-56be5fc3fc97 (1) 203127640-caa1f279-1555-48e6-9465-8c441ea65149

How I'm using it in production - customized & with some features turned on or off:

Arc 2023-03-20 at 01 34 05@2x

Arc.2023-03-20.at.01.45.57.mp4

Example - Basic

payload.config.ts:

import { buildConfig } from 'payload/config'; import { LexicalPlugin } from "payload-plugin-lexical"; export default buildConfig({ ... plugins: [ LexicalPlugin({ // Only set this if you want to use the the AISuggest Feature ai: { openai_key: process.env.OPENAI_KEY, }, }), ], typescript: { outputFile: path.resolve(__dirname, 'payload-types.ts'), }, });

Collection config:

import { CollectionConfig } from 'payload/types'; import { lexicalRichTextField } from 'payload-plugin-lexical'; const Lexical: CollectionConfig = { slug: 'lexicalRichText', admin: { useAsTitle: 'title', }, fields: [ { name: 'title', type: 'text', required: true, }, lexicalRichTextField({ name: 'lexicalRichTextEditor', label: 'Lexical Rich Text Editor', }), ], }; export default Lexical;

Example - more customization and own, custom node:

import { CollectionConfig } from 'payload/types'; import { lexicalRichTextField, EquationsFeature, EmojisFeature, EmojiPickerFeature, HorizontalRuleFeature, FigmaFeature, YouTubeFeature, TwitterFeature, SpeechToTextFeature, ImportFeature, ExportFeature, ClearEditorFeature, ReadOnlyModeFeature, ConvertFromMarkdownFeature, MentionsFeature, TreeViewFeature, KeywordsFeature, AutoCompleteFeature, CollapsibleFeature, TypingPerfFeature, PasteLogFeature, TestRecorderFeature, LinkFeature, TableOfContentsFeature, AISuggestFeature, } from 'payload-plugin-lexical'; const Lexical: CollectionConfig = { slug: 'lexicalRichText', admin: { useAsTitle: 'title', }, fields: [ { name: 'title', type: 'text', required: true, }, lexicalRichTextField({ name: 'lexicalRichTextEditor', label: 'cool richtext editor', localized: true, editorConfigModifier: (defaultEditorConfig) => { defaultEditorConfig.debug = false; defaultEditorConfig.toggles.textColor.enabled = false; defaultEditorConfig.toggles.textBackground.enabled = false; defaultEditorConfig.toggles.fontSize.enabled = false; defaultEditorConfig.toggles.font.enabled = false; defaultEditorConfig.toggles.align.enabled = false; defaultEditorConfig.toggles.tables.enabled = true; defaultEditorConfig.toggles.tables.display = false; // Optional: these are the default features. Feel free to customize them or remove the ones you do not like! defaultEditorConfig.features = [ EquationsFeature({}), // LaTex (well KaTeX) equations EmojisFeature({}), // Adds new Emoji nodes with new, different-looking emojis EmojiPickerFeature({}), // Use in combination with EmojisPlugin. When you start typing ":" it will show you different emojis you can use. They also look different! HorizontalRuleFeature({}), // Horizontal rule in the editor. FigmaFeature({}), // Figma Embed YouTubeFeature({}), // YouTube Embed TwitterFeature({}), // Twitter Embed SpeechToTextFeature({}), // Adds a Speech-to-text button in the Actions menu (bottom right of the editor). When you click on it and speak, it converts the speech into text ImportFeature({}), // Acion button: import ExportFeature({}), // Acion button: export ClearEditorFeature({}), // Adds a button in the action menu which clears the editor ReadOnlyModeFeature({}), // Acion button: toggle read-only mode on or off ConvertFromMarkdownFeature({}), // Acion button: convert from markdown MentionsFeature({}), // Ability to mention someone when you type "@" TreeViewFeature({ enabled: defaultEditorConfig.debug }), // If enabled, will show the node representation of the editor under the editor. Good for debugging KeywordsFeature({}), // Highlights certain words AutoCompleteFeature({}), // Autocompletes certain words while typing CollapsibleFeature({}), // Adds a "collapsible" node TypingPerfFeature({ enabled: defaultEditorConfig.debug }), // Some debug tool for performance testing PasteLogFeature({ enabled: defaultEditorConfig.debug }), // Another debug tool TestRecorderFeature({ enabled: defaultEditorConfig.debug }), // Another debug tool used for lexical core development, with which you can automatically generate tests LinkFeature({}), // Obvious: hyperlinks! This includes the AutoLink plugin. TableOfContentsFeature({ enabled: false }), // Shows a table of contents on the right hand-side of the screen AISuggestFeature({}), // Make sure you set your openai key in the plugin config to be able to use it ]; // A feature can consist of nodes, plugins, modals, toolbar elements and more! YourOwnCustomFeature must be of type "Feature" defaultEditorConfig.features.push(YourOwnCustomFeature({})); return defaultEditorConfig; }, }), ], }; export default Lexical;

This example can also be found in the demo!

Serializing

Feel free to use my serializer in the serialize-example folder of this repo. Lexical is using bitwise operations for the node formats.

This currently serialized the most important stuff, but not everything. Feel free to contribute to it if you add more!

Idea list:

  • Update slash commands to reflect the toolbar
  • Add wordcount, charactercount & preview to the json output
  • Commenting functionality
  • Upload plugin/node captions
  • Ability to add custom fields to uploads like captions
  • (relationship node?)
  • Fix internal collection search for internal link editor
  • Edit Upload Button
  • Improve design & UX of links. For example, clicking on the link button should open the link drawer immediately
  • (maybe?) lazy loading lexical editor to reduce load times. or maybe just the images?
  • New format/node: "highlight"/"mark" (WILL BE ADDED NATIVELY BY LEXICAL IN 0.7.8)
  • Increase customizability & DX. Plugins should all be set in the config. Slash commands & Toolbar items should come from the same place.
  • Add ExcaliDraw
  • Take a closer look at AutoLink. Is it necessary and what does it do?
  • Make extranodes, extraplugins ... config options hold the ENTIRE nodes, and rename to just "nodes" and "plugins". Makes it easier to remove them and start from scratch, or to insert one at a special position, instead of just pushing it to the end. Especially useful for the Toolbar plugin.
  • extraFloatingToolbarElements
  • Implement Table Cell Background Color PR

Updating lexical

Since this is based on their playground, you gotta upstream their changes. Then, the following is additionally copied over outside of the playground package - needs to be considered in lexical updates as well:

About

Extends payload CMS with Meta's lexical RichText editor - a much more advanced and customizable richtext editor

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Languages