---
title: "上标扩展"
description: "在 Tiptap 中使用上标扩展，以在正常行上方书写文本。在我们的文档中了解更多信息！"
canonical_url: "https://tiptap.zhcndoc.com/editor/extensions/marks/superscript"
---

# 上标扩展

在 Tiptap 中使用上标扩展，以在正常行上方书写文本。在我们的文档中了解更多信息！

使用此扩展来渲染 上标 文本。如果你在编辑器的初始内容中传递 `<sup>` 或带有 `vertical-align: super` 的文本作为内联样式，两者都将相应渲染。

> **限制:**
>
> 此扩展将在读取 `Editor` 实例的内容时生成相应的 `<sup>` HTML 标签。所有上标文本，无论方法如何，都将规范化为 `<sup>` HTML 标签。

> **Interactive demo:** [Superscript](https://embed.tiptap.dev/preview/Marks/Superscript)

## 安装

```bash
npm install @tiptap/extension-superscript
```

## 设置

### HTMLAttributes

应添加到渲染的 HTML 标签的自定义 HTML 属性。

```js
Superscript.configure({
  HTMLAttributes: {
    class: 'my-custom-class',
  },
})
```

## 命令

### setSuperscript()

将文本标记为上标。

```js
editor.commands.setSuperscript()
```

### toggleSuperscript()

切换上标标记。

```js
editor.commands.toggleSuperscript()
```

### unsetSuperscript()

移除上标标记。

```js
editor.commands.unsetSuperscript()
```

## 键盘快捷键

| 命令                  | Windows/Linux | macOS   |
| ------------------- | ------------- | ------- |
| toggleSuperscript() | Control + .   | Cmd + . |

## 源代码

[packages/extension-superscript/](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-superscript/)