小程序模板網(wǎng)

小程序超實(shí)用組件:仿微信通訊錄

發(fā)布時(shí)間:2018-09-12 14:53 所屬欄目:小程序開發(fā)教程

效果圖

話不多說,先上效果圖

因?yàn)槭鞘褂玫氖謾C(jī)錄屏,視頻格式為MP4,上傳到文章時(shí)發(fā)現(xiàn)只支持圖片,還好電腦自動(dòng)錄屏功能,所以簡(jiǎn)單的錄制了一下,完后又提示只能4M,只能再去壓縮圖片,所以畫質(zhì)略渣,各位客官講究的看看吧。

特色功能介紹

  1. 用戶只需按照格式傳入?yún)?shù),組件能夠自動(dòng)將參數(shù)按首字母分組,簡(jiǎn)單方便;
  2. 組件右側(cè)首字母導(dǎo)航無需另外傳值,并且根據(jù)參數(shù)具體有哪些首字母顯示(沒有的咱就不要);
  3. 用戶進(jìn)行上下滑動(dòng)時(shí),左右相互聯(lián)動(dòng);
  4. 點(diǎn)擊右側(cè)導(dǎo)航,組件會(huì)相應(yīng)的上下滾動(dòng)。

實(shí)現(xiàn)基礎(chǔ)

說到滾動(dòng)當(dāng)然少不了小程序的基礎(chǔ)組件scroll-view,該組件就是在此基礎(chǔ)上實(shí)現(xiàn)的;
監(jiān)聽組件scroll-view的bindscroll事件,進(jìn)而對(duì)組件數(shù)據(jù)進(jìn)行操作,即可完成。

Wxml

  1. 滾動(dòng)區(qū)域
<scroll-view scroll-y style="height:100%;white-space:nowrap;" scroll-into-view="{{toView}}" enable-back-to-top bindscroll="scroll" scroll-with-animation scroll-top="{{scrollTop}}">
  <view class="list-group" wx:for="{{logs}}" wx:for-item="group">
    <view class="title" id="{{group.title}}">{{group.title}}</view>
    <block wx:for="{{group.items}}" wx:for-item="user">
      <view id="" class="list-group-item">
        <image class="icon" src="{{user.avatar}}" lazy-load="true"></image>
        <text class="log-item">{{user.name}}</text>
      </view>
    </block>
  </view>
</scroll-view>

簡(jiǎn)單說一下上述代碼:根據(jù)小程序文檔,在使用scroll-view組件用于豎向滾動(dòng)時(shí)一定要設(shè)置高度,你們可以看到我在代碼中設(shè)置了'height:100%;'這就實(shí)現(xiàn)了組件的滾動(dòng)高度是整個(gè)頁面。
但是請(qǐng)注意:很多同學(xué)會(huì)發(fā)現(xiàn)設(shè)置了高度100%后,組件并沒有效果,這是因?yàn)槟銢]有將頁面高度設(shè)置為100%,所以你還需在app.wxss中設(shè)置page的高度為100%
其他的屬性看文檔就好,我就不再多說;

2.側(cè)邊字母導(dǎo)航

<view class="list-shortcut">
  <block wx:for="{{logs}}">
    <text class="{{currentIndex===index?'current':''}}" data-id="{{item.title}}" bindtap='scrollToview'>{{item.title}}</text>
  </block>
</view>

3.固定在頂部的字母導(dǎo)航

仔細(xì)的同學(xué)能發(fā)現(xiàn)在滾動(dòng)時(shí),頂部有一個(gè)固定位置的字母導(dǎo)航,其值對(duì)應(yīng)滾動(dòng)到的區(qū)域

<view class="list-fixed {{fixedTitle=='' ? 'hide':''}}" style="transform:translate3d(0,{{fixedTop}}px,0);">
    <view class="fixed-title">
      {{fixedTitle}}
    </view>
</view>

Wxss

樣式太簡(jiǎn)單了,就不發(fā)了,重點(diǎn)看js部分

 

js

  1. 拿到參數(shù)第一步當(dāng)然是將參數(shù)列表渲染上去啦,
