文本组件 (v1) text-component-v

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
核心组件

创建对象：

开发人员
管理员
用户

文本组件是一种富文本编辑和撰写组件，具有就地编辑功能。

用途 usage

文本组件提供了一个强大的富文本编辑器，允许在简化的内联编辑器中以全屏格式轻松编辑文本。

“编辑”对话框具有带有限选项的内联编辑功能，可在全屏编辑对话框中实现完整功能。利用“设计”对话框，可以为内容作者配置模板的文本格式选项，例如标题、特殊字符和段落样式。

版本和兼容性 version-and-compatibility

本文档介绍了文本组件 v1，它最初随带 AEM 6.3 的核心组件发行版本 1.0.0 引入。

下表列出了文本组件 v1 的兼容性。

AEM 版本

文本组件 v1

6.3

兼容

6.4

兼容

CAUTION

本文档介绍了文本组件 v1。

有关当前版本的文本组件的详细信息，请参阅文本组件文档。

示例组件输出 sample-component-output

以下是摘自 We.Retail 的示例。

屏幕快照 screenshot

HTML html

<div class="cmp cmp-text aem-GridColumn aem-GridColumn--default--12">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer porttitor ante a tortor volutpat maximus. Donec eu porta eros. Aenean sit amet eleifend arcu, eu vestibulum magna. Fusce eget nisi tincidunt, tristique felis quis, tincidunt est. Aliquam consequat aliquam quam non eleifend. Phasellus ut magna luctus, aliquam risus eget, fermentum augue. Aliquam lobortis accumsan magna, quis efficitur enim dictum eu. Pellentesque iaculis felis eget felis commodo, non euismod dolor euismod. Quisque nec arcu rutrum, mollis tortor non, sollicitudin odio. Sed dictum nulla mauris, eu pretium dui vulputate a. Maecenas lacus massa, egestas vitae tincidunt eu, interdum et magna. Lorem ipsum dolor sit amet, consectetur adipiscing elit. In eleifend ex lacus, in consectetur nunc interdum et. Donec interdum mi vitae dolor pretium mattis. In quis arcu sapien. Phasellus at metus vitae nisi tincidunt varius.<br />
</p>
</div>

JSON json

"text": {
              "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
              "text": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer porttitor ante a tortor volutpat maximus. Donec eu porta eros. Aenean sit amet eleifend arcu, eu vestibulum magna. Fusce eget nisi tincidunt, tristique felis quis, tincidunt est. Aliquam consequat aliquam quam non eleifend. Phasellus ut magna luctus, aliquam risus eget, fermentum augue. Aliquam lobortis accumsan magna, quis efficitur enim dictum eu. Pellentesque iaculis felis eget felis commodo, non euismod dolor euismod. Quisque nec arcu rutrum, mollis tortor non, sollicitudin odio. Sed dictum nulla mauris, eu pretium dui vulputate a. Maecenas lacus massa, egestas vitae tincidunt eu, interdum et magna. Lorem ipsum dolor sit amet, consectetur adipiscing elit. In eleifend ex lacus, in consectetur nunc interdum et. Donec interdum mi vitae dolor pretium mattis. In quis arcu sapien. Phasellus at metus vitae nisi tincidunt varius.</p>\n",
              "richText": true,
              ":type": "weretail/components/content/text"
            }

NOTE

从核心组件执行 JSON 导出需要版本 1.1.0 的核心组件。有关更多信息，请参阅核心组件 v1 的兼容性信息。

“编辑”对话框 edit-dialog

“编辑”对话框提供了用户将用于撰写文本的标准富文本格式工具。

粗体

用于对所选文本应用粗体格式或对在光标后输入的文本应用粗体格式。

Ctrl+B 可用作快捷键。
斜体

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

Ctrl+I 可用作快捷键。
下划线

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

Ctrl+U 可用作快捷键。
下标

用于将所选文本或在光标后输入的文本设置为下标格式。
上标

用于将所选文本或在光标后输入的文本设置为上标格式。
粘贴为文本

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

当选择此选项时，将打开一个窗口，其中的文本可以粘贴为无格式的纯文本，作为插入文本中之前的预览。通过点击或单击复选标记可接受，通过点击或单击 x 可取消。
从 Word 粘贴

当选择此选项时，将打开一个窗口，其中的文本可粘贴并保留其格式，作为插入文本中之前的预览。通过点击或单击复选标记可接受，通过点击或单击 x 可取消。
超链接

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

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

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

输入要搜索的文本并点击或单击查找以开始搜索。点击或单击 x 可取消。

如果您希望根据大小写进行精确匹配，请选择选项 匹配大小写，然后再开始搜索。

如果找到一个匹配项，则将突出显示该匹配项，并且搜索对话框将灰显。在灰显的对话框中再次点击或单击查找按钮可搜索下一个匹配项。

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

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

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

点击或单击查找可开始搜索。单击或点击 x 可取消。

如果您希望根据大小写进行精确匹配，请选择选项 匹配大小写，然后再开始搜索。

如果找到一个匹配项，则将突出显示该匹配项，并且搜索对话框将灰显。在灰显对话框中再次单击查找按钮可搜索下一个匹配项，选择替换按钮可替换突出显示的匹配文本。请注意，替换按钮仅在进行匹配后处于活动状态。

选择 全部替换 可一次性替换文本的所有匹配项。
左对齐文本

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

用于将文本居中对齐。
右对齐文本

用于将文本与右边距对齐。
项目符号

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

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

用于将所选文本设置为编号列表格式或在光标后开始插入编号列表。

要结束编号列表，请再次点击或单击 “编号” 按钮或输入两个回车符。
减少缩进

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

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

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

用于将表插入文本中。选择此选项将打开一个用于指定表的详细信息的窗口。
- 列数 - 表的列数（必需）
- 行数 - 表的行数（必需）
- 宽度 - 表的宽度
- 高度 - 表的高度
- 单元格内边距 - 单元格内容周围的空间
- 单元格间距 - 单元格之间的空间
- 边框 - 表的边框线的粗细
- 对于表的标题：
  - 应使用第一行
  - 应使用第一列
  - 应使用第一行和第一列
  - 或者不应使用标题。
- 题注 - 表的题注
检查拼写

用于检查文本内容的拼写。为可能的拼写错误加下划线（红色虚线）。
特殊字符

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

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

编辑源文件

用于查看和修改文本的 HTML 源。

点击或单击 “编辑源文件” 图标可从格式化视图更改文本内容以查看原始 HTML。在此模式中，将禁用所有其他格式选项。再次点击或单击 “编辑源文件” 图标可返回格式化视图。

note caution
CAUTION
与访问原始 HTML 的情况一样，使用编辑源文件选项时必须小心！
将扫描通过编辑源文件输入的 HTML 以确定是否存在 XSS 风险，插入的任何脚本将被删除且不会显示在结果页上。不过，在编辑源文件中输入的格式错误的 HTML 可能会破坏页面的模板，从而导致意外的格式设置或表明生成的页面不可用。