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 或者 | 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 |
返回值
扫码体验
代码示例
Bug & Tip
无