轉譯網頁中的元件時可產生 HTML 元素,將轉譯的元件圍在其中。這主要有兩個用途:
元件只有以HTML元素包住時,才可加以編輯。
包裝元素用於套用提供以下內容的HTML類:
對於開發人員來說,AEM 提供簡單清晰的邏輯,可控制圍住所含元件的裝飾標記。裝飾標籤的呈現方式及是否由兩個因素的組合所定義,本頁將深入探討:
以下是幾項一般建議,說明何時加入包裝函式元素,有助於避免遇到非預期的問題:
下列屬性和節點可套用至元件,以控制其裝飾標籤的行為:
cq:noDecoration {boolean}
: 此屬性可新增至元件,而true值會強制AEM不在元件上產生任何包裝函式元素。
cq:htmlTag
節點: 此節點可以添加到元件下,並可以具有以下屬性:
cq:tagName {String}
: 這可用來指定要用來包裝元件的自訂HTML標籤,而非預設的DIV元素。class {String}
: 這可用來指定要新增至包裝函式的css類別名稱。一般而言,HTL中的包裝函式行為可總結如下:
data-sly-resource="foo"
)。包裝函式的行為也可完全控制。
cq:noDecoration
和 cq:tagName
)也可以定義包裝函式標籤。您可以完全控制HTL指令碼中包裝函式標籤的行為及其相關邏輯。
如需有關以HTL開發的詳細資訊,請參閱 HTL檔案.
此決策樹會總結決定包裝器標籤行為的邏輯。
以下三個使用案例提供如何處理包裝函式標籤的範例,並說明控制包裝函式標籤的所需行為有多簡單。
下列所有範例假設有下列內容結構和元件:
/content/test/
@resourceType = "test/components/one"
child/
@resourceType = "test/components/two"
/apps/test/components/
one/
one.html
two/
two.html
cq:htmlTag/
@cq:tagName = "article"
@class = "component-two"
最常見的使用案例是,由於程式碼重複使用的原因,元件包含其他元件。 在這種情況下,所包含的元件不想透過其自己的工具列和對話方塊進行編輯,因此不需要包裝函式,也不需要元件的包裝函式 cq:htmlTag
會被忽略。 這可視為預設行為。
one.html: <sly data-sly-resource="child"></sly>
two.html: Hello World!
產生的輸出於 /content/test.html
:
Hello World!
例如,元件包括顯示影像的核心影像元件,在這種情況下,通常是使用合成資源,包括通過將表示元件將具有的所有屬性的映射對象傳遞到data-sly-resource來包括虛擬子元件。
另一個常見使用案例是容器元件包含可編輯的子元件時,例如「版面容器」。 在此情況下,每個包含的子項都必須有一個包裝函式才能使編輯器工作(除非明確禁用 cq:noDecoration
屬性)。
由於包含的元件在此情況下是獨立元件,因此它需要一個包裝元素才能讓編輯器工作,並定義要套用的版面和樣式。 要觸發這種行為, decoration=true
選項。
one.html: <sly data-sly-resource="${'child' @ decoration=true}"></sly>
two.html: Hello World!
產生的輸出於 /content/test.html
:
<article class="component-two">Hello World!</article>
可能會有任何複雜的案例,而HTL可明確提供便可輕鬆達成:
decorationTagName='ELEMENT_NAME'
定義包裝函式的元素名稱。cssClassName='CLASS_NAME'
定義要在其上設定的CSS類名。one.html: <sly data-sly-resource="${'child' @ decorationTagName='aside', cssClassName='child'}"></sly>
two.html: Hello World!
產生的輸出 /content/test.html
:
<aside class="child">Hello World!</aside>
使用 cq:includ
e或 sling:include
,AEM的預設行為是使用DIV來包裝元素。 不過,此包裝可透過兩種方式自訂:
cq:noDecoration
.cq:htmlTag
/ cq:tagName
或 decorationTagName
.以下決策樹說明如何 cq:noDecoration
, cq:htmlTag
, cq:tagName
,和 decorationTagName
會影響包裝行為。