Appearance
获取关联元素(web)
指令说明
在指定的浏览器对象 browser_obj 中获取 element_data 关联的 relative_type,将结果输出为元素对象 element_obj
功能描述
本指令用于根据已有元素获取与其有关系的元素,例如父子关系,兄弟关系的元素,不具备关系的无法获取
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 浏览器对象 | Browser | 是 | 操作的浏览器 |
| 元素对象 | WebPick | 是 | 作为锚点的元素,只能是单个元素对象,不能是相似元素 |
| 关联类型 | Enum | 是 | 选择关联类型,例如:兄弟元素、父级元素、子级元素等 |
| 子元素类型 | Enum | 否 | 关联类型为子元素时有效,子元素的类型,所有子元素/第几个子元素/子元素的xpath/最后一个子元素 |
| 子元素xpath | String | 否 | 关联类型为子元素时有效,子元素的xpath以/开始,内部已经默认加上.,即相对于元素对象的xpath路径,当前仅返回一个元素,即使xpath能获取到多个元素也只会返回第一个 |
| 子元素位置 | Int | 否 | 关联类型为子元素时有效,子元素位置,例如:0表示第一个子元素 |
| 兄弟元素类型 | Enum | 否 | 关联类型为兄弟元素时有效,可选所有兄弟元素/下一个兄弟元素/上一个兄弟元素 |
返回值
返回单个元素对象或者元素对象列表,根据条件返回 element_obj
使用示例
示例1:基本用法

注意事项
- 获取相对元素时,需要确保锚点元素一定是存在的
- 填写子元素xpath时需要注意不要添加相对符号./,该逻辑已经在指令中集成,添加了相当于 锚点元素 ../子元素路径
- 如需相对某个元素的子元素,使用子元素xpath 获取多个元素时,应使用相似元素元素指令获取相似元素列表(web) 实现相关逻辑,而不是使用该能力
- 执行该指令时,请先安装并启用对应的浏览器插件
常见问题
html元素获取父元素时报错
解答:html 为根元素,没有父元素,同理也没有兄弟元素