日期选取器组件 date-picker-adaptive-forms-core-component

自适应表单中的日期选取器组件是一个用户界面元素,通过它,用户可从日历中选择日期或手动输入特定格式的日期。日期选取器组件可以配置为具有不同的格式、验证和默认值。

示例

示例

用途 reasons-to-use-drop-date-picker

有若干原因使得在自适应表单中加入日期选取器有益,这些原因包括:

  • 方便:通过日期选取器组件,用户可轻松地从日历中选择日期,而无需在文本字段中手动输入日期。这可以节省时间并减少错误。

  • 用户体验:可使用日期选取器组件为用户提供一种清晰而直观的方式以选择日期,使得表单更方便用户使用。

  • 数据分析:日期选取器组件可用于从各种来源收集数据并进行分析,或将其用作进一步处理的输入。

  • 事件管理:日期选取器组件可在事件管理网站中用于选择事件日期。

  • 预订和预约:日期选取器组件可在预订和预约网站中用于选择入住和退房日期。

  • 日期格式:日期选取器组件可用于固定显示和输入日期的格式。这可确保日期格式在整个表单中保持一致,以确保一致的用户体验。

版本和兼容性 version-and-compatibility

作为 Cloud Service 核心组件 2.0.4 和 AEM 6.5.16.0 Forms 或更高版本核心组件 1.1.12 的一部分,自适应表单可折叠项面板核心组件于 2023 年 2 月发布。下表显示所有支持的版本、AEM 兼容性以及相应文档的链接:

组件版本
AEM as a Cloud Service
AEM 6.5.16.0 Forms 或更高版本
v1

版本 2.0.4 和更高版本兼容
兼容
版本 1.1.12 及更高但低于 2.0.0 的版本。

有关核心组件版本的信息,请参阅核心组件版本文档。

技术详细信息 technical-details

可在 GitHub 上的技术文档中获得关于自适应表单日期选取器核心组件的最新信息。有关开发核心组件的更多信息,请参阅核心组件开发人员文档

“配置”对话框 configure-dialog

通过“配置”对话框,可轻松地自定义您为访客提供的日期选取器体验。还可轻松地定义日期选取器选项,从而营造一种无缝的用户体验。

“基本”选项卡 basic-tab

“基本”选项卡

  • 名称 - 名称在规则编辑器中唯一标识组件。名称字符串中不允许使用特殊字符和空格。

  • 标题 - 标题是一个字符串,它显示在自适应表单中某个组件的顶部。标题在自适应表单的树结构中唯一地标识该组件。如果不添加标题,则显示该组件的名称而非标题文本。

  • 允许标题为富文本:此功能使用户能够格式化纯文本标题,结合粗体、斜体、下划线文本、各种字体、字体大小、颜色和附加选项等功能,以增强视觉呈现和定制效果。它提供了更大的灵活性以及对创作的控制度,使标题在文档、网站或应用程序中脱颖而出。
    选中​ 允许标题为富文本 ​复选框后,可以看到格式化选项,用于设置组件标题的样式。要访问所有可用的格式选项,您可以点击 全屏图标 选项卡。

    富文本支持

  • 隐藏标题 - 选中此选项以在自适应表单中隐藏该组件类型的标题。

  • 占位符文本 - 表单组件中的占位符文本是指在输入字段中显示的短标签或提示,用于提示用户需要在该字段中输入什么类型的信息。当用户开始向该字段中键入时,占位符文本消失,如果将该字段留空,则占位符文本重新出现。它为用户提供视觉提示,但不充当该字段的永久标签或值。

  • 绑定引用 - 绑定引用是对存储在外部数据源中并在表单中使用的数据元素的引用。通过绑定引用,可动态地将数据绑定到表单字段,以使表单可显示来自数据源的最新数据。例如,可使用绑定引用,根据输入到表单中的客户 ID,在该表单中显示该客户的姓名和地址。还可使用绑定引用,通过输入到表单中的数据更新数据源。这样通过 AEM Forms 即可创建与外部数据源交互的表单,从而为收集和管理数据提供一种无缝的用户体验。

  • 标记为未绑定表单元素:选择此选项可配置未链接到任何架构的表单字段。利用此选项,您可以保存数据而不更新数据源。它还可让您以一种独立于标准数据库集成的自定义方式处理数据。

  • 隐藏组件 - 选中此选项以从表单中隐藏该组件。仍可访问该组件作其他用途,如在规则编辑器中使用它进行计算。当需要存储用户无需看到或直接更改的信息时,此项很有用。

  • 禁用组件 - 选中此选项以禁用该组件。被禁用的组件不再活跃或最终用户无法编辑它。用户可看到但无法修改字段的值。仍可访问该组件作其他用途,如在规则编辑器中使用它进行计算。

  • 只读 - 选中此选项以使组件不可编辑。用户可看到但无法修改字段的值。仍可访问该组件作其他用途,如在规则编辑器中使用它进行计算。

  • 默认日期 - 通过此选项,可将日期添加到表单字段。输入的日期默认显示在组件的位置。如果用户没有输入日期,则在提交表单时提交此值。如果选中了​ 已禁用的组件 ​或​ 只读组件,则在屏幕上显示默认日期,并在提交表单时提交默认日期。

