更新日志

最新组件更新与公告。

由于 Plate UI 并非组件库，更新日志在此维护。

使用 CLI 安装最新版本的组件。

2025年6月 #23

6月9日 #23.1

Plate 49

合并文件，使用更一致的命名约定，并删除未使用的 export 语句。

组件:

由于基本节点现在有默认的 HTML 元素，你可以删除 withProps(..., { as: '...' }) 插件组件。
为了提高解耦性，不再仅为了获取键而导入插件。从 @udecode/plate 导入 KEYS 作为统一的键源。
- ParagraphPlugin.key -> KEYS.p
- INDENT_LIST_KEYS.listStyleType -> KEYS.listType
- ListStyleType.Decimal -> KEYS.ol
- ListStyleType.Disc -> KEYS.ul
- list (经典) -> KEYS.listClassic
- ol (经典) -> KEYS.olClassic
- ul (经典) -> KEYS.ulClassic
- li (经典) -> KEYS.liClassic
- action_item (经典) -> KEYS.listTodoClassic
将所有 *-element、*-leaf 文件重命名为 *-node（以及静态版本）
删除 ai-anchor-element，合并到 ai-node
删除 ai-loading-bar，合并到 ai-menu
删除 ai-menu-items，合并到 ai-menu
将 align-dropdown-menu 重命名为 align-toolbar-button，AlignDropdownMenu 重命名为 AlignToolbarButton
将 api-ai 重命名为 ai-api
将 api-uploadthing 重命名为 media-uploadthing-api
BlockSelection：修复表格的块选择
删除 code-block-combobox，合并到 code-block-node
删除 code-line-element，合并到 code-block-node（以及静态版本）
删除 code-syntax-leaf，合并到 code-block-node（以及静态版本）
将 color-toolbar-button 重命名为 font-color-toolbar-button，ColorDropdownMenu 重命名为 FontColorToolbarButton
删除所有 color-* 文件，合并到 font-color-toolbar-button
- 将 color-dropdown-menu 重命名为 font-color-toolbar-button
删除 column-group-element，合并到 column-node（以及静态版本）
删除 comment-create-form，合并到 comment
将 draggable 重命名为 block-draggable，DraggableAboveNodes 重命名为 BlockDraggable
将 emoji-input-element 重命名为 emoji-node
删除所有 emoji-* 文件（除了 emoji-input-node），合并到 emoji-toolbar-button
- 将 EmojiToolbarDropdown 重命名为 EmojiPopover，EmojiDropdownMenu 重命名为 EmojiToolbarButton
- EmojiPicker 的 icons 属性现在是可选的，默认为 emojiCategoryIcons 和 emojiSearchIcons
将 image-preview 重命名为 media-preview-dialog，ImagePreview 重命名为 MediaPreviewDialog
将 image-element 重命名为 media-image-node
- 将 MediaFileElement 重命名为 FileElement（以及静态版本）
- 将 MediaAudioElement 重命名为 AudioElement（以及静态版本）
- 将 MediaVideoElement 重命名为 VideoElement（以及静态版本）
将 indent-list-toolbar-button 重命名为 list-toolbar-button
- 将 BulletedIndentListToolbarButton 重命名为 BulletedListToolbarButton
- 将 NumberedIndentListToolbarButton 重命名为 NumberedListToolbarButton
将 indent-todo-marker 重命名为 block-list
删除 indent-fire-marker
删除 indent-todo-toolbar-button，合并到 list-toolbar-button
将 IndentTodoToolbarButton 重命名为 TodoListToolbarButton
删除 inline-equation-element 和 equation-popover，合并到 equation-node（以及静态版本）
删除 inline-equation-toolbar-button，合并到 equation-toolbar-button
将 insert-dropdown-menu 重命名为 insert-toolbar-button，InsertDropdownMenu 重命名为 InsertToolbarButton
将 line-height-dropdown-menu 重命名为 line-height-toolbar-button，LineHeightDropdownMenu 重命名为 LineHeightToolbarButton
将 link-floating-toolbar 重命名为 link-toolbar
删除 list-indent-toolbar-button，合并到 list-classic-toolbar-button
将 ListIndentToolbarButton 重命名为 IndentToolbarButton
将 list-node 重命名为 list-classic-node
将 media-popover 重命名为 media-toolbar，MediaPopover 重命名为 MediaToolbar
将 mode-dropdown-menu 重命名为 mode-toolbar-button，ModeDropdownMenu 重命名为 ModeToolbarButton
将 more-dropdown-menu 重命名为 more-toolbar-button，MoreDropdownMenu 重命名为 MoreToolbarButton
删除 outdent-toolbar-button，合并到 indent-toolbar-button
table-icons：将 Border* 重命名为 Border*Icon
将 slash-input-element 重命名为 slash-input-node
将 SuggestionBelowNodes 重命名为 SuggestionLineBreak
删除 table-cell-element，合并到 table-node（以及静态版本）
删除 table-row-element，合并到 table-node（以及静态版本）
将 table-dropdown-menu 重命名为 table-toolbar-button，TableDropdownMenu 重命名为 TableToolbarButton
删除 todo-list-node，合并到 list-classic-node
将 turn-into-dropdown-menu 重命名为 turn-into-toolbar-button，TurnIntoDropdownMenu 重命名为 TurnIntoToolbarButton
export-toolbar-button，indent-list-plugins：从 listStyleTypes 中移除 fire
useCommentEditor：使用 usePlateEditor 替代 useCreateEditor
删除 placeholder，withPlaceholder。迁移：使用 block-placeholder-kit，BlockPlaceholderPlugin 替代。
line-height-toolbar-button：删除 useLineHeightDropdownMenu 钩子。
font-color-toolbar-button：删除 useColorInput 钩子。

