控件对象

from ascript.ios.node import Node

通过控件选择器 Selector() .find() 或 .find_all() 而获得此对象

属性

属性	备注
_id	控件ID
text	控件的文本
label	控件描述
value	控件的值
name	名称
index	排序
className	控件的类型
rect	控件在屏幕中的位置 rect 属性 rect.left:x坐标 rect.top:y坐标 rect 方法 rect.width():控件的宽度 rect.height():控件的高度 rect.centerX():控件的中心坐标X rect.centerY():控件的中心坐标Y
enabled	是否可以访问
displayed	是否可见
visible	是否可见
accessible	是否可无障碍操作
accessibility_container	是否为无障碍容器

方法

点击

点击该控件

• 函数

.click()

• 示例

#案例:找到汽水音乐图标,并点击
from ascript.ios.node import Selector
node =  Selector().label("汽水音乐").type("XCUIElementTypeIcon").find()

if node:
    # 获取node 控件的父元素
    node.click()

---

长按

长按该控件

• 函数

.tap_hold(duration=1000)

• 参数

参数	类型	是否必填	说明
duration	int	否	点按时长,单位毫秒. 默认1000毫秒

• 示例

#案例:找到汽水音乐图标,并长按2秒
from ascript.ios.node import Selector
node =  Selector().label("汽水音乐").type("XCUIElementTypeIcon").find()

if node:
    # 获取node 控件的父元素
    node.tap_hold(2000)

---

滚动控件

按照参数,滚动控件

• 函数

.scroll(self, direction='visible', distance=1.0)

• 参数

参数	类型	是否必填	说明
direction	str	否	"visible", "up", "down", "left", "right" 其中之一,默认visible:滚动至显示

• 返回值

[Node] 控件对象

• 示例

#案例:滚动至显示到屏幕中
from ascript.ios.node import Selector
node =  Selector().label("汽水音乐").type("XCUIElementTypeIcon").find()

if node:
    node.scroll()

---

滚动控件

按照参数,滚动控件

• 函数

.scroll(self, direction='visible', distance=1.0)

• 参数

参数	类型	是否必填	说明
direction	str	否	"visible", "up", "down", "left", "right" 其中之一,默认visible:滚动至显示

• 返回值

[Node] 控件对象

• 示例

#案例:滚动至显示到屏幕中
from ascript.ios.node import Selector
node =  Selector().label("汽水音乐").type("XCUIElementTypeIcon").find()

if node:
    node.scroll()

---

设置控件文本

设置控件的文本

• 函数

.set_text(self, value)

• 参数

参数	类型	是否必填	说明
value	str	是	要设置的文本

• 返回值

[Node] 控件对象

• 示例

#案例:找到输入框控件,并向其输入自在老师666
from ascript.ios.node import Selector
node =  Selector().type("XCUIElementTypeTextField").enabled(True).find()

if node:
    node.set_text("自在老师666")

---

清空控件文本

设置控件的文本

• 函数

.clear_text()

• 参数

无

• 返回值

[Node] 控件对象

• 示例

#案例:找到输入框控件,并清空其中的文本
from ascript.ios.node import Selector
node =  Selector().type("XCUIElementTypeTextField").enabled(True).find()

if node:
    node.clear_text()

---