有幾個進階服務與內容片段的呈現有關。 要使用這些服務,此類元件的資源類型必須使內容片段框架自己知道。
這是通過配置OSGi服務——內容片段元件配置來完成的。
如果您不需要下面所述的advanced services,則可以忽略此配置。
當您擴充或使用現成可用的元件時,不建議您變更組態。
您可以從頭開始編寫僅使用內容片段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 |
對於某些功能(例如,僅呈現段落範圍),您必須遵守一些慣例:
屬性名稱 | 說明 |
paragraphRange |
字串屬性,定義在單一元素演算模式中要輸出的段落範圍。 格式:
|
paragraphScope |
字串屬性,定義在單一元素演算模式中如何輸出段落。 值:
|
paragraphHeadings |
一種布林屬性,定義標題(例如h1 、h2 、h3 )是否被計為段落(true )false |
這在6.5之後的里程碑中可能會改變。
例如,請參閱下列(在現成可用的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"