当前页面数据, 可直接赋值
在当前页面查询元素是否存在
名称 | 类型 | 默认值 | 说明 |
selector | str | Not None | css选择器或以/或//开头的xpath |
max_timeout | int | 10 | 超时时间,单位 s |
inner_text | str | None | 通过控件内的文字识别控件 |
text_contains | str | None | 通过控件内的文字模糊匹配控件 |
value | str | None | 通过控件的 value 识别控件 |
xpath | str | None | 显式指定xpath |
获取页面元素
名称 | 类型 | 默认值 | 说明 |
selector | str | Not None | CSS选择器或以/或//开头的XPath |
inner_text | str | None | 通过控件内的文字识别控件 |
text_contains | str | None | 通过控件内的文字模糊匹配控件 |
value | str | None | 通过控件的 value 识别控件 |
max_timeout | int | 0 | 超时时间,单位 s |
xpath | str | None | 显式指定XPath, 小程序基础库2.19.5后支持 |
获取一组元素
名称 | 类型 | 默认值 | 说明 |
selector | str | Not None | css选择器或以/或//开头的xpath |
max_timeout | int | 0 | 超时时间,单位 s |
inner_text | str | None | 通过控件内的文字识别控件, xpath暂不支持 |
text_contains | str | None | 通过控件内的文字模糊匹配控件, xpath暂不支持 |
value | str | None | 通过控件的 value 识别控件, xpath暂不支持 |
index | int | -1 | index==-1: 获取所有符合的元素, index>=0: 获取前index+1符合的元素 |
xpath | str | None | 显式指定xpath, 小程序基础库2.19.5后支持 |
滚动到指定高度
名称 | 类型 | 默认值 | 说明 |
scroll_top | int | Not None | 高度,单位 px |
duration | int | 300 | 滚动动画时长,单位 ms |
等待直到指定的条件成立, 条件可以是页面元素, 也可以是自定义的函数或者是需要等待的时间(单位秒)
名称 | 类型 | 默认值 | 说明 |
condition | int | str | function |
max_timeout | int | 10 | 超时时间,单位 s |
查找一个元素
名称 | 类型 | 默认值 | 说明 |
selector | str | Not None | 选择器 |
inner_text | str | None | 通过控件内的文字识别控件 |
text_contains | str | None | 通过控件内的文字模糊匹配控件 |
value | str | None | 通过控件的 value 识别控件 |
max_timeout | int | 0 | 超时时间,单位 s |
查找一组元素
名称 | 类型 | 默认值 | 说明 |
selector | str | Not None | 选择器 |
max_timeout | int | 0 | 超时时间,单位 s |
inner_text | str | None | 通过控件内的文字识别控件 |
text_contains | str | None | 通过控件内的文字模糊匹配控件 |
value | str | None | 通过控件的 value 识别控件 |
index | int | -1 | index==-1: 获取所有符合的元素, index>=0: 获取前index+1符合的元素 |
获取元素属性
点击元素
在tap()之前检查元素pointer-events样式是否为none 示例代码如下:
长按元素
移动元素(触发元素的 touchstart、touchmove、touchend 事件)
名称 | 类型 | 默认值 | 说明 |
x_offset | int | Not None | x 方向上的偏移,往右为正数,往左为负数 |
y_offset | int | Not None | y 方向上的偏移,往下为正数,往上为负数 |
move_delay | int | 350 | 移动前摇,ms |
smooth | bool | False | 平滑移动 |
获取元素的样式属性
名称 | 类型 | 默认值 | 说明 |
names | str | list | Not None |
元素滚动
基础库v2.23.4版本后支持
名称 | 类型 | 默认值 | 说明 |
top | int | None | x 轴上滚动的距离 |
left | int | None | y 轴上滚动的距离 |
input & textarea 组件输入文字
IDE上不会改变element上的value属性,建议使用变化的Page.data/hook绑定的input方法判断是否生效
名称 | 类型 | 默认值 | 说明 |
text | str | None | 输入文本 |
欢迎光临 云裂变营销网 (https://www.yunliebian.com/yingxiao/) | Powered by Discuz! X3.4 |