微信小程序程序员

初识小程序 - 配置

2018-03-26  本文已影响21人  勇敢的_心_

全局配置~app.json

 {
  "pages": [ "pages/index/index",
                 "pages/logs/index" ], 
  "window": {
        "navigationBarTitleText": "Demo" }, 
  "tabBar": { 
      "list": [{ "pagePath": "pages/index/index", "text": "首页" },
               { "pagePath": "pages/logs/logs", "text": "日志" }] }, 
  "networkTimeout": { 
      " request": 10000, 
      "downloadFile": 10000 }, 
  "debug": true
 }
配置项 类型 必填 描述
pages Array 设置页面路径
window Object 设置默认页面的窗口表现
tabBar Object 设置底部tab的表现
networkTimeout Object 设置网络超时时间
debug Boolean 设置是否开启debug模式

1.pages配置项

pages配置项接受一个数组,用来指定小程序由哪些页面组成,是必需的配置项。数组的每一项都是字符串,代表对应页面的“路径+文件名”信息。

pages配置项要注意三点:
1)数组的第一项用于设定小程序的初始页面,即小程序启动页。
2)小程序中新增/减少页面,都需要对pages数组进行修改。
3)文件名不需要写文件后缀。小程序框架会自动去寻找路径.json、.js、.wxml、.wxss这四类文件进行整合。

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

2.window配置项

window配置项接受对象值,用来设置小程序的状态栏、导航条、标题、窗口等对象的颜色、背景色、内容属性,非必填配置项。没有配置时将使用默认值。

{ 
  "window":{ 
  "navigationBarBackgroundColor": "#ffffff",                                                                  "navigationBarTextStyle": "black",
   "navigationBarTitleText": "微信接口功能演示", 
  "backgroundColor": "#eeeeee", 
  "backgroundTextStyle": "light" }
 }
对象 类型 默认值 描述
navigationBarBackgroundColor HexColor #000000 导航栏背景颜色
navigationBarTextStyle String white 导航栏标题颜色
navigationBarTitleText String ... 导航栏标题文字内容
backgroundColor HexColor #ffffff 窗口的背景色
backgroundTextStyle String dark 下拉背景字体、loading图的样式,仅支持dark/light
enablePullDownRefresh Boolean false 是否开启下拉刷新

3.tabBar配置项

小程序可以是多标签页切换的应用,这种情况下,就需要通过tabBar配置项来指定标签页的表现,及标签页切换时所显示的对应页面;

对象 类型 必填 默认值 描述
color HexColor ... 标签上的文字默认颜色
selectedColor HexColor ... 标签页上的文字选中时的颜色
backgroundColor HexColor ... 标签页的背景色
borderStyle String black 标签条上的框线颜色,仅支持black/white
list Array ... 标签页列表,支持最少2个,最多5个标签页
position String bottom 可选值bottom、top
对象 类型 必填 描述
pagePath String 页面路径,必须在pages中先定义
text String 标签页上的按钮文字
iconPath String 标签上icon图片路径,icon图片大小限制为40KB
selectedIconPath String 选中标签时的icon图片路径,icon图片大小限制为40KB

tabBar配置项接受多个对象的设定,其中的对象list(列表)是一个数组,用于配置标签页。
注意:
1).只能配置最少2个、最多5个标签页。标签页按数组的顺序排序。
2).list(列表)接受数组值,数组中的每一项也都是一个对象。
对象的数据值说明如下:

对象 类型 必填 描述
pagePath String 页面路径,必须在pages中先定义
text String 标签页上的按钮文字
iconPath String 标签上icon图片路径,icon图片大小限制为40KB
selectedIconPath String 选中标签时的icon图片路径,icon图片大小限制为40KB

代码:

{ "tabBar":
   { "color":"#dddddd",
     "selectedColor":"#3cc51f",
     "borderStyle":"black",
     "backgroundColor":"#ffffff", 
      "list": [{ "pagePath": "pages/components ", 
                "iconPath": "pages/images/components.png",                       "selectedIconPath": "pages/images/componentsHL.png", 
                "text": "组件" }, 
      { "pagePath": "pages/interface", 
        "iconPath": "pages/images/interface.png", 
        "selectedIconPath": "pages/images/interfaceHL.png", 
        "text": "接口" }]
 }
 }

4.networkTimeout配置项

networkTimeout配置项用于设置各种网络请求对象的超时时间,非必须配置项。可设置的网络请求超时的相关对象有request、connectSocket、uploadFile、downloadFile。超时的单位均为毫秒。这些超时若不设置,则默认使用操作系统内核或遵循服务器WebServer的设定值。

对象 类型 必填 描述
request Number wx.request的超时时间,单位为ms
connectSocket Number wx.connectSocket的超时时间,单位为ms
uploadFile Number wx.uploadFile的超时时间,单位为ms
downloadFile Number wx.downloadFile的超时时间,单位为ms

代码:

{ 
        "networkTimeout": { "request":30000,
        "connectSocket":30000, 
        "uploadFile":30000,
        "downloadFile":30000 }
 }

5.debug配置项

debug配置项用于开启开发者工具的调试模式,它接受一个boolean值(默认值是false)。开启后,页面(page)的注册、页面路由、数据更新、事件触发等调试信息将以info的形式,输出在“调试”功能的console(控制台)面板上。
比如,以下配置为打开调试模式:

 { "debug": true }

页面配置~page.json

页面.json文件配置比app.json配置简单得多,只能设置window配置项的内容。显然页面.json文件中的window配置值将覆盖app.json中的配置值。

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

猜你喜欢

热点阅读