初识小程序 - 配置

作者: 勇敢的_心_ | 来源:发表于2018-03-26 10:34 被阅读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"    }
    

    相关文章

      网友评论

        本文标题:初识小程序 - 配置

        本文链接:https://www.haomeiwen.com/subject/cdgtcftx.html