wx.createSelectorQuery()

基礎庫 1.4.0 開始支持，低版本需做兼容處理

返回一個SelectorQuery對象實例。可以在這個實例上使用select等方法選擇節點，并使用boundingClientRect等方法選擇需要查詢的信息。

示例代碼：

Page({
  queryMultipleNodes: function(){
    var query = wx.createSelectorQuery()
    query.select('#the-id').boundingClientRect()
    query.selectViewport().scrollOffset()
    query.exec(function(res){
      res[0].top       // #the-id節點的上邊界坐標
      res[1].scrollTop // 顯示區域的豎直滾動位置
    })
  }
})

selectorQuery

selectorQuery 對象的方法列表：

selectorQuery.select(selector)

在當前頁面下選擇第一個匹配選擇器selector的節點，返回一個NodesRef對象實例，可以用于獲取節點信息。

selector類似于CSS的選擇器，但僅支持下列語法。

• ID選擇器：#the-id
• class選擇器（可以連續指定多個）：.a-class.another-class
• 子元素選擇器：.the-parent > #the-child.a-class
• 多選擇器的并集：#a-node, .some-other-nodes

selectorQuery.selectAll(selector)

在當前頁面下選擇匹配選擇器selector的節點，返回一個NodesRef對象實例。 與selectorQuery.selectNode(selector)不同的是，它選擇所有匹配選擇器的節點。

selectorQuery.selectViewport()

選擇顯示區域，可用于獲取顯示區域的尺寸、滾動位置等信息，返回一個NodesRef對象實例。

nodesRef.boundingClientRect([callback])

添加節點的布局位置的查詢請求，相對于顯示區域，以像素為單位。其功能類似于DOM的getBoundingClientRect。返回值是nodesRef對應的selectorQuery。

返回的節點信息中，每個節點的位置用left、right、top、bottom、width、height字段描述。如果提供了callback回調函數，在執行selectQuery的exec方法后，節點信息會在callback中返回。

示例代碼：

Page({
  getRect: function(){
    wx.createSelectorQuery().select('#the-id').boundingClientRect(function(rect){
      rect.id      // 節點的ID
      rect.dataset // 節點的dataset
      rect.left    // 節點的左邊界坐標
      rect.right   // 節點的右邊界坐標
      rect.top     // 節點的上邊界坐標
      rect.bottom  // 節點的下邊界坐標
      rect.width   // 節點的寬度
      rect.height  // 節點的高度
    }).exec()
  },
  getAllRects: function(){
    wx.createSelectorQuery().selectAll('.a-class').boundingClientRect(function(rects){
      rects.forEach(function(rect){
        rect.id      // 節點的ID
        rect.dataset // 節點的dataset
        rect.left    // 節點的左邊界坐標
        rect.right   // 節點的右邊界坐標
        rect.top     // 節點的上邊界坐標
        rect.bottom  // 節點的下邊界坐標
        rect.width   // 節點的寬度
        rect.height  // 節點的高度
      })
    }).exec()
  }
})

nodesRef.scrollOffset([callback])

添加節點的滾動位置查詢請求，以像素為單位。節點必須是scroll-view或者viewport。返回值是nodesRef對應的selectorQuery。

返回的節點信息中，每個節點的滾動位置用scrollLeft、scrollHeight字段描述。如果提供了callback回調函數，在執行selectQuery的exec方法后，節點信息會在callback中返回。

示例代碼：

Page({
  getScrollOffset: function(){
    wx.createSelectorQuery().selectViewport().scrollOffset(function(res){
      res.id      // 節點的ID
      res.dataset // 節點的dataset
      res.scrollLeft // 節點的水平滾動位置
      res.scrollTop  // 節點的豎直滾動位置
    }).exec()
  }
})

nodesRef.fields(fields, [callback])

獲取節點的相關信息，需要獲取的字段在fields中指定。返回值是nodesRef對應的selectorQuery。可指定獲取的字段包括：

示例代碼：

Page({
  getFields: function(){
    wx.createSelectorQuery().select('#the-id').fields({
      dataset: true,
      size: true,
      scrollOffset: true,
      properties: ['scrollX', 'scrollY']
    }, function(res){
      res.dataset    // 節點的dataset
      res.width      // 節點的寬度
      res.height     // 節點的高度
      res.scrollLeft // 節點的水平滾動位置
      res.scrollTop  // 節點的豎直滾動位置
      res.scrollX    // 節點 scroll-x 屬性的當前值
      res.scrollY    // 節點 scroll-x 屬性的當前值
    }).exec()
  }
})

selectorQuery.exec([callback])

執行所有的請求，請求結果按請求次序構成數組，在callback的第一個參數中返回。