自定义和扩展通用编辑器 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
显示的文本字段

扩展通用编辑器UI extending

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

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

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

  1. UI可扩展性 — 这是UI扩展的开发人员文档。
  2. UI扩展性指南 — 有关如何开发您自己的扩展的分步说明
  3. 通用编辑器扩展点 — 特定于通用编辑器的扩展点文档
TIP
如果您希望通过示例学习,请参阅AEM UI可扩展性教程。虽然它侧重于扩展内容片段控制台,但在通用编辑器中实施UI扩展的概念是相同的。

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab