控件对象

from ascript.ios.node import Node

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

属性

属性	备注
id	控件ID
_id	控件ID（同id）
label	控件描述
value	控件的值
text	控件文本
name	名称
type	控件类型（同className）
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(dur=0.02)

• 参数

参数	类型	是否必填	说明
dur	float	否	点击持续时间（秒），默认0.02秒

• 示例

#案例:找到汽水音乐图标,并点击
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)

---

点按 tap

直接点击该控件（底层原始点击）

• 函数

.tap()

• 示例

from ascript.ios.node import Selector
node = Selector().label("确定").find()
if node:
    node.tap()

---

滚动控件

按照参数,滚动控件

• 函数

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

• 参数

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

• 返回值

[Node] 控件对象

• 示例

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

if node:
    node.scroll()

---

缩放 pinch

对控件执行缩放手势

• 函数

.pinch(scale, velocity)

• 参数

参数	类型	是否必填	说明
scale	float	是	缩放比例，大于1为放大，小于1为缩小
velocity	float	是	缩放速度

• 示例

from ascript.ios.node import Selector
node = Selector().type("XCUIElementTypeImage").find()
if node:
    node.pinch(2.0, 1.0)  # 放大2倍

---

是否选中 selected

获取控件的选中状态

• 函数

.selected()

• 返回值

[bool] 是否选中

• 示例

from ascript.ios.node import Selector
node = Selector().label("开关").find()
if node:
    print("选中状态:", node.selected())

---

设置控件文本

设置控件的文本

• 函数

.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()

---