Loading...

特性

  • 将文本格式化为上标,适用于数学表达式或脚注
  • 支持键盘快捷键快速格式化
  • 默认渲染为 <sup> HTML 元素

套件使用方式

安装

最快捷添加上标插件的方式是使用 BasicMarksKit,它包含预配置的 SuperscriptPlugin 以及其他基础标记和它们的 Plate UI 组件。

添加套件

将套件添加到你的插件中:

import { createPlateEditor } from 'platejs/react';
import { BasicMarksKit } from '@/components/editor/plugins/basic-marks-kit';
 
const editor = createPlateEditor({
  plugins: [
    // ...其他插件,
    ...BasicMarksKit,
  ],
});

手动使用方式

安装

pnpm add @platejs/basic-nodes

添加插件

在创建编辑器时,将 SuperscriptPlugin 包含到 Plate 插件数组中。

import { SuperscriptPlugin } from '@platejs/basic-nodes/react';
import { createPlateEditor } from 'platejs/react';
 
const editor = createPlateEditor({
  plugins: [
    // ...其他插件,
    SuperscriptPlugin,
  ],
});

配置插件

你可以为 SuperscriptPlugin 配置自定义键盘快捷键。

import { SuperscriptPlugin } from '@platejs/basic-nodes/react';
import { createPlateEditor } from 'platejs/react';
 
const editor = createPlateEditor({
  plugins: [
    // ...其他插件,
    SuperscriptPlugin.configure({
      shortcuts: { toggle: { keys: 'mod+period' } },
    }),
  ],
});
  • shortcuts.toggle: 定义用于切换上标格式的键盘快捷键

添加工具栏按钮

你可以向工具栏添加 MarkToolbarButton 来切换上标格式。

插件

SuperscriptPlugin

用于上标文本格式化的插件。默认渲染为 <sup> HTML 元素。

转换操作

tf.superscript.toggle

为选中的文本切换上标格式。