获取手机关联元素
指令说明
获取指定的手机元素的父/子/兄弟/子孙元素，父元素始终只有一个，子元素和兄弟元素可能有多个，当查找到多个匹配的子孙元素时会报错，需要修改元素，以确保始终只能匹配到唯一元素。 子孙元素+index也可以实现获取指定元素的第n个直接子元素
指令输入参数
| 输入参数 | 输入参数类型 | 说明 |
|---|---|---|
| 手机对象 | Phone | 已连接的手机对象 |
| 手机元素 | PhoneElement 或 str （捕获的元素UID，非元素名称，非ms-rpa-id） | 获取该元素的关联元素，可以选择捕获的手机元素也可以选择获取手机元素、获取手机相似元素、获取手机关联元素等指令获取到手机元素 |
| 关联方式 | 枚举项 | 父元素、子元素、兄弟元素、前一个兄弟元素、后一个兄弟元素、子孙元素 |
| 子孙元素 | str | 捕获的手机子孙元素UID，非元素名称，非ms-rpa-id，仅关联方式是子孙元素时需要该参数，会从上面的手机元素开始查找对应子孙元素。祖先元素可以是捕获的元素，也可以是任意的PhoneElement对象 |
| 等待元素时长 | float | 若元素未出现则一直等待，直到元素出现为止，若超过最长等待时间后元素仍未出现则触发错误或者返回空列表，单位：秒 |
指令输出参数
| 输出参数 | 输出参数类型 | 说明 |
|---|---|---|
| 手机元素 | PhoneElement 或 List[PhoneElement] | 关联方式是父元素、前一个兄弟元素、后一个兄弟元素、子孙元素 时类型是PhoneElement，否则是 List[PhoneElement] |
类型定义参考
关联方式说明
| 关联方式 | 说明 |
|---|---|
| 父元素 | 获取当前元素的直接父节点，只返回一个元素 |
| 子元素 | 获取当前元素的直接子节点，通常返回多个元素 |
| 兄弟元素 | 获取当前元素同层级的其他元素，通常返回多个元素 |
| 子孙元素 | 在当前元素内部继续查找指定后代元素，适合从商品卡片、联系人项等容器中提取内部字段 |
相关链接
适用场景
- 当无法唯一定位元素时可以通过关联元素尝试获取期望的元素
- 商品列表中每件商品都有名称和价格，当获取到商品名称后可以通过关联元素获取这件商品对应的价格
提示
需要先开启手机开发者选项并通过数据线连接手机和电脑，参考 连接手机
常见问题
参考手机常见问题