NodesRef.fields
收藏
我的收藏

基础库 1.7.0 开始支持本方法,这是一个同步方法。

添加节点的相关信息的查询,在 fields 中指定需要获取的字段。

如果提供了 callback 回调函数,在执行 SelectQuery.exec 方法后,节点信息会在 callback 中返回。

语法

nodesRef.fields(fields, callback)

参数说明

fields

类型

默认值

必填

说明

最低支持版本

Fields


指定查询的节点信息内容

1.7.0

Fields 类型说明

object 类型,属性如下:

属性名

类型

默认值

必填

说明

最低支持版本

id

boolean

false

是否返回节点的 ID

1.7.0

dataset

boolean

false

是否返回节点的 dataset

1.7.0

rect

boolean

false

是否返回节点布局位置(left、right、top、bottom)

1.7.0

size

boolean

false

是否返回节点尺寸(width、height)

1.7.0

scrollOffset

boolean

false

是否返回节点的滚动位置信息(scrollLeft、scrollTop),节点必须是 scroll-view 或者 viewport

1.7.0

node

boolean

false

是否返回节点对应的 Node 实例,当前仅支持新方案 canvas 实例的获取

1.78.0

computedStyle

string[]

[]

指定样式名列表,返回节点对应样式名的当前值

2.13.0

注:新方案 canvas 是指定了合法的 type 属性的 canvas 组件,详细见 canvas 组件 文档。

callback

类型

默认值

必填

说明

最低支持版本

function


回调函数

1.7.0

回调函数参数说明

object 类型,代表查询结果,属性如下:

参数

参数类型

说明

最低支持版本

id

string

节点的 ID

1.7.0

dataset

object

节点的 dataset

1.7.0

left

number

节点的左边界坐标

1.7.0

right

number

节点的右边界坐标

1.7.0

top

number

节点的上边界坐标

1.7.0

bottom

number

节点的下边界坐标

1.7.0

width

number

节点的宽度

1.7.0

height

number

节点的高度

1.7.0

scrollLeft

number

节点的水平滚动位置

1.7.0

scrollTop

number

节点的竖直滚动位置

1.7.0

返回值

SelectorQuery

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

Bug & Tip

该文档是否有帮助?