内容片段模板 content-fragment-templates

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的内容会被覆盖(在应用修补程序或功能包时很可能会被覆盖)。
建议用于配置和其他更改的方法是:
  1. /apps下重新创建所需项(即/libs中存在的项)

  2. /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