注意

app.config.js 中配置页面时,需要注意以下几点:

  • 路径必须以 / 开头,且对应的文件路径必须存在
  • 页面配置中的 navigationBarTitleText 用于设置页面顶部标题
  • 所有页面路径需在 pages 数组中声明,否则无法被访问
  • 支持通过配置分包,优化首包体积和加载速度

其他注意点

  • 页面路径不支持使用变量或者动态拼接,必须是静态字符串
  • 配置项中支持开启 enablePullDownRefresh 来实现下拉刷新功能
  • 若需要修改默认导航栏样式,可通过 window 配置项进行调整,如背景色、字体颜色等
  • 对于 tabBar 页面的配置,需要在根目录下的 tabBar 字段中声明,并且对应页面路径也要包含在 pages 数组内
  • 若存在多个小程序环境(如开发版和生产版),建议分别维护不同的配置文件,避免部署时出错

示例配置片段

export default {
  pages: [
    '/pages/index/index',
    '/pages/logs/logs'
  ],
  window: {
    navigationBarBackgroundColor: '#fff',
    navigationBarTextStyle: 'black',
    navigationBarTitleText: 'Taro App',
    backgroundColor: '#eeeeee'
  },
  tabBar: {
    list: [
      {
        pagePath: '/pages/index/index',
        text: '首页',
        iconPath: './assets/icon_home.png',
        selectedIconPath: './assets/icon_home_active.png'
      },
      {
        pagePath: '/pages/logs/logs',
        text: '日志',
        iconPath: './assets/icon_logs.png',
        selectedIconPath: './assets/icon_logs_active.png'
      }
    ],
    color: '#999999',
    selectedColor: '#1AAD19',
    backgroundColor: '#ffffff'
  }
}