Page History

...

• htmlHeader在HTML的head元件里插入管理元件，用来表示关键词、描述等，创建标题元件，以及到样式表和JavaScript的链接。
• branding包含标志、品牌口号、搜索框以及内部登录链接。
• sectionHeader只在章节页面上使用，包含章节的横幅正文。除非特意配置，否则sectionHeader会被所有子页面继承。
• stage只在主页使用，包含一个较大的要点组件。
• platform不被使用，但可以添加到任何模板，包含一个页面要点。
• main包含页面的主要内容。用在一个文章页面时，主内容为文章故事，在新闻页面时则为新闻项等。在章节页面和主页上，主内容为链接到内容页面的要点。
• extras为要点组件而使用。通常这些都与主内容有关。例如，如果主内容是事件，那么附加物可以是日历、通信录以及新事件要点组件，提供一个可点击的日历、通信录信息和一个即将发生的事件列表。
• promos通常被用来推广特殊事件或交易。窗口够宽时，该区域浮在main和extras右方；窗口较窄时，则会在下方。
• base占用页面的整个宽度，可包含一个大的圆盘幻灯片或分类云组件。
• footer包含链接、样板文件和版权声明。

嵌套区域

区域可以包含嵌套的子区域，而子区域可反过来有它们自己的嵌套区域。嵌套区域在区域可以嵌套子区域，而子区域也可反过来有它们自己的嵌套区域。嵌套区域在/default/templates/areas/<parent area name>/areas/<child area name>节点下配置。第二（或第三）个areas内容节点名识别子配置为一个区域。父区域和子区域支持相同的属性和配置选项。内容节点名标志着子配置为一个区域。父区域和子区域支持相同的属性和配置选项。

区域定义

以下列出了区域包含的最少的属性。唯一必须的属性为以下列出了区域可包含的最少的属性。唯一必须的属性为type。

• description设置区域描述的消息包关键字。
• enabled是一个布尔属性，有true和false两个值可选，来启用或禁用该区域。该属性缺省值为两个值可选，来启用或禁用该区域。该属性默认值为true，故当此属性被忽略时，区域默认被启用。模板原型里启用的区域可通过修改原型的值在具体模板里禁用。，故当此属性被忽略时，区域默认被启用。模板原型里启用的区域可通过在具体模板里修改原型的值来禁用。
• templateScript设置到绘制区域的脚本的路径。专用脚本仅在做简单绘制区域以外的事时才需要。所有的具体模板使用原型里定义的脚本，除非模板定义里引用了另一个脚本。例如，main区域通过STK > 模板 设置到绘制区域的脚本的路径。专用脚本仅在做简单绘制区域以外的事时才需要。除非模板定义里引用了另一个脚本，否则所有的具体模板使用原型里定义的脚本。例如，除了stkSection和stkHome使用/templating-kit/pages/globalsection/mainArea.ftl为所有具体模板绘制，除了stkSection和stkHome使用ftl之外，所有具体模板使用STK > 模板 /templating-kit/pages/sectionglobal/mainArea.ftl绘制main区域。
• title为区域名设置消息包关键字。该值在区域工具栏里绘制。

• type定义多少组件（如果有的话）可在区域里绘制。可用的选项在以下的定义可在区域里绘制的组件数量（如果可以有组件的话）。可用的选项在以下的区域类型中讨论。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 prototype   areas   base   availableComponents   Paragraph description areas.templates.base.description Paragraph enabled true Paragraph templateScript /templating-kit/pages/global/baseArea.ftl Paragraph title areas.templates.base.title Paragraph type list

很多STK区域定义也使用以下属性中的一个或多个：很多STK区域定义也使用以下的一个或多个属性：

• class定义具体的用来实例化的Java类。
• dialog以<module name>:<path to dialog>格式设置到对话框定义的路径。
• editable为一个布尔属性，有true和false两个选项值，用来定义编辑者是否可以编辑此区域内容。
• modelClass定义包含此区域业务逻辑的Java类。

• optional为一个布尔属性，有true和false两个选项值，用来定义编辑者是否可以删除此区域。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 prototype   areas   sectionHeader   Paragraph description areas.templates.sectionHeader.description Paragraph dialog standard-templating-kit:pages/section/stkSectionHeader Paragraph editable false Paragraph enabled true Paragraph modelClass info.magnolia.module.templatingkit.templates.areas.SectionHeaderAreaModel Paragraph templateScript /templating-kit/pages/content/sectionHeader.ftl Paragraph title areas.templates.sectionHeader.title Paragraph type noComponent

您可以在参考资料部分找到您可以在参考资料部分找到区域属性的完整列表。

区域类型

type属性决定什么可以在此区域内绘制，有三个选项：属性决定可以在区域内绘制的内容，有三个选项：single，list和noComponent。

• 前两个用来绘制组件在前两个选项绘制/<area name>/availableComponents节点下可用（参考以下的节点下可用的组件（参考以下的可用组件）：
• single区域在页面上生成一个组件。编辑者可以从很多组件类型中选择，但只可以添加一个。单个区域的例子有区域在页面上生成一个组件。编辑者可以从很多组件类型中选择，但只可以添加一个。此类型区域的例子有stage这样有两种大的要点类型可选的，以及，opener和comments这样只有一个组件类型可用的。可以在两种大的要点类型中选择；后两者里只能有单个组件类型。
• list区域在页面上绘制任意数量的有序组件。编辑者可用的组件类型的选择可以从一个到多个。列表区域的例子有区域在页面上绘制任意数量的有序组件。编辑者可用的组件类型的选择可以从一个到多个。此类型区域的例子包括metaNavigation，content，extras1/2，base，footer这些有多个组件类型可用的，以及promos这种编辑者只可以添加一个组件类型的。
• noComponent区域不绘制在区域不绘制<area name>/availableComponents节点下可用的组件，但可绘制配置不同的组件。noComponent区域的例子有：
• intro和sectionHeader，绘制页面页眉和章节页眉组件。
• branding，main和extras，包含子区域。
• htmlHeader，logo，search和breadcrumb，通过区域脚本绘制。

您可以在具体定义里改变type区域。参看您可以在具体定义里改变区域类型（type）。参看模板定义 > 改变区域行为了解这在特性模板上是如何实现的。

区域脚本

模板原型所使用的区域脚本在模板原型所使用的区域脚本可在STK > 模板 /templating-kit/pages下可获得。多数区域脚本只简单的分配一个DIV元件以要求绘制区域，而不定义在区域里有什么，因为那是区域定义的责任。下获得。多数区域脚本只简单的分配一个DIV元件，然后调用要绘制的区域，而不定义在区域里有什么，因为那是区域定义的责任。

一个区域定义就可以绘制一个区域。如果single或list区域并没有直接引用templateScript，那么采用以下代码：，那么系统会采用以下默认代码：

[@cms.component content=component /]

[#list components as component]
   [@cms.component content=component /]
[/#list]

...