“验证”选项卡 validation-tab

“验证”选项卡

  • 必需 - 如果要在自适应表单中显示该组件,请选中此选项。选择此选项后,您必须先做出选择,之后才能继续提交表单。选中此选项后,无法在​ 基本 ​选项卡中选择​ 隐藏组件 ​或​ 禁用组件

  • 错误消息 - 通过此选项,可输入如果选中了​ 必需 ​复选框并将表单字段留空,所显示的消息。

  • 脚本验证消息 - 通过此选项,可输入如果脚本验证失败,所显示的消息。

  • 最早日期 - 通过此选项,可输入要求的最早日期。如果输入的日期比在“最早日期”中指定的日期更早,则在屏幕上显示一条错误消息。通过​ 最早日期错误消息 ​对话框,可添加自定义错误消息。

  • 最早日期错误消息 - 通过​ 最早日期错误消息 ​对话框,可添加如果输入的日期比在​ 最早日期 ​选项中指定的日期更早,则显示的自定义错误消息。

  • 排除最小日期 - 通过此选项,可省略给定日期范围或日期组中的最小日期。

  • 最晚日期 - 通过此选项,可输入要求的最晚日期。如果输入的日期比在“最晚日期”中指定的日期更晚,则在屏幕上显示一条错误消息。通过​ 最晚日期错误消息 ​对话框,可添加自定义错误消息。

  • 最晚日期错误消息 - 通过​ 最晚日期错误消息 ​对话框,可添加如果输入的日期比在​ 最晚日期 ​选项中指定的日期更晚,则显示的自定义错误消息。

  • 排除最大日期 - 通过此选项,可省略给定日期范围或日期组中的最大日期。

“帮助内容”选项卡 help-content-tab

“帮助内容”选项卡

  • 简短描述 - 简短描述是一段简短的文字说明,其中提供关于特定表单字段的用途的其他信息或阐述。它帮助用户了解应将什么类型的数据输入到字段中,并可提供准则或示例以帮助确保所输入的信息有效且符合预期的标准。默认情况下,简短描述保持隐藏状态。启用​ 始终显示简短描述 ​选项以在组件下方显示它。

  • 始终显示简短描述 - 启用该选项以在组件下方显示简短描述。

  • 帮助文本 - 帮助文本是指提供给用户以帮助其正确填写表单字段的其他信息或指导。当用户单击组件旁的“帮助”图标 (i) 时显示它。帮助文本提供比表单字段的标签或占位符文本更详细的信息,旨在帮助用户了解该字段的要求或限制。它还可提供建议或示例,以使填写表单更轻松且更准确。

“辅助功能”选项卡 accessibility-tab

