AEM元件 — 基本概念

開始開發新元件時，您需要了解其結構和設定的基本知識。

此程式包括閱讀理論，以及查看標準AEM例項中的廣泛元件實作。 雖然AEM已改用新的標準、現代化、觸控式UI，但傳統UI仍可繼續提供支援，這讓後一種方法略為複雜。

概覽

本節介紹開發您自己的元件時所需的詳細資訊，並說明重要概念和問題。

規劃

開始實際設定或編寫元件程式碼之前，您應先詢問：

• 您到底需要新元件做什麼？

  • 在開發、測試和移交的所有階段，明確的規格都有幫助。

    詳細資訊可能會隨時間而改變，但可以更新規格（儘管更改也應記錄在案）。

• 您是否需要從頭建立元件，還是可以從現有元件繼承基本知識？

  • 沒有必要重新發明輪子。
  • AEM提供數種機制，可讓您繼承和延伸其他元件定義的詳細資訊，包括覆寫、覆蓋和Sling Resource Merger。

• 元件是否需要邏輯才能選取/操控內容？

  • 邏輯應與使用者介面層分開。 HTL的設計目的，是為了協助確保此情況發生。

• 元件是否需要CSS格式？

  • CSS格式應與元件定義分開。 定義命名HTML元素的慣例，以便透過外部CSS檔案修改它們。

• 我應考慮哪些安全方面？

  • 如需詳細資訊，請參閱安全性檢查清單 — 開發最佳實務 。

觸控式與傳統UI

在開始進行有關開發元件的嚴肅討論之前，您必須知道您的作者將使用哪個UI:

• 觸控式UI
  AEM 5. 6.0導入的標準使用者介面，作為預覽並在6.x中延伸。這是以Adobe Marketing Cloud的統一使用者體驗為基礎，使用Coral UI和 Granite UI 的基礎技術。

• 基
  於CQ 5.1中引入的ExtJS技術的傳統UIUser介面。

如需詳細資訊，請參閱適用於客戶的UI介面Recommendations 。

可實作元件，以支援觸控式UI、傳統UI或兩者。 查看標準例項時，您也會看到原本為傳統UI、觸控式UI或兩者設計的現成元件。

因此，在本頁中，我們將說明兩者的基本概念，以及如何辨識兩者。

內容邏輯和呈現標籤

建議您將負責標籤和轉譯的程式碼與控制用來選取元件內容之邏輯的程式碼分開。

HTL支援此理念，該模板語言故意限制以確保使用真正的寫程式語言定義基礎業務邏輯。 系統會透過特定命令從HTL叫用此（選用）邏輯。 此機制會反白標示為指定檢視所呼叫的程式碼，並視需要為相同元件的不同檢視允許特定邏輯。

HTL與JSP

HTL是AEM 6.0推出的HTML範本語言。

在開發您自己的元件時，有關是使用 HTL還是JSP（Java伺服器頁面）的討論應該簡單明瞭，因為HTL現在是AEM的建議指令碼語言。

HTL和JSP皆可用來開發傳統和觸控式UI的元件。 雖然有可能會假設HTL僅適用於傳統UI的觸控式UI和JSP，但這是一種誤解，更多是因為時間的緣故。 大約在相同時段內，觸控式UI和HTL已整合至AEM。 由於HTL現在是建議的語言，因此會用於新元件，而這類元件通常用於觸控式UI。

開發您自己的元件

若要針對適當的UI建立您自己的元件，請參閱（閱讀本頁後）:

• AEM元件（觸控式UI）
• AEM元件（適用於傳統UI）

快速入門的方法是複製現有元件，然後進行您想要的變更。 若要了解如何建立自己的元件並將其新增至段落系統，請參閱：

• 開發元件 （著重於觸控式UI）

將元件移至發佈執行個體

呈現內容的元件必須部署在與內容相同的AEM例項上。 因此，必須在發佈執行個體上部署用於製作和呈現製作執行個體頁面的所有元件。 部署後，元件可用於呈現已激活的頁面。

使用下列工具將元件移至發佈例項：

• 使用套 件管理員將元件新增至套件，並將其移至其他AEM例項。
• 使用「激活樹」復 制工具來複製元件。

從開始注意的元件

• 頁面:

  • AEM具有​page​元件(cq:Page)。
  • 這是對內容管理非常重要的特定資源類型。
    • 頁面對應於保存網站內容的網頁。

