Show Menu
主题×

文本组件

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

使用

文本组件优惠了强大的富文本编辑器,它允许通过简化的内嵌编辑器以及全屏格式轻松编辑文本。
“编 辑”对话框 ,以有限的选项进行联机编辑,并且全屏编辑对话框中提供了完整功能。 使用设 计对话框 ,可以为内容作者的模板配置文本格式选项,如标题、特殊字符和段落样式。

版本和兼容性

文本组件的当前版本为v2,2018年1月在核心组件的2.0.0版中引入了v2,本文档中对此进行了说明。
下表详细列出了组件的所有受支持版本、与组件版本兼容的AEM版本以及指向先前版本文档的链接。
组件版本
AEM 6.3
AEM 6.4
AEM 6.5
AEM 云服务
v2
-
兼容
兼容
兼容
兼容
兼容
兼容
-
有关核心组件版本和版本的详细信息,请参阅文档 核心组件版本

示例组件输出

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

技术详细信息

有关文本组件的最新技 术文档,请访问GitHub
有关开发核心组件的更多详细信息,请参阅核 心组件开发人员文档

文本组件和富文本编辑器

核心组件文本组件利用AEM富文本编辑器(RTE)。 RTE为内容作者提供了各种用于编辑其文本内容的功能。 RTE的配置非常灵活,并优惠了许多选项。 有关如何配置RTE的更多详细信息,请参阅 配置富文本编辑器 和配置富文本编辑器插件
本文的其余部分演示了使用现成RTE配置的核心组件文本组件的标准配置。
文本组件中 仅提供由RTE的UI 配置启用的选项。

Edit Dialog

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

粗体

用于对选定文本应用粗体格式或大胆设置光标后输入的文本格式。
Ctrl+B 可用作键盘快捷键。

斜体

用于将斜体格式应用于选定文本或在光标后输入的斜体文本。
Ctrl+I 可用作键盘快捷键。

下划线

用于将带下划线的格式应用于在光标后输入的选定文本或下划线文本。
Ctrl+U 可用作键盘快捷键。

下标

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

上标

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

粘贴文本

将任何复制的文本粘贴为纯文本,而不使用任何格式。
选择此选项时,将打开一个窗口,在该窗口中,文本可以粘贴为纯文本,且在插入文本之前没有预览。 点按或单击复选标记以接受,点按或单击x以取消。

从 Word 粘贴

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

超链接

使用此选项可将选定文本转换为超链接或修改已定义的链接。 仅当已选择文本并打开一个包含设置链接的其他选项的窗口时,此选项才处于活动状态。
  • 输入路径
    • 在AEM中使用“打开选择”对话框选择路径
    • 如果链接不在AEM中,请输入绝对URL
      • 非绝对路径被解释为相对于AEM
  • 输入链接的替代描述性文本
  • 选择链接行为
    • 目标
    • 相同选项卡
    • 新选项卡
    • 父框架
    • 顶层框架
    点按或单击复选标记以应用链接,或点按x以取消。

取消链接

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

查找

使用此选项可搜索文本以查找指定文本字符串的匹配项。 选择此选项将打开一个窗口,用于指定搜索选项。
输入要搜索的文本并点按,或单击“查 ”开始搜索。 点按或单击x可取消。 如果要根据大小写进行精确匹配,请在开始搜索 之前选择 “匹配大小写”选项。 如果找到匹配项,则突出显示该匹配项,并且搜索对话框灰显。 再次点按或单 击灰显 对话框中的“查找”按钮,以搜索下一个匹配项。
如果未找到其他匹配项,则将显示一条消息,并从文本的开头开始搜索。

替换

使用此选项可搜索出现指定文本字符串的文本,并将匹配项替换为其他字符串。 选择此选项将打开一个窗口,用于指定搜索和替换选项。
输入要搜索的文本以及应替换的文本。
  • 点按或单 击查 找以开始搜索。 单击或点按x可取消。
  • 如果要根据大小写进行精确匹配,请在开始搜索 之前选择 “匹配大小写”选项。
  • 择“全部替 换”以一次替换所有出现的文本。
如果找到匹配项,则突出显示该匹配项,并且搜索对话框灰显。 再次单 击灰 显对话框中的“查找”按钮以搜索下一个匹配项,或选择“替 ”按钮以替换突出显示的匹配文本。 请注意,只 有匹配 后,“替换”按钮才处于活动状态。
单击“查找并替换”对话框时,该对话框变得透明,单击“替换”时变得不透明。 这允许作者查看作者将替换的文本。
使用替换功能时,应与查找字符串同时输入要替换的替换字符串。 但是,在替换字符串之前,您仍可以单击“查找”以搜索该字符串。 如果在单击“查找”后输入替换字符串,则搜索将重置为文本的开头。

