📘
Luckydesigner
  • Knowledge Code Guide
  • HTML CODE
    • Dictionary
  • CSS CODE
    • Dictionary
  • Javascript Code
    • Dictionary
    • Examples
    • Reference
  • Regular Expressions
    • Reference
  • Wechat Mini Program Develop Notes
    • 开篇
    • 流程
    • 构成
      • 框架
    • 配置
      • index.wxml+index.js
      • Button
      • UserInfo
      • TabBar
      • Clipboard
    • Api
      • 背景
      • 交互
      • 导航栏
    • 标签
Powered by GitBook
On this page
  • 全局配置
  • app.json
  • app.wxss
  • app.js
  • Sitemap.json

Was this helpful?

  1. Wechat Mini Program Develop Notes

配置

Previous框架Nextindex.wxml+index.js

Last updated 4 years ago

Was this helpful?

全局配置

app.json

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

entryPagePath

指定小程序的默认启动路径(首页),常见情景是从微信聊天列表页下拉启动、小程序列表启动等。如果不填,将默认为 pages 列表的第一项。不支持带页面路径参数。

{
  "entryPagePath": "pages/index/index"
}

pages

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

window

用于设置小程序的状态栏、导航条、标题、窗口背景色。

  • navigationBarBackgroundColor 导航栏背景颜色

  • navigationBarTextStyle 导航栏标题颜色 两个参数“black”和“white”

  • navigationBarTitleText 导航栏标题文字内容

  • navigationStyle 导航栏样式仅支持default和custom

  • backgroundColor #ffffff

  • backgroundTextStyle 下拉 loading 的样式,仅支持 dark / light

  • backgroundColorTop 顶部窗口的背景色,仅 iOS 支持

  • backgroundColorBottom 底部窗口的背景色,仅 iOS 支持

  • onReachBottomDistance

  • enablePullDownRefresh 页面刷新,true or false

  • pageOrientation 页面旋转,拥有参数auto/portrait/landscape,其中auto是跟随系统旋转,landscape是固定横屏,portrait是固定竖屏,如果要支持ipad,则需要是使用如下的命令:

{
  "resizable": true
}

tap

如果小程序是一个多 tab 应用(客户端窗口的底部或顶部有 tab 栏可以切换页面),可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。

其中 list 接受一个数组,只能配置最少 2 个、最多 5 个 tab。tab 按数组的顺序排序,每个项都是一个对象,其属性值如下:

networkTimeout

各类网络请求的超时时间,单位均为毫秒。

app.wxss

app.js

App(Object object)

注册小程序。接受一个 Object 参数,其指定小程序的生命周期回调等。

App() 必须在 app.js 中调用,必须调用且只能调用一次。不然会出现无法预期的后果。

参数

Object object

属性

类型

默认值

必填

说明

最低版本

onLaunch

function

否

生命周期回调——监听小程序初始化。

onShow

function

否

生命周期回调——监听小程序启动或切前台。

onHide

function

否

生命周期回调——监听小程序切后台。

onError

function

否

错误监听函数。

onPageNotFound

function

否

页面不存在监听函数。

1.9.90

onUnhandledRejection

function

否

未处理的 Promise 拒绝事件监听函数。

2.10.0

onThemeChange

function

否

监听系统主题变化

2.11.0

其他

any

否

开发者可以添加任意的函数或数据变量到 Object 参数中,用 this 可以访问

Sitemap.json

小程序根目录下的 sitemap.json 文件用来配置小程序及其页面是否允许被微信索引。

{
  "rules":[{
    "action": "allow",
    "page": "*"
  }]
}