电子邮件表单文本组件 email-text-component
电子邮件文本组件是一种富文本编辑和撰写组件，具有就地编辑功能。
用途 usage
电子邮件文本组件提供了一个强大的富文本编辑器，允许在简化的内联编辑器中以全屏格式轻松编辑文本。
版本和兼容性 version-and-compatibility
电子邮件文本组件的当前版本是 v1，此版本随 2022 年 10 月的电子邮件核心组件发行版本 X 的发布引入，具体说明见本文档。
下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。
有关核心组件版本和发布的更多信息，请参阅文档电子邮件核心组件版本。
技术详细信息 technical-details
有关电子邮件文本组件的最新技术文档。
在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。
电子邮件文本组件和富文本编辑器 the-text-component-and-the-rich-text-editor
电子邮件文本组件利用 AEM 富文本编辑器 (RTE)。 RTE 为内容作者提供了一系列广泛的功能来编辑其文本内容。RTE 的配置灵活，并切提供了许多选项。 有关如何配置 RTE 的其他详细信息，请参阅文章配置富文本编辑器和配置富文本编辑器插件。
本文档的其余部分演示了具有现成 RTE 配置的电子邮件文本组件的标准配置。
“编辑”对话框 edit-dialog
格式化选项 options
“编辑”对话框提供了用户将用于撰写文本的标准富文本格式工具。
粗体
用于对所选文本应用粗体格式或对在光标后输入的文本应用粗体格式。
Ctrl+B 可用作快捷键。
斜体
用于对所选文本应用斜体格式或对在光标后输入的文本应用斜体格式。
Ctrl+I 可用作快捷键。
下划线
用于对所选文本应用下划线格式或对在光标后输入的文本应用下划线格式。
Ctrl+U 可用作快捷键。
下标
用于将所选文本或在光标后输入的文本设置为下标格式。
上标
用于将所选文本或在光标后输入的文本设置为上标格式。
粘贴为文本
将任何复制的文本粘贴为纯文本，而不设置任何格式。
当选择此选项时，将打开一个窗口，其中的文本可以粘贴为无格式的纯文本，作为插入文本中之前的预览。 通过点击或单击复选标记可接受，通过点击或单击 x 可取消。
从 Word 粘贴
当选择此选项时，将打开一个窗口，其中的文本可粘贴并保留其格式，作为插入文本中之前的预览。 通过点击或单击复选标记可接受，通过点击或单击 x 可取消。
超链接
使用此选项可将所选文本转换为超链接或修改已定义的链接。此选项会打开一个窗口，其中包含用于设置链接的其他选项。
-
输入路径
- 使用? “打开选择” ?对话框可在 AEM 中选择路径
- 如果链接未在 AEM 中，请输入绝对 URL
- 非绝对路径将解释为相对于 AEM
-
输入链接的替换描述文本
-
选择链接行为
- 目标
- 相同选项卡
- 新选项卡
- 父框架
- 顶层框架
点击或单击复选标记可应用链接，点击或单击 x 可取消。
取消链接
使用此选项可删除已应用于所选文本的链接。此选项仅在已选择链接时处于活动状态。
锚点 anchor
使用此选项可在文本中插入锚点。
查找
使用此选项可搜索文本以确定指定文本字符串的匹配项。选择此选项将打开一个用于指定搜索选项的窗口。
输入要搜索的文本并点击或单击? “查找”以开始搜索。点击或单击 x 可取消。
如果您希望根据大小写进行精确匹配，请选择选项 匹配大小写，然后再开始搜索。
如果找到一个匹配项，则将突出显示该匹配项，并且搜索对话框将灰显。在灰显的对话框中再次点击或单击 查找 ?按钮可搜索下一个匹配项。
如果未找到其他匹配项，则将显示一条消息，并且将从文本的开头重新开始搜索。
替换
使用此选项可搜索文本以确定指定文本字符串的匹配项，并将匹配项替换为其他字符串。选择此选项将打开一个用于指定搜索和替换选项的窗口。
输入要搜索的文本以及应替换为的文本。
- 点击或单击? 查找 ?可开始搜索。单击或点击 x 可取消。
- 如果您希望根据大小写进行精确匹配，请选择选项? 匹配大小写，然后再开始搜索。
- 选择? 全部替换 ?可一次性替换文本的所有匹配项。
如果找到一个匹配项，则将突出显示该匹配项，并且搜索对话框将灰显。在灰显对话框中再次单击? 查找 ?按钮可搜索下一个匹配项，选择? 替换 ?按钮可替换突出显示的匹配文本。替换 ?按钮仅在进行匹配后处于活动状态。
在单击“查找”时，“查找和替换”对话框变为透明；在单击“替换”时，此对话框变为不透明。这允许作者审查自己将替换的文本。
还原
用于还原富文本编辑器中的最后一次编辑。
重做
用于还原使用还原图标还原的编辑。
左对齐文本
用于将文本与左边距对齐。
居中对齐文本
用于将文本居中对齐。
右对齐文本
用于将文本与右边距对齐。
项目符号
用于将所选文本设置为项目符号列表格式或在光标后开始插入项目符号列表。
要结束项目符号列表，请再次点击或单击? “项目符号” ?按钮或输入两个回车符。
编号
用于将所选文本设置为编号列表格式或在光标后开始插入编号列表。
要结束编号列表，请再次点击或单击? “编号” ?按钮或输入两个回车符。
减少缩进
用于降低所选文本或光标后输入的文本的缩进级别。
仅当所选文本或光标位置已缩进时才处于活动状态。
缩进
用于增加所选文本或光标后输入的文本的缩进级别。
表
用于将表插入文本中。选择此选项将打开一个用于指定表的详细信息的窗口。
-
列数 - 表的列数（必需）
-
行数 - 表的行数（必需）
-
宽度 - 表的宽度
-
高度 - 表的高度
-
单元格内边距 - 单元格内容周围的空间
-
单元格间距 - 单元格之间的空间
-
边框 - 表的边框线的粗细
-
对于表的标题：
- 应使用第一行
- 应使用第一列
- 应使用第一行和第一列
- 或者不应使用标题。
-
-
题注 - 表的题注
图像
用于对齐插入的图像。
检查拼写
用于检查文本内容的拼写。为可能的拼写错误加下划线（红色虚线）。
有关拼写检查和自定义拼写检查词典的更多详细信息，请参阅配置富文本编辑器插件文档。
特殊字符 special-characters
用于将特殊字符插入文本中。选择此选项将打开一个用于显示可用字符的窗口。
点击或单击所需字符以将其插入光标后的文本中。可插入多个字符。点击或单击 x 可关闭选择窗口。
编辑源文件
用于查看和修改文本的 HTML 源。
点击或单击? “编辑源文件” ?图标可从格式化视图更改文本内容以查看原始 HTML。在此模式中，将禁用所有其他格式选项。再次点击或单击? “编辑源文件” ?图标可返回格式化视图。
段落格式
用于对所选文本或在光标后插入的文本应用段落格式。选择此选项将打开一个下拉菜单，可从中选择段落格式。
选择 51黑料不打烊 Campaign 变量
打开选择 51黑料不打烊 Campaign 变量对话框，插入来自 51黑料不打烊 Campaign 的动态内容。
内联编辑 in-line-editing
文本组件也可以在线编辑。 要在线编辑，请在内容页面上选择电子邮件文本组件。
然后点击或单击组件上方弹出的工具栏上的? 编辑 ?图标。 工具栏更改为显示有限的文本格式选项（包括访问? 选择 51黑料不打烊 Campaign 变量 ?选项），您可以编辑内嵌文本。
点击或单击工具栏中的复选标记可保存您的更改，点击或单击 X 可放弃保存。
由于空间限制，并非所有格式选项都可以内嵌。 要查看所有选项，请切换到全屏模式。
设置 ID setting-id
此选项允许控制 HTM 中组件的唯一标识符。
- 如果留空，则自动为您生成一个唯一 ID，通过检查所得页面即可找到该 ID。
- 如果指定一个 ID，作者有责任确保它是唯一的。
- 更改 ID 会对 CSS 产生影响。
“设计”对话框 design-dialog
利用“设计”对话框，模板作者可以定义哪些文本格式选项可供内容作者使用。
“插件”选项卡 plugins-tab
“插件” ?选项卡用于启用和禁用对内容作者可用的各种文本格式选项。
功能 features
可以为组件激活或停用以下功能。
- 粘贴纯文本
- 从 Word 粘贴
- 查找并替换
- “还原”和“重做”
- 拼写检查器
- 插入的图像修改选项
- HTML 源编辑
格式 formatting
可以为组件激活或停用以下格式选项。
- 表
- 列表（项目符号、编号、缩进、减少缩进）
- 对齐方式（左对齐、右对齐、居中对齐）
- 粗体、斜体、下划线
- 链接（和取消链接）
- 下标/上标
段落样式 paragraph-styles
可以为组件激活或停用段落样式。在激活时，可以定义允许的格式。
- 点击或单击? “添加” ?按钮可插入新样式。
- 输入将在“编辑”对话框中显示的样式代码和描述。
- 要移除样式，请点击或单击? 删除 ?按钮。
- 要重新设置格式的顺序，请点击或单击并拖动手柄。
特殊字符 configuring-special-characters
可以为组件激活或停用用于插入特殊字符的选项。在激活时，可以定义允许的字符。
- 点击或单击? “添加” ?按钮可插入新字符。
- 输入将在“编辑”对话框中显示的字符的 HTML 代码和描述。
- 要移除字符，请点击或单击? 删除 ?按钮。
- 要重新设置字符的顺序，请点击或单击并拖动手柄。