插件:

将所有 *-plugin、*-plugins 文件重命名为 -kit，将 *Plugin、*Plugins 重命名为 *Kit。插件套件是已配置插件的集合。
- 将 editor-plugins 重命名为 editor-kit
- 将 equation-plugins 重命名为 math-kit，equationPlugins 重命名为 MathKit
- 将 indent-list-plugins 重命名为 list-kit，indentListPlugins 重命名为 ListKit
- 在 block-list 中添加 BlockList 组件，在 list-kit 中使用
- 删除 use-create-editor，使用 usePlateEditor 替代
ai-kit：添加 show 快捷键。从 ai-menu 中删除 useHotkeys('mod+j')
comment-kit：添加 setDraft 转换，快捷键
basic-marks-kit，basic-blocks-kit：添加快捷键
transforms，block-draggable：删除 STRUCTURE_TYPES，这些现在从 plugin.node.isContainer 推断。改用 editor.meta.containerTypes。
从 useSelectionFragmentProp 用法中删除 structuralTypes。

2025年5月 #22

5月26日 #22.7

list (classic) -> KEYS.listClassic
ol (classic) -> KEYS.olClassic
ul (classic) -> KEYS.ulClassic
li (classic) -> KEYS.liClassic
action_item (classic) -> KEYS.listTodoClassic
将所有 *-element、*-leaf 文件重命名为 *-node（以及静态版本）
删除 ai-anchor-element，合并到 ai-node
删除 ai-loading-bar，合并到 ai-menu
删除 ai-menu-items，合并到 ai-menu
将 align-dropdown-menu 重命名为 align-toolbar-button，AlignDropdownMenu 重命名为 AlignToolbarButton
将 api-ai 重命名为 ai-api
将 api-uploadthing 重命名为 media-uploadthing-api
BlockSelection：修复表格的块选择
删除 code-block-combobox，合并到 code-block-node
删除 code-line-element，合并到 code-block-node（以及静态版本）
删除 code-syntax-leaf，合并到 code-block-node（以及静态版本）
将 color-toolbar-button 重命名为 font-color-toolbar-button，ColorDropdownMenu 重命名为 FontColorToolbarButton
删除所有 color-* 文件，合并到 font-color-toolbar-button
- 将 color-dropdown-menu 重命名为 font-color-toolbar-button
删除 column-group-element，合并到 column-node（以及静态版本）
删除 comment-create-form，合并到 comment
将 draggable 重命名为 block-draggable，DraggableAboveNodes 重命名为 BlockDraggable
将 emoji-input-element 重命名为 emoji-node
删除所有 emoji-* 文件（除了 emoji-input-node），合并到 emoji-toolbar-button
- 将 EmojiToolbarDropdown 重命名为 EmojiPopover，EmojiDropdownMenu 重命名为 EmojiToolbarButton
- EmojiPicker 的 icons 属性现在是可选的，默认为 emojiCategoryIcons 和 emojiSearchIcons
将 image-preview 重命名为 media-preview-dialog，ImagePreview 重命名为 MediaPreviewDialog
将 image-element 重命名为 media-image-node
- 将 MediaFileElement 重命名为 FileElement（以及静态版本）
- 将 MediaAudioElement 重命名为 AudioElement（以及静态版本）
- 将 MediaVideoElement 重命名为 VideoElement（以及静态版本）
将 indent-list-toolbar-button 重命名为 list-toolbar-button
- 将 BulletedIndentListToolbarButton 重命名为 BulletedListToolbarButton
- 将 NumberedIndentListToolbarButton 重命名为 NumberedListToolbarButton
将 indent-todo-marker 重命名为 block-list
删除 indent-fire-marker
删除 indent-todo-toolbar-button，合并到 list-toolbar-button
将 IndentTodoToolbarButton 重命名为 TodoListToolbarButton
删除 inline-equation-element 和 equation-popover，合并到 equation-node（以及静态版本）
删除 inline-equation-toolbar-button，合并到 equation-toolbar-button
将 insert-dropdown-menu 重命名为 insert-toolbar-button，InsertDropdownMenu 重命名为 InsertToolbarButton
将 line-height-dropdown-menu 重命名为 line-height-toolbar-button，LineHeightDropdownMenu 重命名为 LineHeightToolbarButton
将 link-floating-toolbar 重命名为 link-toolbar
删除 list-indent-toolbar-button，合并到 list-classic-toolbar-button
将 ListIndentToolbarButton 重命名为 IndentToolbarButton
将 list-node 重命名为 list-classic-node
将 media-popover 重命名为 media-toolbar，MediaPopover 重命名为 MediaToolbar
将 mode-dropdown-menu 重命名为 mode-toolbar-button，ModeDropdownMenu 重命名为 ModeToolbarButton
将 more-dropdown-menu 重命名为 more-toolbar-button，MoreDropdownMenu 重命名为 MoreToolbarButton
删除 outdent-toolbar-button，合并到 indent-toolbar-button
table-icons：将 Border* 重命名为 Border*Icon
将 slash-input-element 重命名为 slash-input-node
将 SuggestionBelowNodes 重命名为 SuggestionLineBreak
删除 table-cell-element，合并到 table-node（以及静态版本）
删除 table-row-element，合并到 table-node（以及静态版本）
将 table-dropdown-menu 重命名为 table-toolbar-button，TableDropdownMenu 重命名为 TableToolbarButton
删除 todo-list-node，合并到 list-classic-node
将 turn-into-dropdown-menu 重命名为 turn-into-toolbar-button，TurnIntoDropdownMenu 重命名为 TurnIntoToolbarButton
export-toolbar-button，indent-list-plugins：从 listStyleTypes 中移除 fire
useCommentEditor：使用 usePlateEditor 替代 useCreateEditor
删除 placeholder，withPlaceholder。迁移：使用 block-placeholder-kit，BlockPlaceholderPlugin 替代。
line-height-toolbar-button：删除 useLineHeightDropdownMenu 钩子。
font-color-toolbar-button：删除 useColorInput 钩子。

