微信小程序-全局配置-pages/window

发布时间:2022-09-15 18:30

微信小程序-全局配置-pages/window

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

pages

用于指定小程序由哪些页面组成,每一项都对应一个页面的 路径(含文件名) 信息。文件名不需要写文件后缀,框架会自动去寻找对应位置的 .json.js.wxml.wxss 四个文件进行处理。

未指定 entryPagePath 时,数组的第一项代表小程序的初始页面(首页)。

小程序中新增/减少页面,都需要对 pages 数组进行修改。

如开发目录为:

├── app.js

├── app.json

├── app.wxss

├── pages

│   │── index

│   │   ├── index.wxml

│   │   ├── index.js

│   │   ├── index.json

│   │   └── index.wxss

│   └── logs

│       ├── logs.wxml

│       └── logs.js

└── utils

则需要在 app.json 中写

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

window

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

属性

类型

默认值

描述

最低版本

navigationBarBackgroundColor

HexColor

#000000

导航栏背景颜色,如 #000000

 

navigationBarTextStyle

string

white

导航栏标题颜色,仅支持 black / white

 

navigationBarTitleText

string

 

导航栏标题文字内容

 

navigationStyle

string

default

导航栏样式,仅支持以下值:
default 默认样式
custom 自定义导航栏,只保留右上角胶囊按钮。参见注 2。

iOS/Android 微信客户端 6.6.0,Windows 微信客户端不支持

backgroundColor

HexColor

#ffffff

窗口的背景色

 

backgroundTextStyle

string

dark

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

 

backgroundColorTop

string

#ffffff

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

微信客户端 6.5.16

backgroundColorBottom

string

#ffffff

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

微信客户端 6.5.16

enablePullDownRefresh

boolean

false

是否开启全局的下拉刷新。
详见 Page.onPullDownRefresh

 

onReachBottomDistance

number

50

页面上拉触底事件触发时距页面底部距离,单位为 px。
详见 Page.onReachBottom

 

pageOrientation

string

portrait

屏幕旋转设置,支持 autoportrait / landscape 
详见 响应显示区域变化

2.4.0 (auto) / 2.5.0(landscape)

  • 注 1:HexColor(十六进制颜色值),如"#ff00ff"
  • 注 2:关于navigationStyle
    • iOS/Android 客户端 7.0.0 以下版本,navigationStyle 只在 app.json 中生效。
    • iOS/Android 客户端 6.7.2 版本开始,navigationStyle: custom 对 web-view 组件无效
    • 开启 custom 后,低版本客户端需要做好兼容。开发者工具基础库版本切到 1.7.0(不代表最低版本,只供调试用)可方便切到旧视觉
    • Windows 客户端 3.0 及以上版本,为了给用户提供更符合桌面软件的使用体验,统一了小程序窗口的导航栏,navigationStyle: custom 不再生效

ItVuer - 免责声明 - 关于我们 - 联系我们

本网站信息来源于互联网,如有侵权请联系:561261067@qq.com

桂ICP备16001015号