• 開(kāi)發(fā) .json 文件
  • 配置示例
  • 頁(yè)面配置項(xiàng)列表
    • navigationStyle 配置

開(kāi)發(fā) .json 文件

小程序頁(yè)面可以使用 .json 文件來(lái)對(duì)本頁(yè)面的窗口表現(xiàn)進(jìn)行配置。

創(chuàng)新互聯(lián)主打移動(dòng)網(wǎng)站、成都網(wǎng)站制作、網(wǎng)站建設(shè)、網(wǎng)站改版、網(wǎng)絡(luò)推廣、網(wǎng)站維護(hù)、申請(qǐng)域名、等互聯(lián)網(wǎng)信息服務(wù)，為各行業(yè)提供服務(wù)。在技術(shù)實(shí)力的保障下，我們?yōu)榭蛻舫兄Z穩(wěn)定，放心的服務(wù)，根據(jù)網(wǎng)站的內(nèi)容與功能再?zèng)Q定采用什么樣的設(shè)計(jì)。最后，要實(shí)現(xiàn)符合網(wǎng)站需求的內(nèi)容、功能與設(shè)計(jì)，我們還會(huì)規(guī)劃穩(wěn)定安全的技術(shù)方案做保障。

頁(yè)面的配置只能設(shè)置 app.json 中部分 window 配置項(xiàng)的內(nèi)容，頁(yè)面中配置項(xiàng)會(huì)覆蓋 app.json 的 window 中相同的配置項(xiàng)。

配置示例

代碼示例

 
 
 

  
  
  
{
  
  
  
 "navigationBarBackgroundColor": "#ffffff",
  
  
  
 "navigationBarTextStyle": "black",
  
  
  
 "navigationBarTitleText": "智能小程序接口功能演示",
  
  
  
 "backgroundColor": "#eeeeee",
  
  
  
 "backgroundTextStyle": "light"
  
  
  
}
 
 
 

頁(yè)面配置項(xiàng)列表

屬性	類型	默認(rèn)值	描述	最低版本
navigationBarBackgroundColor	HexColor	#000000	導(dǎo)航欄背景顏色，如 #000000
navigationBarTextStyle	String	white	導(dǎo)航欄標(biāo)題顏色，有效值 black / white
navigationBarTitleText	String		導(dǎo)航欄標(biāo)題文字內(nèi)容
navigationStyle	String	default	導(dǎo)航欄樣式，有效值：default(默認(rèn)樣式) custom(自定義導(dǎo)航欄)，只保留右上角膠囊按鈕，在頁(yè)面級(jí)配置優(yōu)先級(jí)高于全局配置	iOS 基礎(chǔ)庫(kù)版本 3.0.39，Android 基礎(chǔ)庫(kù)版本 2.10.34
backgroundColor	HexColor	#ffffff	窗口的背景色
backgroundTextStyle	String	dark	下拉 loading 的樣式，有效值 dark / light
backgroundColorTop	HexColor	#ffffff	頂部窗口的背景色，僅 iOS 支持
backgroundColorBottom	HexColor	#ffffff	底部窗口的背景色，僅 iOS 支持
enablePullDownRefresh	Boolean	false	是否全局開(kāi)啟下拉刷新。詳見(jiàn) Page.onPullDownRefresh
onReachBottomDistance	Number	50	頁(yè)面上拉觸底事件觸發(fā)時(shí)距頁(yè)面底部距離（單位：px）。詳見(jiàn) Page.onReachBottom
disableScroll	Boolean	false	設(shè)置為 true 則頁(yè)面整體不能上下滾動(dòng)。只在頁(yè)面配置中有效，無(wú)法在 app.json 中設(shè)置	Android 暫不支持

說(shuō)明：

• 頁(yè)面的 .json 只能設(shè)置 window 相關(guān)的配置項(xiàng)，以決定本頁(yè)面的窗口表現(xiàn)，所以無(wú)需寫(xiě) window 這個(gè)鍵；
• navigationStyle 全局配置Android和iOS從基礎(chǔ)庫(kù)版本 2.10.34 開(kāi)始支持, 但子頁(yè)面配置支持情況Android從基礎(chǔ)庫(kù)版本2.10.34開(kāi)始支持，iOS從基礎(chǔ)庫(kù)版本 3.0.39開(kāi)始支持, 做低版本兼容時(shí)，通過(guò) swan.getSystemInfo 或者 swan.getSystemInfoSync 獲取百度 APP 版本號(hào)進(jìn)行兼容判斷，具體見(jiàn)下表；
• 無(wú)其它特殊說(shuō)明，請(qǐng)使用SWAN基礎(chǔ)庫(kù)版本進(jìn)行兼容判斷。

navigationStyle 配置

當(dāng)swanNativeVersion>=2.28.0時(shí)，小程序框架將回收二級(jí)頁(yè)面（非首頁(yè) / 非 Tab 頁(yè)）左上角返回按鈕的自定義權(quán)限。在小程序二級(jí)頁(yè)面使用自定義導(dǎo)航欄時(shí)，小程序框架將提供統(tǒng)一的返回按鈕控制方案。詳情請(qǐng)參考非兼容性升級(jí)。

頂 bar 設(shè)置	iOS	Android	WebView 組件頁(yè)面	備注
百度 APP 定義的頂 bar	無(wú)版本限制	無(wú)版本限制	無(wú)版本限制
頂 bar 全局透明設(shè)置	基礎(chǔ)庫(kù)版本 2.10.34	基礎(chǔ)庫(kù)版本 2.10.34	不生效
頂 bar 子頁(yè)面透明設(shè)置	基礎(chǔ)庫(kù)版本 3.0.39	基礎(chǔ)庫(kù)版本 2.10.34	不生效	每個(gè) page 的 json 文件可以單獨(dú)配置 navigationStyle

適配提示
原生頂 bar 高度 = 狀態(tài)欄高度（statusBarHeight）+ 頂部導(dǎo)航欄高度（navigationBarHeight）；可通過(guò) swan.getSystemInfo 或者 swan.getSystemInfoSync 獲取。

當(dāng)前名稱：創(chuàng)新互聯(lián)百度小程序教程：開(kāi)發(fā).json文件
網(wǎng)站地址：http://www.dlmjj.cn/article/cdgjpeh.html