插件:

将所有 *-plugin、*-plugins 文件重命名为 -kit，将 *Plugin、*Plugins 重命名为 *Kit。插件套件是已配置插件的集合。
- 将 editor-plugins 重命名为 editor-kit
- 将 equation-plugins 重命名为 math-kit，equationPlugins 重命名为 MathKit
- 将 indent-list-plugins 重命名为 list-kit，indentListPlugins 重命名为 ListKit
- 在 block-list 中添加 BlockList 组件，在 list-kit 中使用
- 删除 use-create-editor，使用 usePlateEditor 替代
ai-kit：添加 show 快捷键。从 ai-menu 中删除 useHotkeys('mod+j')
comment-kit：添加 setDraft 转换，快捷键
basic-marks-kit，basic-blocks-kit：添加快捷键
transforms，block-draggable：删除 STRUCTURE_TYPES，这些现在从 plugin.node.isContainer 推断。改用 editor.meta.containerTypes。
从 useSelectionFragmentProp 用法中删除 structuralTypes。

2025年5月 #22

5月26日 #22.7

修复组合框关闭问题
inline-combobox：修复组合框关闭时 insertPoint 未更新的问题。

5月15日 #22.6

修复内联数学键盘行为和样式
equation-popover：关闭弹出框时将焦点返回到编辑器。
inline-equation-element：选择时应高亮显示。

