---
title: "文本对齐"
description: "文本对齐如何在 DOCX 和 Tiptap 之间转换，以及如何配置 TextAlign 扩展以实现干净的往返转换。"
canonical_url: "https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/text-alignment"
---

# 文本对齐

文本对齐如何在 DOCX 和 Tiptap 之间转换，以及如何配置 TextAlign 扩展以实现干净的往返转换。

Text alignment is a paragraph-level property that can be preserved round-trip between DOCX and the editor. After configuring the TextAlign extension, alignment remains unchanged during import, editing, and export.

## 你需要什么

- **扩展：** [`ConvertKit`](https://tiptap.zhcndoc.com/conversion/import/docx/convertkit.md) 捆绑了 `TextAlign`，并使用 `types: ['paragraph', 'heading']` 进行了预配置。
- **配置：** 无需配置。
- **就是这样。** 使用标准的 ConvertKit 设置，对齐功能即可端到端正常工作。

## 支持概览

|      | 导入 | 编辑器 | 导出 |
| ---- | -- | --- | -- |
| 左对齐  | 支持 | 支持  | 支持 |
| 居中   | 支持 | 支持  | 支持 |
| 右对齐  | 支持 | 支持  | 支持 |
| 两端对齐 | 支持 | 支持  | 支持 |

## 导入

使用 [编辑器扩展](https://tiptap.zhcndoc.com/conversion/import/docx/editor-extension.md) 或 [REST API](https://tiptap.zhcndoc.com/conversion/import/docx/rest-api.md) 导入文本对齐。两者会生成完全相同的输出。

转换服务会读取每个 DOCX 段落中的 `<w:jc>` 元素，并将其映射到对应 Tiptap 节点上的 `textAlign` 属性。

| Word `<w:jc>` 值 | Tiptap `textAlign`             |
| --------------- | ------------------------------ |
| `left`          | `left`                         |
| `center`        | `center`                       |
| `right`         | `right`                        |
| `both`          | `justify`                      |
| `start`         | `start`（原样传递，TextAlign 可能无法识别） |
| `end`           | `end`（原样传递，TextAlign 可能无法识别）   |

`textAlign` 属性会同时设置在 `paragraph` 和 `heading` 节点上。

> **不支持从右到左的文本方向:**
>
> 导入器不会解析 DOCX 段落方向（`<w:bidi>`）和 run 方向（`<w:rtl>`）。使用阿拉伯语、希伯来语、波斯语、乌尔都语或其他 RTL 语言编写的文档，会按照 Tiptap 的 CSS 方向渲染（默认是 LTR），而不管源文档是如何编写的。导出器也不会将方向写回，因此以 LTR 编辑的文档导出后仍然是 LTR。若要处理 RTL 内容，目前可以在编辑器根元素的 CSS 中设置 `dir="rtl"`，或在应用层检测语言并自行应用方向。

## 编辑器渲染

[`TextAlign`](https://tiptap.zhcndoc.com/editor/extensions/functionality/textalign.md) 扩展会在你指定的节点类型上添加全局属性 `textAlign`。它会在 HTML 元素上渲染为内联 `style="text-align: ..."`。ConvertKit 已将其注册为 `types: ['paragraph', 'heading']`，因此导入的对齐可以开箱即用地渲染出来：

```ts
import { ConvertKit } from '@tiptap-pro/extension-convert-kit'

new Editor({ extensions: [ConvertKit] })
```

如果你需要不同的类型（例如表格单元格），可以覆盖该配置：

```ts
ConvertKit.configure({
  textAlign: { types: ['paragraph', 'heading', 'tableCell'] },
})
```

> **禁用 textAlign 会丢失该属性:**
>
> 如果你设置 `ConvertKit.configure({ textAlign: false })`，那么导入中的 `textAlign` 属性不会被 schema 识别，也不会被应用。不会抛出错误。有关此行为的更多信息，请参阅 [无效 schema 指南](https://tiptap.zhcndoc.com/guides/invalid-schema.md)。

## 导出

使用 [编辑器扩展](https://tiptap.zhcndoc.com/conversion/export/docx/editor-extension.md) 或 [REST API](https://tiptap.zhcndoc.com/conversion/export/docx/rest-api.md) 导出文本对齐。两者会以相同方式处理文本对齐。

导出器会读取每个段落和标题中的 `node.attrs.textAlign`，并将其映射回 DOCX 的对齐类型。不需要额外配置。如果导入和编辑器配置正确，导出会自动跟随生效。