内容片段模板 content-fragment-templates

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

主题：

创建对象：

开发人员

CAUTION

建议使用内容片段模型来创建所有新的内容片段。

内容片段模型用于WKND中的所有示例。

NOTE

在AEM 6.3之前，内容片段是基于模板而不是模型创建的。

现已弃用内容片段模板。它们仍可用于创建片段，但建议改用内容片段模型。不会向片段模板中添加任何新功能，并且会在未来版本中删除这些功能。

创建内容片段时可以选择模板。它们为新片段提供基本结构、元素和变量。用于内容片段的模板受Granite配置管理器的约束。

现成的模板保存在下：

/libs/settings/dam/cfm/templates

您可以在以下位置为内容片段创建特定于站点的模板：

/apps/settings/dam/cfm/templates
用于覆盖现成模板或提供特定于客户的应用程序范围的模板的位置，这些模板在运行时不会进行扩展/更改。
/conf/global/settings/dam/cfm/templates
运行时需要更改的全实例客户特定模板的位置。

优先顺序为（降序） /conf、/apps、/libs。

CAUTION

您必须不更改/libs路径中的任何内容。

这是因为下次升级实例时/libs的内容会被覆盖（在应用修补程序或功能包时很可能会被覆盖）。

建议用于配置和其他更改的方法是：

在/apps下重新创建所需项（即/libs中存在的项）
在/apps中进行任何更改

模板的基本结构保存在下：

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

具体结构为：

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

有关节点及其属性的更多详细信息包括：

模板

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
名称	类型	价值
`<template-name>`	`nt:unstructured`	此节点是每个模板的根。它是强制性的，应具有唯一名称。
`jcr:title`	`String` 必需	模板的标题（显示在创建片段向导中）。
`jcr:description`	`String` 可选	描述模板用途的文本（显示在创建片段向导中）。
`initialAssociatedContent`	`String[]` 可选	一个数组，其中包含指向集合的路径，默认情况下，这些路径应关联到新创建的内容片段。
`precreateElements`	`Boolean` 必填	`true`，如果在创建内容片段时应该创建表示内容片段的元素（主元素除外）的子资产；如果应该“动态”创建子资产，则为 false。注意：当前此参数必须设置为`true`。
`version`	`Long` 必填	内容结构的版本；当前支持：注意：当前此参数必须设置为`2`。

元素

table 0-row-3 1-row-3 html-authored

名称类型价值

elements

nt:unstructured

必填

包含内容片段元素定义的节点。它是强制性的，并且需要为 Main 元素至少包含一个子节点，但可以包含[1.n]个子节点。

使用模板时，元素子分支复制到片段的模型子分支。

第一个元素(在CRXDE Lite中查看)自动视为 main 元素；节点名称不相关，并且节点本身除了由主资源表示之外，不具有特殊意义；其他元素作为子资源处理。

元素名称

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
名称	类型	价值
`<element-name>`	`nt:unstructured`	此节点定义一个元素。它是强制性的，应具有唯一名称。
`jcr:title`	`String` 必填	元素的标题（显示在片段编辑器的元素选择器中）。
`defaultContent`	`String` 可选默认：“”	元素的初始内容；仅在`precreateElements` = `true`时使用
`initialContentType`	`String` 可选默认： `text/html`	元素的初始内容类型；仅在`precreateElements` = `true`时使用；当前支持： `text/html` `text/plain` `text/x-markdown`
`name`	`String` 必填	元素的内部名称；对于片段类型必须是唯一的。

变体

table 0-row-3 1-row-3 html-authored

名称类型价值

variations

nt:unstructured

可选

此可选节点包含内容片段的初始变体的定义。

变量名称

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
名称	类型	价值
`<variation-name>`	`nt:unstructured` 如果存在变体节点，则此为必填字段	定义初始变量。默认情况下，该变量会添加到内容片段的所有元素。变体的初始内容将与相应元素相同（请参阅 `defaultContent/ initialContentType` ）
`jcr:title`	`String` 必填	变量的标题(显示在片段编辑器的变量选项卡中（左边栏）)。
`jcr:desciption`	`String` 可选默认：“”	提供变量的描述的文本(显示在片段编辑器的变量选项卡中（左边栏）)。

recommendation-more-help

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