5月11-12日 #22.5

模板迁移到 Plate 48
迁移到 shadcn v4：
- Plate 有一个分叉版本的 shadcn/ui 原语，可能会与您现有的组件冲突。我们的组件现在完全依赖于原始的 shadcn/ui 原语，使 Plate 更容易集成到您现有的 shadcn/ui 组件集中。
将所有 *-element、*-leaf 文件重命名为 *-node（以及静态版本）
删除 ai-anchor-element，合并到 ai-node
删除 ai-loading-bar，合并到 ai-menu
删除 ai-menu-items，合并到 ai-menu
将 align-dropdown-menu 重命名为 align-toolbar-button，AlignDropdownMenu 重命名为 AlignToolbarButton
将 api-ai 重命名为 ai-api
将 api-uploadthing 重命名为 media-uploadthing-api
BlockSelection：修复表格的块选择
删除 code-block-combobox，合并到 code-block-node
删除 code-line-element，合并到 code-block-node（以及静态版本）
删除 code-syntax-leaf，合并到 code-block-node（以及静态版本）
将 color-toolbar-button 重命名为 font-color-toolbar-button，ColorDropdownMenu 重命名为 FontColorToolbarButton
删除所有 color-* 文件，合并到 font-color-toolbar-button
- 将 color-dropdown-menu 重命名为 font-color-toolbar-button
删除 column-group-element，合并到 column-node（以及静态版本）
删除 comment-create-form，合并到 comment
将 draggable 重命名为 block-draggable，DraggableAboveNodes 重命名为 BlockDraggable
将 emoji-input-element 重命名为 emoji-node
删除所有 emoji-* 文件（除了 emoji-input-node），合并到 emoji-toolbar-button
- 将 EmojiToolbarDropdown 重命名为 EmojiPopover，EmojiDropdownMenu 重命名为 EmojiToolbarButton
- EmojiPicker 的 icons 属性现在是可选的，默认为 emojiCategoryIcons 和 emojiSearchIcons
将 image-preview 重命名为 media-preview-dialog，ImagePreview 重命名为 MediaPreviewDialog
将 image-element 重命名为 media-image-node
- 将 MediaFileElement 重命名为 FileElement（以及静态版本）
- 将 MediaAudioElement 重命名为 AudioElement（以及静态版本）
- 将 MediaVideoElement 重命名为 VideoElement（以及静态版本）
将 indent-list-toolbar-button 重命名为 list-toolbar-button
- 将 BulletedIndentListToolbarButton 重命名为 BulletedListToolbarButton
- 将 NumberedIndentListToolbarButton 重命名为 NumberedListToolbarButton
将 indent-todo-marker 重命名为 block-list
删除 indent-fire-marker
删除 indent-todo-toolbar-button，合并到 list-toolbar-button
将 IndentTodoToolbarButton 重命名为 TodoListToolbarButton
删除 inline-equation-element 和 equation-popover，合并到 equation-node（以及静态版本）
删除 inline-equation-toolbar-button，合并到 equation-toolbar-button
将 insert-dropdown-menu 重命名为 insert-toolbar-button，InsertDropdownMenu 重命名为 InsertToolbarButton
将 line-height-dropdown-menu 重命名为 line-height-toolbar-button，LineHeightDropdownMenu 重命名为 LineHeightToolbarButton
将 link-floating-toolbar 重命名为 link-toolbar
删除 list-indent-toolbar-button，合并到 list-classic-toolbar-button
将 ListIndentToolbarButton 重命名为 IndentToolbarButton
将 list-node 重命名为 list-classic-node
将 media-popover 重命名为 media-toolbar，MediaPopover 重命名为 MediaToolbar
将 mode-dropdown-menu 重命名为 mode-toolbar-button，ModeDropdownMenu 重命名为 ModeToolbarButton
将 more-dropdown-menu 重命名为 more-toolbar-button，MoreDropdownMenu 重命名为 MoreToolbarButton
删除 outdent-toolbar-button，合并到 indent-toolbar-button
table-icons：将 Border* 重命名为 Border*Icon
将 slash-input-element 重命名为 slash-input-node
将 SuggestionBelowNodes 重命名为 SuggestionLineBreak
删除 table-cell-element，合并到 table-node（以及静态版本）
删除 table-row-element，合并到 table-node（以及静态版本）
将 table-dropdown-menu 重命名为 table-toolbar-button，TableDropdownMenu 重命名为 TableToolbarButton
删除 todo-list-node，合并到 list-classic-node
将 turn-into-dropdown-menu 重命名为 turn-into-toolbar-button，TurnIntoDropdownMenu 重命名为 TurnIntoToolbarButton
export-toolbar-button，indent-list-plugins：从 listStyleTypes 中移除 fire
useCommentEditor：使用 usePlateEditor 替代 useCreateEditor
删除 placeholder，withPlaceholder。迁移：使用 block-placeholder-kit，BlockPlaceholderPlugin 替代。
line-height-toolbar-button：删除 useLineHeightDropdownMenu 钩子。
font-color-toolbar-button：删除 useColorInput 钩子。插件:
将所有 *-plugin、*-plugins 文件重命名为 -kit，将 *Plugin、*Plugins 重命名为 *Kit。插件套件是已配置插件的集合。
- 将 editor-plugins 重命名为 editor-kit
- 将 equation-plugins 重命名为 math-kit，equationPlugins 重命名为 MathKit
- 将 indent-list-plugins 重命名为 list-kit，indentListPlugins 重命名为 ListKit
- 在 block-list 中添加 BlockList 组件，用于 list-kit
- 删除 use-create-editor，改用 usePlateEditor
ai-kit：添加 show 快捷键。从 ai-menu 中移除 useHotkeys('mod+j')
comment-kit：添加 setDraft 转换和快捷键
basic-marks-kit、basic-blocks-kit：添加快捷键
transforms、block-draggable：移除 STRUCTURE_TYPES，现在从 plugin.node.isContainer 推断。改用 editor.meta.containerTypes。
从 useSelectionFragmentProp 用法中移除 structuralTypes。

