注冊

微信小程序API的WXML節(jié)點(diǎn)信息,微信小程序獲取節(jié)點(diǎn)

2020-09-27
導(dǎo)讀:wx.createSelectorQuery() 基礎(chǔ)庫 1.4.0 開始支持,低版本需做兼容處理 返回一個SelectorQuery對象實(shí)例??梢栽谶@個實(shí)例上使用 select 等方法選擇節(jié)點(diǎn),并使用 boundingClientRect 等方法選擇需要查詢...

wx.createSelectorQuery()


基礎(chǔ)庫 1.4.0 開始支持,低版本需做兼容處理

微信小程序API的WXML節(jié)點(diǎn)信息,微信小程序獲取節(jié)點(diǎn)

返回一個SelectorQuery對象實(shí)例??梢栽谶@個實(shí)例上使用select等方法選擇節(jié)點(diǎn),并使用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節(jié)點(diǎn)的上邊界坐標(biāo)
      res[1].scrollTop // 顯示區(qū)域的豎直滾動位置
    })
  }
})

selectorQuery

selectorQuery 對象的方法列表:

方法 參數(shù) 說明
select selector 參考下面詳細(xì)介紹
selectAll selector 參考下面詳細(xì)介紹
selectViewport   參考下面詳細(xì)介紹
exec [callback] 參考下面詳細(xì)介紹

selectorQuery.select(selector)


在當(dāng)前頁面下選擇第一個匹配選擇器selector的節(jié)點(diǎn),返回一個NodesRef對象實(shí)例,可以用于獲取節(jié)點(diǎn)信息。

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

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

selectorQuery.selectAll(selector)


在當(dāng)前頁面下選擇匹配選擇器selector的節(jié)點(diǎn),返回一個NodesRef對象實(shí)例。 與selectorQuery.selectNode(selector)不同的是,它選擇所有匹配選擇器的節(jié)點(diǎn)。

selectorQuery.selectViewport()


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

nodesRef.boundingClientRect([callback])


添加節(jié)點(diǎn)的布局位置的查詢請求,相對于顯示區(qū)域,以像素為單位。其功能類似于DOM的getBoundingClientRect。返回值是nodesRef對應(yīng)的selectorQuery。

返回的節(jié)點(diǎn)信息中,每個節(jié)點(diǎn)的位置用leftright、top、bottom、widthheight字段描述。如果提供了callback回調(diào)函數(shù),在執(zhí)行selectQuery的exec方法后,節(jié)點(diǎn)信息會在callback中返回。

示例代碼:

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

nodesRef.scrollOffset([callback])


添加節(jié)點(diǎn)的滾動位置查詢請求,以像素為單位。節(jié)點(diǎn)必須是scroll-view或者viewport。返回值是nodesRef對應(yīng)的selectorQuery。

返回的節(jié)點(diǎn)信息中,每個節(jié)點(diǎn)的滾動位置用scrollLeft、scrollHeight字段描述。如果提供了callback回調(diào)函數(shù),在執(zhí)行selectQuery的exec方法后,節(jié)點(diǎn)信息會在callback中返回。

示例代碼:

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

nodesRef.fields(fields, [callback])


獲取節(jié)點(diǎn)的相關(guān)信息,需要獲取的字段在fields中指定。返回值是nodesRef對應(yīng)的selectorQuery。可指定獲取的字段包括:

字段名 默認(rèn)值 說明
id 是否返回節(jié)點(diǎn)id
dataset 是否返回節(jié)點(diǎn)dataset
rect 是否返回節(jié)點(diǎn)布局位置(left right top bottom
size 是否返回節(jié)點(diǎn)尺寸(width height
scrollOffset 是否返回節(jié)點(diǎn)的 scrollLeft scrollTop ,節(jié)點(diǎn)必須是scroll-view或者viewport
properties [] 指定屬性名列表,返回節(jié)點(diǎn)對應(yīng)屬性名的當(dāng)前屬性值(只能獲得組件文檔中標(biāo)注的常規(guī)屬性值, id class style 和事件綁定的屬性值不可獲取)

示例代碼:

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

selectorQuery.exec([callback])


執(zhí)行所有的請求,請求結(jié)果按請求次序構(gòu)成數(shù)組,在callback的第一個參數(shù)中返回。

更多微信小程序開發(fā)教程,可以關(guān)注hi小程序。
重磅推薦:小程序開店目錄

第一部分:小商店是什么

第二部分:如何開通一個小商店

第三部分:如何登錄小商店

第四部分:開店任務(wù)常見問題

第五部分:小商店可以賣什么

第六部分:HiShop小程序特色功能

第七部分:小程序直播

第八部分:小程序收貨/物流

第九部分:小程序怎么結(jié)算

第十部分:小程序客服

第十一部分:電商創(chuàng)業(yè)

第十二部分:小程序游戲開發(fā)