# NodesRef.fields
获取节点的相关信息。需要获取的字段在 fields
中指定。返回值是 nodesRef
对应的 selectorQuery
。
# 支持说明
应用能力 | Android | iOS | PC | 预览效果 |
---|---|---|---|---|
小程序 | 3.0.0 | 3.0.0 | 3.2.0 | 待补充 |
网页应用 | X | X | X | 待补充 |
# 输入
名称 | 数据类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
fields | object | 是 | fields配置 | |
∟ id | boolean | 否 | false | 是否返回节点 id |
∟ dataset | boolean | 否 | false | 是否返回节点 dataset |
∟ rect | boolean | 否 | false | 是否返回节点布局位置( left right top bottom ) |
∟ size | boolean | 否 | false | 是否返回节点尺寸( width height ) |
∟ scrollOffset | boolean | 否 | false | 是否返回节点的 scrollLeft scrollTop ,节点必须是 scroll-view 或者 viewport |
∟ properties | string[] | 否 | [] | 指定属性名列表,返回节点对应属性名的当前属性值(只能获得组件文档中标注的常规属性值,id class style 和事件绑定的属性值不可获取) |
∟ computedStyle | string[] | 否 | [] | 指定样式名列表,返回节点对应样式名的当前值 |
∟ context | boolean | 否 | false | 是否返回节点对应的 Context 对象 |
callback | function | 是 | callback function |
# 输出
回调函数返回对象的属性
名称 | 数据类型 | 描述 |
---|---|---|
id | string | 节点id |
dataset | object | 节点的dataset |
left | number | 节点的左边界坐标 |
right | number | 节点的右边界坐标 |
top | number | 节点的上边界坐标 |
bottom | number | 节点的下边界坐标 |
width | number | 节点的宽度 |
height | number | 节点的高度 |
# 代码示例
let view = bz.createSelectorQuery().in(this).select(".test");
view.fields({
size: true,
scrollOffset: true
}, data => {
console.log("得到节点信息" + JSON.stringify(data));
console.log("节点的宽为" + data.width);
}).exec();
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11