2025年5月 #22

5月26日 #22.7

修复 combobox 关闭问题
inline-combobox：修复 combobox 关闭时 insertPoint 未更新的问题。

5月15日 #22.6

修复内联数学键盘行为和样式
equation-popover：关闭弹出框时将焦点返回到编辑器。
inline-equation-element：选中时应高亮显示。

5月11-12日 #22.5

模板迁移到 Plate 48
迁移到 shadcn v4：
- Plate 之前有一个分叉版本的 shadcn/ui 原语，可能会与你现有的组件冲突。我们的组件现在完全依赖原始的 shadcn/ui 原语，使 Plate 更容易集成到你现有的 shadcn/ui 组件集中。
- 所有组件更新到 Tailwind v4。
- 查看更新的安装指南。
迁移到 React 19。如果你使用 React 18，可能需要在一些地方使用 React.forwardRef。
迁移到 shadcn CLI：
- 从 components.json 中移除 registries
- 使用 npx shadcn 替代 npx shadcx
MCP 支持
从所有组件中移除 withRef
从 @/lib/utils 导入 cn 而不是 @udecode/cn，以保持与 shadcn/ui 的一致性
从所有 element 和 leaf 组件中移除未使用的 className、style 属性
draggable：
- 修复 Firefox 中的拖放功能
media-placeholder-element：重构为使用 use-upload-file 钩子而不是 uploadthing
- 迁移：npx shadcn@latest add https://platejs.org/r/api-uploadthing

5月6日 #22.3

ai-chat-editor：支持非标准 markdown 节点。
slash-input-element：添加 callout 支持。
block-selection-plugins.tsx：修复块选择不工作的问题。

5月4日 #22.2

ai/command: 从 ai 包分叉的 smoothStream 现在默认使用 30ms 延迟（仅代码块和表格使用 100ms 延迟）。

5月2日 #22.1

use-chat: 添加 _abortFakeStream。
ai-menu: 修复菜单项显示不正确的问题。
ai-loading-bar: 将 esc 按键处理移至 ai-menu。
ai/command: 将分块延迟增加到 100ms（临时解决性能问题）。

2025年4月 #21

4月30日 #21.3

autoformat-plugin: 允许以非1的数字开始新的缩进列表

