有數種 進階服務 和內容片段的演算相關。 若要使用這些服務,內容片段架構必須瞭解這些元件的資源型別。
這是透過設定 OSGi服務 — 內容片段元件設定.
下列情況需要此資訊:
建議使用核心元件。
如果您不需要 進階服務 如下所述,您可以忽略此設定。
當您延伸或使用現成元件時,不建議變更OSGi設定。
您可以從頭開始撰寫只使用內容片段API (沒有進階服務)的元件. 但是,在這種情況下,您必須開發元件,以便處理適當的處理。
因此,建議使用核心元件。
需要註冊元件的服務包括:
如果您需要這些功能中的一或多個,那麼使用現成可用的進階服務通常會比較容易,而不是從頭開始開發。
設定需要繫結到OSGi服務 內容片段元件設定:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
另請參閱 OSGi設定 以取得更多詳細資料。
例如:
OSGi設定為:
標籤 | OSGi設定 |
說明 |
資源類型 | dam.cfm.component.resourceType |
要註冊的資源型別;例如,
|
參考屬性 | dam.cfm.component.fileReferenceProp |
包含片段參照的屬性名稱;例如, fragmentPath 或 fileReference |
元素屬性 | dam.cfm.component.elementsProp |
包含要呈現之元素名稱的屬性名稱;例如,elementName |
變數屬性 |
dam.cfm.component.variationProp |
包含要呈現之變數名稱的屬性名稱;例如,variationName |
對於某些功能,您的元件必須遵循預先定義的慣例。 下表詳細說明每個段落(亦即 jcr:paragraph
(每個元件例項),讓服務可以正確偵測及處理它們。
屬性名稱 | 說明 |
paragraphScope |
字串屬性,定義段落在中的輸出方式 單一元素轉譯模式. 值:
|
paragraphRange |
字串屬性,定義要在下列情況下輸出的段落範圍: 單一元素轉譯模式. 格式:
|
paragraphHeadings |
布林值屬性,定義標題(例如, h1 , h2 , h3 )計算為段落(true )或不是(false ) |
如需範例,請參閱以下內容(在現成可用的AEM例項上):
/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config
這包含:
dam.cfm.component.resourceType="core/wcm/components/contentfragment/v1/contentfragment"
dam.cfm.component.fileReferenceProp="fragmentPath"
dam.cfm.component.elementsProp="elementName"
dam.cfm.component.variationProp="variationName"