对话框定义

对话框用来输入内容。编辑者在输入域（field）里输入内容，对话框将它存储在内容库中。对话框可以用来编辑页面、区域和组件内容。对话框里每个域的功能是由一个域定义类提供，编辑者可以输入文字，上传图片，选择日期等。域装在标签卡（tab）里，而标签卡则装在对话框里。

STK对话框定义在STK > 对话框定义下配置，主要在四个文件夹里：/generic，/pages，/components，/functional。

STK对话框是标准的Magnolia CMS对话框。更多有关对话框以及如何配置的信息请参考对话框。

通用配置

为简化配置，通用的对话框、标签卡和域在/generic文件夹里配置。这些配置被页面和组件对话框重复使用。您只需简单的引用通用配置就行了，而不需要复制它。四个子文件夹名（/pages、/controls、/teasers和/master）表明了这四个文件夹的内容以及用的最多的地方。同时很多地方都用到了扩展机制。

有关它如何工作，这是一个例子：

• hideTeaserImage字段在/generic/teasers文件夹里配置。

• /generic/master里配置的baseTeaserInternal对话框包含了两种标签卡，用在所有内部要点中：tabTeaser和tabTeaserOverwrite。hideTeaserImage字段在第一个标签卡中，使用extends属性。

  节点名	值
  generic
  pages
  controls
  teasers
  teaserImg
  shortTitle
  highlighted
  hideTeaserImage
  master
  baseTeaserInternal
  actions
  form
  tabs
  tabTeaser
  fields
  link
  hideTeaserImage
  extends	/modules/standard-templating-kit/dialogs/generic/teasers/hideTeaserImage
  highlighted
  label	dialogs.paragraphs.teasers.stkTeaser.tabTeaser.label
  tabTeaserOverwrite
  i18nBasename	info.magnolia.module.templatingkit.messages
  label	dialogs.paragraphs.teasers.stkTeaser.label

• /components/teasers文件夹里配置的stkTeaser对话框扩展（extends）了主配置。

  节点名	值
  components
  teasers
  stkTeaser
  extends	/modules/standard-templating-kit/dialogs/generic/master/baseTeaserInternal

这是编辑者看到的stkTeaser对话框。

页面对话框

/pages文件夹包含页面模板使用的对话框定义，每个模板都有一个子文件夹。除stkHome外，所有页面模板都有以下对话框定义：

• 属性：<template name>Properties，用来输入页面属性。
• 简介：<template name>Intro，用来在页面页眉组件里输入内容，该组件在大多数模板的main/intro区域绘制。更多信息参考intro区域。

/home文件夹只有一个stkHomeProperties对话框，这是因为intro区域在stkHome模板里是禁用的。更多信息参考intro区域。

/section和/footer文件夹还有两个例外：

• stkSectionHeader对话框用来在stkSection模板的章节页眉组件里输入内容。更多信息参考sectionHeader区域。
• stkFooter对话框用来在页脚组件中输入copyright信息。更多信息参考footer区域。

属性对话框

每个页面都有一个属性对话框，有以下特点：

• 在STK > 模板定义 /pages/<template name>/dialog的页面模板定义里分配给页面。
• 通过执行编辑页面属性动作打开。
• 除stkHome外（stkHome还包含了网站宽度的信息），对所有模板都一致。属性对话框有以下属性：
  
  • tabMain：将页面从导航栏，以及与页面标题不同的导航标题和浏览器窗口里去除。关于如何使用该内容，参考htmlHeader区域和导航。
  • tabMetaData：输入管理关键字和描述（它们通过htmlHeader.ftl脚本插入HTML）。更多信息参考htmlHeader区域。
  • tabChannels：绘制变异形式例如智能手机变异时，去除此页。更多信息参考针对特定内容。
  • tabDependencies：自动生成依赖页面和DMS数字资产的列表。此功能依赖内容依赖性模块，是一个企业版特性。

主配置在STK > 对话框定义 /generic/master/basePageProperties里。

单个对话框在/<page folder>/<template name>Properties里。

这是编辑者看到的对话框。

简介对话框

除stkHome和stkRedirect外，所有模板在main/intro区域里都有一个页面页眉组件。

该组件是页面模板固有的，与大多数其它组件配置方法不同。intro区域里有关于这个页面区域的更多信息。

简介（intro）对话框在STK > 对话框定义 /pages/<page folder>/<template name>Intro里，因模板而异。这些对话框：

• 在页面模板定义的intro区域定义里分配。
• 通过点击页面页眉工具栏的编辑图标来打开。
• 可以输入以下内容：
  
  • 适用每个模板，但有时可以将模板区别开的内容。例如stkArticleIntro对话框包含内容分类；stkEventIntro对话框包含事件专用的域，如eventTitle，dateEnd，location。
  • 用在要点里的内容，要点用来引用页面。大多数内部要点包含了在简介对话框里输入的title，kicker，abstract和image内容。

这是stkArticleIntro对话框的定义。

这是编辑者看到的对话框。

组件对话框

组件对话框在STK > 对话框定义 /components下配置。对话框定义在子文件夹里，按组件类型区分。文件夹和对话框定义的名称与STK > 模板定义 > /components配置组件模板定义里的一致。每个组件定义在dialog属性节点里引用相应的对话框定义。每个对话框定义都是唯一的，满足组件特定的内容输入需求。