控制复选框

📖 节点概述

用于控制网页中的复选框或单选框状态。可以将指定元素强制选中、取消选中，或者反转当前状态。支持原生 <input> 元素，也兼容各类 UI 框架（如 Element UI、Ant Design）的自定义复选框组件。通过智能检测元素当前状态，避免无用操作，并内置物理点击与 JS 直改两种模式，确保在各种复杂页面中都能起作用。

💡 使用场景：

• 表单自动勾选：批量勾选协议同意、服务条款。
• 多选列表操作：在表格或列表中勾选要操作的条目。
• 权限设置：批量开启或关闭功能开关。
• UI 框架适配：处理 Element UI 的 el-checkbox、Ant Design 的 a-checkbox 等非原生组件。
• 状态同步：确保某个复选框始终保持选中状态，或周期性刷新。

🎮 实战连线指南：如何正确使用它？

节点默认操作当前活动标签页，也支持指定 Tab。需要提供复选框的定位器，可从备选列表中选择或手动输入。动作分为“强制勾选”、“取消勾选”、“反转状态”。操作模式有“物理模拟点击”（推荐）和“JS 直接修改”（仅适用于标准原生 input 元素）。

场景案例：在用户协议页面勾选“同意条款”

1. 打开页面：使用【访问网址】进入注册页面。
2. 定位复选框：找到“同意用户协议”的复选框，记下其选择器（如 #agreeCheckbox 或 .policy-checkbox）。将其填入“元素定位”。
3. 选择动作：动作为“强制勾选”。即使复选框已勾选，节点也会检测并跳过操作，不会出错。
4. 选择操作模式：保持默认“物理模拟点击”，因为它兼容大部分 UI 框架。
5. 串联执行：将上一个步骤的 Exec 输出连接到本节点的 Exec 输入。勾选成功后，Exec 输出可连接【点击元素】节点点击“提交注册”按钮。

场景案例：批量切换表格中复选框的状态

1. 定位全选框：找到表头的全选复选框，动作为“强制勾选”或“反转状态”。
2. 执行勾选：全选后，表格里的复选框都会自动选中。
3. 后续处理：可以连接【点击元素】执行批量操作，如“删除选中项”。

注意：对于单选框（radio），由于浏览器行为不支持取消选中同一组中的选项，使用“取消勾选”时可能需要额外处理；节点会尝试将 checked 置为 false 并触发 change 事件，但结果取决于页面逻辑。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 对于非原生的复选框（如由 <div> 模拟的），务必使用“物理模拟点击”模式，它能正确触发前端框架的响应逻辑。
• 节点在执行前会读取元素当前的选中状态，如果动作目标已达成（如“强制勾选”且元素已选中），则会直接跳过操作并输出提示，不会重复点击。
• 备选定位列表可帮助你为一组类似的复选框准备多个定位器，节点会依次尝试，直到找到一个存在的元素。
• 如果需要同时操作多个复选框，可配合 for列表遍历 节点循环执行，或使用多选逻辑的节点。