文档AEM核心组件指南

按钮组件 button-component-adaptive-forms-core-component

Last update: Thu Nov 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 开发人员
  • 管理员
  • 用户

自适应表单中的按钮是一个 UI 元素，通过它，用户在单击时可开始某个操作。按钮元素可用于提交表单、重置表单或执行其他操作，例如导航到不同的页面或触发自定义代码。可使用按钮核心组件创建按钮。

通过自适应表单规则编辑器，用户可为按钮组件设置多种操作。这些操作包括打开网站、显示或隐藏表单组件、添加面板或组件的实例、提交或重置表单等等。

自适应表单具有单独的“提交”按钮和“重置”按钮组件，用户通过它们可方便地提交或重置表单。可根据特定需求灵活地配置按钮组件以执行这些操作。

用户可以使用自适应表单规则编辑器访问按钮组件支持的完整操作列表。通过规则编辑器，用户可创建由单击按钮时、加载表单时或字段值更改时等多种事件触发的规则。然后，可使用这些规则执行多种操作，如显示或隐藏组件、设置字段值或提交表单。

示例

按钮示例

用途 reasons-to-use-button

有若干原因使得在自适应表单中加入按钮组件有益，这些原因包括：

  • 表单提交：一般使用按钮提交表单，通过该按钮，用户可将其输入的数据发送到服务器以供处理。

  • 表单重置：按钮还可用于重置表单，从而清除用户输入的所有数据。

  • 导航：按钮可用于在表单的不同部分之间或网站上的不同页面之间导航。

  • 事件处理：按钮可用于触发不同的事件，如打开网站、显示/隐藏组件、将面板或组件的实例添加到按钮。

  • 交互性：按钮可用于创建交互式表单。例如，按钮可用于打开模式对话框或切换表单的某个部分。

版本和兼容性 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 即可创建与外部数据源交互的表单，从而为收集和管理数据提供一种无缝的用户体验。

  • 标记为未绑定表单元素：选择此选项可配置未链接到任何架构的表单字段。利用此选项，您可以保存数据而不更新数据源。它还可让您以一种独立于标准数据库集成的自定义方式处理数据。
  • 隐藏组件 - 选中此选项以从表单中隐藏该组件。仍可访问该组件作其他用途，如在规则编辑器中使用它进行计算。当需要存储用户无需看到或直接更改的信息时，此项很有用。
  • 禁用组件 - 选中此选项以禁用该组件。被禁用的组件不再活跃或最终用户无法编辑它。用户可看到但无法修改字段的值。仍可访问该组件作其他用途，如在规则编辑器中使用它进行计算。

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

“帮助内容”选项卡

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

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

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

辅助功能 accessibility

“辅助功能”选项卡

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

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

“设计”对话框 design-dialog

“设计”对话框用于定义和管理按钮组件的 CSS 样式。

“样式”选项卡 styles-tab

自适应表单按钮核心组件支持 AEM 样式系统。

“设计”对话框

  • 默认 CSS 类：可为自适应表单按钮核心组件提供默认 CSS 类。

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

自定义属性

“自定义属性”对话框

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

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

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

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

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

另请参阅 see-also

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