微信小程序基础配置

469 阅读2分钟

全局配置

在app.json里进行配置

pages-页面路径列表

  1. 用来指定小程序有哪些页面组成,每一项对应页面的路径信息,文件名不需要写后缀
  2. 页面相关文件:.json/.js/.wxml/.wxss
  3. 新增、减少页面,需要对pages数组进行修改
  4. 没有entryPagePath时,pages数组第一项默认为首页展示页

pages.png

entryPagePath-默认启动路径(首页)

window-设置小程序状态栏,导航条,标题,窗口背景色

  1. navigationBarBackgroundColor导航栏背景色,支持#ffffff格式
  2. navigationBarTitleText导航栏标题文字内容
  3. navigationBarTextStyle导航栏标题颜色,仅支持black/white
  4. backgroundTextStyle下拉loading的样式,仅支持dark/light
  5. enablePullDownRefresh是否开启全局下拉刷新,true/false
  6. backgroundColor下拉窗口的背景色,支持#ffffff格式

window.png

tabBar-顶部/底部tab栏切换页面-颜色仅支持#ffffff格式

  1. color,tab栏上文字的默认颜色
  2. selectedColor,tab栏上文字被选中的颜色
  3. backgroundColor,tab栏的背景色
  4. borderStyle,tab栏边框颜色,仅支持black/white
  5. position,tab栏的位置,仅支持bottom/top
  6. list,tab栏的列表,最少2,最多5

tabBar.png

list配置

  1. pagePath,页面路径,必须在pages中先定义
  2. text,tab上按钮的文字
  3. iconPath,未被选中的图标路径,当position为top时不显示icon
  4. selectedIconPath,选中的图标路径

list.png

页面配置

pages.json-当前页面的配置

  1. navigationBarBackgroundColor导航栏背景色,支持#ffffff格式
  2. navigationBarTitleText导航栏标题文字内容
  3. navigationBarTextStyle导航栏标题颜色,仅支持black/white
  4. backgroundTextStyle下拉loading的样式,仅支持dark/light
  5. enablePullDownRefresh是否开启全局下拉刷新,true/false
  6. backgroundColor下拉窗口的背景色,支持#ffffff格式
  7. usingComponents页面自定义组件配置

pages-json.png

sitemap配置

配置小程序及其页面是否允许被微信索引,没有sitemap.json,则默认所有页面都允许被索引

  1. rulse,索引规则列表,对象类型,每项规则都是一个JSON对象
  • action,字符串,命中该规则的页面是否能被索引,取值allow/disallow
  • page,字符串,必填,所有页面,页面路径
  • parmas,page字段可能使用的参数名称列表
  • matching,说明parmas的匹配方式
    • exact,页面参数列表等于parmas时,规则命中
    • inclusive,页面参数列表包含parmas时,规则命中
    • exclusive,页面参数列表与parmas交集为空时,规则命中
    • partial,页面参数列表与parmas交集不为空时,规则命中
  • priority,优先级,默认从上到下

sitemap.png