4月29日 #21.2

ai-leaf: 添加 aiIndicatorVariants 以显示加载状态。
cursor-overlay: 当 AI 流式传输时隐藏。
api/ai/command: 修复分块问题。

添加 discussion-plugin:

将 discussionPlugin 添加到 editor-plugins，从 suggestionPlugin 中移除 configure
重构 block-suggestion, comment 以使用 discussionPlugin
修复 comment-create-form 在不存在讨论时创建讨论
suggestion-leaf 中的样式更改
修复 link-floating-toolbar 以支持内部链接，并在建议或评论激活时顶部放置

4月19日 #21.1

ai-anchor-element: 添加 ai-anchor-element 组件，在流式传输前插入，流式传输后移除，用于定位 ai-menu
ai-loading-bar: 添加 ai-loading-bar 组件，用于显示插入模式流式传输的加载进度
ai-menu: 迁移到最新的 ai 包
ai-menu-items: 添加 generateMarkdownSample
ai-plugins: 移除提示中的单段落限制
editor: 引入 PlateContainer 组件

4月2日 #21.1

export-toolbar-button: 修复与 html2canvas-pro 的 PDF 导出问题
import-toolbar-button: 修复有时无法选择文件的问题

2025年3月 #20

3月12日 #20.4

ai-toolbar-button: 添加缺失的 @platejs/ai 依赖。
comment-toolbar-button: 添加缺失的 comments-plugin registry 依赖。
font-size-toolbar-button: 添加缺失的 popover registry 依赖。
tooltip: 添加缺失的 button registry 依赖。

3月10日 #20.3

block-context-menu: 防止在只读模式下打开上下文菜单

3月2日 #20.2

block-suggestion: 修复样式
suggestion-leaf-static: 添加静态版本

3月1日 #20.1

Plate 46 - 新代码块

从 Prism.js 迁移到 lowlight 进行语法高亮
- code-block-element-static, code-block-element, code-block-combobox: 更新以使用 lowlight 类。默认为 github 主题。
- code-syntax-leaf-static, code-syntax-leaf: 更新以使用 lowlight token 类
- 移除 prismjs 依赖及相关样式
- 使用 lowlight 插件选项代替 prism 选项
- code-block-combobox: 添加 Auto 语言选项，更改语言值以匹配 lowlight
autoformat-plugin: 防止在代码块上自动格式化

import { all, createLowlight } from 'lowlight';
 
const lowlight = createLowlight(all);
 
CodeBlockPlugin.configure({
  options: {
    lowlight,
  },
});

2月21日 #19.3

image-preview: 防止在图像预览遮罩上显示块菜单
media-popover: 当图像预览打开时隐藏媒体弹出窗口

2月18日 #19.2

Plate 45 - 新评论和建议 UI

新增 block-discussion 作为主容器，用于 plate-element
新增 comment 用于单个评论显示
新增 comment-create-form 带有最小 Plate 编辑器用于输入
移除旧组件:
- comments-popover
- comment-avatar
- comment-reply-items
- comment-value
- comment-resolve-button
新增 block-suggestion
新增 suggestion-leaf
新增 suggestion-line-break
移除 plate-element，从 platejs/react 导入 PlateElement 代替。在 block-selection-plugins 中添加:

render: {
  belowRootNodes: (props) => {
    if (!props.className?.includes('slate-selectable')) return null;
 
    return <BlockSelection />;
  },
},

2月3日 #19.1

React 19
TailwindCSS 4
Plate 45
Jotai 2
Zustand 6
comment-more-dropdown: 移除 useCommentEditButtonState, useCommentDeleteButtonState
image-element, media-embed-element, media-video-element, mode-dropdown-menu
- 使用 const width = useResizableValue('width')
image-preview: 移除 useScaleInputState, useImagePreviewState
floating-toolbar:
- 用 useEventEditorValue 替换 useEventEditorSelectors
media-popover:
- 用 FloatingMediaStore.set 替换 floatingMediaActions,
- 用 useFloatingMediaValue 替换 useFloatingMediaSelectors

2025年1月 #18

1月23日 #18.8

table-element: 修复样式，折叠时显示表格边框控件
table-row-element: 重构
table-cell-element: 选择背景品牌色

1月21日 #18.7

