NodesRef.fields(Object fields, function callback)

更新时间：2024-08-13 16:47:37

获取节点的相关信息。需要获取的字段在 fields 中指定。返回值是 nodesRef 对应的 selectorQuery

参数

Object fields

属性	类型	默认值	必填	说明
id	boolean	false	否	是否返回节点 id
dataset	boolean	false	否	是否返回节点 dataset
mark	boolean	false	否	是否返回节点 mark
rect	boolean	false	否	是否返回节点布局位置（left right top bottom）
size	boolean	false	否	是否返回节点尺寸（width height）
scrollOffset	boolean	false	否	否 是否返回节点的 scrollLeft scrollTop，节点必须是 scroll-view 或者 viewport
properties	Array	[]	否	指定属性名列表，返回节点对应属性名的当前属性值（只能获得组件文档中标注的常规属性值，id class style 和事件绑定的属性值不可获取）
computedStyle	Array	[]	否	指定样式名列表，返回节点对应样式名的当前值
context	boolean	false	否	是否返回节点对应的 Context 对象
node	boolean	false	否	是否返回节点对应的 Node 实例

function callback

回调函数

参数

Object res

节点的相关信息

返回值

SelectorQuery

注意

computedStyle 的优先级高于 size，当同时在 computedStyle 里指定了 width/height 和传入了 size: true，则优先返回 computedStyle 获取到的 width/height。

示例代码

Page({
    getFields() {
        ks.createSelectorQuery().select('#the-id').fields({
            dataset: true,
            size: true,
            scrollOffset: true,
            properties: ['scrollX', 'scrollY'],
            computedStyle: ['margin', 'backgroundColor'],
            context: true,
        }, function(res) {
            res.dataset // 节点的dataset
            res.width // 节点的宽度
            res.height // 节点的高度
            res.scrollLeft // 节点的水平滚动位置
            res.scrollTop // 节点的竖直滚动位置
            res.scrollX // 节点 scroll-x 属性的当前值
            res.scrollY // 节点 scroll-y 属性的当前值
            // 此处返回指定要返回的样式名
            res.margin
            res.backgroundColor
            res.context // 节点对应的 Context 对象
        }).exec()
    }
})