文档AEM 6.4开发指南

创建新的Granite UI字段组件 creating-a-new-granite-ui-field-component

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 开发人员
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

Granite UI提供了一系列旨在用于表单的组件；这些名称 字段 在Granite UI词汇中。 标准Granite表单组件位于：

/libs/granite/ui/components/foundation/form/*

NOTE
这些Granite UI表单字段特别受关注，因为它们用于 组件对话框.
NOTE
有关字段的完整详细信息，请参阅 Granite用户界面文档.

使用Granite UI Foundation框架开发和/或扩展Granite组件。 其中包含两个元素：

  • 服务器端：

    • 基础组件的集合

      • 基础 — 模块化、可组合、可分层、可重用
      • 组件 — Sling组件

    • 帮助应用程序开发人员

  • 客户端：

    • clientlibs集合，提供一些词汇(即HTML语言的扩展)，以通过超媒体驱动的UI实现通用交互模式

通用Granite UI组件 field 由两个目标文件组成：

  • init.jsp:处理通用处理；标记、描述，并提供在渲染字段时需要的表单值。
  • render.jsp:这是执行字段实际渲染的地方，需要覆盖自定义字段的实际渲染；包含者 init.jsp.

请参阅 Granite用户界面文档 — 字段 的问题。

有关示例，请参阅：

  • cqgems/customizingfield/components/colorpicker

  • granite/ui/components/foundation/form

NOTE
由于此机制使用JSP，因此i18n和XSS不是现成提供的。 这意味着您需要国际化并规避字符串。 以下目录包含标准实例中的通用字段，您可以将这些字段用作引用：
/libs/granite/ui/components/foundation/form 目录

为组件创建服务器端脚本 creating-the-server-side-script-for-the-component

您的自定义字段应仅覆盖 render.jsp 脚本，其中为组件提供标记。 您可以将JSP（即渲染脚本）视为标记的包装器。

  1. 创建使用 sling:resourceSuperType 要继承的属性：

    /libs/granite/ui/components/foundation/form/field

  2. 覆盖脚本：

    render.jsp

    在此脚本中，您需要生成超媒体标记（即包含超媒体可供使用的扩充标记），以便客户端知道如何与生成的元素进行交互。 这应遵循Granite UI服务器端编码样式。

    自定义时，您 必须 实现是读取表单值（在中初始化） init.jsp):

    code language-none 
    // Delivers the value of the field (read from the content)
ValueMap vm = (ValueMap) request.getAttribute(Field.class.getName());
vm.get("value, String.class");

    有关更多详细信息，请参阅现成Granite UI字段的实施；例如， /libs/granite/ui/components/foundation/form/textfield.

    note note
    NOTE
    目前，JSP是首选的脚本编写方法，因为在HTL中很难实现将信息从一个组件传递到另一个组件（在表单/字段的上下文中非常频繁）。

为组件创建客户端库 creating-the-client-library-for-the-component

要向组件添加特定的客户端行为，请执行以下操作：

  1. 创建类别的clientlib cq.authoring.dialog.

  2. 创建类别的clientlib cq.authoring.dialog 定义 JS/ CSS 里面。

    定义 JS/ CSS 在clientlib中。

    note note
    NOTE
    目前，Granite UI未提供任何可用于直接添加JS行为的现成监听器或挂钩。 因此，要向组件添加其他JS行为，您必须将JS挂接实施到自定义类，然后在标记生成期间将该类分配给组件。
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e