Show Menu
主题×

文本组件

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

使用情况

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

版本和兼容性

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

示例组件输出

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

技术详细信息

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

文本组件和富文本编辑器

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

Edit Dialog

编辑对话框提供了用户期望合成文本的标准富文本格式工具。

粗体

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

斜体

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

下划线

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

下标

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

上标

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

粘贴文本

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

从 Word 粘贴

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

超链接

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

取消链接

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

查找

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

替换

使用此选项可搜索文本以查找指定文本字符串的出现次数,并将匹配项替换为其他字符串。 选择此选项将打开一个窗口,用于指定搜索和替换选项。
输入要搜索的文本以及应替换为的文本。
点按或单击
查找
,开始搜索。 单击或点按x可取消。
如果要根据大小写进行精确匹配,请在开始搜索之前选择
“匹配大小写
”选项。
如果找到匹配项,则高亮显示该匹配项,并且搜索对话框灰显。 在灰显
的对话框中再次单击
“查找”按钮以搜索下一个匹配项,或选择“替换”按钮以替换高亮显示的匹配文本。 请注意,“
替换
”按钮仅在匹配后才处于活动状态。
选择
全部替换
,以同时替换所有出现的文本。

左对齐文本

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

居中对齐文本

用于将文本居中。

右对齐文本

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

Bullet

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

编号

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

突出

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

缩进

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

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

拼写检查

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

特殊字符

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

编辑源文件

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

段落格式

用于将段落格式应用于选定文本或光标后插入的文本。 选择此选项将打开从中选择段落格式的下拉列表。
文本组件也可以联机编辑,但由于空间限制,并非所有格式选项都可联机编辑。 要查看所有选项,请切换到全屏模式。

设计对话框

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

插件选项卡

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

功能

可以为组件激活或取消激活以下功能。
  • 粘贴纯文本
  • 过去自词
  • 查找和替换
  • 拼写检查器
  • 源编辑

格式化

可以为组件激活或取消激活以下格式选项。
  • 列表
  • 对齐
  • 粗体、斜体、下划线
  • 链接
  • 子/上标

段落样式

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

配置特殊字符

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

样式选项卡

文本组件支持AEM样 式系统