按键精灵ios脚本新增元素功能助力辅助工具开发（二）
元素节点功能（iOSElement）
在按键精灵 iOS 新版 APP v2.2.0 中，新增了元素节点功能 iOSElement，该功能包含共 15 个函数。这一功能的出现，为开发者在处理 iOS 应用界面元素时提供了更为精准和高效的方式。通过这些函数，开发者能够更加便捷地定位、操作应用中的各种元素，从而实现更复杂的自动化任务。例如，在自动化测试场景中，可以利用 iOSElement 函数快速找到特定的按钮、文本框等元素，并模拟用户的点击、输入等操作，大大提高测试效率。
下面介绍下5个函数信息：iOSElement.FindParent、iOSElement.FindSibling、iOSElement.SetText、iOSElement.Click、iOSElement.ScrollToOffset
函数名称
iOSElement.FindParent 获取指定元素的父元素
功能
获取指定元素的父元素信息的键值表
语法
result = iOSElement.FindParent(subElement)
代码范例
Dim result, subelement
RunApp "com.apple.Preferences"
Delay 1000
subElement = {"id": "PSTableCell"}
result = iOSElement.Find(subElement)
If result["code"] = 0 Then
result = iOSElement.FindParent(result["data"])
If result["code"] = 0 Then
TracePrint Encode.TableToJson(result["data"])
Else
TracePrint result["msg"]
End If
Else
TracePrint result["msg"]
End If
函数名称
iOSElement.FindSibling 获取指定元素的所有同层级元素
功能
获取指定元素的所有同层级元素信息的键值表
语法
result = iOSElement.FindSibling(element,selector)
代码范例
Dim result, selector
RunApp "com.apple.Preferences"
Delay 1000
selector = {"id": "PSTableCell"}
result = iOSElement.Find(selector)
If result["code"] = 0 Then
// 获取当前层级的所有兄弟节点
result = iOSElement.FindSibling(result["data"])
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
// 查找指定条件的兄弟节点
result = iOSElement.FindSibling(result["data"], {"text":"隐私", "type":"UITableViewLabel"})
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
函数名称
iOSElement.SetText 设置指定输入框元素的内容
功能
设置指定输入框元素的内容，支持完整目标元素节点或者元素查找条件，如查找到多个元素则只操作第一个元素
语法
result = iOSElement.SetText(element, text, isClear)
代码范例
Dim result, selector
RunApp "com.apple.Preferences"
Delay 1000
selector = {"id": "UISearchBarTextField"}
result = iOSElement.Find(selector)
If result["code"] = 0 Then
result = iOSElement.SetText(result["data"], "通用")
If result["code"] = 0 Then
TracePrint "输入成功"
Else
TracePrint result["msg"]
End If
Else
TracePrint result["msg"]
End If
函数名称
iOSElement.Click 点击指定的元素节点
功能
点击指定的元素节点，支持完整目标元素节点或者元素查找条件，如查找到多个元素则只操作第一个元素
语法
result = iOSElement.Click(element)
代码范例
Dim result, selector
RunApp "com.apple.Preferences"
Delay 1000
selector = {"text": "通用"}
result = iOSElement.Find(selector)
If result["code"] = 0 Then
result = iOSElement.Click(result["data"])
If result["code"] = 0 Then
TracePrint "点击成功"
Else
TracePrint result["msg"]
End If
Else
TracePrint result["msg"]
End If
函数名称
iOSElement.ScrollToOffset 将可滚动视图元素滚动到指定的方位
功能
将可滚动视图元素滚动到指定的方位
语法
result = iOSElement.ScrollToOffset(selector,x,y,animated)
代码范例
Dim result, selector
RunApp "com.apple.Preferences"
Delay 1000
selector = {"id": "UITableView"}
result = iOSElement.ScrollToOffset(selector, 0, 1000)
If result["code"] = 0 Then
TracePrint "滚动成功"
Else
TracePrint result["msg"]
End If