bilibili小程序

使用小贴士

NodesRef.fields

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

参数说明

Object fields

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

Bug & Tip

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

示例代码

methods: {
  getFields () {
    bl.createSelectorQuery().select('#the-id').fields({
      dataset: true,
      size: true,
      scrollOffset: true,
      properties: ['scrollX', 'scrollY'],
      computedStyle: ['margin', 'backgroundColor']
    }, 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
    }).exec()
  }
}
← NodesRefNodesRef.boundingClientRect →