溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊(cè)×
其他方式登錄
點(diǎn)擊 登錄注冊(cè) 即表示同意《億速云用戶服務(wù)條款》

小程序app.json文件怎么配置

發(fā)布時(shí)間:2022-03-08 10:04:56 來(lái)源:億速云 閱讀:843 作者:iii 欄目:開(kāi)發(fā)技術(shù)

這篇文章主要介紹“小程序app.json文件怎么配置”,在日常操作中,相信很多人在小程序app.json文件怎么配置問(wèn)題上存在疑惑,小編查閱了各式資料,整理出簡(jiǎn)單好用的操作方法,希望對(duì)大家解答”小程序app.json文件怎么配置”的疑惑有所幫助!接下來(lái),請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧!

配置


我們使用app.json文件來(lái)對(duì)微信小程序進(jìn)行全局配置,決定頁(yè)面文件的路徑、窗口表現(xiàn)、設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間、設(shè)置多 tab 等。

以下是一個(gè)包含了所有配置選項(xiàng)的簡(jiǎn)單配置app.json

{  "pages": ["pages/index/index","pages/logs/index"  ],  
"window": {"navigationBarTitleText": "Demo"  },  "tabBar": {"list": [{      "pagePath": "pages/index/index",      "text": "首頁(yè)"    }, {      "pagePath": "pages/logs/logs",      "text": "日志"    }]
  },  "networkTimeout": {"request": 10000,"downloadFile": 10000  },  "debug": true}

app.json 配置項(xiàng)列表

屬性 類(lèi)型 必填 描述
pages String Array 設(shè)置頁(yè)面路徑
window Object 設(shè)置默認(rèn)頁(yè)面的窗口表現(xiàn)
tabBar Object 設(shè)置底部 tab 的表現(xiàn)
networkTimeout Object 設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間
debug Boolean 設(shè)置是否開(kāi)啟 debug 模式

pages

接受一個(gè)數(shù)組,每一項(xiàng)都是字符串,來(lái)指定小程序由哪些頁(yè)面組成。每一項(xiàng)代表對(duì)應(yīng)頁(yè)面的【路徑+文件名】信息,數(shù)組的第一項(xiàng)代表小程序的初始頁(yè)面。小程序中新增/減少頁(yè)面,都需要對(duì) pages 數(shù)組進(jìn)行修改。

文件名不需要寫(xiě)文件后綴,因?yàn)榭蚣軙?huì)自動(dòng)去尋找路徑.json,.js,.wxml,.wxss的四個(gè)文件進(jìn)行整合。

如開(kāi)發(fā)目錄為:

pages/

pages/index/index.wxml

pages/index/index.js

pages/index/index.wxss

pages/logs/logs.wxml

pages/logs/logs.js

app.js

app.json

app.wxss

則,我們需要在 app.json 中寫(xiě)

{  "pages":["pages/index/index"    "pages/logs/logs"  ]
}

window

用于設(shè)置小程序的狀態(tài)欄、導(dǎo)航條、標(biāo)題、窗口背景色。

屬性 類(lèi)型 默認(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)容
backgroundColor HexColor #ffffff 窗口的背景色
backgroundTextStyle String dark 下拉背景字體、loading 圖的樣式,僅支持 dark/light
enablePullDownRefresh Boolean false 是否開(kāi)啟下拉刷新,詳見(jiàn)頁(yè)面相關(guān)事件處理函數(shù)。
onReachBottomDistance Number 50 頁(yè)面上拉觸底事件觸發(fā)時(shí)距頁(yè)面底部距離,單位為px

注:HexColor(十六進(jìn)制顏色值),如"#ff00ff"

如 app.json :

{  "window":{"navigationBarBackgroundColor": "#ffffff","navigationBarTextStyle": "black","navigationBarTitleText": "微信接口功能演示","backgroundColor": "#eeeeee","backgroundTextStyle": "light"  }
}

小程序app.json文件怎么配置

tabBar

如果我們的小程序是一個(gè)多 tab 應(yīng)用(客戶端窗口的底部有tab欄可以切換頁(yè)面),那么我們可以通過(guò) tabBar 配置項(xiàng)指定 tab 欄的表現(xiàn),以及 tab 切換時(shí)顯示的對(duì)應(yīng)頁(yè)面。

Tip:

1. 當(dāng)設(shè)置 position 為 top 時(shí),將不會(huì)顯示 icon

2. tabBar 是一個(gè)數(shù)組,只能配置最少2個(gè)、最多5個(gè) tab,tab 按數(shù)組的順序排序。

屬性說(shuō)明:

屬性 類(lèi)型 必填 默認(rèn)值 描述
color HexColor   tab 上的文字默認(rèn)顏色
selectedColor HexColor   tab 上的文字選中時(shí)的顏色
backgroundColor HexColor   tab 的背景色
borderStyle String black tabbar上邊框的顏色, 僅支持 black/white
list Array   tab 的列表,詳見(jiàn) list 屬性說(shuō)明,最少2個(gè)、最多5個(gè) tab
position String bottom 可選值 bottom、top

其中 list 接受一個(gè)數(shù)組,數(shù)組中的每個(gè)項(xiàng)都是一個(gè)對(duì)象,其屬性值如下:

屬性 類(lèi)型 必填 說(shuō)明
pagePath String 頁(yè)面路徑,必須在 pages 中先定義
text String tab 上按鈕文字
iconPath String 圖片路徑,icon 大小限制為40kb,建議尺寸為 81px * 81px,當(dāng) postion 為 top 時(shí),此參數(shù)無(wú)效
selectedIconPath String 選中時(shí)的圖片路徑,icon 大小限制為40kb,建議尺寸為 81px * 81px ,當(dāng) postion 為 top 時(shí),此參數(shù)無(wú)效

小程序app.json文件怎么配置

networkTimeout

可以設(shè)置各種網(wǎng)絡(luò)請(qǐng)求的超時(shí)時(shí)間。

屬性說(shuō)明:

屬性 類(lèi)型 必填 說(shuō)明
request Number wx.request的超時(shí)時(shí)間,單位毫秒
connectSocket Number wx.connectSocket的超時(shí)時(shí)間,單位毫秒
uploadFile Number wx.uploadFile的超時(shí)時(shí)間,單位毫秒
downloadFile Number wx.downloadFile的超時(shí)時(shí)間,單位毫秒

debug

可以在開(kāi)發(fā)者工具中開(kāi)啟 debug 模式,在開(kāi)發(fā)者工具的控制臺(tái)面板,調(diào)試信息以 info 的形式給出,其信息有Page的注冊(cè),頁(yè)面路由數(shù)據(jù)更新,事件觸發(fā) ??梢詭椭_(kāi)發(fā)者快速定位一些常見(jiàn)的問(wèn)題。

page.json

每一個(gè)小程序頁(yè)面也可以使用.json文件來(lái)對(duì)本頁(yè)面的窗口表現(xiàn)進(jìn)行配置。頁(yè)面的配置比app.json全局配置簡(jiǎn)單得多,只是設(shè)置 app.json 中的 window 配置項(xiàng)的內(nèi)容,頁(yè)面中配置項(xiàng)會(huì)覆蓋 app.json 的 window 中相同的配置項(xiàng)。

頁(yè)面的.json只能設(shè)置window相關(guān)的配置項(xiàng),以決定本頁(yè)面的窗口表現(xiàn),所以無(wú)需寫(xiě)window這個(gè)鍵,如:

屬性 類(lèi)型 默認(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)容
backgroundColor HexColor #ffffff 窗口的背景色
backgroundTextStyle String dark 下拉背景字體、loading 圖的樣式,僅支持 dark/light
enablePullDownRefresh Boolean false 是否開(kāi)啟下拉刷新,詳見(jiàn)頁(yè)面相關(guān)事件處理函數(shù)。
disableScroll Boolean false 設(shè)置為 true 則頁(yè)面整體不能上下滾動(dòng);只在 page.json 中有效,無(wú)法在 app.json 中設(shè)置該項(xiàng)
{  "navigationBarBackgroundColor": "#ffffff",  "navigationBarTextStyle": "black",  "navigationBarTitleText": "微信接口功能演示",  "backgroundColor": "#eeeeee",  "backgroundTextStyle": "light"}

到此,關(guān)于“小程序app.json文件怎么配置”的學(xué)習(xí)就結(jié)束了,希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí),快去試試吧!若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí),請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站,小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章!

向AI問(wèn)一下細(xì)節(jié)

免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。

AI