配置富文本编辑器 configure-the-rich-text-editor

富文本编辑器(RTE)为作者提供了一系列广泛的功能来编辑其文本内容。 为所见即所得文本编辑体验提供了图标、选择框、工具栏和菜单。

要了解如何使用RTE功能进行创作，请参阅使用富文本编辑器进行创作。 可以将RTE配置为启用、禁用和扩展创作组件中可用的功能。 以下工作流说明了在Experience Manager中完成RTE配置任务的建议顺序。

图：了解如何配置RTE的一系列步骤

了解触屏优化UI和经典UI understand-touch-enabled-ui-and-classic-ui

触屏优化UI是用于Experience Manager的标准用户界面。 Adobe为创作环境引入了触屏优化UI，其中具有响应式设计。 触屏优化UI专为触控和桌面设备而设计。 该界面与原始经典UI有很大不同。

已启用触控的用户界面中的

图：触屏UI中的富文本编辑器工具栏

经典UI中的

图：经典UI中的富文本编辑器工具栏

各种编辑模式 editingmodes

作者可以使用各种组件模式在Experience Manager中创建和编辑文本内容。 在不同编辑模式下，用于创作内容和设置内容格式的工具栏选项以及启用RTE的组件的用户体验因RTE配置而异。

内联编辑 inline-editing

打开时（缓慢双击），可以在页面中编辑内容。 此时会显示一个包含非常基本选项的紧凑工具栏。

图：在触屏UI中使用基本工具栏进行内联编辑

在经典UI中，双击组件缓慢即可进行内联编辑，并且橙色轮廓会突出显示内容。 如果“内容查找器”处于打开状态，则窗口顶部会显示一个包含可用RTE格式选项的工具栏。 如果“内容查找器”未打开，则不会显示格式选项，并且您只能进行基本的文本编辑。

全屏编辑 full-screen-editing

Experience Manager组件可以在全屏视图中打开，该视图会隐藏页面内容并占据可用屏幕。 请考虑全屏编辑内联编辑的详细版本，因为它提供了最多的编辑选项。 使用内联编辑模式时，可通过单击紧凑工具栏中的 来打开该页面。

在对话框的全屏模式以及详细的RTE工具栏中，对话框中可用的选项和组件也可用。 它仅适用于包含RTE以及其他组件的对话框。

图：在触屏UI中以全屏模式编辑时，显示详细的RTE工具栏

对话框编辑 dialog-editing

双击组件时，将打开一个对话框用于编辑内容。 对话框将在现有页面的顶部打开。 在某些特定情况下，对话框会作为弹出窗口打开。 例如，当文本组件属于多列页面布局中的列且可用于对话框的区域较少时。

图：触控式UI中的对话框编辑模式

图：经典UI中包含用于编辑的详细工具栏的对话框

关于RTE插件和相关功能 aboutplugins

该功能通过一系列插件提供，每个插件均具有：

RTE的基本功能由相应插件专属的节点上的features属性值激活或停用。

下表列出了当前的插件，其中显示：

了解配置路径和位置 understand-the-configuration-paths-and-locations

当您激活RTE插件时，您为作者提供的RTE编辑模式（和UI）将决定配置详细信息的位置：

配置以下仅适用于Touch UI中的对话框编辑模式的属性：

在启用触屏的对话框中使用RTE时，必须将属性useFixedInlineToolbar设置为true以避免出现问题。

自定义就地编辑 customizing-in-place-editing

通过配置以下HTML，您可以定义文本编辑器从哪个属性选择器开始：

对话框模式的相应属性为name。

通过激活插件启用RTE功能 enable-rte-functionalities-by-activating-plug-ins

RTE功能通过一系列插件提供，每个插件都具有功能属性。 您可以配置features属性以启用或禁用每个插件的各种功能。

有关RTE插件的详细配置，请参阅如何激活和配置RTE插件。

示例：下载此示例配置，该示例配置说明了如何配置RTE。 在此程序包中，将启用所有功能。

配置RTE工具栏 dialogfullscreen

AEM允许您为不同的编辑模式以不同的方式配置富文本编辑器的界面。 默认设置如下所示。 您可以根据自己的要求覆盖这些默认值。 您只需自定义要提供给作者的工具栏功能。 您无需指定所有工具栏配置。

要为dialogFullScreen配置工具栏，请使用以下示例配置。

<uiSettings jcr:primaryType="nt:unstructured">
  <cui jcr:primaryType="nt:unstructured">
    <inline
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,#justify,#lists,links#modifylink,links#unlink,#paraformat]">
      <popovers jcr:primaryType="nt:unstructured">
        <justify
          jcr:primaryType="nt:unstructured"
          items="[justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify]"
          ref="justify"/>
        <lists
          jcr:primaryType="nt:unstructured"
          items="[lists#unordered,lists#ordered,lists#outdent,lists#indent]"
          ref="lists"/>
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </inline>
    <dialogFullScreen
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify,lists#unordered,lists#ordered,lists#outdent,lists#indent,links#modifylink,links#unlink,table#createoredit,#paraformat,image#imageProps]">
      <popovers jcr:primaryType="nt:unstructured">
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </dialogFullScreen>
    <tableEditOptions
      jcr:primaryType="nt:unstructured"
      toolbar="[table#insertcolumn-before,table#insertcolumn-after,table#removecolumn,-,table#insertrow-before,table#insertrow-after,table#removerow,-,table#mergecells-right,table#mergecells-down,table#mergecells,table#splitcell-horizontal,table#splitcell-vertical,-,table#selectrow,table#selectcolumn,-,table#ensureparagraph,-,table#modifytableandcell,table#removetable,-,undo#undo,undo#redo,-,table#exitTableEditing,-]">
    </tableEditOptions>
  </cui>
</uiSettings>

内联模式和全屏模式使用不同的UI设置。 工具栏属性用于指定工具栏的按钮。

例如，如果按钮本身是功能（例如，Bold），则将其指定为PluginName#FeatureName（例如，links#modifylink）。

如果按钮是弹出框（包含插件的某些功能），则将其指定为#PluginName（例如，#format）。

可以使用-在按钮组之间指定分隔符(|)。

内联或全屏模式下的弹出节点包含正在使用的弹出框列表。 “弹出项”节点下的每个子节点均以插件的名称（例如，格式）命名。 它具有包含插件功能列表（例如，format#bold）的“items”属性。

RTE用户界面设置和内容策略 rtecontentpolicies

管理员可以使用内容策略来控制RTE选项，而不是执行如上所述的配置。 当内容策略用作可编辑模板的一部分时，它定义组件的设计属性。 例如，如果将使用RTE的文本组件与可编辑模板一起使用，则内容策略可以定义粗体选项是否可用，以及几个段落格式选项是否可用。 内容策略可重复使用，并且可以跨多个模板应用。

RTE中的可用选项会从用户界面配置下游流向内容策略。

例如，您可以看到文本核心组件文档。

自定义工具栏图标和命令之间的映射 iconstoolbar

您可以自定义RTE工具栏上显示的Coral图标与可用命令之间的映射。 除了Coral图标之外，您无法使用任何其他图标。

下面是将命令Bold映射到名为textItalic的Coral图标的示例片段。

<text jcr:primaryType="nt:unstructured" sling:resourceType="cq/gui/components/authoring/dialog/richtext" name="./text" useFixedInlineToolbar="{Boolean}true">
    <rtePlugins jcr:primaryType="nt:unstructured">
        <format jcr:primaryType="nt:unstructured" features="bold,italic"/>
    </rtePlugins>
    <uiSettings jcr:primaryType="nt:unstructured">
        <cui jcr:primaryType="nt:unstructured">
            <inline jcr:primaryType="nt:unstructured"
                toolbar="[format#bold,format#italic,format#underline,links#modifylink,links#unlink]">
            </inline>
            <icons jcr:primaryType="nt:unstructured">
                <bold jcr:primaryType="nt:unstructured"
                    command="format#bold"
                    icon="textItalic"/>
            </icons>
        </cui>
    </uiSettings>
</text>

切换到CoralUI 2富文本编辑器 switch-to-coralui-rich-text-editor

在页面上，您可以包含CoralUI 2 RTE clientlib或CoralUI 3 RTE clientlib。 默认情况下，富文本编辑器包括CoralUI 3 RTE clientlib。 要切换到CoralUI 2 RTE，请执行以下步骤。

更多信息 further-information

有关配置RTE的更多信息，请参阅AEM Widget API参考。

具体来说，要查看插件及相关可用选项，请执行以下操作：

这些资源可用于扩展和自定义您自己的RTE。 例如，要在创建链接时列出页面中可用的锚点，您可以提供自己的LinkPlugin实现。

已知限制 known-limitations

AEM RTE功能具有以下限制：

最佳实践和提示 best-practices-and-tips

解决RTE的常见问题 troubleshoot-issues-with-aem-rich-text-editor

如何选择多个表单元格？

要选择表中的多个单元格，请按Ctrl或Cmd键，然后逐一单击表单元格。

现在，对所选内容执行操作，例如设置所选单元格的属性。

使用“配置”按钮编辑组件时，超链接丢失

通过使用“配置”按钮编辑文本组件，在文本组件中添加超链接。 再次编辑超链接并再次验证超链接时，可能会丢失该超链接。

解决方法是，在第二次显示“编辑”对话框时单击文本组件，然后运行链接验证。

此问题可在AEM 6.3及更高版本中解决。

在源编辑模式下添加的​ HTML内容丢失

请勿添加易受XSS影响的HTML。 AEM而非RTE，可能会删除一些HTML内容以遵守XSS反精神病规则。

要验证粘贴的HTML是否已保存，请在CRXDE（在content节点中）中检查保存的内容。

如果未保存，则HTML必须已被RTE删除，因为它不符合RTE规则。

如果保存在CRXDE中但未在页面上渲染(要检查渲染，请参阅页面的预览，它被AEM XSS规则删除。

多字段组件未按预期工作

要创建多字段组件，请专门使用CoralUI 3 。 请勿使用CoralUI 2组件对话框。

此外，请验证多字段实施代码和节点结构是否正确。

可供管理员使用的配置不可供作者使用

如果反映的是管理员的接口配置更新，而不是作者帐户的接口配置更新，请确保配置节点未命名为config。 使用configPath属性。