小程序開發教程:wx.setTopBarText(OBJECT)


狀態信息展示

 

當小程序被顯示在聊天頂部時,開發者可將重要的狀態變更信息實時展示出來,便於用戶及時獲知。

 

詳見文檔:小程序文檔

 

 

小程序更新之后,有個更有用的功能!支持狀態欄實時狀態更新!!

wx.setTopBarText(OBJECT)

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

動設置置頂欄文字內容,只有當前小程序被置頂時能生效,如果當前小程序沒有被置頂,也能調用成功,但是不會立即生效,只有在用戶將這個小程序置頂后才換上設置的文字內容。注意:調用成功后,需間隔 5s 才能再次調用此接口,如果在 5s 內再次調用此接口,會回調 fail,errMsg:"setTopBarText: fail invoke too frequently"

OBJECT參數說明:

參數 類型 必填 說明
text String 置頂欄文字內容
success Function 接口調用成功的回調函數
fail Function 接口調用失敗的回調函數
complete Function 接口調用結束的回調函數(調用成功、失敗都會執行)

示例代碼:

wx.setTopBarText({
  text: 'hello, world!'
})

  

 

這個具體需要怎么調用呢?我研究了一番,這個接口需要主動觸發才可以使用。接下來,直接上代碼(app.js在注冊APP的腳本里面添加)

 

App({

  /**
   * 當小程序初始化完成時,會觸發 onLaunch(全局只觸發一次)
   */
  onLaunch: function () {
    
  },

  /**
   * 當小程序啟動,或從后台進入前台顯示,會觸發 onShow
   */
  onShow: function (options) {
    
  },

  /**
   * 當小程序從前台進入后台,會觸發 onHide
   */
  onHide: function () {
    var i=0;
    setInterval(function () {
      i++;
      wx.setTopBarText({
        text: "aaaa"+i,
        success: function (res) {
          console.log(res);
        },
        fail: function (res) {
          console.log(res);
        }
      });
    }, 6000);
  },

  /**
   * 當小程序發生腳本錯誤,或者 api 調用失敗時,會觸發 onError 並帶上錯誤信息
   */
  onError: function (msg) {
    
  }
})

  看,在onHide的函數里面監聽,這是屬於小程序的生命周期的函數,當用戶訪問完了你的小程序之后,置頂你的小程序,返回微信界面,小程序就進入了后台,那么,就出發這個函數

  在這個函數里面,可以實時的更新小程序的通知,只要用戶置頂了小程序,就可以看到小程序的通知變化!

這個功能是不是 很有用處呢?


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM