节点方法 (node)

---

1. 根据节点的id属性匹配 (id)

说明: 根据节点的id属性匹配

函数: id(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的具体控件的id

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = id("com.nx.nxprojit:id/detail_tv_title")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

2. 根据id包含的部分字符串匹配 (idContains)

说明: 根据id包含的部分字符串匹配

函数: idContains(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的模糊的包含id某一段字符串的内容

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = idContains("detail_tv_title")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

3. 根据id的前缀去匹配 (idStartsWith)

说明: 根据id的前缀去匹配

函数: idStartsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的id的前缀

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = idStartsWith("com.nx.nxprojit")
local node = sel:findOne(10000)
if node~= nil then
	print(node:id())
end

---

4. 根据id的后缀去匹配 (idEndsWith)

说明: 根据id的后缀去匹配

函数: idEndsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的id的后缀

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = idEndsWith("detail_tv_title")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

5. 正则匹配id (idMatches)

说明: 正则匹配id

函数: idMatches(str)

参数:

参数名	类型	必填	说明
str	string	是	正则表达式字符串

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = idMatches(".*detail_tv_title$")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

6. 根据节点的text属性匹配 (text)

说明: 根据节点的text属性匹配

函数: text(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的具体控件的text

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = text("懒人高级版")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

7. 根据text包含的部分字符串匹配 (textContains)

说明: 根据text包含的部分字符串匹配

函数: textContains(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的模糊的包含text某一段字符串的内容

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = textContains("懒人")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

8. 根据text的前缀去匹配 (textStartsWith)

说明: 根据text的前缀去匹配

函数: textStartsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的text的前缀

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = textStartsWith("懒人")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

9. 根据text的后缀去匹配 (textEndsWith)

说明: 根据text的后缀去匹配

函数: textEndsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的text的后缀

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = textEndsWith("高级版")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

10. 正则匹配text (textMatches)

说明: 正则匹配text

函数: textMatches(str)

参数:

参数名	类型	必填	说明
str	string	是	正则表达式字符串

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = textMatches(".*高级版$")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

11. 根据节点的desc属性匹配 (desc)

说明: 根据节点的desc属性匹配

函数: desc(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的具体控件的desc

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = desc("懒人高级版")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

12. 根据desc包含的部分字符串匹配 (descContains)

说明: 根据desc包含的部分字符串匹配

函数: descContains(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的模糊的包含desc某一段字符串的内容

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = descContains("懒人")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

13. 根据desc的前缀去匹配 (descStartsWith)

说明: 根据desc的前缀去匹配

函数: descStartsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的desc的前缀

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = descStartsWith("懒人")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

14. 根据desc的后缀去匹配 (descEndsWith)

说明: 根据desc的后缀去匹配

函数: descEndsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的desc的后缀

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = descEndsWith("高级版")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

15. 正则匹配desc (descMatches)

说明: 正则匹配desc

函数: descMatches(str)

参数:

参数名	类型	必填	说明
str	string	是	正则表达式字符串

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = descMatches(".*高级版$")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

16. 根据节点的className属性匹配 (className)

说明: 根据节点的className属性匹配

函数: className(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找的具体控件的类名

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

17. 根据className属性所包含的字符串模糊匹配 (classNameContains)

说明: 根据className属性所包含的字符串模糊匹配

函数: classNameContains(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找className包含该字符的节点

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = classNameContains("android.widget")
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

18. 根据className属性前缀匹配 (classNameStartsWith)

说明: 根据className属性前缀匹配

函数: classNameStartsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找className前缀为该字符的节点

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = classNameStartsWith("android.widget")
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

19. 根据className属性后缀匹配 (classNameEndsWith)

说明: 根据className属性后缀匹配

函数: classNameEndsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要查找className后缀为该字符的节点

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = classNameEndsWith("TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

20. 根据className属性正则匹配 (classNameMatches)

说明: 根据className属性正则匹配

函数: classNameMatches(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要匹配className的正则表达式

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = classNameMatches("^android.*TextView$")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

21. 根据packageName属性全字段匹配 (packageName)

说明: 根据packageName属性全字段匹配

函数: packageName(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，指定要匹配节点所属的包名

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = packageName("com.nx.nxprojit"):className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

22. 匹配包含指定字符串的节点 (packageNameContains)

说明: 匹配包含指定字符串的的节点

函数: packageNameContains(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，包含该字符串的包名的节点将被匹配到

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = packageNameContains("nxprojit"):className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

23. 匹配包名前缀为指定字符串的节点 (packageNameStartsWith)

说明: 匹配包名前缀为指定字符串的的节点

函数: packageNameStartsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，包名为该字符的前缀的节点将被匹配到

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = packageNameStartsWith("com.nx"):className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

24. 匹配包名后缀为指定字符串的节点 (packageNameEndsWith)

说明: 匹配包名后缀为指定字符串的的节点

函数: packageNameEndsWith(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，包名为该字符的后缀的节点将被匹配到

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = packageNameEndsWith("nx.nxprojit"):className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

25. 包名正则匹配 (packageNameMatches)

说明: 包名正则匹配

函数: packageNameMatches(str)

参数:

参数名	类型	必填	说明
str	string	是	字符串类型，根据这个正则字符串匹配所有符合规则包名的节点

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = packageNameMatches("com.nx.*"):className("android.widget.TextView")
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

26. 根据节点的范围匹配 (bounds)

说明: 根据节点的范围匹配

函数: bounds(l,t,r,b)

参数:

参数名	类型	必填	说明
l	number	是	左范围
t	number	是	上范围
r	number	是	右范围
b	number	是	下范围

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = bounds(30,212,236,250)
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

27. 匹配该范围内的节点 (boundsInside)

说明: 匹配该范围内的节点

函数: boundsInside(l,t,r,b)

参数:

参数名	类型	必填	说明
l	number	是	左范围
t	number	是	上范围
r	number	是	右范围
b	number	是	下范围

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = boundsInside(30,212,236,250)
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

28. 根据绘制顺序匹配 (drawingOrder)

说明: 根据绘制顺序匹配

函数: drawingOrder(level)

参数:

参数名	类型	必填	说明
level	number	是	绘制顺序级别

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = drawingOrder(1)
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

29. 根据深度索引匹配 (depth)

说明: 根据深度索引匹配

函数: depth(level)

参数:

参数名	类型	必填	说明
level	number	是	深度索引级别

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = depth(1)
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

30. 根据在当前父节点里面的索引顺序查找 (index)

说明: 根据在当前父节点里面的索引顺序查找

函数: index(level)

参数:

参数名	类型	必填	说明
level	number	是	索引级别

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = index(1)
local node = sel:findOne(10000)
if node~= nil then
	print(node:text())
end

---

31. 根据是否可见匹配 (visibleToUser)

说明: 根据是否可见匹配

函数: visibleToUser(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否可见

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = visibleToUser(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

32. 根据是否选中匹配 (selected)

说明: 根据是否选中匹配

函数: selected(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否选中

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = selected(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

33. 根据是否可点击匹配 (clickable)

说明: 根据是否可点击匹配

函数: clickable(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否可点击

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = clickable(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

34. 根据是否可长按点击匹配 (longClickable)

说明: 根据是否可长按点击匹配

函数: longClickable(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否可长按点击

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = longClickable(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

35. 根据是否可用匹配 (enabled)

说明: 根据是否可用匹配

函数: enabled(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否可用

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = enabled(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

36. 根据是否是密码框匹配 (password)

说明: 根据是否是密码框匹配

函数: password(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否是密码框

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = password(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

37. 根据是否可以滚动来匹配 (scrollable)

说明: 根据是否可以滚动来匹配

函数: scrollable(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否可以滚动

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = scrollable(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

38. 根据是否被勾选来匹配 (checked)

说明: 根据是否被勾选来匹配

函数: checked(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否被勾选

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = checked(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end

---

39. 根据是否可以被勾选来匹配 (checkable)

说明: 根据是否可以被勾选来匹配

函数: checkable(b)

参数:

参数名	类型	必填	说明
b	boolean	是	是否可以被勾选

返回值:

返回值类型	说明
selector	返回一个选择器对象，该对象支持级联选择

示例:

local sel = checkable(true)
local node = sel:findOne(10000)
if node~= nil then
	print(node:className())
end