自訂和擴充通用編輯器 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

自訂預覽URL custom-preview-urls

您可以透過urn:adobe:aue:config:preview中繼設定來指定自訂預覽URL，按一下編輯器右上角工具列中的​ 開啟頁面 ​按鈕時，將會開啟此設定。

這對於具有特定預覽需求的應用程式特別有用，例如那些將Edge Delivery Services與WYSIWYG編寫搭配使用的。

若要這麼做，只需將所需的預覽URL加入所檢測應用程式的中繼標籤中，例如下列範例。

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

擴充通用編輯器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）中。 您可以將自己的按鈕和動作新增到頁首功能表和屬性面板，以及為通用編輯器建立自己的事件。

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

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