页面配置
app.json 中的部分配置,也支持对单个页面进行配置,可以在页面对应的 .json 文件来对本页面的表现进行配置。
页面中配置项在当前页面会覆盖 app.json 中相同的配置项(样式相关的配置项属于 app.json 中的 window 属性,但这里不需要额外指定 window 字段),具体的取值和含义可参考全局配置文档中说明。
文件内容为一个 JSON 对象,有以下属性:
配置项
属性 | 类型 | 是否必填 | 默认值 | 描述 | 最低版本 |
---|---|---|---|---|---|
enablePullDownRefresh | Boolean | 否 | false | 是否允许下拉刷新 | 1.0.0 |
enablePullUpRefresh | Boolean | 否 | false | 是否允许上拉刷新 | 1.0.0 |
enableTransparentStatusBar | Boolean | 否 | false | 是否开启透明 TitleBar 沉浸式状态栏 | 1.0.0 |
enableNavigationBarLoading | Boolean | 否 | true | 是否开否 TitleBar 加载进度条 | 1.0.0 |
navigationBarTitleText | String | 否 | 页面默认标题 | 1.0.0 | |
navigationStyle | String | 是 | 导航栏样式,支持的值参见下文 | ||
navigationBarBackgroundColor | HexColor | 是 | 导航栏及状态栏背景颜色,如 #FFFFFF | 1.0.0 | |
navigationBarTextStyle | String | 是 | 导航栏及状态栏文字颜色,仅支持 black /white | 1.0.0 | |
navigationBarIconStyle | String | 是 | 导航栏 icon 颜色类型,仅支持black /white | 1.0.0 | |
navigationBarHomeAction | String | 否 | home | 导航栏 Home 按钮动作,仅支持 home /back /all ,含义说明参见下文。 | |
refreshHeaderStyle | String | 否 | 刷新头样式 default: 默认样式 custom:自定义刷新头。 自定义刷新头必须满足传入 refreshHeaderCustomLoadingGif、refreshHeaderCustomSuccessGif、refreshHeaderCustomLoading、refreshHeaderCustomSuccess 四个属性且满足要求后才可成功,否则将使用默认刷新头。 | 1.0.0 | |
refreshHeaderCustomTextEnable | Boolean | 否 | 刷新文案是否展示。仅在自定义刷新头开启情况下有效。 | 1.0.0 | |
refreshHeaderCustomLoadingGif | String | 否 | 自定义刷新头加载动画,必须为 gif 图,且会循环播放。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。 | 1.0.0 | |
refreshHeaderCustomSuccessGif | String | 否 | 自定义刷新头成功动画,必须为 gif 图,且单次播放。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。 | 1.0.0 | |
refreshHeaderCustomLoading | String | 否 | 自定义刷新加载静态占位图。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。 | 1.0.0 | |
refreshHeaderCustomSuccess | String | 否 | 自定义刷新头成功静态占位图。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。 | 1.0.0 | |
refreshHeaderTranslationContent | Boolean | 否 | true | 内容视图拖动效果是否开启。内容视图开启容器层透明状态栏且内容视图禁止拖动的情况下,Header 刷新起始显示以状态栏高度为偏移量开始显示。 | 1.0.0 |
refreshHeaderAccentColor | HexColor | 否 | 刷新头文字颜色,开启刷新组件有效,如 #000000 | 1.0.0 | |
refreshHeaderBackgroundColor | HexColor | 否 | 刷新头背景颜色,开启刷新组件有效,如 #000000 | 1.0.0 | |
refreshHeaderDelayed | Number | 否 | 超时停止下拉刷新时间,默认不开启,大于 0 生效,单位 ms | 1.0.0 | |
refreshFooterAccentColor | HexColor | 否 | 刷新脚文字颜色,开启刷新组件有效,如 #000000 | 1.0.0 | |
refreshFooterBackgroundColor | HexColor | 否 | 刷新脚背景颜色,开启刷新组件有效,如 #000000 | 1.0.0 | |
refreshFooterDelayed | Number | 否 | 超时停止上拉刷新时间,默认不开启,大于 0 生效,单位 ms | 1.0.0 | |
contentBackgroundColor | HexColor | 否 | 主页背景颜色,如 #000000 | 1.0.0 | |
enablePageLoading | Boolean | 否 | false | 页面跳转 Loading。 | 1.0.0 |
enableTabBarAdjustPan | Boolean | 否 | false | 含 TabBar 页面,有输入标签,支持 TabBar 不被键盘顶起 | 4.1.0 |
darkModeNavigationBarBackgroundColor | HexColor | 否 | 暗黑模式下导航栏及状态栏背景颜色,如 #00000000 | 6.0.0 | |
darkModeNavigationBarTextStyle | String | 否 | 暗黑模式下导航栏及状态栏文字颜色,仅支持 black / white | 6.0.0 | |
darkModeNavigationBarIconStyle | String | 否 | 暗黑模式下导航栏 icon 颜色类型,仅支持 black / white | 6.0.0 | |
darkModeContentBackgroundColor | HexColor | 否 | 暗黑模式下主页背景颜色,如 #000000 | 6.0.0 |
- 注 1:HexColor(十六进制颜色值),如 "#ff00ff"
navigationBarHomeAction 支持值说明
支持的值 | 描述 | 最低版本 |
---|---|---|
home | 小房子按钮,点击时返回主页 | 1.0.0 |
back | 向左返回箭头,点击时仅返回一级 | 1.0.0 |
all | 显示返回与小房子胶囊体 | 1.0.0 |
navigationStyle 支持值说明
支持的值 | 描述 | 最低版本 |
---|---|---|
default | 默认样式 | 1.0.0 |
hide | 隐藏导航栏只保留胶囊体(该模式下 navigationBarTextStyle 、navigationBarIconStyle 不生效,包括对应 api 调用也不生效) | 3.0.0 |
custom | 自定义导航栏(仅有该状态下,enableTransparentStatusBar , navigationBarBackgroundColor , navigationBarTextStyle , navigationBarIconStyle 、navigationBarHomeAction ,才可生效,包括对应 api 调用) | 1.0.0 |
页面配置示例
{
"enablePullDownRefresh": false,
"enablePullUpRefresh": false,
"enableAddScreen": true,
"navigationStyle": "custom",
"navigationBarTitleText": "MiniApp Official Demo",
"navigationBarBackgroundColor": "#FFFFFF",
"navigationBarTextStyle": "black",
"navigationBarIconStyle": "black",
"navigationBarHomeAction": "back",
"darkModeNavigationBarBackgroundColor": "#000000",
"darkModeNavigationBarTextStyle": "white",
"darkModeNavigationBarIconStyle": "white",
"darkModeContentBackgroundColor": "#000000"
}