文本组件

核心组件文本组件是一个富文本编辑和合成组件，可进行就地编辑。

使用

文本组件优惠了强大的富文本编辑器，它允许通过简化的内嵌编辑器以及全屏格式轻松编辑文本。

编辑对话框采用有限选项进行联机编辑，全屏编辑对话框中提供完整功能。 使用设计对话框，可以为内容作者的模板配置文本格式选项，如标题、特殊字符和段落样式。

版本和兼容性

文本组件的当前版本为v2,2018年1月在核心组件的2.0.0版中引入了v2，本文档中对此进行了说明。

下表详细列出了组件的所有受支持版本、与组件版本兼容的AEM版本以及指向先前版本文档的链接。

组件版本	AEM 6.4	AEM 6.5	AEM as a Cloud Service
v2	兼容	兼容	兼容
v1	兼容	兼容	-

有关核心组件版本和版本的详细信息，请参阅文档核心组件版本。

示例组件输出

要体验文本组件及其配置选项以及HTML和JSON输出的示例，请访问组件库。

技术详细信息

有关文本组件的最新技术文档可在GitHub上找到。

有关开发核心组件的更多详细信息，请参阅核心组件开发人员文档。

文本组件和富文本编辑器

核心组件文本组件利用AEM富文本编辑器(RTE)。 RTE为内容作者提供了各种用于编辑其文本内容的功能。 RTE的配置非常灵活，并优惠了许多选项。 有关如何配置RTE的更多详细信息，请参阅文章配置富文本编辑器和配置富文本编辑器插件。

本文的其余部分演示了使用现成RTE配置的核心组件文本组件的标准配置。

编辑对话框

编辑对话框优惠用户希望合成文本的标准富文本格式工具。

粗体

用于对选定文本应用粗体格式或大胆设置光标后输入的文本格式。

Ctrl+ B可用作键盘快捷键。

斜体

用于将斜体格式应用于选定文本或在光标后输入的斜体文本。

Ctrl+ Ican可用作键盘快捷键。

下划线

用于将带下划线的格式应用于在光标后输入的选定文本或下划线文本。

Ctrl+ Ucan可用作键盘快捷键。

下标

用于将光标后输入的选定文本或文本格式化为下标。

上标

用于将光标后输入的选定文本或文本格式化为上标。

粘贴文本

将任何复制的文本粘贴为纯文本，而不使用任何格式。

选择此选项时，将打开一个窗口，在该窗口中，文本可以粘贴为纯文本，且在插入文本之前没有预览。 点按或单击复选标记以接受，点按或单击x以取消。

从 Word 粘贴

选择此选项时，将打开一个窗口，在将文本插入文本之前，该窗口将保持其格式预览。 点按或单击复选标记以接受，点按或单击x以取消。

超链接

使用此选项可将选定文本转换为超链接或修改已定义的链接。 仅当已选择文本并打开一个包含设置链接的其他选项的窗口时，此选项才处于活动状态。

• 输入路径

  • 使用“打开选择”对话框在AEM中选择路径
  • 如果链接不在AEM中，请输入绝对URL
    • 非绝对路径被解释为相对于AEM的相对路径

• 输入链接的替代描述性文本

• 选择链接行为

  • 目标
  • 相同选项卡
  • 新选项卡
  • 父框架
  • 顶层框架

  点按或单击复选标记以应用链接，或点按x以取消。

取消链接

使用此选项可删除已应用于所选文本的链接。 仅当已选择链接时，此选项才处于活动状态。

查找

使用此选项可搜索文本以查找指定文本字符串的匹配项。 选择此选项将打开一个窗口，用于指定搜索选项。

输入要搜索的文本并点按或单击​查找​以开始搜索。 点按或单击x可取消。
如果要根据大小写进行精确匹配，请在开始搜索之前选择选项​匹配大小写。
如果找到匹配项，则突出显示该匹配项，并且搜索对话框灰显。 再次点按或单击灰显对话框中的​查找​按钮，以搜索下一个匹配项。

如果未找到其他匹配项，则将显示一条消息，并从文本的开头开始搜索。

替换

使用此选项可搜索出现指定文本字符串的文本，并将匹配项替换为其他字符串。 选择此选项将打开一个窗口，用于指定搜索和替换选项。

输入要搜索的文本以及应替换的文本。

• 点按或单击​查找​以开始搜索。 单击或点按x可取消。
• 如果要根据大小写进行精确匹配，请在开始搜索之前选择选项​匹配大小写。
• 选择​全部替换​以一次替换所有出现的文本。

