文档AEM 6.4Forms 指南

在HTML5表单中创建自定义外观 create-custom-appearances-in-html-forms

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

创建对象：

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

您可以将自定义小组件插入到移动设备Forms。 您可以扩展现有的jQuery小组件，或使用外观框架开发您自己的自定义小组件。 XFA引擎使用各种小组件，请参阅 自适应表单和HTML表单的外观框架5 以了解详细信息。

默认和自定义小组件的示例
图： 默认和自定义小组件的示例

将自定义小组件与HTML5表单集成 integrating-custom-widgets-with-html-forms

创建用户档案  create-a-profile-nbsp

您可以创建配置文件或选择现有配置文件以添加自定义小组件。 有关创建用户档案的更多信息，请参阅 创建自定义用户档案.

创建小组件 create-a-widget

HTML5表单提供了小组件框架的实施，可扩展以创建新小组件。 实施是一个jQuery小组件 abstractWidget 可以扩展为编写新小组件。 只有扩展/覆盖上述功能，新小组件才能正常工作。

函数/类
描述
render
呈现函数返回小组件默认HTML元素的jQuery对象。 默认HTML元素应为可聚焦类型。 例如， <a>, <input>和 <li>. 返回的元素将用作$userControl。 如果$userControl指定了上述约束，则AbstractWidget类的函数可按预期工作，否则某些常用API（焦点、单击）需要更改。
getEventMap
返回将HTML事件转换为XFA事件的映射。
{
模糊：XFA_EXIT_EVENT，
}
此示例显示模糊是HTML事件，XFA_EXIT_EVENT是相应的XFA事件。
getOptionsMap
返回一个映射，其中提供了在更改选项时要执行的操作的详细信息。 键是提供给小组件的选项，值是每当检测到该选项发生更改时调用的函数。 小组件为所有常用选项（value和displayValue除外）提供处理程序
getCommitValue
每当小组件的值保存在XFAModel中（例如，在textField的退出事件中）时，小组件框架便会加载该函数。 实施应返回小组件中保存的值。 处理程序将为选项提供新值。
showValue
默认情况下，在XFA中，输入事件时，将显示字段的rawValue。 调用此函数时，会向用户显示rawValue。
showDisplayValue
默认情况下，在退出事件时的XFA中，将显示字段的formattedValue 。 调用此函数时，会向用户显示带格式的值。

要创建您自己的小组件，请在上面创建的配置文件中，包含JavaScript文件的引用，该文件包含被覆盖的函数和新添加的函数。 例如， sliderNumericFieldWidget 是用于数字字段的小组件。 要在用户档案的标题部分中使用小组件，请加入以下行：

window.formBridge.registerConfig("widgetConfig" , widgetConfigObject);

使用XFA脚本引擎注册自定义小组件  register-custom-widget-with-xfa-scripting-engine-nbsp

在自定义小组件代码准备就绪后，使用 registerConfigAPI 表单桥. 它将widgetConfigObject作为输入。

window.formBridge.registerConfig("widgetConfig",
        {
        ".<field-identifier>":"<name-of-the-widget>"
        }
    );

widgetConfigObject widgetconfigobject

小组件配置作为JSON对象（键值对的集合）提供，其中键标识字段，值表示要用于这些字段的小组件。 配置示例如下所示：

*{*

*“identifier1” : “customwidgetname”,
“identifier2” : “customwidgetname2”,
..
}*

其中，“identifier”是jQuery CSS选择器，它表示特定字段、特定类型的字段集或所有字段。 下面列出了不同情况下标识符的值：

标识符类型
标识符
描述
名称为“字段名称”的特定字段
标识符："div.fieldname"
所有名为“fieldname”的字段均使用小组件呈现。
所有类型为“type”的字段（其中类型为NumericField、DateField等）。:
标识符："div.type"
对于Timefield和DateTimeField，类型为文本字段，因为这些字段不受支持。
所有字段
标识符："div.field"
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da