小程序app.json 基础配置

本文介绍了小程序的基础配置文件app.json,包括pages数组定义页面、window设置界面样式、tabBar配置底部导航以及networkTimeout和debug选项的使用。pages数组中第一项为初始页面,tabBar的list数组用于定义最多5个底部tab,每个tab是一个包含路径、文字和选中状态颜色的对象。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

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
}

app.json配置列表

属性类型必填描述
pagesStringArray设置页面路径
windowObject设置默认页面的窗口表现
tabBarObject设置底部tab的表现
networkTimeoutObject设置网络超时时间
debugBoolean设置是否debug模式

+ pages 接受一个数组,每一项都是字符串,来指定小程序又那些页面组成。每一项代表页面对应的[路径+文件名]信息
数组的第一项代表出事页面,小程序中增减页面都需要对pages数组进行修改
文件名不需要写文件后缀,因为框架会自动去寻找路径下 .json, .js, .wxml, .wxss 四个文件进行整合。

  • window 用于设置小程序的状态栏、导航条、标题、窗口背景色
属性类型必填描述
navigationBarBackgroundColorHexColor000000导航栏背景颜色,如”#000000”
navigationBarTextStyleStringwhite导航栏标题颜色,仅支持 black/white
navigationBarTitleTextString导航栏标题文字内容
backgroundColorHexColorffffff窗口的背景色
backgroundTextStyleStringdark下拉背景字体、loading 图的样式,仅支持 dark/light
enablePullDownRefreshBooleanfalse是否开启下拉刷新,详见页面相关事件处理函数。
onReachBottomDistanceNumber50页面上拉触底事件触发时距页面底部距离,单位为px
  • tabBar
    如果小程序是一个多 tab 应用(客户端窗口的底部或顶部有 tab 栏可以切换页面),可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。
    Tip:
    当设置 position 为 top 时,将不会显示 icon
    tabBar 中的 list 是一个数组,只能配置最少2个、最多5个 tab,tab 按数组的顺序排序。
属性类型必填默认值描述
colorHexColortab上的文字默认颜色
selectedColorHexColortab上的文字选中时的颜色
backgroundColorHexColortab的背景色
borderStyleStringblacktabbar上边框的颜色, 仅支持 black/white
listArraytab的列表,详见 list 属性说明,最少2个、最多5个 tab
positionStringbottom可选值

其中 list 接受一个数组,数组中的每个项都是一个对象,其属性值如下:

属性类型必填说明
pagePathString页面路径,必须在 pages 中先定义
textStringtab 上按钮文字
iconPathString图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,当 postion 为
selectedIconPathString选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 postion 为 top 时,此参数无效

+ networkTimeout
设置网络超时时间

属性类型必填说明
requestNumberwx.request的超时时间,单位毫秒,默认为:60000
connectSocketNumberwx.connectSocket的超时时间,单位毫秒,默认为:60000
uploadFileNumberwx.uploadFile的超时时间,单位毫秒,默认为:60000
downloadFileNumberwx.downloadFile的超时时间,单位毫秒,默认为:60000
  • debug
    可以在开发者工具中开启 debug 模式,在开发者工具的控制台面板,调试信息以 info 的形式给出,其信息有Page的注册,页面路由,数据更新,事件触发 。 可以帮助开发者快速定位一些常见的问题。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值