SelectorQuery NodesRef.fields(Object fields, function callback)

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

参数

Object fields

属性类型默认值必填说明最低版本
idbooleanfalse否是否返回节点 id
datasetbooleanfalse否是否返回节点 dataset
markbooleanfalse否是否返回节点 mark
rectbooleanfalse否是否返回节点布局位置（left right top bottom）
sizebooleanfalse否是否返回节点尺寸（width height）
scrollOffsetbooleanfalse否否 是否返回节点的 scrollLeft scrollTop，节点必须是 scroll-view 或者 viewport
propertiesArray.<string>[]否指定属性名列表，返回节点对应属性名的当前属性值（只能获得组件文档中标注的常规属性值，id class style 和事件绑定的属性值不可获取）
computedStyleArray.<string>[]否指定样式名列表，返回节点对应样式名的当前值2.1.0
contextbooleanfalse否是否返回节点对应的 Context 对象2.4.2
nodebooleanfalse否是否返回节点对应的 Node 实例2.7.0

function callback

回调函数

参数

Object res

节点的相关信息

返回值

SelectorQuery

注意

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

示例代码

  1. Page({
  2.   getFields () {
  3.     wx.createSelectorQuery().select('#the-id').fields({
  4.       dataset: true,
  5.       size: true,
  6.       scrollOffset: true,
  7.       properties: ['scrollX', 'scrollY'],
  8.       computedStyle: ['margin', 'backgroundColor'],
  9.       context: true,
  10.     }, function (res) {
  11.       res.dataset    // 节点的dataset
  12.       res.width      // 节点的宽度
  13.       res.height     // 节点的高度
  14.       res.scrollLeft // 节点的水平滚动位置
  15.       res.scrollTop  // 节点的竖直滚动位置
  16.       res.scrollX    // 节点 scroll-x 属性的当前值
  17.       res.scrollY    // 节点 scroll-y 属性的当前值
  18.       // 此处返回指定要返回的样式名
  19.       res.margin
  20.       res.backgroundColor
  21.       res.context    // 节点对应的 Context 对象
  22.     }).exec()
  23.   }
  24. })