自定义通用编辑器 customizing

最近更新： 2025年12月16日

适用对象：
Experience Manager as a Cloud Service

主题：
Developing

创建对象：

Admin
Developer

了解如何通过不同的选项自定义通用编辑器，以满足内容作者的需求。

TIP

通用编辑器还提供了许多扩展点，允许您扩展其功能，以满足您的项目需求。

使用Meta配置标记 meta-tags

某些创作工作流可能要求使用通用编辑器的某些功能，而不是其他功能。为了支持这些不同的情况，meta标记可用于配置或禁用编辑器的某些功能或按钮。

禁用功能 disable-features

在页面的<head>部分使用此标记可禁用一项或多项功能：

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

如果要禁用多个功能，请提供以逗号分隔的值列表。

以下是content支持的值，即可以使用meta标记禁用的功能。

内容值

描述

publish

禁用所有发布功能，即发布按钮和取消发布按钮

publish-live

禁用实时发布

publish-preview

禁用预览发布（如果预览服务可用）

unpublish

禁用取消发布按钮

copy

禁用复制和粘贴按钮

duplicate

禁用重复按钮

header-open-page

禁用打开页面按钮

aem-dev-login

禁用开发人员登录按钮

定义编辑器模式 defining-mode

您可以强制通用编辑器在特定模式下打开。在页面的<head>部分使用此标记强制编辑器模式：

<meta name="urn:adobe:aue:config:mode" content="..." />

以下是content支持的值，即可以使用meta标记禁用的功能。

内容值

描述

preview

编辑器在预览模式下打开。预览图标已隐藏，用户无法切换回编辑模式。

readonly

编辑器将以只读模式打开。属性按钮和面板已隐藏。详细信息可在内容树中找到，但无法进行任何更改。

通过meta标记定义模式时，模式不能被用户覆盖。

自定义预览 URL custom-preview-urls

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

为此，只需将所需的预览 URL 包含在已适配的应用程序的元标记中，如下例所示。

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

更改您的端点 custom-endpoint

如果您不想使用 Adobe 托管的通用编辑器服务，而是使用您自己的托管版本，您可以在元标记中设置这一点。详细信息请参阅文档在 AEM 中使用通用编辑器快速入门。

筛选组件 filtering-components

您可以使用组件过滤器限制通用编辑器中每个容器允许使用的组件。有关更多信息，请参阅文档筛选组件。

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

通常情况下会有一个或多个组件可供作者使用，但在某些情况下可能会不合理。在这种情况下，您可以将一个 condition 属性添加到组件模型的字段中，隐藏属性面板中的组件。

可以使用 JsonLogic 架构定义条件。如果条件为真，就显示该字段。如果条件为假，就隐藏该字段。

模型示例

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] }
      }
    ]
 }

条件为假

条件为真

限制：多字段容器中的条件 conditions-multi-field-limitation

条件var分辨率是绝对分辨率，不是相对于当前行的分辨率。 var必须是根级别fieldName，或者，对于容器中的字段，其前缀为容器名称containerName|fieldName。

相同的方法不适用于多个容器（可重复行）。行内容在运行时索引为containerName/0|fieldName、containerName/1|fieldName等，但在创作条件时该索引未知，并且它会随着行的添加、删除或重新排序而移动。因此，作者无法定位同一行中的特定字段，因此不支持多个容器中的条件。

recommendation-more-help

experience-manager-cloud-service-help-main-toc