配置用于呈现的组件的内容片段 content-fragments-configuring-components-for-rendering

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined

有几个高级服务与内容片段的呈现相关。要使用这些服务，必须使内容片段框架知道这些组件的资源类型。

这是通过配置OSGi服务 — 内容片段组件配置完成的。

CAUTION

如果您不需要下面描述的高级服务，则可以忽略此配置。

CAUTION

在扩展或使用现成组件时，不建议更改配置。

CAUTION

您可以从头开始编写仅使用内容片段API的组件，而无需使用高级服务。但是，在这种情况下，您必须开发组件，以便它处理相应的处理。

因此，建议使用核心组件。

需要配置的高级服务的定义 definition-of-advanced-services-that-need-configuration

需要注册组件的服务包括：

在发布期间正确确定依赖关系（即，如果片段和模型自上次发布以来已更改，请确保它们可以随页面自动发布）。
支持全文搜索中的内容片段。
中间内容的管理/处理。
管理/处理 混合媒体资产。
Dispatcher刷新引用的片段（如果重新发布包含片段的页面）。
使用基于段落的渲染。

如果您需要这些功能中的一个或多个功能，则（通常）使用现成功能比从头开始开发更容易。

OSGi服务 — 内容片段组件配置 osgi-service-content-fragment-component-configuration

该配置需要绑定到OSGi服务 内容片段组件配置：

com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl

NOTE

有关详细信息，请参阅配置OSGi。

例如：

cfm-01

OSGi配置为：

标签

OSGi配置

描述

资源类型

dam.cfm.component.resourceType

要注册的资源类型；例如，

core/wcm/components/contentfragment/v1/contentfragment

引用属性

dam.cfm.component.fileReferenceProp

包含对片段的引用的属性的名称；例如，fragmentPath或 fileReference

元素属性

dam.cfm.component.elementsProp

包含要呈现的元素名称的属性的名称；例如，elementName

变量属性

dam.cfm.component.variationProp

包含要呈现的变量的名称的属性的名称；例如，variationName

对于某些功能（例如，仅呈现段落范围），您必须遵守某些约定：

属性名称

描述

paragraphRange

一个字符串属性，定义在 单元素渲染模式 下要输出的段落范围。

格式：

1 或1-3或1-3;6;7-8或 *-3;5-*
仅在paragraphScope设置为时评估 range

paragraphScope

一个字符串属性，它定义在 单元素呈现模式 下段落的输出方式。

值：

all ：渲染所有段落
range ：呈现以下项提供的段落范围： paragraphRange

paragraphHeadings

一个布尔属性，定义标题（例如h1、h2、h3）是否计为段落(true)(false)

CAUTION

这可能在6.5以后的里程碑中发生变化。

示例 example

例如，请参阅以下内容(在现成的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"

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2