核心组件文本组件是一种富文本编辑和撰写组件,具有就地编辑功能。
文本组件提供了一个强大的富文本编辑器,允许在简化的内联编辑器中以全屏格式轻松编辑文本。
“编辑”对话框具有带有限选项的内联编辑功能,可在全屏编辑对话框中实现完整功能。利用“设计”对话框,可以为内容作者配置模板的文本格式选项,例如标题、特殊字符和段落样式。
文本组件的当前版本是 v2,此版本随 2018 年 1 月的核心组件发行版本 2.0.0 的发布引入,具体说明见本文。
下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。
组件版本 | AEM 6.4 | AEM 6.5 | AEM as a Cloud Service |
---|---|---|---|
v2 | 兼容 版本 2.17.4 和更低版本 |
兼容 | 兼容 |
v1 | 兼容 | 兼容 | 兼容 |
有关核心组件版本的更多信息,请参阅文档核心组件版本。
要体验文本组件并查看其配置选项示例以及 HTML 和 JSON 输出,请访问组件库。
在 GitHub 上可找到有关文本组件的最新技术文档。
在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。
核心组件文本组件利用 AEM 富文本编辑器 (RTE)。RTE 为内容作者提供了一系列广泛的功能来编辑其文本内容。RTE 的配置非常灵活,并切提供了许多选项。有关如何配置 RTE 的其他详细信息,请参阅文章配置富文本编辑器和配置富文本编辑器插件。
本文章的其余部分演示了带现成的 RTE 配置的核心组件文本组件的标准配置。
仅由 RTE 的 UI 配置启用的选项在文本组件中可用。
“编辑”对话框提供了用户将用于撰写文本的标准富文本格式工具。
用于对所选文本应用粗体格式或对在光标后输入的文本应用粗体格式。
Ctrl+B 可用作快捷键。
用于对所选文本应用斜体格式或对在光标后输入的文本应用斜体格式。
Ctrl+I 可用作快捷键。
用于对所选文本应用下划线格式或对在光标后输入的文本应用下划线格式。
Ctrl+U 可用作快捷键。
用于将所选文本或在光标后输入的文本设置为下标格式。
用于将所选文本或在光标后输入的文本设置为上标格式。
将任何复制的文本粘贴为纯文本,而不设置任何格式。
当选择此选项时,将打开一个窗口,其中的文本可以粘贴为无格式的纯文本,作为插入文本中之前的预览。通过点击或单击复选标记可接受,通过点击或单击 x 可取消。
当选择此选项时,将打开一个窗口,其中的文本可粘贴并保留其格式,作为插入文本中之前的预览。通过点击或单击复选标记可接受,通过点击或单击 x 可取消。
使用此选项可将所选文本转换为超链接或修改已定义的链接。此选项仅在已选择文本并打开一个窗口(其中包含用于设置链接的附加选项)时处于活动状态。
输入路径
输入链接的替换描述文本
选择链接行为
点击或单击复选标记可应用链接,点击或单击 x 可取消。
使用此选项可删除已应用于所选文本的链接。此选项仅在已选择链接时处于活动状态。
使用此选项可搜索文本以确定指定文本字符串的匹配项。选择此选项将打开一个用于指定搜索选项的窗口。
输入要搜索的文本并点击或单击“查找”以开始搜索。点击或单击 x 可取消。
如果您希望根据大小写进行精确匹配,请选择选项匹配大小写,然后再开始搜索。
如果找到一个匹配项,则将突出显示该匹配项,并且搜索对话框将灰显。在灰显的对话框中再次点击或单击查找按钮可搜索下一个匹配项。
如果未找到其他匹配项,则将显示一条消息,并且将从文本的开头重新开始搜索。
使用此选项可搜索文本以确定指定文本字符串的匹配项,并将匹配项替换为其他字符串。选择此选项将打开一个用于指定搜索和替换选项的窗口。
输入要搜索的文本以及应替换为的文本。
如果找到一个匹配项,则将突出显示该匹配项,并且搜索对话框将灰显。在灰显对话框中再次单击查找按钮可搜索下一个匹配项,选择替换按钮可替换突出显示的匹配文本。请注意,替换按钮仅在进行匹配后处于活动状态。
在单击“查找”时,“查找和替换”对话框变为透明;在单击“替换”时,此对话框变为不透明。这允许作者审查自己将替换的文本。
在使用替换功能时,要替换的替换字符串应与查找字符串同时输入。不过,您仍可以在替换字符串之前单击“查找”来搜索它。如果在单击“查找”后输入替换字符串,则搜索将重置到文本的开头。
用于将文本与左边距对齐。
用于将文本居中对齐。
用于将文本与右边距对齐。
用于将所选文本设置为项目符号列表格式或在光标后开始插入项目符号列表。
要结束项目符号列表,请再次点击或单击“项目符号”按钮或输入两个回车符。
用于将所选文本设置为编号列表格式或在光标后开始插入编号列表。
要结束编号列表,请再次点击或单击“编号”按钮或输入两个回车符。
用于降低所选文本或光标后输入的文本的缩进级别。
仅当所选文本或光标位置已缩进时才处于活动状态。
用于增加所选文本或光标后输入的文本的缩进级别。
用于将表插入文本中。选择此选项将打开一个用于指定表的详细信息的窗口。
用于检查文本内容的拼写。为可能的拼写错误加下划线(红色虚线)。
有关拼写检查和自定义拼写检查词典的更多详细信息,请参阅配置富文本编辑器插件文档。
用于将特殊字符插入文本中。选择此选项将打开一个用于显示可用字符的窗口。
点击或单击所需字符以将其插入光标后的文本中。可插入多个字符。点击或单击 x 可关闭选择窗口。
用于查看和修改文本的 HTML 源。
点击或单击“编辑源文件”图标可从格式化视图更改文本内容以查看原始 HTML。在此模式中,将禁用所有其他格式选项。再次点击或单击“编辑源文件”图标可返回格式化视图。
与访问原始 HTML 的情况一样,使用编辑源文件选项时必须小心!
将扫描通过编辑源文件输入的 HTML 以确定是否存在 XSS 风险,插入的任何脚本将被删除且不会显示在结果页上。不过,在编辑源文件中输入的格式错误的 HTML 可能会破坏页面的模板,从而导致意外的格式设置或表明生成的页面不可用。
由于将扫描通过编辑源文件输入的 HTML 以确定是否存在 XSS 风险和任何脚本,并且会自动删除找到的脚本,因此保留的实际内容可能会因在编辑源文件中输入的内容而异。因此,要保存使用编辑源文件夹所做的更改,您必须先退出编辑源文件以在保存之前在常用编辑器中查看文本。
用于对所选文本或在光标后插入的文本应用段落格式。选择此选项将打开一个下拉菜单,可从中选择段落格式。
也可以对文本组件进行内联编辑,但由于空间限制,无法对所有格式选项进行内联编辑。要查看所有选项,请切换到全屏模式。
利用此选项,可以控制 HTML 和 Data Layer 中的组件的唯一标识符。
利用“设计”对话框,模板作者可以定义哪些文本格式选项可供内容作者使用。
“插件”选项卡用于启用和禁用对内容作者可用的各种文本格式选项。
可以为组件激活或停用以下功能。
可以为组件激活或停用以下格式选项。
可以为组件激活或停用段落样式。在激活时,可以定义允许的格式。
可以为组件激活或停用用于插入特殊字符的选项。在激活时,可以定义允许的字符。
文本组件支持 AEM 样式系统。
文本组件支持 Adobe Client Data Layer。