開發與維運

MINA小程序開發框架

MINA


MINA(MINA IS NOT APP) 是在微信中開發小程序的框架。

MINA的目標是通過儘可能簡單、高效的方式讓開發者可以在微信中開發具有原生APP體驗的服務。

MINA提供了自己的視圖層描述語言WXML和WXSS,以及基於JavaScript的邏輯層框架,並在視圖層與邏輯層間提供了數據傳輸和事件系統,可以讓開發者可以方便的聚焦於數據與邏輯上。

文件結構


框架程序包含一個描述整體程序的 app 和多個描述各自頁面的 page。

一個框架程序主體部分由三個文件組成,必須放在項目的根目錄,如下:

文件 必填 作用
app.js 小程序邏輯
app.json 小程序公共設置
app.wxss 小程序公共樣式表

一個框架頁面由四個文件組成,分別是:

文件類型 必填 作用
js 頁面邏輯
wxml 頁面結構
wxss 頁面樣式表
json 頁面配置

配置


我們使用app.json文件來對微信小程序進行全局配置,決定頁面文件的路徑、窗口表現、設置網絡超時時間、設置多 tab 等。

以下是一個包含了所有配置選項的簡單配置app.json :

{

"pages": [

"pages/wechat/wechat",

"pages/note/note",

"pages/find/find",

"pages/mine/mine",

"pages/message/message",

"pages/audio/audio",

"pages/info/info",

"pages/newfriend/newfriend",

"pages/moments/moments",

"pages/picker/picker",

"pages/upload/upload",

"pages/ws/ws",

"pages/index/index",

"pages/logs/logs"

],

"window":{

"navigationBarBackgroundColor": "#000",

"navigationBarTextStyle": "white",

"navigationBarTitleText": "",

"backgroundColor": "#eee",

"backgroundTextStyle": "dark"

},

"tabBar": {

"backgroundColor":"#333",

"selectedColor":"red",

"list": [{

"pagePath": "pages/wechat/wechat",

"iconPath":"image/wechat.png",

"selectedIconPath":"image/wechat_2.png",

"text": "微信"

}, {

"pagePath": "pages/note/note",

"iconPath":"image/note.png",

"selectedIconPath":"image/note_2.png",

"text": "通訊錄"

}, {

"pagePath": "pages/find/find",

"iconPath":"image/find.png",

"selectedIconPath":"image/find_2.png",

"text": "發現"

}, {

"pagePath": "pages/mine/mine",

"iconPath":"image/mine.png",

"selectedIconPath":"image/mine_2.png",

"text": "我"

}]

},

"networkTimeout": {

"request": 10000,

"downloadFile": 10000

},

"debug": true

}

app.json 配置項列表

屬性 類型 必填 描述
pages Array 設置頁面路徑
window Object 設置默認頁面的窗口表現
tabBar Object 設置底部 tab 的表現
networkTimeout Object 設置網絡超時時間
debug Boolean 設置是否開啟 debug 模式

pages

接受一個數組,每一項都是字符串,來指定小程序由哪些頁面組成。每一項代表對應頁面的【路徑+文件名】信息,數組的第一項代表小程序的初始頁面。小程序中新增/減少頁面,都需要對 pages 數組進行修改。

文件名不需要寫文件後綴,因為框架會自動去尋找路徑.json,.js,.wxml,.wxss的四個文件進行整合。

window

用於設置小程序的狀態欄、導航條、標題、窗口背景色。

屬性 類型 默認值 描述
navigationBarBackgroundColor HexColor #000000 導航欄背景顏色,如"#000000"
navigationBarTextStyle String white 導航欄標題顏色,僅支持 black/white
navigationBarTitleText String 導航欄標題文字內容
backgroundColor HexColor #ffffff 下拉窗口的背景色
backgroundTextStyle String dark 下拉背景字體、loading 圖的樣式,僅支持 dark/light

tabBar

如果我們的小程序是一個多 tab 應用(客戶端窗口的底部有tab欄可以切換頁面),那麼我們可以通過 tabBar 配置項指定 tab 欄的表現,以及 tab 切換時顯示的對應頁面。

tabBar 是一個數組,只能配置最少2個、最多5個 tab,tab 按數組的順序排序。

屬性說明:

屬性 類型 必填 默認值 描述
color HexColor tab 上的文字默認顏色
selectedColor HexColor tab 上的文字選中時的顏色
backgroundColor HexColor tab 的背景色
borderStyle String black tabbar上邊框的顏色, 僅支持 black/white
list Array tab 的列表,詳見 list 屬性說明,最少2個、最多5個 tab

其中 list 接受一個數組,數組中的每個項都是一個對象,其屬性值如下:

屬性 類型 必填 說明
pagePath String 頁面路徑,必須在 pages 中先定義
text String tab 上按鈕文字
iconPath String 圖片路徑,icon 大小限制為40kb
selectedIconPath String 選中時的圖片路徑,icon 大小限制為40kb

networkTimeout

可以設置各種網絡請求的超時時間。

屬性說明:

屬性 類型 必填 說明
request Number wx.request的超時時間,單位毫秒
connectSocket Number wx.connectSocket的超時時間,單位毫秒
uploadFile Number wx.uploadFile的超時時間,單位毫秒
downloadFile Number wx.downloadFile的超時時間,單位毫秒

debug

可以在開發者工具中開啟 debug 模式,在開發者工具的控制檯面板,調試信息以 info 的形式給出,其信息有Page的註冊,頁面路由,數據更新,事件觸發 。 可以幫助開發者快速定位一些常見的問題。

每個頁面的配置文件(.json)

每一個小程序頁面也可以使用.json文件來對本頁面的窗口表現進行配置。 頁面的配置比app.json全局配置簡單得多,只是設置 app.json 中的 window 配置項的內容,頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。

頁面的.json只能設置 window 相關的配置項,以決定本頁面的窗口表現,所以無需寫 window 這個鍵,如:

{  

"navigationBarBackgroundColor":"#ffffff", 

"navigationBarTextStyle":"black",  

"navigationBarTitleText":"微信接口功能演示",  

"backgroundColor":"#eeeeee",  

"backgroundTextStyle":"light"

}

雲服務器ECS地址:阿里雲·雲小站

Leave a Reply

Your email address will not be published. Required fields are marked *