normalizeSinger(list) {
    //歌手列表渲染
    let map = {
      hot: {
        title: this.data.HOT_NAME,
        items: []
      }
    }
    list.forEach((item, index) => {
      if (index < this.data.HOT_SINGER_LEN) {
        map.hot.items.push({
          name: item.Fsinger_name,
          avatar:this.constructor(item.Fsinger_mid)
          })
      }
      const key = item.Findex
      if (!map[key]) {
        map[key] = {
          title: key,
          items: []
        }
      }
      map[key].items.push({
        name: item.Fsinger_name,
        avatar: this.constructor(item.Fsinger_mid)
      })
    })
    let ret = []
    let hot = []
    for (let key in map) {
      let val = map[key]
      if (val.title.match(/[a-zA-Z]/)) {
        ret.push(val)
      } else if (val.title === this.data.HOT_NAME) {
        hot.push(val)
      }
    }
    ret.sort((a, b) => {
      return a.title.charCodeAt(0) - b.title.charCodeAt(0)
    })
    return hot.concat(ret)
  },

將用戶數(shù)據(jù)分為兩大塊,即熱門組和不熱門組默認(rèn)將參數(shù)的前10組歸類為熱門組,然后對(duì)所以參數(shù)安裝首字母進(jìn)行排序分組。

  1. 計(jì)算各組高度
var lHeight = [],
    that = this;
let height = 0;
lHeight.push(height);
var query = wx.createSelectorQuery();
query.selectAll('.list-group').boundingClientRect(function(rects){
    var rect = rects,
        len = rect.length;
    for (let i = 0; i < len; i++) {
        height += rect[i].height;
        lHeight.push(height)
    }
 }).exec();
var calHeight = setInterval(function(){
    if (lHeight != [0]) {
       that.setData({
          listHeight: lHeight
       });
    clearInterval(calHeight);
  } 
},1000)

在獲取元素屬性上,小程序提供了一個(gè)很方便的api,wx.createSelectotQuery();具體使用方法請(qǐng)看節(jié)點(diǎn)信息API
使用該方法獲取到各分組的高度,存入lHeight中用于之后滾動(dòng)時(shí)判斷使用;
同學(xué)們可以看到我在將lHeight賦值給data的listHeight時(shí)使用了定時(shí)器,這是因?yàn)楂@取節(jié)點(diǎn)信息api是異步執(zhí)行的,顧你直接進(jìn)行賦值是沒有效果的,所以我使用了定時(shí)器功能;
我覺得這里使用定時(shí)器不是最好的處理方式,同學(xué)們有更好的方法請(qǐng)告訴我,謝謝
3.第三步就是在滾動(dòng)的時(shí)候獲取滾動(dòng)高度,相應(yīng)的處理即可,滾動(dòng)使用到了scroll-view自帶事件,這個(gè)事件會(huì)返回滾動(dòng)的距離,及其方便

const listHeight = this.data.listHeight
// 當(dāng)滾動(dòng)到頂部,scrollY<0
if (scrollY == 0 || scrollY < 0) {
  this.setData({
    currentIndex:0,
    fixedTitle:''
  })
  return
}
// 在中間部分滾動(dòng)
for (let i = 0; i < listHeight.length - 1; i++) {
  let height1 = listHeight[i]
  let height2 = listHeight[i + 1]
  if (scrollY >= height1 && scrollY < height2) {
    this.setData({
      currentIndex:i,
      fixedTitle:this.data.logs[i].title
    })
    this.fixedTt(height2 - newY);
    return
  }
}
// 當(dāng)滾動(dòng)到底部,且-scrollY大于最后一個(gè)元素的上限
this.setData({
  currentIndex: listHeight.length - 2,
  fixedTitle: this.data.logs[listHeight.length - 2].title
})

參數(shù)格式

list:[
    {
        "index": "X",
        "name": "薛之謙",
    },
    {
        "index": "Z",
        "name": "周杰倫",
    },
    {
        "index": "B",
        "name": "BIGBANG (??)",
    },
    {
        "index": "B",
        "name": "陳奕迅",
    },
    {
        "index": "L",
        "name": "林俊杰",
    },
    {
        "index": "A",
        "name": "Alan Walker (艾倫·沃克)",
    },
]

如果你們還需要其他的參數(shù),對(duì)應(yīng)的在后面加上即可。

END



易優(yōu)小程序(企業(yè)版)+靈活api+前后代碼開源 碼云倉(cāng)庫(kù):starfork
本文地址:http://22321a.com/wxmini/doc/course/24803.html 復(fù)制鏈接 如需定制請(qǐng)聯(lián)系易優(yōu)客服咨詢:800182392 點(diǎn)擊咨詢
QQ在線咨詢