table-element, table-row-element: 支持行拖放和选择
plate-element: 添加 blockSelectionClassName 属性
editor: 选择区域 z-50
draggable:
- 用 editor.api.blockSelection.clear 替换 editor.api.blockSelection.replaceSelectedIds
- 使用 TooltipButton 作为拖动手柄
- 在拖动手柄点击时选择块
- 在表格单元格中隐藏拖动手柄
column-element, table-cell-element: 添加 isSelectionAreaVisible 检查
block-selection: 拖动时隐藏
用 editor.api.blockSelection.set 替换 editor.api.blockSelection.addSelectedRow:
- ai-menu
- equation-popover
align-dropdown-menu: 弃用

1月18日 #18.6

inline-equation-element 和 equation-popover: 修复: 当选择内联公式时，弹出窗口不应打开，因为它会导致选择丢失。

1月17日 #18.5

emoji-picker-search-bar: 添加 autoFocus

1月16日 #18.4

import-toolbar-button 和 export-toolbar-button: 添加 markdown 支持

1月14日 #18.3

fixed-toolbar-buttons: 添加 import-toolbar-button
indent-fire-marker.tsx 添加 data-plate-prevent-deserialization 以防止反序列化火标记。将 span 标签更改为 li。
indent-todo-marker.tsx 将 span 标签更改为 li。
image-element-static.tsx 和 hr-element-static.tsx: 修复 nodeProps 未传递给 SlateElement。
ai-chat-editor:

const aiEditor = usePlateEditor({ plugins });
useAIChatEditor(aiEditor, content);

1月12日 #18.2

ai-plugins: 移除 createAIEditor，现在在 ai-chat-editor 中创建
ai-chat-editor: 仅使用 useAIChatEditor (v42.1)
ai-menu: 避免冲突，移除 aiEditorRef
command: 添加 focus-visible:outline-none
editor-static: 更新 aiChat 内边距
transforms: 修复 insertBlock 被斜杠命令使用的问题: 如果新插入的块与命令类型相同，则应插入新块。
block-selection-plugins: 更新 BlockSelectionPlugin

BlockSelectionPlugin.configure(({ editor }) => ({
  options: {
    enableContextMenu: true,
    isSelectable: (element, path) => {
      return (
        !['code_line', 'column', 'td'].includes(element.type) &&
        !editor.api.block({ above: true, at: path, match: { type: 'tr' } })
      );
    },
  },
}))

1月8日 #18.1

v42 迁移
table-element, table-element-static
- 将图标移至 table-icons
- 移除 colgroup，列宽现在在 table-cell-element 中设置
table-row-element: 移除 hideBorder 属性
table-cell-element, table-cell-element-static:
- 列悬停/调整大小状态现在使用 Tailwind 而非 JS
- 主要性能改进: 所有表格单元格在单个单元格更改时都会重新渲染。现已修复。
- React.memo
table-dropdown-menu:
- 动态表格插入
- 合并/拆分单元格
- 在前插入行/列
tooltip: 添加 TooltipButton
indent-list-toolbar-button: 移除 IndentListToolbarButton，改用 NumberedIndentListToolbarButton 和 BulletedIndentListToolbarButton。
table-dropdown-menu: 新的插入表格界面。
column-group-element: 修复 ColumnFloatingToolbar onColumnChange

2024年12月 #17

12月28日 #17.8

export-toolbar-button: 添加 katex 支持
plate-element: 移除 relative 类名
所有使用 PlateElement 的组件已移除冗余的 relative 类名。

12月27日 #17.7

fixed-toolbar-buttons: 添加 font-size-toolbar-button
floating-toolbar: 添加 inline-equation-toolbar-button
turn-into-dropdown-menu: 修复: 转换为其他块后，编辑器应重新获得焦点。
insert-dropdown-menu: 添加 inline equation 和 equation 并修复焦点问题
slash-input-element: 添加 equation 和 inline equation

12月23日 #17.5

table-element: 修复选择
之前: isSelectingCell && '[&_*::selection]:bg-none'
之后: isSelectingCell && '[&_*::selection]:!bg-transparent'

12月21日 #17.4

更新 tailwind.config.cjs 以在 HTML 导出中更好地支持字体:

