【微信小程序】回頂部通用組件開發(fā)實(shí)踐

背景:

小程序的開發(fā)中會遇到很多通用的操作小按鈕卵沉,最常見的就是回頂部颠锉、回首頁、點(diǎn)贊史汗、收藏等琼掠。他們會分布于各種需要交互的頁面。在交互一致的情況下停撞,為了減少重復(fù)的代碼和后期維護(hù)瓷蛙,通常都會將它們抽成單獨(dú)的組件。分享個【回頂部】組件的簡單寫法戈毒,也是給自己做一個記錄艰猬。

開發(fā)步驟
  • 新建一個goTop組件文件包,含小程序規(guī)范的幾個文件js/wxml/json
  • 開發(fā)代碼埋市,在需要引用頁面的對應(yīng)配置文件中加入組件配置
  • 在引用的wxml中加入組件代碼和傳參冠桃,js文件寫參數(shù)的交互
效果圖
回頂部效果圖
代碼概覽

1.goTop / goTop.wxml
備注:go_top.png是一個白底的正方形圖片

<!--回頂部-->
<view wx:if="{{showTop}}" catchtap="toTop">
  <image src="../../images/icons/go_top.png"></image>
</view>

2.goTop / goTop.json

{
  "component": true
}

3.goTop / goTop.js

Component({
  properties: {
    showTop: {
      type: Boolean,
      value: false
    }
  },
  data: {

  },
  methods:{
    // 回頂部事件
    toTop:function(){
      wx.pageScrollTo({
        scrollTop: 0,
        duration: 500
      })
    }
  }
})

4.app.wxss
備注:因?yàn)槎鄠€模塊樣式一致,因此把樣式抽出去了,下圖只放出go-top部分~亦可單獨(dú)寫在goTop.wxss中

.go-top{
    position:fixed;
    right:28rpx;
    bottom:80rpx;
}
.go-top image{
    padding:16rpx;
    width:48rpx;
    height:48rpx;
    background:#fff;    
    border-radius:40rpx;
    box-shadow:0 4rpx 10rpx #707070;
}

↓組件開發(fā)已經(jīng)完成道宅,接下去是組件的使用↓

1.demo.json
備注:usingComponents加入對應(yīng)組件配置即可

{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "DemoTitle",
  "usingComponents": {
    "go-top": "/component/goTop/goTop"
  }
}

2.demo.wxml
備注:showTop通過滾動事件觸發(fā)取值

<view>
    <!-- S 其他業(yè)務(wù)代碼 -->
    <!-- E 其他業(yè)務(wù)代碼 -->

    <!-- 回頂部組件 -->
    <go-top class="go-top" showTop="{{showTop}}"></go-top>
</view>

3.demo.js
備注:刪除了其他業(yè)務(wù)代碼食听,僅剩和回頂部組件相關(guān)的交互,便于閱讀污茵。onPageScroll是小程序開放出來的一個頁面事件樱报,用于監(jiān)聽頁面的滾動,但有一定的延時泞当。

Page({
  data: {
    showTop:false
  },
  onPageScroll(e){
    //參數(shù)e會返回滾動條滾動的高度
    if(e.scrollTop>1200){
      this.setData({
        showTop:true
      })
    }else{
      this.setData({
        showTop:false
      })
    }
  }
})

其他說明:
以上代碼中樣式go-top我是寫在demo.wxml引用中的迹蛤,因?yàn)槠浯a寫在app.wxss里,如果是寫在goTop.wxss中則模塊樣式名直接寫在goTop.wxml的結(jié)構(gòu)中即可。app.wxss中的樣式和組件內(nèi)的樣式是獨(dú)立的笤受,不干擾不影響穷缤。如果樣式寫在外部,樣式名寫在內(nèi)部則不會生效箩兽!

通過該方式亦可擴(kuò)展多個右側(cè)懸浮按鈕,通過傳參控制其顯示與否章喉!

完...

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末汗贫,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子秸脱,更是在濱河造成了極大的恐慌落包,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,042評論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件摊唇,死亡現(xiàn)場離奇詭異咐蝇,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)巷查,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 89,996評論 2 384
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人浅浮,你說我怎么就攤上這事暴浦。” “怎么了崇败?”我有些...
    開封第一講書人閱讀 156,674評論 0 345
  • 文/不壞的土叔 我叫張陵盅称,是天一觀的道長。 經(jīng)常有香客問我后室,道長缩膝,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,340評論 1 283
  • 正文 為了忘掉前任岸霹,我火速辦了婚禮疾层,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘松申。我一直安慰自己云芦,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,404評論 5 384
  • 文/花漫 我一把揭開白布贸桶。 她就那樣靜靜地躺著舅逸,像睡著了一般。 火紅的嫁衣襯著肌膚如雪皇筛。 梳的紋絲不亂的頭發(fā)上琉历,一...
    開封第一講書人閱讀 49,749評論 1 289
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼旗笔。 笑死彪置,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的蝇恶。 我是一名探鬼主播拳魁,決...
    沈念sama閱讀 38,902評論 3 405
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼撮弧!你這毒婦竟也來了潘懊?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,662評論 0 266
  • 序言:老撾萬榮一對情侶失蹤贿衍,失蹤者是張志新(化名)和其女友劉穎授舟,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體贸辈,經(jīng)...
    沈念sama閱讀 44,110評論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡释树,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,451評論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了擎淤。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片奢啥。...
    茶點(diǎn)故事閱讀 38,577評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖揉燃,靈堂內(nèi)的尸體忽然破棺而出扫尺,到底是詐尸還是另有隱情,我是刑警寧澤炊汤,帶...
    沈念sama閱讀 34,258評論 4 328
  • 正文 年R本政府宣布正驻,位于F島的核電站,受9級特大地震影響抢腐,放射性物質(zhì)發(fā)生泄漏姑曙。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,848評論 3 312
  • 文/蒙蒙 一迈倍、第九天 我趴在偏房一處隱蔽的房頂上張望伤靠。 院中可真熱鬧,春花似錦啼染、人聲如沸宴合。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,726評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽卦洽。三九已至,卻和暖如春斜棚,著一層夾襖步出監(jiān)牢的瞬間阀蒂,已是汗流浹背该窗。 一陣腳步聲響...
    開封第一講書人閱讀 31,952評論 1 264
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留蚤霞,地道東北人酗失。 一個月前我還...
    沈念sama閱讀 46,271評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像昧绣,于是被迫代替她去往敵國和親规肴。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,452評論 2 348