自定义和扩展通用编辑器 customizing-extending

了解不同的扩展点和其他功能，这些功能允许您自定义通用编辑器的创作体验，以支持内容作者的需求。

概述 overview

通用编辑器允许您根据项目需求进行两种类型的适应。

以下各节将详细介绍这两种类型。

自定义 Universal Editor customizing

通用编辑器提供了多个内置选项以自定义其功能。

禁用发布 disable-publish

某些创作工作流在发布之前需要审查内容。 在这种情况下，任何作者都不应可以使用发布选项。

因此，可以通过添加以下元数据在应用程序中完全隐藏​ Publish ​按钮。

<meta name="urn:adobe:aue:config:disable" content="publish"/>

筛选组件 filtering-components

使用通用编辑器时，您可以限制每个容器组件允许的组件。 为此，必须引入额外的脚本标记，该标记指向过滤器定义。

<script type="application/vnd.adobe.aue.filter+json" src="/static/filter-definition.json"></script>

过滤器定义可能如下所示，这将限制容器仅允许添加文本和图像。

[
  {
    "id": "container-filter",
     "components": ["text", "image"]
   }
]

然后，您可以通过添加属性data-aue-filter，传递您之前定义的筛选器的ID，从容器组件中引用筛选器定义。

data-aue-filter="container-filter"

将筛选器定义中的components属性设置为null将允许所有组件，就像没有筛选器一样。

[
  {
    "id": "another-container-filter",
     "components": null
   }
]

有条件地显示和隐藏属性面板中的组件 conditionally-hide

尽管一个或多个组件通常可供您的作者使用，但在某些情况下可能没有意义。 在这种情况下，可以通过向组件模型的字段添加condition属性来隐藏属性面板中的组件。

可以使用JsonLogic架构定义条件。如果条件为true，则将显示该字段。 如果条件为false，则字段将隐藏。

示例模型

code language-json
{ "id": "conditionally-revealed-component", "fields": [ { "component": "boolean", "label": "Shall the text field be revealed?", "name": "reveal", "valueType": "boolean" }, { "component": "text-input", "label": "Hidden text field", "name": "hidden-text", "valueType": "string", "condition": { "===": [{"var" : "reveal"}, true] } } ] }

条件False

条件True

自定义预览URL custom-preview-urls

您可以通过urn:adobe:aue:config:preview元配置指定自定义预览URL，单击编辑器右上角工具栏中的​ 打开页面 ​按钮时，将打开该配置。

这对于具有特定预览要求的应用程序特别有用，例如那些将Edge Delivery Services与WYSIWYG创作结合使用的。

要实现此目的，只需将所需的预览URL包含在所检测应用程序的meta标记中，如下例所示。

<meta name="urn:adobe:aue:config:preview" content="https://wknd.site"/>

扩展通用编辑器UI extending

作为Adobe Experience Cloud服务，可以使用App Builder和Experience Manager扩展通用编辑器的UI。

UI扩展是使用AdobeApp Builder构建的JavaScript应用程序，可以嵌入在Adobe Experience Cloud unified shell下运行的UI应用程序，例如通用编辑器。 您可以将自己的按钮和操作添加到标题菜单和属性面板，并为通用编辑器创建自己的事件。

如果您想探索这些可能性，请参阅以下资源：

在AEM Sites中使用Extension Manager，您可以基于每个实例启用或禁用扩展，访问Adobe的第一方扩展，包括通用编辑器的第一方扩展等等。