fontFamily: {
  heading: [
    'var(--font-heading)',
    'ui-sans-serif',
    '-apple-system',
    'BlinkMacSystemFont',
    'Segoe UI Variable Display',
    'Segoe UI',
    'Helvetica',
    'Apple Color Emoji',
    'Arial',
    'sans-serif',
    'Segoe UI Emoji',
    'Segoe UI Symbol',
    'Noto Color Emoji',
  ],
  mono: ['var(--font-mono)', ...fontFamily.mono],
  sans: [
    'var(--font-sans)',
    'ui-sans-serif',
    '-apple-system',
    'BlinkMacSystemFont',
    'Segoe UI Variable Display',
    'Segoe UI',
    'Helvetica',
    'Apple Color Emoji',
    'Arial',
    'sans-serif',
    'Segoe UI Emoji',
    'Segoe UI Symbol',
    'Noto Color Emoji',
  ],

12月20日 #17.3

insertColumnGroup, toggleColumnGroup: 使用 columns 选项代替 layout
移除 with-draggables。添加 DraggableAboveNodes 到 draggable。添加到 DndPlugin 配置:

DndPlugin.configure({ render: { aboveNodes: DraggableAboveNodes } }),

column-element, image-element, media-video-element: 移除 useDraggableState。使用 const { isDragging, previewRef, handleRef } = useDraggable
column-group-element: 移除 useColumnState。改用:

const columnGroupElement = useElement<TColumnGroupElement>(ColumnPlugin.key);
 
const onColumnChange = (widths: string[]) => {
  setColumns(editor, {
    at: findNodePath(editor, columnGroupElement),
    widths,
  });
};

export-toolbar-button: 添加 exportToHtml

12月19日 #17.2

Plate 41

新的 RSC 组件用于元素和叶子组件，文件名以 -static.tsx 结尾。这些现在与默认的客户端组件一起添加。
editor: 添加 select-text 到 editorVariants
date-element: 只读时移除弹出窗口
indent-todo-marker: 使用 SlateRenderElementProps 类型代替 PlateRenderElementProps
hr-element, media-audio-element, media-embed-element, mention-element: 改进光标样式
media-file-element: 使用 <a> 代替 div + onClick
所有元素和叶子组件: className 属性现在放在内联属性之前。

12月16日 #17.1

column-element:
- 添加列的拖放支持
- 添加带工具提示的拖动手柄
- 修复列间距和内边距
column-group-element:
- 移除列之间的间隙
- 移除顶部边距
draggable:
- 移除 DraggableProvider HOC
- 移除 DropLine 子属性

2024年11月 #16

11月26日 #16.9

https://github.com/udecode/plate/pull/3809/files

添加 select-editor, tag-element, label, form
用 @udecode/cmdk 替换 cmdk 依赖。这是 cmdk 的可控版本。
command: 添加变体
editor: 添加 select 变体
popover: 添加 animate 变体

https://github.com/udecode/plate/pull/3807/files

toc-element: 移除 <nav> 标签，改用 <div> 修复 html2canvas 问题
editor: 移除 role="button" 修复 html2canvas 问题

11月21日 #16.8

Shadcn 同步:

input: 添加 text-base md:text-sm
textarea: 添加 text-base md:text-sm
editor(ai, aiChat 变体): 添加 text-base md:text-sm

11月14日 #16.7

toolbar: 添加 ToolbarSplitButton, ToolbarSplitButtonPrimary, ToolbarSplitButtonSecondary
media-toolbar-button: 使用 ToolbarSplitButton

11月13日 #16.6

resizable: 只读时隐藏 ResizeHandle

11月8日 #16.5

将此添加到您的 tailwind 配置:

// 插件
require("tailwind-scrollbar-hide")
 
// theme.extend.screens
screens: {
  /**
   * 匹配主指向设备可以方便悬停的设备。用法: main-hover:group-hover:bg-red-500 参见:
   * https://developer.mozilla.org/en-US/docs/Web/CSS/@media/hover
   *
   * 在 iOS 设备上，包含 `group-hover:` CSS 规则的 .group 元素内的按钮需要点击两次才能
   * 点击。作为解决方法，我们在无法方便悬停的设备上禁用这些规则，使用 `main-hover:`。
   */
  'main-hover': {
    raw: '(hover: hover)',
  },
},

editor:
- EditorContainer: 移除 ref，改用 useEditorContainerRef
- 添加 caret-primary selection:bg-brand/25
- 将 `id

Text Changelog