自訂和擴充通用編輯器 customizing-extending

瞭解不同的擴充點和其他功能,這些功能可讓您自訂Universal Editor的撰寫體驗,以支援內容作者的需求。

概觀 overview

Universal Editor允許兩種型別的調整,以滿足您專案的需求。

以下各節將詳細介紹這兩種型別。

自訂 Universal Editor customizing

Universal Editor提供數個內建選項,可用於自訂其功能。

停用發佈 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服務,Universal Editor的UI可以使用App Builder和Experience Manager進行擴充。

UI擴充功能是使用Adobe App Builder建置的JavaScript應用程式,可嵌入在Adobe Experience Cloud unified shell底下執行的UI應用程式(例如Universal Editor)中。 您可以將自己的按鈕和動作新增到頁首功能表和屬性邊欄,並為通用編輯器建立自己的事件。

如果您想探索這些可能性,請參閱下列資源:

  1. UI擴充功能 — 這是UI擴充功能的開發人員檔案。
  2. UI擴充性指南 — 如何開發您自己的擴充功能的逐步指示
  3. 通用編輯器擴充點檔案 — 通用編輯器專用的擴充點檔案
TIP
如果您偏好以範例學習,請參閱AEM UI擴充性教學課程。雖然其著重於擴充內容片段主控台,但在通用編輯器中實作UI擴充功能的概念是相同的。

在AEM Sites中使用Extension Manager,您可以根據執行個體來啟用或停用擴充功能、存取Adobe的第一方擴充功能(包括Universal Editor的擴充功能)等等。

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