核心组件文本组件是一个富文本编辑和合成组件,可进行就地编辑。
文本组件优惠了强大的富文本编辑器,它允许通过简化的内嵌编辑器以及全屏格式轻松编辑文本。
编辑对话框采用有限选项进行联机编辑,全屏编辑对话框中提供完整功能。 使用设计对话框,可以为内容作者的模板配置文本格式选项,如标题、特殊字符和段落样式。
文本组件的当前版本为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配置的核心组件文本组件的标准配置。
文本组件中仅提供由RTE](https://docs.adobe.com/content/help/zh-Hans/experience-manager-cloud-service/implementing/configuring-and-extending/configure-rich-text-editor-plug-ins.html)的[UI配置启用的选项。
编辑对话框优惠用户希望合成文本的标准富文本格式工具。
用于对选定文本应用粗体格式或大胆设置光标后输入的文本格式。
Ctrl+ B可用作键盘快捷键。
用于将斜体格式应用于选定文本或在光标后输入的斜体文本。
Ctrl+ Ican可用作键盘快捷键。
用于将带下划线的格式应用于在光标后输入的选定文本或下划线文本。
Ctrl+ Ucan可用作键盘快捷键。
用于将光标后输入的选定文本或文本格式化为下标。
用于将光标后输入的选定文本或文本格式化为上标。
将任何复制的文本粘贴为纯文本,而不使用任何格式。
选择此选项时,将打开一个窗口,在该窗口中,文本可以粘贴为纯文本,且在插入文本之前没有预览。 点按或单击复选标记以接受,点按或单击x以取消。
选择此选项时,将打开一个窗口,在将文本插入文本之前,该窗口将保持其格式预览。 点按或单击复选标记以接受,点按或单击x以取消。
使用此选项可将选定文本转换为超链接或修改已定义的链接。 仅当已选择文本并打开一个包含设置链接的其他选项的窗口时,此选项才处于活动状态。
输入路径
输入链接的替代描述性文本
选择链接行为
点按或单击复选标记以应用链接,或点按x以取消。
使用此选项可删除已应用于所选文本的链接。 仅当已选择链接时,此选项才处于活动状态。
使用此选项可搜索文本以查找指定文本字符串的匹配项。 选择此选项将打开一个窗口,用于指定搜索选项。
输入要搜索的文本并点按或单击查找以开始搜索。 点按或单击x可取消。
如果要根据大小写进行精确匹配,请在开始搜索之前选择选项匹配大小写。
如果找到匹配项,则突出显示该匹配项,并且搜索对话框灰显。 再次点按或单击灰显对话框中的查找按钮,以搜索下一个匹配项。
如果未找到其他匹配项,则将显示一条消息,并从文本的开头开始搜索。
使用此选项可搜索出现指定文本字符串的文本,并将匹配项替换为其他字符串。 选择此选项将打开一个窗口,用于指定搜索和替换选项。
输入要搜索的文本以及应替换的文本。
如果找到匹配项,则突出显示该匹配项,并且搜索对话框灰显。 再次单击灰显对话框中的查找按钮以搜索下一个匹配项,或选择替换按钮以替换高亮显示的匹配文本。 请注意,只有匹配后,替换按钮才处于活动状态。
单击“查找并替换”对话框时,该对话框变得透明,单击“替换”时变得不透明。 这允许作者查看作者将替换的文本。
使用替换功能时,应与查找字符串同时输入要替换的替换字符串。 但是,在替换字符串之前,您仍可以单击“查找”以搜索该字符串。 如果在单击“查找”后输入替换字符串,则搜索将重置为文本的开头。
用于将文本与左边距对齐。
用于将文本居中。
用于将文本与右边距对齐。
用于将选定文本格式化为项目符号列表,或在光标后开始插入项目符号列表。
要结束项目符号列表,请再次点按或单击项目符号按钮,或输入两个回车符。
用于将选定文本格式化为编号列表,或在光标后开始插入编号列表。
要结束编号列表,请再次点按或单击编号按钮,或输入两个回车符。
用于降低在光标后输入的选定文本或文本的缩进级别。
仅当光标的选定文本或位置已缩进时才处于活动状态。
用于增加在光标后输入的选定文本或文本的缩进级别。
用于在文本中插入表。 选择此选项将打开一个窗口,用于指定表的详细信息。
用于检查文本内容的拼写。 可能的拼写错误用破红线加下划线。
有关拼写检查和自定义拼写检查字典的更多详细信息,请参阅文档配置富文本编辑器插件。
用于在文本中插入特殊字符。 选择此选项将打开一个窗口,其中显示可用字符。
点按或单击所需字符,将其插入光标后的文本中。 可插入多个字符。 点按或单击x以关闭选择窗口。
用于视图和修改文本的HTML源。
点按或单击源编辑图标,将文本的内容从格式化视图更改为视图原始HTML。 在此模式下,所有其他格式选项都被禁用。 再次点按或单击源编辑图标,以返回到格式化视图。
与访问原始HTML时一样,在使用源编辑选项时必须小心!
通过源编辑输入的HTML将扫描XSS风险,并删除所插入的任何脚本,不会显示在生成的页面上。 但是,在源代码编辑中输入的格式错误的HTML可能会中断页面的模板,导致意外的格式或导致生成的页面无法使用。
由于通过源编辑输入的HTML会扫描XSS风险和任何脚本并自动删除找到的脚本,因此保留的实际内容可能与在源编辑中输入的内容不同。 因此,要保存使用源代码编辑所做的更改,必须先退出源代码编辑,以在普通编辑器中视图文本,然后再进行保存。
用于将段落格式应用于选定文本或光标后插入的文本。 选择此选项将打开一个下拉框,从中选择段落格式。
文本组件也可以联机进行编辑,但由于空间限制,并非所有格式选项都联机可用。 要查看所有选项,请切换到全屏模式。
此选项允许控制HTML和数据层中组件的唯一标识符。
设计对话框允许模板作者定义内容作者可以使用的文本格式选项。
插件选项卡用于启用和禁用内容作者可用的各种文本格式选项。
可以为组件激活或取消激活以下功能。
可以为组件激活或取消激活以下格式选项。
可以为组件激活或取消激活段落样式。 激活后,可以定义允许的格式。
可以为组件激活或取消激活插入特殊字符的选项。 激活后,可以定义允许的字符。
文本组件支持AEM 样式系统。