微信小程序 配置文件詳細(xì)介紹
下面以開發(fā)者工具自動(dòng)生成的程序框架為例,對(duì)小程序的框架進(jìn)行介紹。
選擇一個(gè)空的項(xiàng)目目錄創(chuàng)建一個(gè)小程序項(xiàng)目,如下圖:
創(chuàng)建完成后我們看到如下目錄結(jié)構(gòu):
目錄結(jié)構(gòu)

小程序包含一個(gè)描述整體程序的 app 和多個(gè)描述各自頁面的 page。
一個(gè)小程序主體部分由三個(gè)文件組成,必須放在項(xiàng)目的根目錄,如下:
| 文件 | 必須 | 作用 |
|---|---|---|
| app.js | 是 | 小程序邏輯 |
| app.json | 是 | 小程序公共設(shè)置 |
| app.wxss | 否 | 小程序公共樣式表 |
pages目錄下為小程序頁面,每個(gè)頁面須建立獨(dú)立的文件夾,例如上面生成的小程序有兩個(gè)頁面,分別為pages/index、pages/logs,一個(gè)頁面由四個(gè)文件組成,分別是:
| 文件類型 | 必須 | 作用 |
|---|---|---|
| js | 是 | 頁面邏輯 |
| wxml | 是 | 頁面結(jié)構(gòu) |
| wxss | 否 | 頁面樣式表 |
| json | 否 | 頁面配置 |
配置
app.json文件來對(duì)微信小程序進(jìn)行全局配置,決定頁面文件的路徑、窗口表現(xiàn)、設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間、設(shè)置多 tab 等。
例子中的配置文件內(nèi)容如下:
{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle":"black"
}
}
app.json共提供了以下配置項(xiàng):
| 屬性 | 類型 | 必填 | 描述 |
|---|---|---|---|
| pages | String Array | 是 | 設(shè)置頁面路徑 |
| window | Object | 否 | 設(shè)置默認(rèn)頁面的窗口表現(xiàn) |
| tabBar | Object | 否 | 設(shè)置底部 |
| networkTimeout | Object | 否 | 設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間 |
| debug | Boolean | 否 | 設(shè)置是否開 |
接受一個(gè)數(shù)組,每一項(xiàng)都是字符串,來指定小程序由哪些頁面組成。每一項(xiàng)代表對(duì)應(yīng)頁面的【路徑+文件名】信息,數(shù)組的第一項(xiàng)代表小程序的初始頁面。小程序中新增/減少頁面,都需要對(duì) pages 數(shù)組進(jìn)行修改。
window
用于設(shè)置小程序的狀態(tài)欄、導(dǎo)航條、標(biāo)題、窗口背景色。
| 屬性 | 類型 | 默認(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 | 是否開啟下拉刷新,詳見頁面相關(guān)事件處理函數(shù)。 |
tabBar
如果我們的小程序是一個(gè)多 tab 應(yīng)用(客戶端窗口的底部有tab欄可以切換頁面),那么我們可以通過 tabBar 配置項(xiàng)指定 tab 欄的表現(xiàn),以及 tab 切換時(shí)顯示的對(duì)應(yīng)頁面。
tabBar 是一個(gè)數(shù)組,只能配置最少2個(gè)、最多5個(gè) tab,tab 按數(shù)組的順序排序。
| 屬性 | 類型 | 默認(rèn)值 | 描述 |
|---|---|---|---|
| color | HexColor | 是 | tab 上的文字默認(rèn)顏色 |
| selectedColor | HexColor | 是 | tab 上的文字選中時(shí)的顏色 |
| backgroundColor | HexColor | 是 | tab 的背景色 |
| borderStyle | String | 否 | black tabbar上邊框的顏色, 僅支持 black/white |
| list | Array | 是 | tab 的列表,詳見 list 屬性說明,最少2個(gè)、最多5個(gè) tab |
| position | String | 否 | bottom 可選值 bottom、top |
其中 list 接受一個(gè)數(shù)組,數(shù)組中的每個(gè)項(xiàng)都是一個(gè)對(duì)象,其屬性值如下:
| 屬性 | 類型 | 必填 | 說明 |
|---|---|---|---|
| pagePath | String | 是 | 頁面路徑,必須在 pages 中先定義 |
| text | String | 是 | tab 上按鈕文字 |
| iconPath | String | 是 | 圖片路徑,icon 大小限制為40kb |
| selectedIconPath | String | 是 | 選中時(shí)的圖片路徑,icon 大小限制為40kb |
可以設(shè)置各種網(wǎng)絡(luò)請(qǐng)求的超時(shí)時(shí)間。
屬性說明:
| 屬性 | 類型 | 必填 | 說明 |
|---|---|---|---|
| request | Number | 否 | wx.request的超時(shí)時(shí)間,單位毫秒 |
| connectSocket | Number | 否 | wx.connectSocket的超時(shí)時(shí)間,單位毫秒 |
| uploadFile | Number | 否 | wx.uploadFile的超時(shí)時(shí)間,單位毫秒 |
| downloadFile | Number | 否 | wx.downloadFile的超時(shí)時(shí)間,單位毫秒 |
可以在開發(fā)者工具中開啟 debug 模式,在開發(fā)者工具的控制臺(tái)面板,調(diào)試信息以 info 的形式給出,其信息有Page的注冊(cè),頁面路由,數(shù)據(jù)更新,事件觸發(fā) 。
page.json
每一個(gè)小程序頁面也可以使用.json文件來對(duì)本頁面的窗口表現(xiàn)進(jìn)行配置。 頁面的配置比app.json全局配置簡(jiǎn)單得多,只是設(shè)置 app.json 中的 window 配置項(xiàng)的內(nèi)容,頁面中配置項(xiàng)會(huì)覆蓋 app.json 的 window 中相同的配置項(xiàng)。
頁面的.json只能設(shè)置 window 相關(guān)的配置項(xiàng),以決定本頁面的窗口表現(xiàn),所以無需寫 window 這個(gè)鍵,如:
{
"navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "微信接口功能演示",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light"
}
感謝閱讀,希望能幫助到大家,謝謝大家對(duì)本站的支持!
- 微信小程序購物商城系統(tǒng)開發(fā)系列-目錄結(jié)構(gòu)介紹
- 微信小程序 wx.request合法域名配置詳解
- 微信公眾號(hào)菜單配置微信小程序?qū)嵗斀?/a>
- 微信小程序 教程之小程序配置
- 微信小程序Server端環(huán)境配置詳解(SSL, Nginx HTTPS,TLS 1.2 升級(jí))
- 微信小程序(二)Window 配置詳細(xì)介紹
- 微信小程序 Nginx環(huán)境配置詳細(xì)介紹
- 微信小程序?qū)W習(xí)(4)-系統(tǒng)配置app.json詳解
- node.js微信小程序配置消息推送的實(shí)現(xiàn)
- 微信小程序?qū)W習(xí)筆記之目錄結(jié)構(gòu)、基本配置圖文詳解
相關(guān)文章
微信小程序getPhoneNumber獲取用戶手機(jī)號(hào)
這篇文章主要介紹了 微信小程序getPhoneNumber獲取用戶手機(jī)號(hào)的相關(guān)資料,希望通過本文能幫助到大家,需要的朋友可以參考下2017-09-09
利用JavaScript寫一個(gè)簡(jiǎn)單計(jì)算器
這篇文章主要介紹了?如何利用JavaScript寫一個(gè)簡(jiǎn)單計(jì)算器,利用JavaScript寫一個(gè)簡(jiǎn)單計(jì)算器算是一個(gè)簡(jiǎn)單的小練習(xí)吧,需要的小伙伴可以參考一下<BR>2021-11-11
JS開發(fā)前端團(tuán)隊(duì)展示控制器來為成員引流
這篇文章主要為大家介紹了JS開發(fā)前端團(tuán)隊(duì)展示控制器實(shí)現(xiàn)為成員引流示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-08-08
JS前端可擴(kuò)展的低代碼UI框架Sunmao使用詳解
這篇文章主要為大家介紹了JS前端可擴(kuò)展的低代碼UI框架Sunmao使用詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-07-07
精確到按鈕級(jí)別前端權(quán)限管理實(shí)現(xiàn)方案
這篇文章主要為大家介紹了精確到按鈕級(jí)別前端權(quán)限管理實(shí)現(xiàn)方案詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-09-09

