1. uni.setNavigationBarTitle(OBJECT)
動態設置當前頁面的標題。
OBJRECT參數說明:
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| title | String | 是 | 頁面標題 |
| success | Function | 否 | 接口調用成功的回調函數 |
| fail | Function | 否 | 接口調用失敗的回調函數 |
| complete | Function | 否 | 接口調用結束的回調函數(調用成功、失敗都會執行) |
//動態設置標題 uni.setNavigationBarTitle({ title: '歡迎聯系客服' })
2. uni.setNavigationBarColor(OBJECT)
設置頁面導航條顏色。如果需要進入頁面就設置顏色,請延遲執行,防止被框架內設置顏色邏輯覆蓋
平台差異說明:
| App | H5 | 微信小程序 | 支付寶小程序 | 百度小程序 | 字節跳動小程序 | QQ小程序 |
|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ |
OBJECT參數說明:
| 參數 | 類型 | 必填 | 說明 | 平台差異說明 |
|---|---|---|---|---|
| frontColor | String | 是 | 前景顏色值,包括按鈕、標題、狀態欄的顏色,僅支持 #ffffff 和 #000000 | App、H5、微信小程序、百度小程序 |
| backgroundColor | String | 是 | 背景顏色值,有效值為十六進制顏色 | |
| animation | Object | 否 | 動畫效果,{duration,timingFunc} | 微信小程序、百度小程序 |
| success | Function | 否 | 接口調用成功的回調函數 | |
| fail | Function | 否 | 接口調用失敗的回調函數 | |
| complete | Function | 否 | 接口調用結束的回調函數(調用成功、失敗都會執行) |
注意
- Android 上的 backgroundColor 參數有限制,黑色大於 rgb(30,30,30), 白色小於 rgb(235,235,235)
- 如果需要在頁面進入時設置標題,可以在
onReady內執行,以避免被框架內的修改所覆蓋。如果必須在onShow內執行需要延遲一小段時間
animation 結構
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| duration | number | 0 | 否 | 動畫變化時間,單位 ms |
| timingFunc | String | 'linear' | 否 | 動畫變化方式 |
animation.timingFunc 有效值
| 值 | 說明 |
|---|---|
| linear | 動畫從頭到尾的速度是相同的。 |
| easeIn | 動畫以低速開始 |
| easeOut | 動畫以低速結束。 |
| easeInOut | 動畫以低速開始和結束。 |
success返回參數說明
| 參數名 | 類型 | 說明 |
|---|---|---|
| errMsg | String | 調用結果 |
uni.setNavigationBarColor({ frontColor: '#ffffff', backgroundColor: '#ff0000', animation: { duration: 400, timingFunc: 'easeIn' } })
3. uni.showNavigationBarLoading(OBJECT)
在當前頁面顯示導航條加載動畫。(常用於加載數據前,讓用戶感知狀態)
平台差異說明:
| App | H5 | 微信小程序 | 支付寶小程序 | 百度小程序 | 字節跳動小程序 | QQ小程序 |
|---|---|---|---|---|---|---|
| x | √ | √ | √ | √ | x | √ |
App平台調用此API時會在屏幕中間懸浮顯示loading
OBJECT參數說明:
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| success | Function | 否 | 接口調用成功的回調函數 |
| fail | Function | 否 | 接口調用失敗的回調函數 |
| complete | Function | 否 | 接口調用結束的回調函數(調用成功、失敗都會執行) |
uni.showNavigationBarLoading()
4. uni.hideNabigationBarLoading(OBJECT)
在當前頁面隱藏導航條加載動畫。
平台差異說明:
| App | H5 | 微信小程序 | 支付寶小程序 | 百度小程序 | 字節跳動小程序 | QQ小程序 |
|---|---|---|---|---|---|---|
| x | √ | √ | √ | √ | x | √ |
App平台調用此API時會關閉屏幕中間懸浮顯示的loading
OBJECT參數說明:
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| success | Function | 否 | 接口調用成功的回調函數 |
| fail | Function | 否 | 接口調用失敗的回調函數 |
| complete | Function | 否 | 接口調用結束的回調函數(調用成功、失敗都會執行) |
uni.hideNavigationBarLoading()
uni.hideHomeButton(OBJECT)
隱藏返回首頁按鈕。
平台差異說明:
| App | H5 | 微信小程序 | 支付寶小程序 | 百度小程序 | 字節跳動小程序 | QQ小程序 |
|---|---|---|---|---|---|---|
| x | x | √ | x | x | 1.48.0+ | 1.10.0+ |
OBJECT參數說明:
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| success | Function | 否 | 接口調用成功的回調函數 |
| fail | Function | 否 | 接口調用失敗的回調函數 |
| complete | Function | 否 | 接口調用結束的回調函數(調用成功、失敗都會執行) |
uni.hideHomeButton()
