# 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