文件AEM as a Cloud Service使用手冊

篩選器 filters

Last update: Thu Mar 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用對象：
  • Experience Manager as a Cloud Service

建立對象：

  • 管理員
  • 開發人員

瞭解如何定義篩選器以限制編輯器中可用的選項，例如可用元件、RTE選項和資產選擇。

設定篩選器 configuring-filters

使用通用編輯器時，您可以定義篩選器來限制特定功能允許的選項。 篩選器是特定前後關聯可用的專案或動作清單。 例如，您可以篩選可插入容器的可用元件，您可以篩選RTE中可用的選項，以及您可以篩選資產選取器中的可用資產。

所有篩選器的定義都必須類似。

  1. 新增指令碼標籤以指向篩選器定義
  2. 定義篩選器
  3. 參考篩選器

讓我們舉一個依容器元件篩選元件的範例。

參考篩選器定義 add-tag

首先，引進其他指令碼標籤，指向篩選器定義。

在我們的範例中，為每一個容器篩選允許的元件，標籤看起來可能會像這樣。

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

定義篩選 define-filter

篩選器定義包含的JSON具有篩選器唯一ID和篩選器准則。

在我們的範例中，若要篩選每個容器允許的元件，可能會如下所示，這會限制容器僅允許新增文字和影像。

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

將篩選器定義中的 components 屬性設定為 null，會允許所有元件，如同沒有篩選器一般。

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

參考篩選器 reference-filter

若要使用篩選器，您必須參考篩選器定義。 您可以透過以下方式進行：

  • 透過新增屬性data-aue-filter，傳遞篩選的ID，從容器元件參照篩選。

    code language-html 
    data-aue-filter="container-filter"

  • 從您的元件定義參考篩選器，傳遞篩選器的ID。

    code language-json 
    {
   "title":"My Container",
   "id":"my-container",
   "model": "my-model",
   "filter": "container-filter",
   ...
}

其他資源 additional-resources

參閱以下文件，了解通用編輯器能夠使用的其他自訂和擴充選項：

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