获取相似元素列表(web)

功能说明

功能描述

可通过捕获元素、CSS 选择器或 XPath 定位网页上的一组相似元素，并获取其对象或文本信息

配置项说明

常规

指令输入

• 网页对象TBrowser: 输入一个获取到的或通过'打开网页'函数创建的网页对象

• 定位方式Integer: 选择定位方式。包括默认方式、CSS选择器、XPath选择器

• 目标元素TTarget: 请选择需要操作的目标网页元素。可以从「元素库」中选择一个已捕获的元素，或使用「捕获新元素」功能来获取网页中的新元素作为操作目标。

• CSS选择器string: 输入CSS选择器

• XPath选择器string: 输入XPath选择器

• 关联父元素Boolean: 是否关联父元素。勾选后，在指定父元素内获取相似元素列表

• 父元素TTarget: 请选择父级元素。可以从「元素库」中选择一个已捕获的元素，或使用「捕获新元素」功能来获取网页中的新元素作为操作目标。

• 元素操作Integer: 选择要获取元素对象或元素的其他信息。

  • 获取元素对象：获取与目标元素相似的元素对象，后续可对元素对象进行点击、悬停等操作
  • 获取元素文本内容：获取元素的可见文本内容。
  • 获取元素值：获取元素的value属性值
  • 获取网页链接地址：获取<a>标签(超链接元素)、<img>标签(图像元素)、<video>标签(视频元素)的链接地址
  • 获取元素源代码：获取元素的源代码内容
  • 获取元素属性：获取元素指定属性的值，如'href'、'class'、'id'等
  • 获取元素位置：获取目标元素相对于屏幕左上角或相对于浏览器页面左上角的位置。返回值为字典类型。包含以下键值对：

  {
  "EleHeight": "元素高度",          # 元素的高度
  "EleBottom": "底部",              # 元素的底部距离屏幕或浏览器顶部的距离
  "EleWidth": "元素宽度",           # 元素的宽度
  "EleLeft": "左边",                # 元素的左边距离屏幕或浏览器左边的距离
  "EleTop": "顶部",                 # 元素的顶部距离屏幕或浏览器顶部的距离
  "EleCenterX": "元素中心点横坐标",  # 元素的中心点横坐标
  "EleCenterY": "元素中心点纵坐标",  # 元素的中心点纵坐标
  "EleRight": "右边"                # 元素的右边距离屏幕或浏览器左边的距离

} ```

• 智能识别并补充链接前缀Boolean: 智能识别并补充网页链接的前缀（http://或 https://）。当无法获取链接地址或需补充地址前缀时，可勾选此选项

• 属性名称string: 网页元素的属性名称

• 输出相似元素的个数Boolean: 是否输出相似元素的个数

指令输出

• 保存相似元素列表至TList<TUiElement>: 保存获取到的相似元素对象列表

• 保存相似元素列表信息至TList<String>: 保存获取到的相似元素列表信息

• 保存相似元素个数至Integer: 保存获取到的相似元素个数

高级

• 执行前的延迟(毫秒)Integer: 指令执行前的等待时间

• 等待目标元素存在(毫秒)Integer: 等待指定的目标关联元素存在的超时时间

错误处理

• 打印错误日志Boolean：当指令运行出错时，打印错误日志到【日志】面板。默认勾选。

• 处理方式Integer：

• 终止流程：指令运行出错时，终止流程。

• 忽略异常并继续执行：指令运行出错时，忽略异常，继续执行流程。

• 重试此指令：指令运行出错时，重试运行指定次数指令，每次重试间隔指定时长。

使用示例

流程逻辑描述： 使用【打开网页】指令打开金智维官网 --> 使用【获取相似元素列表(web)】指令获取一组与目标元素相似的元素列表 --> 使用【ForEach列表循环】循环相似元素列表中的每一项 --> 循环体内执行【点击元素(web)】依次点击相似元素

常见错误及处理

无

常见问题解答

无