左对齐文本

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

居中对齐文本

用于将文本居中。

右对齐文本

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

Bullet

用于将选定文本格式化为项目符号列表,或在光标后开始插入项目符号列表。
要结束项目符号列表,请再次点按或单 “项目符号”按钮,或输入两个回车。

编号

用于将选定文本格式化为编号列表,或在光标后开始插入编号列表。
要结束编号列表,请再次点按或单 “编号”按钮,或输入两个回车。

突出

用于降低在光标后输入的选定文本或文本的缩进级别。
仅当光标的选定文本或位置已缩进时才处于活动状态。

缩进

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

用于在文本中插入表。 选择此选项将打开一个窗口,用于指定表的详细信息。
  • -表的列数(必需)
  • -表的行数(必需)
  • 宽度 -表的宽度
  • 高度 -表的高度
  • 单元格边距 -单元格内容周围的空格
  • 单元格间距 -单元格之间的间距
  • 边框 -表边框线的权重
    • 如果表的标题:
      • 应使用第一行
      • 应使用第一列
      • 应使用第一行和第一列
      • 或者不应使用标题。
  • Caption —— 表的标题

拼写检查

用于检查文本内容的拼写。 可能的拼写错误用破红线加下划线。
有关拼写检查和自定义拼写检查字典的更多详细信息,请参 阅文档配置富文本编辑器插件

特殊字符

用于在文本中插入特殊字符。 选择此选项将打开一个窗口,其中显示可用字符。
点按或单击所需字符,将其插入光标后的文本中。 可插入多个字符。 点按或单击x以关闭选择窗口。

编辑源文件

用于视图和修改文本的HTML源。
点按或单击 源编辑 图标,以将文本的内容从格式化视图更改为视图原始HTML。 在此模式下,所有其他格式选项都被禁用。 再次点按或单 击源编辑 图标以返回已设置格式的视图。
与访问原始HTML时一样,在使用“源编辑”选项时 必须小心 !
通过源编 辑输入 的HTML将扫描XSS风险,并删除所插入的任何脚本,且不会显示在生成的页面上。 但是,在源代码编辑中输 入的格 式错误的HTML可能会中断页面的模板,导致意外的格式或导致生成的页面无法使用。
由于通过源编 辑输入的 HTML会扫描XSS风险和任何脚本并自动删除找到的脚本,因此保留的实际内容可能与在源编辑中输入的内容 不同 。 因此,要保存使用源代码编辑所做 的更改 ,必须先退出源代码 ​编辑,以在普通编辑器中视图文本,然后再进行保存。

段落格式

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

联机编辑

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

设置和ID

此选项允许控制HTML和数据层中组件的唯一标 识符
  • 如果留空,则会自动为您生成唯一ID,并可通过检查生成的页面找到该ID。
  • 如果指定了ID,则作者有责任确保它是唯一的。
  • 更改ID可能会影响CSS、JS和数据层跟踪。

设计对话框

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

插件选项卡

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

功能

可以为组件激活或取消激活以下功能。
  • 粘贴纯文本
  • 过去自词
  • 查找和替换
  • 拼写检查器
  • 插入的图像修改选项
  • HTML源编辑

格式化

可以为组件激活或取消激活以下格式选项。
  • 列表(项目符号、数字、缩进、凸出)
  • 对齐(左对齐、右对齐、居中对齐)
  • 粗体、斜体、下划线
  • 链接(和取消链接)
  • 子/上标

段落样式

可以为组件激活或取消激活段落样式。 激活后,可以定义允许的格式。
  • 点按或单击 添加 按钮以插入新样式。
  • 输入样式的代码以及将在编辑对话框中显示的说明。
  • 要删除样式点按或单击“删 ”按钮。
  • 要重新排列格式的顺序,请点按或单击并拖动手柄。

特殊字符

可以为组件激活或取消激活插入特殊字符的选项。 激活后,可以定义允许的字符。
  • 点按或单击添 加按 钮以插入新字符。
  • 输入字符的HTML代码和将在编辑对话框中显示的说明。
  • 要删除字符点按或单击“删 ”按钮。
  • 要重新排列字符的点按顺序,请单击或拖动手柄。

样式选项卡

文本组件支持AEM样 式系统