• 段落制度：

  • 段落系統是網站的關鍵部分，因為它管理著段落清單。 它可用來保留和建構包含實際內容的個別元件。
  • 您可以在段落系統中建立、移動、複製和刪除段落。
  • 您也可以選取要在特定段落系統內使用的元件。
  • 標準實例中有各種可用的段落系統（例如parsys、 [responsivegrid](/docs/experience-manager-64/sites-authoring/responsive-layout.md)）。

結構

AEM元件的結構既強大又靈活，主要考量為：

• 資源類型
• 元件定義
• 元件的屬性和子節點
• 對話方塊
• 設計對話方塊
• 元件可用性
• 元件及其建立的內容

資源類型

結構的一個關鍵元素是資源類型。

• 內容結構聲明意圖。
• 資源類型會實作它們。

這是抽象，有助於確保即使外觀和感覺隨著時間而改變，意圖仍會持續。

元件定義

元件基本知識

元件的定義可依下列方式劃分：

• AEM元件以Sling為基礎。

• AEM元件（通常位於下列位置）:

  • HTL: /libs/wcm/foundation/components
  • JSP:/libs/foundation/components

• 專案/網站特定元件（通常）位於：

  • /apps/<myApp>/components

• AEM標準元件定義為cq:Component，且有關鍵元素：

  • jcr屬性：

    jcr屬性清單；這些是變數，有些可能是選用的，但元件節點的基本結構、其屬性和子節點由cq:Component定義定義

  • 資源:

    這些定義元件使用的靜態元素。

  • 指令碼:

  用於實作元件之產生例項的行為。

• 根節點:

  • <mycomponent> (cq:Component) — 元件的階層節點。

• 重要屬性:

  • jcr:title — 元件標題；例如，當元件列在元件瀏覽器或sidekick中時，會以標籤的形式使用。

  • jcr:description — 元件的說明；可在元件瀏覽器或sidekick中作為滑鼠移過提示使用。

  • 傳統 UI:

    • icon.png — 此元件的表徵圖。
    • thumbnail.png — 如果此元件列在段落系統中，則顯示的影像。

  • 觸控式 UI

    • 如需詳細資訊，請參閱觸控式UI🔗中的元件圖示。

• 重要子節點:

  • cq:editConfig (cq:EditConfig) — 定義元件的編輯屬性，並使元件顯示在「元件」瀏覽器或Sidekick中。

    注意：如果元件有對話方塊，則會自動出現在「元件」瀏覽器或Sidekick中，即使cq:editConfig不存在亦然。

  • cq:childEditConfig (cq:EditConfig) — 控制未定義子元件的製作UI方面。 cq:editConfig

  • 觸控式UI:

    • cq:dialog ( nt:unstructured) — 此元件的對話方塊。定義介面，讓使用者設定元件和/或編輯內容。
    • cq:design_dialog ( nt:unstructured) — 此元件的設計編輯

  • 傳統 UI:

    • dialog ( cq:Dialog) — 此元件的對話方塊。定義介面，讓使用者設定元件和/或編輯內容。
    • design_dialog ( cq:Dialog) — 此元件的設計編輯。

觸控式UI中的元件圖示

當開發人員建立元件時，元件的圖示或縮寫會透過元件的JCR屬性定義。 這些屬性的計算順序如下，並使用找到的第一個有效屬性。

1. cq:icon — 指向Coral UI資料庫中標準圖示的字 串屬 性，以在元件瀏覽器中顯示

   • 使用Coral圖示的HTML屬性值。

2. abbreviation — 字串屬性，可自訂元件瀏覽器中元件名稱的縮寫

   • 縮寫應限制為兩個字元。

   • 提供空字串將從jcr:title屬性的前兩個字元建立縮寫。

     • 例如，「Im」代表「Image」
     • 本地化的標題將用於建立縮寫。

   • 僅當元件具有abbreviation_commentI18n屬性，然後將該屬性用作翻譯提示時，才翻譯縮寫。

3. cq:icon.png 或 cq:icon.svg — 此元件的圖示，顯示在元件瀏覽器中

   • 20 x 20像素是標準元件的圖示大小。

     • 較大的圖示會縮小（用戶端）。

   • 建議的顏色為rgb(112, 112, 112)> #707070

   • 標準元件圖示的背景是透明的。

   • 僅支援.png和.svg檔案。

   • 如果透過Eclipse外掛程式從檔案系統匯入，檔案名稱需要逸出為_cq_icon.png或_cq_icon.svg。

   • .png 若兩者皆 .svg 存在，將取代先例

如果元件上未找到上述屬性（cq:icon、abbreviation、cq:icon.png或cq:icon.svg）:

• 系統將在sling:resourceSuperType屬性後面的超級元件上搜索相同的屬性。
• 如果超級元件級別上未找到任何縮寫或空縮寫，則系統將從當前元件jcr:title屬性的第一個字母建立縮寫。

要取消超級元件的表徵圖繼承，在元件上設定空abbreviation屬性將恢復為預設行為。

元件控制台顯示如何定義特定元件的表徵圖。

SVG表徵圖示例

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "https://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg version="1.1" id="Layer_1" xmlns="https://www.w3.org/2000/svg" xmlns:xlink="https://www.w3.org/1999/xlink" x="0px" y="0px"
     width="20px" height="20px" viewBox="0 0 20 20" enable-background="new 0 0 20 20" xml:space="preserve">
    <ellipse cx="5" cy="5" rx="3" ry="3" fill="#707070"/>
    <ellipse cx="15" cy="5" rx="4" ry="4" fill="#707070"/>
    <ellipse cx="5" cy="15" rx="5" ry="5" fill="#707070"/>
    <ellipse cx="15" cy="15" rx="4" ry="4" fill="#707070"/>
</svg>

元件的屬性和子節點

定義元件所需的許多節點/屬性在兩個UI中都很常見，差異仍獨立，因此您的元件可在兩個環境中運作。

元件是cq:Component類型的節點，具有以下屬性和子節點：

如果查看​Text​元件（任一版本），我們會看到以下元素：

• HTL ( /libs/wcm/foundation/components/text)

  

• JSP(/libs/foundation/components/text)

  

特定權益物業包括：

• jcr:title — 元件標題；這可用來識別元件，例如，元件會顯示在元件瀏覽器或sidekick內的元件清單中

• jcr:description — 元件的說明；可在sidekick內的元件清單中作為滑鼠移過提示使用

• sling:resourceSuperType:這表示延伸元件時的繼承路徑（透過覆寫定義）

特別感興趣的子節點包括：

• cq:editConfig ( cq:EditConfig) — 這可控制視覺方面；例如，它可以定義條形或介面工具集的外觀，也可以添加自定義控制項

• cq:childEditConfig ( cq:EditConfig) — 這會控制子元件的視覺化方面，這些元件沒有其自己的定義

• 觸控式UI:

  • cq:dialog ( nt:unstructured) — 定義用於編輯此元件內容的對話框
  • cq:design_dialog ( nt:unstructured) — 指定此元件的設計編輯選項

• 傳統 UI:

  • dialog ( cq:Dialog) — 定義用於編輯此元件內容的對話方塊（專用於傳統UI）
  • design_dialog ( cq:Dialog) — 指定此元件的設計編輯選項
  • icon.png — 要用作Sidekick中元件表徵圖的圖形檔案
  • thumbnail.png — 將元件從Sidekick拖動時用作元件縮圖的圖形檔案

對話方塊

對話方塊是元件的關鍵元素，因為對話方塊提供介面，供作者設定及提供該元件的輸入。

根據元件的複雜性，您的對話框可能需要一個或多個頁簽，以保持對話框簡短並對輸入欄位進行排序。

對話方塊定義是UI專屬的：

• 觸控式UI

  • cq:dialog ( nt:unstructured節點):

    • 定義用於編輯此元件的內容的對話框

    • 特定於觸控式UI

    • 是使用Granite UI元件來定義

    • 具有屬性sling:resourceType，作為標準Sling內容結構

    • 可以具有helpPath屬性來定義當「幫助」表徵圖(? 圖示)。

      • 若為現成可用的元件，這通常會參照檔案中的頁面。
      • 若未指定helpPath，則會顯示預設URL（檔案概述頁面）。

  

  在對話方塊中，會定義個別欄位：

  

• 傳統 UI

  • dialog ( cq:Dialog節點)

    • 定義用於編輯此元件的內容的對話框

    • 專屬於傳統UI

    • 是使用ExtJS Widget定義

    • 具有xtype屬性，該屬性指ExtJS

    • 可以具有屬性helpPath來定義當選擇​Help​按鈕時訪問的上下文相關幫助資源（絕對或相對路徑）。

      • 若為現成可用的元件，這通常會參照檔案中的頁面。
      • 若未指定helpPath，則會顯示預設URL（檔案概述頁面）。

  

  在對話方塊中，會定義個別欄位：

  

  在傳統對話方塊中：

  • 您可以將對話方塊建立為cq:Dialog，該對話框將提供單個頁簽（如文本元件中），或者如果需要多個頁簽（如文本時間元件），則該對話框可定義為cq:TabPanel。
  • a cq:WidgetCollection(items)用於為輸入欄位(cq:Widget)或更多頁簽(cq:Widget)提供基礎。 此階層可延伸。

設計對話框

設計對話方塊與用來編輯和設定內容的對話方塊非常類似，但提供介面供作者設定及提供該元件的設計詳細資料。

設計對話框在設計模式中可用，但並非所有元件（如標題和影像）都 ​​需 ​​要它們，但文本 ​​不需要。

段落系統的設計對話框（例如parsys）是特殊情況，因為它允許用戶選擇特定的其他元件（從元件瀏覽器或sidekick）。

將元件添加到段落系統

定義元件後，必須將其提供使用。 要使元件可用於段落系統，可以執行以下任一操作：

1. 開啟頁面的設計模式並啟用所需元件。

2. 將所需元件新增至範本定義的components屬性，位於：

   /etc/designs/<*yourProject*>/jcr:content/<*yourTemplate*>/par

   例如，請參閱：

   /etc/designs/geometrixx/jcr:content/contentpage/par

   

元件及其建立的內容

如果我們在頁面上建立並設定​Title​元件的例項：<content-path>/Prototype.html

• 觸控式UI

  

• 傳統 UI

  

接著，我們便可查看在存放庫內建立的內容結構：

尤其是，如果查看​Title​的實際文本：

• 定義（適用於兩個UI）的屬性為name= ./jcr:title

  • /libs/foundation/components/title/cq:dialog/content/items/column/items/title
  • /libs/foundation/components/title/dialog/items/title

• 在內容中，這會產生包含作者內容的屬性jcr:title。

定義的屬性取決於個別定義。 儘管它們可能比高一些，但它們仍遵循著同樣的基本原則。

元件層次結構和繼承

AEM內的元件受3個不同階層的規範：

• 資源類型層次結構

  這可用來使用屬性sling:resourceSuperType擴充元件。 這可讓元件繼承。 例如，文本元件將繼承標準元件中的各種屬性。

  • 指令碼（由Sling解析）
  • 對話
  • 說明（包括縮圖影像、圖示等）

• 容器階層

  這可用來將組態設定填入子元件，且最常用於parsys案例。

  例如，可以在父元件上定義編輯欄按鈕、控制集佈局（編輯欄、變換）、對話框佈局（內聯、浮動）的配置設定，並傳播到子元件。

  會傳播cq:editConfig和cq:childEditConfig中的組態設定（與編輯功能相關）。

• 包含階層

  這是在執行階段以包含的順序強加。

  此層次結構由設計人員使用，而設計人員又是渲染的各個設計方面的基礎；包括版面資訊、css資訊、parsys中的可用元件等。

編輯行為

本節說明如何設定元件的編輯行為。 這包括可用於元件的動作、就地編輯器的特性以及與元件上的事件相關的監聽器等屬性。

觸控式和傳統UI都會使用此設定，雖然有某些特定差異。

元件的編輯行為是通過在元件節點（cq:Component類型）下添加cq:editConfig類型的cq:EditConfig節點以及添加特定屬性和子節點來配置的。 下列屬性和子節點可用：

• cq:editConfig 節點屬性:

  • cq:actions ( String array):定義可在元件上執行的動作。

  • cq:layout ( String)::會定義在傳統UI中編輯元件的方式。

  • cq:dialogMode ( String):定義傳統UI中開啟元件對話方塊的方式

    • 在觸控式UI中，對話方塊一律會在案頭模式中浮動，並在行動裝置中以全螢幕自動開啟。

  • cq:emptyText ( String):會定義沒有視覺內容時顯示的文字。

  • cq:inherit ( Boolean):定義是否從它繼承的元件繼承缺少的值。

  • dialogLayout （字串）:定義對話方塊的開啟方式。

• cq:editConfig 子節點:

  • cq:dropTargets (節點類 nt:unstructured型):定義可接受內容尋找器資產中刪除的刪除目標的清單

    • 傳統UI中僅提供多個放置目標。
    • 在觸控式UI中，允許使用單一放置目標。

  • cq:actionConfigs (節點類 nt:unstructured型):會定義附加至cq:actions清單的新動作清單。

  • cq:formParameters (節點類 nt:unstructured型):會定義新增至對話方塊表單的其他參數。

  • cq:inplaceEditing (節點類 cq:InplaceEditingConfig型):定義元件的就地編輯設定。

  • cq:listeners (節點類 cq:EditListenersConfig型):定義元件上發生動作之前或之後所發生的動作。

