按键精灵ios脚本新增元素功能助力辅助工具开发（一）
元素节点功能（iOSElement）
在按键精灵 iOS 新版 APP v2.2.0 中，新增了元素节点功能 iOSElement，该功能包含共 15 个函数。这一功能的出现，为开发者在处理 iOS 应用界面元素时提供了更为精准和高效的方式。通过这些函数，开发者能够更加便捷地定位、操作应用中的各种元素，从而实现更复杂的自动化任务。例如，在自动化测试场景中，可以利用 iOSElement 函数快速找到特定的按钮、文本框等元素，并模拟用户的点击、输入等操作，大大提高测试效率。
下面介绍下5个函数信息：iOSElement.Source、iOSElement.Find、iOSElement.Finds、iOSElement.FindChild、iOSElement.FindChildren
函数名称
iOSElement.Source 获取整个元素节点信息
功能
获取返回包含整个页面元素节点信息的键值表
语法
result = iOSElement.Source()
代码例子：
Dim result
result = iOSElement.Source()
If result["code"] = 0 Then
TracePrint Encode.TableToJson(result["data"])
Else
TracePrint result["msg"]
End If
函数名称
iOSElement.Find 查找并返回第一个符合条件的元素
功能
查找并返回第一个符合条件的元素信息的键值表
语法
result = iOSElement.Find(selector, isRegex)
代码范例
Dim result, selector
RunApp "com.apple.Preferences"
Delay 1000
selector = {"text": "通用"}
result = iOSElement.Find(selector)
If result["code"] = 0 Then
TracePrint Encode.TableToJson(result["data"])
Else
TracePrint result["msg"]
End If
// 使用正则匹配模糊查找
selector = {"text": "通.+"}
result = iOSElement.Find(selector, true)
If result["code"] = 0 Then
TracePrint Encode.TableToJson(result["data"])
Else
TracePrint result["msg"]
End If
函数名称
iOSElement.Finds 查找并返回所有符合条件的元素
功能
查找并返回所有符合条件的元素信息的键值表
语法
result = iOSElement.Finds(selector, isRegex)
代码范例
Dim result, selector
RunApp "com.apple.Preferences"
Delay 1000
selector = {"id": "UITableViewCellContentView"}
result = iOSElement.Finds(selector)
If result["code"] = 0 Then
For i = 1 To Len(result["data"])
TracePrint Encode.TableToJson(result["data"][i])
Next
Else
TracePrint result["msg"]
End If
// 使用正则匹配模糊查找
selector = {"text": "通.+", "id": "UITableViewLabel"}
result = iOSElement.Finds(selector, true)
If result["code"] = 0 Then
For i = 1 To Len(result["data"])
TracePrint result["data"][i]["text"]
Next
Else
TracePrint result["msg"]
End If
函数名称
iOSElement.FindChild 在指定的父元素下查找并返回第一个符合条件的元素
功能
在指定的父元素下查找并返回第一个符合条件的元素信息键值表
语法
result = iOSElement.FindChild(parent, selector, isRegex)
代码范例
Dim result, parent, selector
RunApp "com.apple.Preferences"
Delay 1000
parent = {"id": "UITableViewCellContentView"}
selector = {"id":"UITableViewLabel"}
result = iOSElement.Find(parent)
If result["code"] = 0 Then
result = iOSElement.FindChild(result["data"], selector)
If result["code"] = 0 Then
TracePrint Encode.TableToJson(result["data"])
Else
TracePrint result["msg"]
End If
Else
TracePrint result["msg"]
End If
// 使用正则匹配模糊查找
parent = {"index": 55}
selector = {"text":"[\\u4e00-\\u9fa5]"} '匹配中文
result = iOSElement.Find(parent)
If result["code"] = 0 Then
result = iOSElement.FindChild(result["data"], selector, true)
If result["code"] = 0 Then
TracePrint Encode.TableToJson(result["data"])
Else
TracePrint result["msg"]
End If
Else
TracePrint result["msg"]
End If
函数名称
iOSElement.FindChildren 在指定的父元素下查找并返回所有符合条件的元素
功能
在指定的父元素下查找并返回所有符合条件的元素信息的键值表
语法
result =iOSElement.FindChildren(parent, selector, isRegex)
代码范例
Dim result, parent, selector
RunApp "com.apple.Preferences"
Delay 1000
parent = {"id": "UITableView"}
selector = {"id": "PSTableCell"}
result = iOSElement.Find(parent)
If result["code"] = 0 Then
result = iOSElement.FindChildren(result["data"], selector)
If result["code"] = 0 Then
For i = 1 To Len(result["data"])
TracePrint Encode.TableToJson(result["data"][i])
Next
Else
TracePrint result["msg"]
End If
Else
TracePrint result["msg"]
End If
// 使用正则匹配模糊查找
parent = {"id": "UITableView"}
selector = {"text":"[\\u4e00-\\u9fa5]", "id": "UITableViewLabel"} '匹配中文
result = iOSElement.Find(parent)
If result["code"] = 0 Then
result = iOSElement.FindChildren(result["data"], selector, true)
If result["code"] = 0 Then
For i = 1 To Len(result["data"])
TracePrint result["data"][i]["text"]
Next
Else
TracePrint result["msg"]
End If
Else
TracePrint result["msg"]
End If