菜单和拖动手柄
菜单和拖动手柄可在内容旁放置自定义控件,包括选中文本旁的菜单、空行上的菜单,以及用于拖动块的手柄。
使用场景
- 设置选区格式。 Bubble menu 会在选中文本旁显示菜单,例如提供用于应用标记的按钮。
- 插入内容块。 Floating menu 会在空行上显示菜单,例如用于插入内容块。
- 移动内容块。 Drag handle 会显示可拖动的手柄,用于将内容块移到其他位置。启用
nested设置后,它也适用于列表项和其他嵌套内容。
工作原理
- 控件由你构建。 扩展会显示并定位你提供的元素,其标记和样式由你决定。
- React 和 Vue 提供组件。
@tiptap/react和@tiptap/vue-3包含 Bubble menu 和 Floating menu 组件;使用这些组件时无需另行添加对应扩展。Drag handle React 和 Drag handle Vue 将拖动手柄封装为组件,并会自动将其注册到编辑器。 - 多个实例需要使用不同的键。 同一个编辑器中的每个菜单或手柄都要使用唯一的
pluginKey。 - 需要手动添加。 这些扩展都不包含在 StarterKit 中。