按键精灵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