---
title: "文本对齐扩展"
description: "左对齐、右对齐、居中，无论怎么样！使用文本对齐扩展任意对齐文本。更多内容请参见文档！"
canonical_url: "https://tiptap.zhcndoc.com/editor/extensions/functionality/textalign"
---

# 文本对齐扩展

左对齐、右对齐、居中，无论怎么样！使用文本对齐扩展任意对齐文本。更多内容请参见文档！

此扩展为指定节点列表添加文本对齐属性。此属性用于对齐文本。

> **Firefox 错误:**
>
> `text-align: justify` 在 Firefox 中无法与 `white-space: pre-wrap` 一起使用，[这是一个已知问题](https://bugzilla.mozilla.org/show_bug.cgi?id=1253840)。

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

## 安装

```bash
npm install @tiptap/extension-text-align
```

## 设置

### types

应应用文本对齐属性的节点列表。通常类似 `['heading', 'paragraph']`。

默认值: `[]`

```js
TextAlign.configure({
  types: ['heading', 'paragraph'],
})
```

### alignments

文本对齐属性的可用选项列表。

默认值: `['left', 'center', 'right', 'justify']`

```js
TextAlign.configure({
  alignments: ['left', 'right'],
})
```

### defaultAlignment

默认文本对齐方式。

默认值: `null`

```js
TextAlign.configure({
  defaultAlignment: 'right',
})
```

## 命令

### setTextAlign()

将文本对齐设置为指定值。

```js
editor.commands.setTextAlign('right')
```

### unsetTextAlign()

移除文本对齐值。

```js
editor.commands.unsetTextAlign()
```

### toggleTextAlign()

切换文本对齐值。如果当前值与指定值相同，则将其移除。

```js
editor.commands.toggleTextAlign('right')
```

## 快捷键

| 命令                    | Windows/Linux    | macOS           |
| --------------------- | ---------------- | --------------- |
| setTextAlign(left)    | Ctrl + Shift + L | Cmd + Shift + L |
| setTextAlign(center)  | Ctrl + Shift + E | Cmd + Shift + E |
| setTextAlign(right)   | Ctrl + Shift + R | Cmd + Shift + R |
| setTextAlign(justify) | Ctrl + Shift + J | Cmd + Shift + J |

## 源代码

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