<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0"
    cq:actions="[edit]"
    cq:dialogMode="floating"
    cq:layout="editbar"
    jcr:primaryType="cq:EditConfig">
    <cq:listeners
        jcr:primaryType="cq:EditListenersConfig"
        afteredit="REFRESH_PAGE"/>
</jcr:root>

存放庫中有許多現有設定。 您可以輕鬆搜索特定屬性或子節點：

• 查找cq:editConfig節點的屬性，例如cq:actions，您可以在​CRXDE Lite​中使用「查詢」工具，並使用下列XPath查詢字串進行搜索：

  //element(cq:editConfig, cq:EditConfig)[@cq:actions]

• 要查找cq:editConfig的子節點，例如，可以搜索cq:dropTargets，其類型為cq:DropTargetConfig;您可以在​CRXDE Lite​中使用查詢工具，並使用下列XPath查詢字串進行搜索：

  //element(cq:dropTargets, cq:DropTargetConfig)

元件佔位符

元件必須一律轉譯作者可看見的某些HTML，即使元件沒有內容亦然。 否則，它可能會從編輯器的介面中以視覺化方式消失，從技術上而言，它會呈現在頁面上，但在編輯器中則隱藏。 在這種情況下，作者將無法選取空白元件並與其互動。

因此，只要元件在頁面編輯器中轉譯頁面時（當WCM模式為edit或preview時）未轉譯任何可見輸出，元件就應轉譯預留位置。
預留位置的典型HTML標籤如下：

<div class="cq-placeholder" data-emptytext="Component Name"></div>

呈現上述預留位置HTML的一般HTL指令碼如下：

<div class="cq-placeholder" data-emptytext="${component.properties.jcr:title}"
     data-sly-test="${(wcmmode.edit || wcmmode.preview) && isEmpty}"></div>

在上一個範例中，isEmpty是變數，只有在元件沒有內容且作者無法看見時才為true。

為避免重複，Adobe建議元件實作者為這些預留位置使用HTL範本，類似於核心元件提供的範本。

接著，您就可使用下列HTL行，在上一個連結中使用範本：

<sly data-sly-use.template="core/wcm/components/commons/v1/templates.html"
     data-sly-call="${template.placeholder @ isEmpty=!model.text}"></sly>

在上一個範例中，model.text是只有在內容有且可見時才為true的變數。

您可在核心元件中查看此範本的使用範例，例如在標題元件中。

使用cq進行配置：EditConfig屬性

cq:actions

cq:actions屬性(String array)定義了可在元件上執行的一個或多個操作。 下列值可用於設定：

以下配置將編輯按鈕、間隔器、刪除和插入按鈕添加到元件編輯欄：

<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0"
    cq:actions="[edit,-,delete,insert]"
    cq:layout="editbar"
    jcr:primaryType="cq:EditConfig"/>

以下配置將「從Base Framework繼承的配置」文本添加到元件編輯欄：

<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0"
    cq:actions="[text:Inherited Configurations from Base Framework]"
    cq:layout="editbar"
    jcr:primaryType="cq:EditConfig"/>

cq:layout（僅限傳統UI）

cq:layout屬性(String)定義了在傳統UI中如何編輯元件。 可使用下列值：

下列設定會將編輯按鈕新增至元件編輯列：

<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0"
    cq:actions="[edit]"
    cq:layout="editbar"
    jcr:primaryType="cq:EditConfig">
</jcr:root>

cq:dialogMode（僅限傳統UI）

元件可連結至編輯對話方塊。 cq:dialogMode屬性(String)定義傳統UI中如何開啟元件對話方塊。 可使用下列值：

下列設定會使用編輯按鈕定義編輯列和浮動對話方塊：

<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0"
    cq:actions="[edit]"
    cq:dialogMode="floating"
    cq:layout="editbar"
    jcr:primaryType="cq:EditConfig">
</jcr:root>

cq:emptyText

cq:emptyText屬性(String)定義當沒有視覺內容時顯示的文本。 預設值為：Drag components or assets here。

cq:inherit

cq:inherit屬性(boolean)定義是否從它繼承的元件繼承缺少的值。 預設為false。

dialogLayout

dialogLayout屬性定義預設情況下開啟對話方塊的方式。

• 值fullscreen會以全螢幕開啟對話方塊。
• 預設值為空或缺少屬性時，會正常開啟對話方塊。
• 請注意，使用者一律可在對話方塊內切換全螢幕模式。
• 不適用於傳統UI。

