开关

1. 组件概述

开关是一个数据输入组件，用于在两种状态之间进行切换选择。它以滑动开关的形式呈现，比传统的勾选框更加直观和现代化。开关组件适用于需要用户做出”是/否”、“开启/关闭”等二选一决策的场景，例如功能开关、设置项启用等。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 功能开关。在智能答疑应用中，用户可以通过开关控制是否启用”详细解析”功能。开启时，AI 会给出更详细的解题步骤；关闭时，只给出简洁答案。配置”绑定变量”为”enableDetail”，在”值变化”事件中可以触发工作流，让 AI 根据开关状态调整回答风格。

• 场景二：学习模式切换。在词汇学习应用中，使用开关让用户选择”练习模式”或”测试模式”。可以设置”说明”为”测试模式”，并配置”填充文本”在开启时显示”测试”、关闭时显示”练习”，让用户清楚当前所处的模式。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
绑定变量	开关组件的变量名，用于存储开关的当前状态值。其他组件可以绑定此变量来获取开关状态，调用工作流时此变量的值也会传递给工作流。这是开关组件最核心的配置项。
标题	开关左侧显示的标签文字，用于说明这个开关的用途，如”启用通知”、“显示答案”等。
说明	显示在开关旁边的说明文字，用于补充解释开关的作用。例如开关标题是”高级模式”，说明可以写”开启后显示更多选项”。
填充文本	开启后可以设置开关滑块上显示的文字。包含两个子配置：开启时 - 开关处于开启状态时滑块上显示的文字，如”开”、“是”；关闭时 - 开关处于关闭状态时滑块上显示的文字，如”关”、“否”。适合需要在开关上直接显示状态的场景。
值格式	开启后可以自定义开关在不同状态下存储的值。包含两个子配置：开启时 - 开关开启时存储的值，默认为 true，可以改为其他值如 1、“yes” 等；关闭时 - 开关关闭时存储的值，默认为 false，可以改为其他值如 0、“no” 等。当后端工作流需要特定格式的值时，可以通过此配置调整。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明。
控件提示	在开关控件旁边显示一个小问号图标，鼠标悬停时弹出提示内容。
描述	显示在开关下方的浅色说明文字，用于补充解释该配置项的用途或填写要求。

事件折叠组

配置项	说明
添加事件	支持”值变化”触发事件，当用户切换开关状态时触发。常见用途：根据开关状态控制其他组件的显示/隐藏，或者触发工作流让 AI 根据开关状态调整处理逻辑。

设计

说明折叠组

配置项	说明
位置	设置”说明”文字相对于开关的位置，可选”左边”或”右边”。默认在右边，即开关在左、说明文字在右。如果希望说明文字显示在开关左侧，可以选择”左边”。