内容片段模板 content-fragment-templates

Last update: Wed Mar 20 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 下次升级实例时将被覆盖（在应用修补程序或功能包时很可能会被覆盖）。

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

重新创建所需项目(即，它存在于 /libs)，在 /apps
在中进行任何更改 /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

必填

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

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

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

元素名称

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