使用cq:EditConfig子節點進行配置

cq:dropTargets

cq:dropTargets節點（節點類型nt:unstructured）定義了一個下拉目標清單，這些下拉目標可以接受從內容查找器拖動的資產中的下拉。 它可作為cq:DropTargetConfig類型節點的集合。

類型cq:DropTargetConfig的每個子節點定義元件中的放置目標。 節點名稱很重要，因為必須在JSP中使用它，如下所示，生成分配給DOM元素的CSS類名稱，該元素是有效放置目標：

<drop target css class> = <drag and drop prefix> +
 <node name of the drop target in the edit configuration>

<*drag and drop prefix*>由Java屬性定義：

com.day.cq.wcm.api.components.DropTarget.CSS_CLASS_PREFIX。

例如，在下載元件的JSP中，類名定義如下
(/libs/foundation/components/download/download.jsp)，其中file是下載元件編輯配置中放置目標的節點名稱：

String ddClassName = DropTarget.CSS_CLASS_PREFIX + "file";

類型cq:DropTargetConfig的節點必須具有以下屬性：

下列設定是從「下載」元件進行。 它可讓media群組中的任何資產（mime類型可以是任何字串）從內容尋找器拖曳至元件中。 放置後，會更新元件屬性fileReference:

    <cq:dropTargets jcr:primaryType="nt:unstructured">
        <file
            jcr:primaryType="cq:DropTargetConfig"
            accept="[.*]"
            groups="[media]"
            propertyName="./fileReference"/>
    </cq:dropTargets>

cq:actionConfigs（僅限傳統UI）

cq:actionConfigs節點（節點類型nt:unstructured）定義了附加到cq:actions屬性所定義清單的新操作清單。 cq:actionConfigs的每個子節點都通過定義介面工具集來定義新操作。

下列範例設定會定義新按鈕（傳統UI會使用分隔符號）:

• 由xtype tbseparator定義的分隔符；

  • 這僅供傳統UI使用。
  • 觸控式UI會忽略此定義，因為會忽略xtype（而分隔符號則不必要，因為觸控式UI中的動作工具列結構不同）。

• 名為​管理注釋​的按鈕，運行處理程式函式CQ_collab_forum_openCollabAdmin()。

<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    cq:actions="[EDIT,COPYMOVE,DELETE,INSERT]"
    jcr:primaryType="cq:EditConfig">
    <cq:actionConfigs jcr:primaryType="nt:unstructured">
        <separator0
            jcr:primaryType="nt:unstructured"
            xtype="tbseparator"/>
        <manage
            jcr:primaryType="nt:unstructured"
            handler="function(){CQ_collab_forum_openCollabAdmin();}"
            text="Manage comments"/>
    </cq:actionConfigs>
</jcr:root>

cq:formParameters

cq:formParameters節點（節點類型nt:unstructured）定義了添加到對話框表單的其他參數。 每個屬性都對應至表單參數。

以下配置將名為name的參數添加到對話框窗體中，並使用值photos/primary設定：

    <cq:formParameters
        jcr:primaryType="nt:unstructured"
        name="photos/primary"/>

cq:inplaceEditing

cq:inplaceEditing節點（節點類型cq:InplaceEditingConfig）定義元件的就地編輯配置。 它可以有下列屬性：

以下配置啟用元件的就地編輯，並將plaintext定義為編輯器類型：

    <cq:inplaceEditing
        jcr:primaryType="cq:InplaceEditingConfig"
        active="{Boolean}true"
        editorType="plaintext"/>

cq:listeners

cq:listeners節點（節點類型cq:EditListenersConfig）定義元件上的動作之前或之後會發生什麼。 下表定義了其可能的屬性。

事件處理常式可透過自訂實作來實作。 例如（其中project.customerAction是靜態方法）:

afteredit = "project.customerAction"

以下範例等同於REFRESH_INSERTED設定：

afterinsert="function(path, definition) { this.refreshCreated(path, definition); }"

使用下列配置時，在元件被刪除、編輯、插入或移動後刷新頁面：

    <cq:listeners
        jcr:primaryType="cq:EditListenersConfig"
        afterdelete="REFRESH_PAGE"
        afteredit="REFRESH_PAGE"
        afterinsert="REFRESH_PAGE"
        afterMove="REFRESH_PAGE"/>

Business.Adobe.com 資源

Style System Customer Communications Personalized Communications Responsive Forms Managed Cloud Version History