2023年微信小程序API 設(shè)置置頂信息
使用wx.setTopBarText接口設(shè)置小程序置頂欄文字內(nèi)容
微信小程序API中的wx.setTopBarText接口,可用于動態(tài)設(shè)置小程序置頂欄的文字內(nèi)容。但需要注意的是,這個接口只有當(dāng)前小程序被置頂時能生效,如果當(dāng)前小程序沒有被置頂,調(diào)用該接口也能成功,但不會立即生效,只有在用戶將這個小程序置頂后才會更新顯示的文字內(nèi)容。
1. 基礎(chǔ)庫版本要求
如果您想在自己的小程序中使用wx.setTopBarText接口,需要保證基礎(chǔ)庫版本不低于1.4.3。如果您的基礎(chǔ)庫版本過低,您需要進行兼容處理以確保接口正常工作。
2. 調(diào)用頻率限制
在成功調(diào)用wx.setTopBarText接口之后,請注意您需要至少等待5秒鐘再次調(diào)用此接口。如果在5秒內(nèi)多次調(diào)用該接口,會回調(diào)fail并報告錯誤信息:"setTopBarText: fail invoke too frequently"。因此,您需要合理使用該接口,并且避免重復(fù)調(diào)用,以免出現(xiàn)異常情況。
3. 參數(shù)說明
在調(diào)用wx.setTopBarText接口時,需傳遞一個OBJECT參數(shù),具體如下:
參數(shù) | 類型 | 必填 | 說明 |
---|---|---|---|
text | String | 是 | 置頂欄文字內(nèi)容 |
success | Function | 否 | 接口調(diào)用成功的回調(diào)函數(shù) |
fail | Function | 否 | 接口調(diào)用失敗的回調(diào)函數(shù) |
complete | Function | 否 | 接口調(diào)用結(jié)束的回調(diào)函數(shù)(無論成功、失敗都會執(zhí)行) |
4. 示例代碼
以下是使用wx.setTopBarText接口設(shè)置小程序置頂欄文字內(nèi)容的示例代碼:
wx.setTopBarText({
text: 'hello, world!'
})
以上代碼將顯示 "hello, world!" 的字樣在小程序置頂欄上。
-
B2B2C多用戶商城系統(tǒng)支持企業(yè)自營與商戶入駐模式共存 會員一站式精細化營銷工具 多用戶分銷,帶來爆發(fā)式增長
系統(tǒng)支持平臺自營+供應(yīng)商店鋪共存的經(jīng)營模式(類天貓&京東模式),幫助企業(yè)打造生態(tài)級商業(yè)平臺為目的的電子商務(wù)系統(tǒng)。
免費試用系統(tǒng) -
B2B2B電商交易系統(tǒng)優(yōu)化供應(yīng)鏈協(xié)作 授信及賬期支付 商品按照數(shù)量階梯設(shè)價
全渠道訂貨/采購及經(jīng)銷商管理數(shù)字化系統(tǒng),實現(xiàn)供應(yīng)鏈整合和交易便捷化。
免費試用系統(tǒng) -
S2B2B電商交易系統(tǒng)供銷一體化,提高市場集中度 集團管控一體化,有效實現(xiàn)供需匹配 移動應(yīng)用一體化,提高運營綜合效率
上下游資源整合數(shù)字化解決方案,賦能產(chǎn)業(yè)供應(yīng)鏈,構(gòu)建產(chǎn)業(yè)互聯(lián)網(wǎng)生態(tài)體系。
免費試用系統(tǒng)