自定义页面属性的视图 customizing-views-of-page-properties
每个页面都有一组可供用户查看和编辑的属性;创建页面(创建视图)时需要某些属性,其他属性可在以后的阶段查看和编辑(编辑视图)。 这些页面属性由相应页面组件的对话框(cq:dialog
)定义和提供。
每个页面属性的默认状态是:
-
在创建视图中隐藏(例如,创建页面 向导)
-
在编辑视图中可用(例如,查看属性)
如果需要任何更改,则必须专门配置字段。这是使用相应的节点属性完成的:
-
页面属性在创建视图中可用(例如,创建页面 向导):
- 名称:
cq:showOnCreate
- 类型:
Boolean
- 名称:
-
编辑视图中可用的页面属性(例如,视图/编辑)属性 选项):
- 名称:
cq:hideOnEdit
- 类型:
Boolean
- 名称:
例如,查看Foundation Page组件的 Basic 选项卡上 More Titles and Description 下分组的字段的设置。 这些内容在 创建页面 向导中可见,因为cq:showOnCreate
已设置为true
:
/libs/foundation/components/page/cq:dialog/content/items/tabs/items/basic/items/column/items/moretitles
配置页面属性 configuring-your-page-properties
您还可以通过配置页面组件的对话框并应用相应的节点属性来配置可用字段。
例如,默认情况下创建页面 向导会显示在 更多标题和描述 中分组的字段。若要对其进行隐藏,您可以配置:
-
在
/apps
下创建您的页面组件。 -
为页面组件的
basic
部分创建一个覆盖(使用 Sling 资源合并器提供的 对话框差异);例如:code language-xml <your-page-component>/cq:dialog/content/items/tabs/items/basic
note note NOTE 作为参考,请参阅: /libs/wcm/foundation/components/basicpage/v1/basicpage/cq:dialog
但是,您 必须 不更改 /libs
路径中的任何内容。这是因为下次升级实例时 /libs
的内容会被覆盖(在应用修补程序或功能包时很可能会被覆盖)。建议用于配置和其他更改的方法是: - 在
/apps
下重新创建所需项(即/libs
中存在的项) - 在
/apps
中进行任何更改
- 在
-
将
basic
上的path
属性设置为指向基本选项卡的覆盖(另请参阅下一步)。例如:code language-xml /apps/demos/components/page/tabs/basic
-
在相应路径上创建
basic
-moretitles
部分的覆盖;例如:code language-xml /apps/demos/components/page/tabs/basic/items/column/items/moretitles
-
应用适当的节点属性:
- 名称:
cq:showOnCreate
- 类型:
Boolean
- 值:
false
更多标题和描述 部分不会再在 创建页面 向导中显示。
- 名称:
页面属性的示例配置 sample-configuration-of-page-properties
此示例演示了Sling资源合并器的对话框比较技术;包括使用sling:orderBefore
。 它还说明了 cq:showOnCreate
和 cq:hideOnEdit
的用法。
GITHUB上的代码
您可以在GitHub上找到此页面的代码