按钮点选

1. 组件概述

按钮点选是一个数据输入组件，以按钮组的形式展示选项供用户选择。与下拉框或单选框相比，按钮点选的选项更加醒目直观，所有选项一目了然，用户无需展开即可看到全部可选内容。该组件支持单选和多选两种模式，适用于选项数量较少（通常 2-5 个）且需要突出展示的选择场景。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 对话模式切换。在智能问答应用中，用户可以通过按钮点选在”简洁回答”、“详细解释”、“举例说明”三种模式间切换。选中的模式会传递给工作流，AI 根据不同模式调整回答风格。建议开启”可多选”让用户同时选择多种回答风格。
• 场景二：知识问答难度选择。在学习辅导类应用中，使用按钮点选让学生选择题目难度（如”入门”、“进阶”、“挑战”）。选项以按钮形式排列，视觉上更加清晰，学生可以快速做出选择。

加载中...

查看 JSON

复制 JSON

3. 功能配置

高级

基本折叠组

配置项	说明
绑定变量	组件的变量名，用户选中的值会以此变量名存储。其他组件可以绑定此变量来显示其值，调用工作流时此变量的值也会传递给工作流。
标题	显示在组件左侧的标签文字，用于说明该选择项的用途，如”回答模式”、“难度等级”。
可多选	开启后允许用户同时选中多个选项。默认为单选模式，即选中新选项会自动取消之前的选择。
描述	显示在组件下方的浅色说明文字，用于补充解释该配置项的用途或选择建议。

按钮管理折叠组

配置项	说明
角标	为按钮添加角标配置。开启后可以在按钮右上角显示小标记（如数字或小红点），适用于提示某个选项有更新或推荐的场景。
数据	配置可供选择的选项列表。每个选项包含显示文本和对应的值。可以手动添加静态选项，也可以绑定变量动态获取选项数据。

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见，可以设置为始终隐藏或根据条件动态控制。
隐藏	控制组件是否隐藏，与”可见”相反。
禁用	控制组件是否禁用。禁用后按钮变灰且不可点击，适用于某些条件下不允许用户修改选择的场景。
静态展示	开启后组件变为只读的纯文本展示模式，仅显示当前选中的值，不可编辑。适用于详情页或确认页面。

校验折叠组

配置项	说明
校验规则	配置表单校验规则，如必填校验。开启必填后，用户必须选择至少一个选项才能提交表单。

设计

基本折叠组

配置项	说明
布局	控制标题和按钮组的排列方式。可选：内联（标题和按钮在同一行）、水平（标题在左，按钮在右，可调整比例）、正常（标题在上，按钮在下）。
平铺模式	开启后按钮会占满父容器宽度，各按钮宽度自适应分配。适用于需要按钮整齐排列、视觉上更加统一的场景。仅在非内联布局下生效。
控件尺寸	按钮的大小，可选：极小、小、中、大。根据页面整体风格和按钮重要程度选择合适的尺寸。
按钮样式	未选中状态下按钮的视觉风格。可选：默认（灰色）、主要（蓝色）、成功（绿色）、警告（橙色）、危险（红色）、链接等。一般使用”默认”样式。
按钮选中样式	选中状态下按钮的视觉风格。默认为”主要”（蓝色），使选中的按钮更加醒目。可根据页面风格调整为其他颜色。

事件

事件折叠组

配置项	说明
添加事件	支持”值变化”触发事件，当用户选择或取消选择选项时触发。常见用途：在值变化时调用工作流，让 AI 根据用户选择的选项实时调整输出内容；或者根据选择结果控制其他组件的显示/隐藏。