极奇策RPA技术教程:设置元素样式 (NodeSetStyle) - 自动化开发与配置详细指南

设置元素样式
📖 节点概述
直接修改网页元素的 CSS 样式或类名,能够动态改变页面的外观。支持批量操作所有匹配的元素,可设置内联样式文本、修改单个 CSS 属性、添加/移除/切换类名,甚至完全移除内联样式。常用于高亮关键信息、显示隐藏元素、调整布局以适应自动化操作。
💡 使用场景:
- 高亮定位的元素:在执行操作前给元素添加红色边框,方便调试时观察。
- 强制显示隐藏内容:移除
display:none或添加display:block !important,让原本隐藏的菜单或选项可见。 - 模拟 UI 状态:添加
active、disabled等类名,触发前端框架的状态样式,绕过复杂的交互逻辑。 - 修复遮挡问题:调整元素的
z-index或position,避免被其他层挡住而无法点击。 - 批量美化截图:在截图前将所有匹配的元素背景设为白色、字体放大,使截图更清晰。
🎮 实战连线指南:如何正确使用它?
节点默认对当前活动标签页操作,也可指定 Tab。需要提供一个元素定位器(支持备选定位列表)。通过“操作模式”选择修改方式,然后填写相应的样式属性或类名。如果勾选“应用到所有匹配元素”,则会批量修改所有满足选择器的元素。
场景案例:强制显示一个被隐藏的“高级选项”面板
- 定位面板:使用【智能定位元素】获取隐藏面板的 CSS 选择器,比如
.advanced-options。 - 设置样式:操作模式选择“设置样式文本”。在“样式文本”输入框中填写
display: block !important;,并勾选“覆盖现有样式”以确保旧的display:none被替换。 - 保留原始样式(可选):如果需要后续恢复,可勾选高级选项中的“保留原始样式以便恢复”,节点会保存修改前的样式到上下文中。
- 串联执行:将前一个步骤的
Exec输出连接到本节点的Exec输入。执行后面板就会显示出来,之后就可以继续点击里面的选项了。
场景案例:给所有待办事项中的已完成项添加删除线
- 定位元素:假设完成项都有类名
.todo-item.completed,使用选择器.todo-item.completed。 - 批量添加类名:操作模式选择“添加类名”,在“类名”输入框中填写
line-through(假设该样式类已在页面中定义),并确保“应用到所有匹配元素”是开启的。 - 执行:所有已完成的待办项文字都会出现删除线。
场景案例:通过设置单个属性来改变背景色
- 操作模式:“设置单个属性”。
- 填写属性:在“属性名”中填
backgroundColor,在“属性值”中填#ffffcc(浅黄色)。 - 应用:所有匹配的元素背景都会变为浅黄色,常用于在循环操作时临时标记当前处理的元素。
与 iframe 配合:如果目标元素位于 iframe 内,可以在高级选项中填写 iframe 的索引(从 0 开始),节点会自动跨域注入样式。
⚙️ 引脚与参数说明
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | 控制流入口,触发后执行样式修改。 |
| Tab | TAB | (可选) 指定操作的标签页,不连则操作当前活动标签页。 |
| 元素定位 | LOCATOR | 目标元素的定位表达式。支持备选定位列表,可动态替换。 |
| 样式文本 | STRING | 当操作模式为“设置样式文本”时,需要提供的完整 CSS 文本(如color: red;)。可连线传入。 |
| 属性名 | STRING | 当操作模式为“设置单个属性”时,需要修改的 CSS 属性名(例如backgroundColor)。 |
| 属性值 | STRING | 对应属性名的值(如#ff0)。 |
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 操作模式 | 下拉选择 | 选择修改样式的方式:<br>• 设置样式文本:直接写入 style.cssText,可一次修改多个属性。<br>• 设置单个属性:修改某个 CSS 属性的值。<br>• 添加/移除/切换类名:操作元素的 class 列表。<br>• 移除内联样式:清除元素的所有内联样式。 |
| 应用到所有匹配元素 | 开关 | 是否对选择器匹配到的所有元素执行操作,默认为开启。关闭时仅操作第一个匹配的元素。 |
| 覆盖现有样式 | 开关 | (仅“设置样式文本”模式) 开启后会替换整个内联样式,而不是追加。 |
| Iframe索引 | 文本输入 | (高级) 如果目标元素在嵌套的 iframe 中,填写 iframe 的索引序列(例如 0,1),节点会穿透到对应层级的 iframe 中去执行。 |
| 等待超时(ms) | 文本输入 | (高级) 等待元素出现的最大时间,超时后将根据忽略报错决定行为。 |
| 重试次数 | 文本输入 | (高级) 操作失败后的重试次数。 |
| 忽略报错 | 开关 | (高级) 开启后,即使修改失败也不会中断流程。 |
| 保留原始样式 | 开关 | (高级) 开启后,会在修改前备份元素的原始内联样式,保存在上下文状态中,供后续可能的恢复操作使用。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | 样式修改完成后触发。 |
| 匹配元素数量 | INT | 实际被修改的元素个数,可用于确认操作范围。 |
| 是否成功 | BOOL | 操作是否成功完成(至少修改了一个元素且无异常)。 |
💎 小贴士:
- 修改样式只是前端视觉变化,不会触发后端逻辑,可以安全地用于调试。
- 使用“切换类名”配合前端框架的状态类(如
.is-disabled)可以轻松切换交互状态。- 如果修改后页面没有刷新,可能因为元素是动态生成的,请配合“等待元素出现”节点使用。
- 如果需要恢复原始样式,请开启“保留原始样式”,之后可通过再次调用本节点并传入备份的样式文本来还原。
- 跨域 iframe 中的样式修改需要正确指定 iframe 索引,并确保目标元素在修改时已加载完成。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

