自适应表单切换组件 switch-adaptive-forms-core-component

用户交互：用户可以通过单击或点按切换组件来与之交互。

状态：切换组件有两种状态：ON 和 OFF。切换组件的初始状态取决于默认设置或它控制的功能的当前状态。

可视表示形式：切换组件通过更改颜色或位置来直观地反映其当前状态。

控制功能：切换组件用于启用或禁用 AEM 表单中的特定功能。例如，它允许用户打开或关闭某项功能。

名称 - 可在表单和规则编辑器中通过唯一名称轻松地标识表单组件，但该名称不得包含空格或特殊字符。

标题 - 通过组件的标题，可轻松地标识表单中的组件，默认情况下，标题显示在该组件的旁边。如果不添加标题，则不会显示该组件。

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

隐藏标题 - 选中此选项可隐藏该组件的标题。

保留“取消选中”状态值 - 选中此选项可让您指定未选择切换组件时要返回的值。

选项 - 指定每个选项的数据值和显示文本。

• 启用时的数据值 - 指定在自适应表单中启用切换时要提交的值。
• 启用时的显示文本 - 指定在自适应表单中启用切换时要显示为标签的文本。
• 禁用时的数据值 - 指定未在自适应表单中启用切换时要提交的值。此选项仅在启用​ 保留“取消选中”状态值 ​切换时可见。
• 禁用时的显示文本 - 指定未在自适应表单中启用切换时要显示为标签的文本。此选项仅在启用​ 保留“取消选中”状态值 ​切换时可见。

您还可以使用​ 允许选项为富文本 ​来格式化切换组件的选项。

选中​ 允许选项为富文本 ​复选框后，格式化选项变得可见，以设置组件选项的样式。要访问所有可用的格式选项，您可以点击Fullscreen 选项卡。

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

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

提交的值的数据类型：此选项指定在选择任何选项时发送的值的数据类型。如果将​ 提交的值的数据类型 ​设置为 Number，而您在​ 选项 ​选项卡上将字符串数据添加到​ 数据值，则屏幕显示一条 Value type mismatch 错误消息。

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

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

默认值：通过此选项，可在表单字段中添加默认值。如果选中了​ 已禁用的组件 ​或​ 只读组件，则在屏幕上显示默认值。如果用户未在表单字段中输入值，则在提交表单时提交此值。

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

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

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

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

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

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

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

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

隐藏标签 - 选中此选项可隐藏切换组件的标签。

显示标签 - 选中此选项可显示切换组件的标签。

默认 CSS 类：可为自适应表单切换核心组件提供默认 CSS 类。

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

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

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

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

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