如果找到匹配项，则突出显示该匹配项，并且搜索对话框灰显。 再次单击灰显对话框中的​查找​按钮以搜索下一个匹配项，或选择​替换​按钮以替换高亮显示的匹配文本。 请注意，只有匹配后，替换​按钮才处于活动状态。

单击“查找并替换”对话框时，该对话框变得透明，单击“替换”时变得不透明。 这允许作者查看作者将替换的文本。

左对齐文本

用于将文本与左边距对齐。

居中对齐文本

用于将文本居中。

右对齐文本

用于将文本与右边距对齐。

Bullet

用于将选定文本格式化为项目符号列表，或在光标后开始插入项目符号列表。

要结束项目符号列表，请再次点按或单击​项目符号​按钮，或输入两个回车符。

编号

用于将选定文本格式化为编号列表，或在光标后开始插入编号列表。

要结束编号列表，请再次点按或单击​编号​按钮，或输入两个回车符。

突出

用于降低在光标后输入的选定文本或文本的缩进级别。

仅当光标的选定文本或位置已缩进时才处于活动状态。

缩进

用于增加在光标后输入的选定文本或文本的缩进级别。

表

用于在文本中插入表。 选择此选项将打开一个窗口，用于指定表的详细信息。

• 列 -表的列数（必需）
• 行 -表的行数（必需）
• 宽度 -表的宽度
• 高度 -表的高度
• 单元格边距 -单元格内容周围的空格
• 单元格间距 -单元格之间的间距
• 边框 -表边框线的权重
  • 如果表的标题：
    • 应使用第一行
    • 应使用第一列
    • 应使用第一行和第一列
    • 或者不应使用标题。
• Caption —— 表的描述

拼写检查

用于检查文本内容的拼写。 可能的拼写错误用破红线加下划线。

有关拼写检查和自定义拼写检查字典的更多详细信息，请参阅文档配置富文本编辑器插件。

特殊字符

用于在文本中插入特殊字符。 选择此选项将打开一个窗口，其中显示可用字符。

点按或单击所需字符，将其插入光标后的文本中。 可插入多个字符。 点按或单击x以关闭选择窗口。

编辑源文件

用于视图和修改文本的HTML源。

点按或单击​源编辑​图标，将文本的内容从格式化视图更改为视图原始HTML。 在此模式下，所有其他格式选项都被禁用。 再次点按或单击​源编辑​图标，以返回到格式化视图。

段落格式

用于将段落格式应用于选定文本或光标后插入的文本。 选择此选项将打开一个下拉框，从中选择段落格式。

行内编辑

文本组件也可以联机进行编辑，但由于空间限制，并非所有格式选项都联机可用。 要查看所有选项，请切换到全屏模式。

设置和ID

此选项允许控制HTML和数据层中组件的唯一标识符。

• 如果留空，则会自动为您生成唯一ID，并可通过检查生成的页面找到该ID。
• 如果指定了ID，则作者有责任确保它是唯一的。
• 更改ID可能会影响CSS、JS和数据层跟踪。

设计对话框

设计对话框允许模板作者定义内容作者可以使用的文本格式选项。

插件选项卡

插件选项卡用于启用和禁用内容作者可用的各种文本格式选项。

功能

可以为组件激活或取消激活以下功能。

• 粘贴纯文本
• 过去自词
• 查找和替换
• 拼写检查器
• 插入的图像修改选项
• HTML源编辑

格式化

可以为组件激活或取消激活以下格式选项。

• 表
• 列表（项目符号、数字、缩进、凸出）
• 对齐（左对齐、右对齐、居中对齐）
• 粗体、斜体、下划线
• 链接（和取消链接）
• 子／上标

段落样式

可以为组件激活或取消激活段落样式。 激活后，可以定义允许的格式。

• 点按或单击​添加​按钮以插入新样式。
• 输入样式的代码以及将在编辑对话框中显示的说明。
• 要删除样式点按或单击​删除​按钮。
• 要重新排列格式的顺序，请点按或单击并拖动手柄。

特殊字符

可以为组件激活或取消激活插入特殊字符的选项。 激活后，可以定义允许的字符。

• 点按或单击​添加​按钮以插入新字符。
• 输入字符的HTML代码和将在编辑对话框中显示的说明。
• 要删除字符点按或单击​删除​按钮。
• 要重新排列字符的点按顺序，请单击或拖动手柄。

样式选项卡

文本组件支持AEM 样式系统。