跳转到内容

元素聚焦

节点类型 browser_focusElement

功能说明

将键盘焦点移到指定元素。

客户端配置界面

元素聚焦节点的客户端配置界面

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。

输入字段

以下字段位于 data.browserUi.inputs。

字段类型或取值Schema 必填执行默认值说明与边界
selectorType"selector" / "element" / "frame"(支持变量引用)否"selector"元素来源 编辑器初值 "selector"
framestring否—iframe 框架变量
elementstring否—元素变量
selectorRadio"CSS" / "XPath"(支持变量引用)否"CSS"定位方式 编辑器初值 "CSS"
selectorstring否—选择器
serialType"fixed" / "randomInterval"(支持变量引用)否"fixed"如果匹配到多个元素对象时 编辑器初值 "fixed"
serialWorkflowNumber否1元素序号; integer; minimum after resolution: 1 编辑器初值 1
serialMinWorkflowNumber否—最小序号; integer; minimum after resolution: 1
serialMaxWorkflowNumber否—最大序号; integer; minimum after resolution: 1
postWaitMsWorkflowNumber否200完成后等待时长(毫秒); minimum after resolution: 0 编辑器初值 200

条件与边界

  • 定位规则: selectorType=selector 要求 selector;frame 要求 frame+selector;element 要求前序 ElementRef 引用。serial 从 1 开始;randomInterval 使用 serialMin/serialMax,最小值不能大于最大值;先等待选择器匹配到元素,再一次性取序号:区间上限按实际匹配数截断;固定序号或区间下限大于匹配数时立即返回 ELEMENT_NOT_FOUND(reason=range,details.field 为 serial 或 serialMin),不操作页面。
  • 校验错误码 RPA_NODE_INPUT_INVALID

输入引用

字段允许的形式
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
postWaitMsliteral, numericExpression

输出字段

输出字段类型或取值
tabIdstring
elementElementRef
isFocusedboolean

按契约用 ${nodeId.data.field} 引用公开字段。

JSON 示例

可放入流程 nodes 数组或其他节点 blocks 中的完整节点对象。

{
  "id": "focus_email",
  "type": "browser_focusElement",
  "data": {
    "title": "聚焦邮箱输入框",
    "browserAction": "focusElement",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "input[name=email]",
        "postWaitMs": 200
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

返回节点目录