HomeDocs
跳到主要内容

页面配置

app.json 中的部分配置,也支持对单个页面进行配置,可以在页面对应的 .json 文件来对本页面的表现进行配置。

页面中配置项在当前页面会覆盖 app.json 中相同的配置项(样式相关的配置项属于 app.json 中的 window 属性,但这里不需要额外指定 window 字段),具体的取值和含义可参考全局配置文档中说明。

文件内容为一个 JSON 对象,有以下属性:

配置项

属性类型是否必填默认值描述最低版本
enablePullDownRefreshBooleanfalse是否允许下拉刷新1.0.0
enablePullUpRefreshBooleanfalse是否允许上拉刷新1.0.0
enableTransparentStatusBarBooleanfalse是否开启透明 TitleBar 沉浸式状态栏1.0.0
enableNavigationBarLoadingBooleantrue是否开否 TitleBar 加载进度条1.0.0
navigationBarTitleTextString页面默认标题1.0.0
navigationStyleString导航栏样式,支持的值参见下文
navigationBarBackgroundColorHexColor导航栏及状态栏背景颜色,如 #FFFFFF1.0.0
navigationBarTextStyleString导航栏及状态栏文字颜色,仅支持 black/white1.0.0
navigationBarIconStyleString导航栏 icon 颜色类型,仅支持black/white1.0.0
navigationBarHomeActionStringhome导航栏 Home 按钮动作,仅支持 home/back/all,含义说明参见下文。
refreshHeaderStyleString刷新头样式
default: 默认样式
custom:自定义刷新头。
自定义刷新头必须满足传入 refreshHeaderCustomLoadingGif、refreshHeaderCustomSuccessGif、refreshHeaderCustomLoading、refreshHeaderCustomSuccess 四个属性且满足要求后才可成功,否则将使用默认刷新头。
1.0.0
refreshHeaderCustomTextEnableBoolean刷新文案是否展示。仅在自定义刷新头开启情况下有效。1.0.0
refreshHeaderCustomLoadingGifString自定义刷新头加载动画,必须为 gif 图,且会循环播放。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。1.0.0
refreshHeaderCustomSuccessGifString自定义刷新头成功动画,必须为 gif 图,且单次播放。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。1.0.0
refreshHeaderCustomLoadingString自定义刷新加载静态占位图。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。1.0.0
refreshHeaderCustomSuccessString自定义刷新头成功静态占位图。仅支持小程序包内图片。仅在自定义刷新头开启情况下有效。1.0.0
refreshHeaderTranslationContentBooleantrue内容视图拖动效果是否开启。内容视图开启容器层透明状态栏且内容视图禁止拖动的情况下,Header 刷新起始显示以状态栏高度为偏移量开始显示。1.0.0
refreshHeaderAccentColorHexColor刷新头文字颜色,开启刷新组件有效,如 #0000001.0.0
refreshHeaderBackgroundColorHexColor刷新头背景颜色,开启刷新组件有效,如 #0000001.0.0
refreshHeaderDelayedNumber超时停止下拉刷新时间,默认不开启,大于 0 生效,单位 ms1.0.0
refreshFooterAccentColorHexColor刷新脚文字颜色,开启刷新组件有效,如 #0000001.0.0
refreshFooterBackgroundColorHexColor刷新脚背景颜色,开启刷新组件有效,如 #0000001.0.0
refreshFooterDelayedNumber超时停止上拉刷新时间,默认不开启,大于 0 生效,单位 ms1.0.0
contentBackgroundColorHexColor主页背景颜色,如 #0000001.0.0
enablePageLoadingBooleanfalse页面跳转 Loading。1.0.0
enableTabBarAdjustPanBooleanfalse含 TabBar 页面,有输入标签,支持 TabBar 不被键盘顶起4.1.0
darkModeNavigationBarBackgroundColorHexColor暗黑模式下导航栏及状态栏背景颜色,如 #000000006.0.0
darkModeNavigationBarTextStyleString暗黑模式下导航栏及状态栏文字颜色,仅支持 black / white6.0.0
darkModeNavigationBarIconStyleString暗黑模式下导航栏 icon 颜色类型,仅支持 black / white6.0.0
darkModeContentBackgroundColorHexColor暗黑模式下主页背景颜色,如 #0000006.0.0
  • 注 1:HexColor(十六进制颜色值),如 "#ff00ff"

navigationBarHomeAction 支持值说明

支持的值描述最低版本
home小房子按钮,点击时返回主页1.0.0
back向左返回箭头,点击时仅返回一级1.0.0
all显示返回与小房子胶囊体1.0.0

navigationStyle 支持值说明

支持的值描述最低版本
default默认样式1.0.0
hide隐藏导航栏只保留胶囊体(该模式下 navigationBarTextStylenavigationBarIconStyle 不生效,包括对应 api 调用也不生效)3.0.0
custom自定义导航栏(仅有该状态下,enableTransparentStatusBar, navigationBarBackgroundColor, navigationBarTextStyle, navigationBarIconStylenavigationBarHomeAction ,才可生效,包括对应 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"
}
Privacy agreementDeveloper agreementcontact us: developer_service.mi@transsion.com © 2024 MiniApp. All Rights Reserved.