“辅助功能”选项卡

  • 屏幕阅读器文本 - 屏幕阅读器文本是指专供由视障人士使用的屏幕阅读器等辅助技术读取的附加文本。此文本提供表单字段用途的音频描述,并可包括关于字段的标题、描述、名称和任何相关消息(自定义文本)的信息。屏幕阅读器文本帮助确保包括视障用户在内的所有用户均可访问表单,并使其完整地了解表单字段及其要求。

    • 自定义文本:选中此选项以将自定义文本用于 ARIA 辅助功能标签。选中此选项将显示“自定义文本”对话框。可在“自定义文本”对话框中添加相关信息。
    • 描述:选中此选项以将描述用于 ARIA 辅助功能标签。
    • 标题:选中此选项以将标题用于 ARIA 辅助功能标签。
    • 名称:选中此选项以将名称用于 ARIA 辅助功能标签。
    • :如果不想为 ARIA 辅助功能标签添加任何内容,请选中此选项。

“格式”选项卡 format-tab

“格式”选项卡

  • 显示格式 - 它表示向用户显示的日期格式。通过​ 类型 ​选项,用户可选择日期格式。还可使用​ 类型 ​下拉菜单中的​ 自定义 ​选项自定义日期格式。

  • 编辑格式 - 它表示用户编辑日期时可以采用的日期格式。通过​ 类型 ​选项,用户可选择日期格式。还可使用​ 类型 ​下拉菜单中的​ 自定义 ​选项自定义日期格式。

  • 格式错误消息:此选项允许您输入当输入的日期格式不正确时在屏幕上显示的消息。

  • 语言:此功能用于格式化特定字段。当用户从​ 类型 ​下拉菜单中选择任何语言选项时,IETF BCP 47 语言标记 ​选项就会出现在面板中。将自适应表单翻译成特定语言时,您可以选择字段格式的语言。

默认情况下,语言集不可见,但用户可以通过更新模板策略输入自定义 IETF BCP 47 语言标记

  1. 在模板编辑器中打开与自适应表单关联的相应模板。

  2. 从下拉菜单中选择 datepicker-default-policy 为现有策略。

    日期选择器模板策略

  3. 单击​ 完成

    note note
    NOTE
    如需了解如何将自适应表单翻译至特定语言环境的更多信息,请点击此处

“设计”对话框 design-dialog

“设计”对话框用于定义和管理日期选取器组件的 CSS 样式。

“样式”选项卡 styles-tab

该选项卡用于定义和管理组件的 CSS 样式。自适应表单日期选取器核心组件支持 AEM 样式系统

“样式”选项卡

  • 默认 CSS 类:可为自适应表单日期选取器核心组件提供默认 CSS 类。

  • 允许使用的样式:可通过提供名称和表示样式的 CSS 类而定义样式。例如,您可以创建一个名为“bold text”的样式,并提供 CSS 类“font-weight: bold”。可使用这些样式或将其应用于自适应表单编辑器中的自适应表单。要应用样式,请在自适应表单编辑器中选择要将样式应用于的组件,导航到“属性”对话框,然后从​ 样式 ​下拉列表中选择所需的样式。如果您需要更新或修改样式,只需返回“设计”对话框,在“样式”选项卡中更新样式,然后保存更改。

自定义属性

“自定义属性”对话框

通过自定义属性,您可使用表单模板将自定义属性(键值对)关联到自适应表单核心组件。自定义属性反映在组件 Headless 演绎版的属性部分中。它可让您创建根据自定义属性值进行调整的动态表单行为。例如,开发人员可以为移动、桌面或 Web 平台设计 Headless 表单组件的各种演绎版,从而大大提升各种设备上的用户体验。

  • 组名称:您可以提供名称来标识自定义属性组。您可以添加、删除或重新排列多个自定义属性组。添加自定义属性组后,可看到以下选项:

    • 键值对:您可以通过单击“添加”按钮,为每个自定义属性组添加多个自定义属性名称和自定义属性值。

    • 删除:点按或单击此项可删除自定义属性名称和自定义属性值。

    • 重新排列:点按或单击并拖动可重新排列自定义属性名称和自定义属性值的顺序。

“格式”选项卡 formats-tab

通过“格式”选项卡,可指定默认和自定义日期格式。

“格式”选项卡

相关文章 related-articles

另请参阅 see-also

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c