Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-uni-app-x-zh
提交
2aa5323e
U
unidocs-uni-app-x-zh
项目概览
DCloud
/
unidocs-uni-app-x-zh
通知
144
Star
2
Fork
33
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
9
列表
看板
标记
里程碑
合并请求
11
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-uni-app-x-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
9
Issue
9
列表
看板
标记
里程碑
合并请求
11
合并请求
11
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
2aa5323e
编写于
12月 10, 2024
作者:
G
git_robot
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新 pagesJson.json
上级
b9390444
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
1 addition
and
1 deletion
+1
-1
docs/.vuepress/utils/pagesJson.json
docs/.vuepress/utils/pagesJson.json
+1
-1
未找到文件。
docs/.vuepress/utils/pagesJson.json
浏览文件 @
2aa5323e
{
"pages"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| globalStyle | [globalStyle 配置项列表](#pages-globalstyle) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 默认页面的窗口表现 |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 页面路径及窗口表现 |
\n
| tabBar | [tabBar 配置项列表](#pages-tabbar) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 底部 tab 的表现 |
\n
| topWindow | [topWindow 配置项列表](#pages-topwindow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 上窗体 |
\n
| leftWindow | [leftWindow 配置项列表](#pages-leftwindow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 左窗体 |
\n
| rightWindow | [rightWindow 配置项列表](#pages-rightwindow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 右窗体 |
\n
| condition | [condition 配置项列表](#pages-condition) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动模式 |
\n
| subPackages | Array
\\
<[PagesSubPackages](#pagessubpackages)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 分包加载配置 |
\n
| preloadRule | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 声明分包预下载的规则 |
\n
| workers | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 使用 Worker 处理多线程任务时，设置 Worker 代码放置的目录 |
\n
| easycom | [easycom 配置项列表](#pages-easycom) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 组件自动引入规则 |
\n
| uniIdRouter | [uniIdRouter 配置项列表](#pages-uniidrouter) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router) |
\n
| entryPagePath | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
√
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 默认启动首页 |"
},
"pages_globalStyle"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | string ([string.ThemeJsonString](/uts/data-type.md#ide-string)) |
\"
black
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题颜色，仅支持 black/white（支付宝小程序不支持，请使用 [my.setNavigationBar](https://opendocs.alipay.com/mini/api/xwq8e6)）。 |
\n
| navigationBarTitleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题文字内容 |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
3.99
\"
,
\"
x
\"
]]}' /> | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.11
\"
,
\"
x
\"
,
\"
4.0
\"
,
\"
4.11
\"
]]}' /> | 页面容器背景色 |
\n
| backgroundTextStyle | string ([string.ThemeJsonString](/uts/data-type.md#ide-string)) |
\"
dark
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.31
\"
,
\"
4.31
\"
]]}' /> | 下拉 loading 的样式，仅支持 dark / light |
\n
| enablePullDownRefresh | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏点击穿透 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.13
\"
,
\"
4.25
\"
]]}' /> | 横屏配置，屏幕旋转设置，仅支持 auto / portrait / landscape 详见 [响应显示区域变化](https://uniapp.dcloud.net.cn/collocation/pages.html#globalstyle)。 |
\n
| hideStatusBar | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统顶部状态栏 |
\n
| hideBottomNavigationIndicator | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统底部导航栏 |
\n
| androidThreeButtonNavigationTranslucent | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
]]}' /> | 页面内容是否可以渲染到虚拟按键区域 |
\n
| animationType | 'slide-in-right'
\\
| 'slide-in-left'
\\
| 'slide-in-top'
\\
| 'slide-in-bottom'
\\
| 'fade-in'
\\
| 'zoom-out'
\\
| 'zoom-fade-out'
\\
| 'pop-in' |
\"
pop-in
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
,
\"
x
\"
]]}' /> | 窗口显示的动画效果，详见：[窗口动画](https://uniapp.dcloud.net.cn/api/router.html#animation)。 |
\n
| animationDuration | number | 300 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口显示动画的持续时间，单位为 ms |
\n
| allowsBounceVertical | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否允许向下拉拽。默认 YES。如果需要下拉刷新，值必须为YES |
\n
| usingComponents | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 引用小程序组件，参考 [小程序组件](https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html)。 |
\n
| renderingMode | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 同层渲染，webrtc(实时音视频) 无法正常时尝试配置 seperated 强制关掉同层 |
\n
| leftWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 leftWindow时，默认是否显示 leftWindow |
\n
| topWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 topWindow时，默认是否显示 topWindow |
\n
| rightWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 rightWindow时，默认是否显示 rightWindow |
\n
| rpxCalcMaxDeviceWidth | number | 960 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | rpx 计算所支持的最大设备宽度，单位 px |
\n
| rpxCalcBaseDeviceWidth | number | 375 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | rpx 计算使用的基准设备宽度，设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算，单位 px |
\n
| rpxCalcIncludeWidth | number | 750 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | rpx 计算特殊处理的值，始终按实际的设备宽度计算，单位 rpx |
\n
| dynamicRpx | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 动态 rpx，屏幕大小变化会重新渲染 rpx |
\n
| maxWidth | number | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 单位px，当浏览器可见区域宽度大于maxWidth时，两侧留白，当小于等于maxWidth时，页面铺满；不同页面支持配置不同的maxWidth；maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |
\n
| app-plus | [app-plus 配置项列表](#globalstyle-app-plus) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 5+ App 特有配置 |
\n
| h5 | [h5 配置项列表](#globalstyle-h5) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | H5 特有配置 |
\n
| mp-alipay | [mp-alipay 配置项列表](#globalstyle-mp-alipay) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 支付宝小程序特有配置 |
\n
| mp-weixin | [mp-weixin 配置项列表](#globalstyle-mp-weixin) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 微信小程序特有配置 |
\n
| mp-baidu | [mp-baidu 配置项列表](#globalstyle-mp-baidu) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 百度小程序特有配置 |
\n
| mp-toutiao | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 头条小程序特有配置 |
\n
| mp-qq | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | QQ小程序特有配置 |
\n
| mp-kuaishou | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 快手小程序特有配置 |
\n
| mp-jd | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 设置编译到 mp-jd 平台的特定样式 |
\n
| mp-lark | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 飞书小程序特有配置 |"
,
"description"
:
"默认页面的窗口表现"
},
"globalStyle_app-plus"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗体背景色。无论vue页面还是nvue页面，在App上都有一个父级原生窗体，该窗体的背景色生效时间快于页面里的css生效时间，vue 页面需要将 body 背景色设为透明 |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏，详见:[导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView)。 |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生子窗体，详见:[原生子窗体](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVues)。 |
\n
| bounce | 'none'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'all' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面回弹效果，设置为
\"
none
\"
时关闭效果。仅支持 app-vue（nvue Android无页面级bounce效果，仅list、recycle-list、waterfall等滚动组件有bounce效果） |
\n
| popGesture | 'close'
\\
| 'none' |
\"
close
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 侧滑返回功能，可选值：
\"
close
\"
（启用侧滑返回）、
\"
none
\"
（禁用侧滑返回）。 |
\n
| softinputNavBar | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | iOS软键盘上完成工具栏的显示模式，设置为
\"
none
\"
时关闭工具栏。 |
\n
| softinputmode | 'nothing'
\\
| 'adjustPan'
\\
| 'adjustResize' |
\"
adjustPan
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 软键盘弹出模式，支持 adjustResize、adjustPan 两种模式 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |
\n
| scrollIndicator | 'all'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'none' |
\"
all
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否显示滚动条，设置为
\"
none
\"
时不显示滚动条。 |
\n
| animationType | 'slide-in-right'
\\
| 'slide-in-left'
\\
| 'slide-in-top'
\\
| 'slide-in-bottom'
\\
| 'fade-in'
\\
| 'zoom-out'
\\
| 'zoom-fade-out'
\\
| 'pop-in' |
\"
pop-in
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
,
\"
x
\"
]]}' /> | 窗口显示的动画效果，详见：[窗口动画](https://uniapp.dcloud.net.cn/api/router.html#animation)。 |
\n
| animationDuration | number | 300 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口显示动画的持续时间，单位为 ms |"
,
"description"
:
"5+ App 特有配置"
},
"app-plus_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#f7f7f7
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 背景颜色，支持16进制颜色或RGBA颜色(仅悬浮导航栏支持RGBA颜色)。 |
\n
| buttons | Array
\\
<[PageStyleAppPlusTitleNViewButton](#pagestyleappplustitlenviewbutton)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 自定义按钮(纯nvue即render:native时暂不支持)，详见 [buttons](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-buttons)。 |
\n
| titleColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#000000
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字颜色 |
\n
| titleOverflow | 'clip'
\\
| 'ellipsis' |
\"
ellipsis
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字超出显示区域时处理方式。
\"
clip
\"
-超出显示区域时内容裁剪；
\"
ellipsis
\"
-超出显示区域时尾部显示省略标记（...）。 |
\n
| titleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字内容 |
\n
| titleSize | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字字体大小 |
\n
| type | 'defaultValue'
\\
| 'transparent'
\\
| 'float' |
\"
defaultValue
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏样式。
\"
default
\"
-默认样式；
\"
transparent
\"
-滚动透明渐变；
\"
float
\"
-悬浮导航栏。 |
\n
| tags | array | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生 View 增强，详见：[5+ View 控件](http://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.ViewDrawTagStyles)。 |
\n
| searchInput | [searchInput 配置项列表](#titlenview-searchinput) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生导航栏上的搜索框配置，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-searchinput)。 |
\n
| homeButton | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏控件是否显示Home按钮 |
\n
| autoBackButton | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏控件是否显示左侧返回按钮 |
\n
| backButton | [backButton 配置项列表](#titlenview-backbutton) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 返回按钮的样式，详见：[backButton](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView-backButtonStyles)。 |
\n
| backgroundImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 支持以下类型： 背景图片路径 - 如
\"
./img/t.png
\"
，仅支持本地文件路径， 相对路径，相对于当前页面的host位置，根据实际标题栏宽高拉伸绘制； 渐变色 - 仅支持线性渐变，两种颜色的渐变，如“linear-gradient(to top, #a80077, #66ff00)”， 其中第一个参数为渐变方向，可取值：
\"
to right
\"
表示从左向右渐变，
\"
to left
\"
表示从右向左渐变，
\"
to bottom
\"
表示从上到下渐变，
\"
to top
\"
表示从下到上渐变，
\"
to bottom right
\"
表示从左上角到右下角，
\"
to top left
\"
表示从右下角到左上角。 |
\n
| backgroundRepeat | 'repeat'
\\
| 'repeat-x'
\\
| 'repeat-y'
\\
| 'no-repeat' |
\"
no-repeat
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 仅在backgroundImage设置为图片路径时有效。 可取值：
\"
repeat
\"
- 背景图片在垂直方向和水平方向平铺；
\"
repeat-x
\"
- 背景图片在水平方向平铺，垂直方向拉伸；
\"
repeat-y
\"
- 背景图片在垂直方向平铺，水平方向拉伸；
\"
no-repeat
\"
- 背景图片在垂直方向和水平方向都拉伸。 默认使用
\"
no-repeat
\"
。 |
\n
| titleAlign | 'center'
\\
| 'left'
\\
| 'auto' |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 可取值：
\"
center
\"
-居中对齐；
\"
left
\"
-居左对齐；
\"
auto
\"
-根据平台自动选择（Android平台居左对齐，iOS平台居中对齐） |
\n
| blurEffect | 'dark'
\\
| 'extralight'
\\
| 'light'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 此效果将会高斯模糊显示标题栏后的内容，仅在type为
\"
transparent
\"
或
\"
float
\"
时有效。 可取值：
\"
dark
\"
- 暗风格模糊，对应iOS原生UIBlurEffectStyleDark效果；
\"
extralight
\"
- 高亮风格模糊，对应iOS原生UIBlurEffectStyleExtraLight效果；
\"
light
\"
- 亮风格模糊，对应iOS原生UIBlurEffectStyleLight效果；
\"
none
\"
- 无模糊效果。 注意：使用模糊效果时应避免设置背景颜色，设置背景颜色可能覆盖模糊效果。 |
\n
| coverage | string |
\"
132px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏控件变化作用范围，仅在type值为transparent时有效，页面滚动时标题栏背景透明度将发生变化。 当页面滚动到指定偏移量时标题栏背景变为完全不透明。 支持百分比、像素值 |
\n
| splitLine | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏的底部分割线([SplitLineStyles](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView-splitLineStyles)))，设置此属性则在标题栏控件的底部显示分割线，可配置颜色值及高度。 设置此属性值为undefined或null则隐藏分割线。 默认不显示底部分割线 |
\n
| subtitleColor | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 副标题文字颜色，颜色值格式为
\"
#RRGGBB
\"
和
\"
rgba(R,G,B,A)
\"
，如
\"
#FF0000
\"
表示标题文字颜色为红色。 默认值与主标题文字颜色一致 |
\n
| subtitleSize | string |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 副标题文字字体大小，字体大小单位为像素，如
\"
14px
\"
表示字体大小为14像素，auto表示自动计算，约为12像素。 |
\n
| subtitleOverflow | 'clip'
\\
| 'ellipsis' |
\"
ellipsis
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字超出显示区域时处理方式，可取值：
\"
clip
\"
- 超出显示区域时内容裁剪；
\"
ellipsis
\"
- 超出显示区域时尾部显示省略标记（...）。 |
\n
| subtitleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 副标题文字内容，设置副标后将显示两行标题，副标显示在主标题（titleText）下方。 注意：设置副标题后将居左显示 |
\n
| titleIcon | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题图标，图标路径如
\"
./img/t.png
\"
，仅支持本地文件路径， 相对路径，相对于当前页面的host位置，固定宽高为逻辑像素值
\"
34px
\"
。 要求图片的宽高相同。 注意：设置标题图标后标题将居左显示。 |
\n
| titleIconRadius | string |
\"
无圆角
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题图标圆角，取值格式为
\"
XXpx
\"
，其中XX为像素值（逻辑像素），如
\"
10px
\"
表示10像素半径圆角。 |"
,
"description"
:
"导航栏，详见:[导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView)。"
},
"PageStyleAppPlusTitleNViewButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| type | 'forward'
\\
| 'back'
\\
| 'share'
\\
| 'favorite'
\\
| 'home'
\\
| 'menu'
\\
| 'close'
\\
| 'none' |
\"
none
\"
| 否 | - | 按钮样式，可取值见：[buttons 样式](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-buttons-type) |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
默认与标题文字颜色一致
\"
| 否 | - | 按钮上文字颜色 |
\n
| colorPressed | string |
\"
默认值为 color 属性值自动调整透明度为 0.3
\"
| 否 | - | 按下状态按钮文字颜色 |
\n
| float | 'right'
\\
| 'left' |
\"
right
\"
| 否 | - | 按钮在标题栏上的显示位置，可取值
\"
left
\"
、
\"
right
\"
|
\n
| fontWeight | 'normal'
\\
| 'bold' |
\"
normal
\"
| 否 | - | 按钮上文字的粗细。可取值
\"
normal
\"
-标准字体、
\"
bold
\"
-加粗字体。 |
\n
| fontSize | string | - | 否 | - | 按钮上文字大小 |
\n
| fontSrc | string | - | 否 | - | 按钮上文字使用的字体文件路径。不支持网络地址，请统一使用本地地址。 |
\n
| select | boolean | false | 否 | - | 是否显示选择指示图标（向下箭头），常用于城市选择 |
\n
| text | string | - | 否 | - | 按钮上显示的文字。使用字体图标时 unicode 字符表示必须
\"\\
u
\"
开头，如
\"
\"
（注意不能写成
\"\\
e123
\"
）。 |
\n
| width | string |
\"
44px
\"
| 否 | - | 按钮的宽度，可取值：
\"
*px
\"
- 逻辑像素值，如
\"
10px
\"
表示10逻辑像素值，不支持rpx。按钮的内容居中显示；
\"
auto
\"
- 自定计算宽度，根据内容自动调整按钮宽度 |"
},
"titleNView_searchInput"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| autoFocus | boolean | false | 否 | - | 是否自动获取焦点 |
\n
| align | 'left'
\\
| 'right'
\\
| 'center' |
\"
center
\"
| 否 | - | 非输入状态下文本的对齐方式。可取值：
\"
left
\"
- 居左对齐；
\"
right
\"
- 居右对齐；
\"
center
\"
- 居中对齐。 |
\n
| backgroundColor | string |
\"
rgba(255,255,255,0.5)
\"
| 否 | - | 背景颜色 |
\n
| borderRadius | string |
\"
0px
\"
| 否 | - | 输入框的圆角半径，取值格式为
\"
XXpx
\"
，其中XX为像素值（逻辑像素），不支持rpx。 |
\n
| placeholder | string | - | 否 | - | 提示文本 |
\n
| placeholderColor | string |
\"
#cccccc
\"
| 否 | - | 提示文本颜色 |
\n
| disabled | boolean | false | 否 | - | 是否可输入 |"
,
"description"
:
"原生导航栏上的搜索框配置，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-searchinput)。"
},
"titleNView_backButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | string |
\"
none
\"
| 否 | - | 背景颜色，仅在标题栏type=transparent时生效，当标题栏透明时按钮显示的背景颜色。 可取值#RRGGBB和rgba格式颜色字符串，默认值为灰色半透明。 |
\n
| badgeText | string | - | 否 | - | 角标文本，最多显示3个字符，超过则显示为... |
\n
| color | string |
\"
窗口标题栏控件的标题文字颜色。
\"
| 否 | - | 图标和标题颜色，可取值：
\"
#RRGGBB
\"
格式字符串，如
\"
#FF0000
\"
表示红色；
\"
rgba(R,G,B,A)
\"
，其中R/G/B分别代表红色值/绿色值/蓝色值，正整数类型，取值范围为0-255，A为透明度，浮点数类型，取值范围为0-1（0为全透明，1为不透明），如
\"
rgba(255,0,0,0.5)
\"
，表示红色半透明。 |
\n
| colorPressed | string | - | 否 | - | 按下状态按钮文字颜色，可取值：
\"
#RRGGBB
\"
格式字符串，如
\"
#FF0000
\"
表示红色；
\"
rgba(R,G,B,A)
\"
，其中R/G/B分别代表红色值/绿色值/蓝色值，正整数类型，取值范围为0-255，A为透明度，浮点数类型，取值范围为0-1（0为全透明，1为不透明），如
\"
rgba(255,0,0,0.5)
\"
，表示红色半透明。 默认值为color属性值自动调整透明度为0.3。 |
\n
| fontWeight | string |
\"
normal
\"
| 否 | - | 返回图标的粗细，可取值：
\"
normal
\"
- 标准字体；
\"
bold
\"
- 加粗字体。 |
\n
| fontSize | string | - | 否 | - | 返回图标文字大小，可取值：字体高度像素值，数字加
\"
px
\"
格式字符串，如
\"
22px
\"
。 窗口标题栏为透明样式（type=
\"
transparent
\"
）时，默认值为
\"
22px
\"
； 窗口标题栏为默认样式（type=
\"
default
\"
）时，默认值为
\"
27px
\"
。 |
\n
| redDot | boolean | false | 否 | - | 是否显示红点，设置为true则显示红点，false则不显示红点。默认值为false。 注意：当设置了角标文本时红点不显示。 |
\n
| title | string | - | 否 | - | 返回按钮上的标题，显示在返回图标（字体图标）后，默认为空字符串。 |
\n
| titleWeight | 'normal'
\\
| 'bold' |
\"
normal
\"
| 否 | - | 返回按钮上标题的粗细，可取值：
\"
normal
\"
- 标准字体；
\"
bold
\"
- 加粗字体。 |"
,
"description"
:
"返回按钮的样式，详见：[backButton](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView-backButtonStyles)。"
},
"PageStyleAppPlusSubNVues"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| id | string | - | 否 | - | subNVue 原生子窗体的标识 |
\n
| path | string ([string.NPageURIString](/uts/data-type.md#ide-string)) | - | 否 | - | 配置 nvue 文件路径，nvue 文件需放置到使用 subNvue 的页面文件目录下 |
\n
| type | 'popup'
\\
| 'navigationBar' | - | 否 | - | 内置样式 |
\n
| style | [style 配置项列表](#pagestyleappplussubnvues-style) | - | 否 | - | subNVue 原生子窗体的样式，配置项参考下方[subNVuesStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVuesStyle) |"
},
"PageStyleAppPlusSubNVues_style"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| position | 'static'
\\
| 'absolute'
\\
| 'dock' |
\"
absolute
\"
| 否 | - | 原生子窗体的排版位置，排版位置决定原生子窗体在父窗口中的定位方式。 可取值：
\"
static
\"
，原生子窗体在页面中正常定位，如果页面存在滚动条则随窗口内容滚动；
\"
absolute
\"
，原生子窗体在页面中绝对定位，如果页面存在滚动条不随窗口内容滚动；
\"
dock
\"
，原生子窗体在页面中停靠，停靠的位置由dock属性值决定。 默认值为
\"
absolute
\"
。 |
\n
| dock | 'top'
\\
| 'bottom'
\\
| 'right'
\\
| 'left' |
\"
bottom
\"
| 否 | - | 原生子窗体的停靠方式,仅当原生子窗体
\"
position
\"
属性值设置为
\"
dock
\"
时才生效，可取值：
\"
top
\"
，原生子窗体停靠则页面顶部；
\"
bottom
\"
，原生子窗体停靠在页面底部；
\"
right
\"
，原生子窗体停靠在页面右侧；
\"
left
\"
，原生子窗体停靠在页面左侧。 默认值为
\"
bottom
\"
。 |
\n
| mask | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
rgba(0,0,0,0.5)
\"
| 否 | - | 原生子窗体的遮罩层,仅当原生子窗体
\"
type
\"
属性值设置为
\"
popup
\"
时才生效，可取值： rgba格式字符串，定义纯色遮罩层样式，如
\"
rgba(0,0,0,0.5)
\"
，表示黑色半透明； |
\n
| width | string |
\"
100%
\"
| 否 | - | 原生子窗体的宽度,支持百分比、像素值，默认为100%。未设置width属性值时，可同时设置left和right属性值改变窗口的默认宽度。 |
\n
| height | string |
\"
100%
\"
| 否 | - | 原生子窗体的高度,支持百分比、像素值，默认为100%。 当未设置height属性值时，优先通过top和bottom属性值来计算原生子窗体的高度。 |
\n
| top | string |
\"
0px
\"
| 否 | - | 原生子窗体垂直向下的偏移量，支持百分比、像素值，默认值为0px。 未设置top属性值时，优先通过bottom和height属性值来计算原生子窗体的top位置。 |
\n
| bottom | string | - | 否 | - | 原生子窗体垂直向上偏移量,支持百分比、像素值，默认值无值（根据top和height属性值来自动计算）。 当同时设置了top和height值时，忽略此属性值； 当未设置height值时，可通过top和bottom属性值来确定原生子窗体的高度。 |
\n
| left | string |
\"
0px
\"
| 否 | - | 原生子窗体水平向左的偏移量，支持百分比、像素值，默认值为0px。 未设置left属性值时，优先通过right和width属性值来计算原生子窗体的left位置。 |
\n
| right | string | - | 否 | - | 原生子窗体水平向右的偏移量，支持百分比、像素值，默认无值（根据left和width属性值来自动计算）。 当设置了left和width值时，忽略此属性值； 当未设置width值时，可通过left和bottom属性值来确定原生子窗体的宽度。 |
\n
| margin | string | - | 否 | - | 原生子窗体的边距，用于定位原生子窗体的位置，支持auto，auto表示居中。若设置了left、right、top、bottom则对应的边距值失效。 |
\n
| zindex | number | - | 否 | - | 原生子窗体的窗口的堆叠顺序值，拥有更高堆叠顺序的窗口总是会处于堆叠顺序较低的窗口的前面，拥有相同堆叠顺序的窗口后调用show方法则在前面。 |
\n
| background | string |
\"
#ffffff
\"
| 否 | - | 窗口的背景颜色,Android平台4.0以上系统才支持“transparent”背景透明样式。比如subnvue为圆角时需要设置为transparent才能看到正确的效果 |"
,
"description"
:
"subNVue 原生子窗体的样式，配置项参考下方[subNVuesStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVuesStyle)"
},
"app-plus_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| support | boolean | false | 否 | - | 是否开启窗口的下拉刷新功能 |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#2BD009
\"
| 否 | - | 颜色值格式为
\"
#RRGGBB
\"
，仅
\"
circle
\"
样式下拉刷新支持此属性。 |
\n
| style | 'defaultValue'
\\
| 'circle' |
\"
Android 平台为 circle；iOS 平台为 default。
\"
| 否 | - | 可取值：
\"
default
\"
——经典下拉刷新样式（下拉拖动时页面内容跟随）；
\"
circle
\"
——圆圈样式下拉刷新控件样式（下拉拖动时仅刷新控件跟随）。 |
\n
| height | string | - | 否 | - | 窗口的下拉刷新控件进入刷新状态的拉拽高度。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
，不支持 rpx。 |
\n
| range | string | - | 否 | - | 窗口可下拉拖拽的范围。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
，不支持 rpx。 |
\n
| offset | string |
\"
0px
\"
| 否 | - | 下拉刷新控件的起始位置。仅对
\"
circle
\"
样式下拉刷新控件有效，用于定义刷新控件下拉时的起始位置。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
，不支持rpx。如使用了非原生title且需要原生下拉刷新，一般都使用circle方式并将offset调至自定义title的高度 |
\n
| contentdown | [contentdown 配置项列表](#pulltorefresh-contentdown) | - | 否 | - | 目前支持一个属性：caption——在下拉可刷新状态时下拉刷新控件上显示的标题内容。仅对
\"
default
\"
样式下拉刷新控件有效。 |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | - | 目前支持一个属性：caption——在释放可刷新状态时下拉刷新控件上显示的标题内容。仅对
\"
default
\"
样式下拉刷新控件有效。 |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | - | 目前支持一个属性：caption——在正在刷新状态时下拉刷新控件上显示的标题内容。仅对
\"
default
\"
样式下拉刷新控件有效。 |"
,
"description"
:
"下拉刷新"
},
"pullToRefresh_contentdown"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在下拉可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentover"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在释放可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentrefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在正在刷新状态时下拉刷新控件显示的内容"
},
"globalStyle_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |"
,
"description"
:
"H5 特有配置"
},
"h5_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#f7f7f7
\"
| 否 | - | 背景颜色，颜色值格式为
\"
#RRGGBB
\"
。 |
\n
| buttons | array | - | 否 | - | 自定义按钮，参考 [buttons](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-titlenview-buttons)。 |
\n
| titleColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#000000
\"
| 否 | - | 标题文字颜色 |
\n
| titleText | string | - | 否 | - | 标题文字内容 |
\n
| titleSize | string | - | 否 | - | 标题文字字体大小 |
\n
| type | 'defaultValue'
\\
| 'transparent' |
\"
defaultValue
\"
| 否 | - | 导航栏样式。
\"
default
\"
-默认样式；
\"
transparent
\"
-透明渐变。 |
\n
| searchInput | object | - | 否 | - | 导航栏上的搜索框样式，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-searchinput)。 |"
,
"description"
:
"导航栏设置"
},
"h5_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| support | boolean | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否开启窗口的下拉刷新功能 |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 颜色值格式为
\"
#RRGGBB
\"
，仅
\"
circle
\"
样式下拉刷新支持此属性。 |
\n
| type | 'defaultValue'
\\
| 'circle' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件样式 |
\n
| height | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口的下拉刷新控件进入刷新状态的拉拽高度。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
。 |
\n
| range | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口可下拉拖拽的范围。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
。 |
\n
| offset | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件的起始位置。仅对
\"
circle
\"
样式下拉刷新控件有效，用于定义刷新控件下拉时的起始位置。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
。 |
\n
| contentdown | [contentdown 配置项列表](#pulltorefresh-contentdown) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 在下拉可刷新状态时下拉刷新控件显示的内容 |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 在释放可刷新状态时下拉刷新控件显示的内容 |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 在正在刷新状态时下拉刷新控件显示的内容 |"
,
"description"
:
"下拉刷新"
},
"globalStyle_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 是否允许向下拉拽。支持 YES / NO |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | - | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 导航栏点击穿透 |
\n
| showTitleLoading | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 是否进入时显示导航栏的 loading。支持 YES / NO |
\n
| titleImage | string | - | 否 | - | 导航栏图片地址，替换导航栏标题，必须为https的图片链接地址 |
\n
| backgroundImageUrl | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图链接 |
\n
| backgroundImageColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图底色 |
\n
| gestureBack | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 支付宝小程序 iOS 用，是否支持手势返回。支持 YES / NO |
\n
| enableScrollBar | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 支付宝小程序 Android 用，是否显示 WebView 滚动条。支持 YES / NO。 |"
,
"description"
:
"支付宝小程序特有配置"
},
"globalStyle_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | - | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 |
\n
| backgroundColorTop | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| backgroundColorBottom | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| restartStrategy | 'homePage'
\\
| 'homePageAndLatestPage' |
\"
homePage
\"
| 否 | - | 重新启动策略配置。支持 homePage / homePageAndLatestPage |
\n
| initialRenderingCache | 'static'
\\
| 'dynamic' | - | 否 | - | 页面初始渲染缓存配置。支持 static / dynamic |
\n
| visualEffectInBackground | 'none'
\\
| 'hidden' |
\"
none
\"
| 否 | - | 切入系统后台时，隐藏页面内容，保护用户隐私。支持 hidden / none |
\n
| handleWebviewPreload | 'static'
\\
| 'manual'
\\
| 'none' |
\"
static
\"
| 否 | - | 控制预加载下个页面的时机。支持 static / manual / auto |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |"
,
"description"
:
"微信小程序特有配置"
},
"globalStyle_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| textSizeAdjust | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | - | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应 |"
,
"description"
:
"百度小程序特有配置"
},
"PagesOptionsPage"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 配置页面路径 |
\n
| style | [style 配置项列表](#pagesoptionspage-style) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。 |
\n
| needLogin | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 是否需要登录才可访问 |"
},
"PagesOptionsPage_style"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | 'white'
\\
| 'black' |
\"
black
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题颜色，仅支持 black/white |
\n
| navigationBarTitleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题文字内容 |
\n
| navigationBarShadow | [navigationBarShadow 配置项列表](#style-navigationbarshadow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style) |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| disableScroll | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 设置为 true 则页面整体不能上下滚动（bounce效果），只在页面配置中有效，在globalStyle中设置无效(仅 IOS 支持)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.11
\"
,
\"
4.41
\"
,
\"
4.0
\"
,
\"
4.11
\"
]]}' /> | 页面容器背景色 |
\n
| backgroundTextStyle | 'dark'
\\
| 'light' |
\"
dark
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.31
\"
,
\"
4.31
\"
]]}' /> | 下拉 loading 的样式，仅支持 dark/light |
\n
| enablePullDownRefresh | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.13
\"
,
\"
4.25
\"
]]}' /> | 页面旋转设置，支持 auto 设备自适应 / portrait 竖向 / landscape 横向 |
\n
| hideStatusBar | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统顶部状态栏 |
\n
| hideBottomNavigationIndicator | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统底部导航栏 |
\n
| androidThreeButtonNavigationTranslucent | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
]]}' /> | 页面内容是否可以渲染到虚拟按键区域 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| disableSwipeBack | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
]]}' /> | 是否禁用右滑手势关闭页面 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏点击穿透 |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |
\n
| app-plus | [app-plus 配置项列表](#style-app-plus) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 编译到 App 平台的特定样式 |
\n
| h5 | [h5 配置项列表](#style-h5) | - | 否 | - | 编译到 H5 平台的特定样式 |
\n
| mp-alipay | [mp-alipay 配置项列表](#style-mp-alipay) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 支付宝小程序特有配置 |
\n
| mp-weixin | [mp-weixin 配置项列表](#style-mp-weixin) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 微信小程序特有配置 |
\n
| mp-baidu | [mp-baidu 配置项列表](#style-mp-baidu) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 百度小程序特有配置 |
\n
| mp-toutiao | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 头条小程序特有配置 |
\n
| mp-qq | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | QQ小程序特有配置 |
\n
| mp-kuaishou | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 快手小程序特有配置 |
\n
| mp-jd | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 设置编译到 mp-jd 平台的特定样式 |
\n
| mp-lark | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 飞书小程序特有配置 |
\n
| usingComponents | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 引用小程序组件，参考 [小程序组件https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html#小程序自定义组件支持)。 |
\n
| leftWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 leftWindow时，当前页面是否显示 leftWindow |
\n
| topWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 topWindow时，当前页面是否显示 topWindow |
\n
| rightWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 rightWindow时，当前页面是否显示 rightWindow |
\n
| maxWidth | number | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 单位px，当浏览器可见区域宽度大于maxWidth时，两侧留白，当小于等于maxWidth时，页面铺满；不同页面支持配置不同的maxWidth；maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |"
,
"description"
:
"配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。"
},
"style_navigationBarShadow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| colorType | 'grey'
\\
| 'blue'
\\
| 'green'
\\
| 'orange'
\\
| 'red'
\\
| 'yellow' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 阴影的颜色，支持：grey、blue、green、orange、red、yellow |"
,
"description"
:
"导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)"
},
"style_app-plus"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗体背景色。无论vue页面还是nvue页面，在App上都有一个父级原生窗体，该窗体的背景色生效时间快于页面里的css生效时间，vue 页面需要将 body 背景色设为透明 |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏，详见:[导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView)。 |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生子窗体，详见:[原生子窗体](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVues)。 |
\n
| bounce | 'none'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'all' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面回弹效果，设置为
\"
none
\"
时关闭效果。仅支持 app-vue（nvue Android无页面级bounce效果，仅list、recycle-list、waterfall等滚动组件有bounce效果） |
\n
| popGesture | 'close'
\\
| 'none' |
\"
close
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 侧滑返回功能，可选值：
\"
close
\"
（启用侧滑返回）、
\"
none
\"
（禁用侧滑返回）。 |
\n
| softinputNavBar | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | iOS软键盘上完成工具栏的显示模式，设置为
\"
none
\"
时关闭工具栏。 |
\n
| softinputmode | 'nothing'
\\
| 'adjustPan'
\\
| 'adjustResize' |
\"
adjustPan
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 软键盘弹出模式，支持 adjustResize、adjustPan 两种模式 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |
\n
| scrollIndicator | 'all'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'none' |
\"
all
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否显示滚动条，设置为
\"
none
\"
时不显示滚动条。 |
\n
| animationType | 'slide-in-right'
\\
| 'slide-in-left'
\\
| 'slide-in-top'
\\
| 'slide-in-bottom'
\\
| 'fade-in'
\\
| 'zoom-out'
\\
| 'zoom-fade-out'
\\
| 'pop-in' |
\"
pop-in
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
,
\"
x
\"
]]}' /> | 窗口显示的动画效果，详见：[窗口动画](https://uniapp.dcloud.net.cn/api/router.html#animation)。 |
\n
| animationDuration | number | 300 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口显示动画的持续时间，单位为 ms |"
,
"description"
:
"编译到 App 平台的特定样式"
},
"style_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |"
,
"description"
:
"编译到 H5 平台的特定样式"
},
"style_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 是否允许向下拉拽。支持 YES / NO |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | - | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 导航栏点击穿透 |
\n
| showTitleLoading | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 是否进入时显示导航栏的 loading。支持 YES / NO |
\n
| titleImage | string | - | 否 | - | 导航栏图片地址，替换导航栏标题，必须为https的图片链接地址 |
\n
| backgroundImageUrl | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图链接 |
\n
| backgroundImageColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图底色 |
\n
| gestureBack | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 支付宝小程序 iOS 用，是否支持手势返回。支持 YES / NO |
\n
| enableScrollBar | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 支付宝小程序 Android 用，是否显示 WebView 滚动条。支持 YES / NO。 |"
,
"description"
:
"支付宝小程序特有配置"
},
"style_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | - | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 |
\n
| backgroundColorTop | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| backgroundColorBottom | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| restartStrategy | 'homePage'
\\
| 'homePageAndLatestPage' |
\"
homePage
\"
| 否 | - | 重新启动策略配置。支持 homePage / homePageAndLatestPage |
\n
| initialRenderingCache | 'static'
\\
| 'dynamic' | - | 否 | - | 页面初始渲染缓存配置。支持 static / dynamic |
\n
| visualEffectInBackground | 'none'
\\
| 'hidden' |
\"
none
\"
| 否 | - | 切入系统后台时，隐藏页面内容，保护用户隐私。支持 hidden / none |
\n
| handleWebviewPreload | 'static'
\\
| 'manual'
\\
| 'none' |
\"
static
\"
| 否 | - | 控制预加载下个页面的时机。支持 static / manual / auto |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |"
,
"description"
:
"微信小程序特有配置"
},
"style_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| textSizeAdjust | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | - | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应 |"
,
"description"
:
"百度小程序特有配置"
},
"pages_tabBar"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 上的文字默认颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 上的文字选中时的颜色 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 的背景色 |
\n
| borderStyle | string ([string.ThemeJsonString](/uts/data-type.md#ide-string)) |
\"
black
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
4.0
\"
,
\"
4.11
\"
]]}' /> | tabbar 上边框的颜色，可选值 black、white，black对应颜色rgba(0,0,0,0.33)，white对应颜色rgba(255,255,255,0.33)。 |
\n
| blurEffect | 'dark'
\\
| 'extralight'
\\
| 'light'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | IOS 高斯模糊效果，可选值 dark/extralight/light/none（参考:[使用说明](https://uniapp.dcloud.net.cn//tutorial/app-blureffect.html)） |
\n
| list | Array
\\
<[PagesOptionsTabbarList](#pagesoptionstabbarlist)> | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 的列表，详见 list 属性说明，最少2个、最多5个 tab |
\n
| position | 'top'
\\
| 'bottom' |
\"
bottom
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | tabbar 的位置,可选值 bottom、top。 |
\n
| fontSize | string |
\"
10px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 文字默认大小 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 图标默认宽度（高度等比例缩放） |
\n
| spacing | string |
\"
3px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 图标和文字的间距 |
\n
| height | string |
\"
50px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | tabBar 默认高度 |
\n
| midButton | [midButton 配置项列表](#tabbar-midbutton) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮 仅在 list 项为偶数时有效 |
\n
| iconfontSrc | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | list设置 iconfont 属性时，需要指定字体文件路径 |
\n
| backgroundImage | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 设置背景图片，优先级高于 backgroundColor |
\n
| backgroundRepeat | 'repeat'
\\
| 'repeat-x'
\\
| 'repeat-y'
\\
| 'no-repeat' |
\"
no-repeat
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 设置标题栏的背景图平铺方式 |
\n
| redDotColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | tabbar上红点颜色 |"
,
"description"
:
"底部 tab 的表现"
},
"PagesOptionsTabbarList"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| iconfont | [iconfont 配置项列表](#pagesoptionstabbarlist-iconfont) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标，优先级高于 iconPath |
\n
| pagePath | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 页面路径，必须在 pages 中先定义 |
\n
| text | string | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 上按钮文字，在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px，当 position 为 top 时，此参数无效，不支持网络图片，不支持字体图标 |
\n
| selectedIconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 选中时的图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px ，当 position 为 top 时，此参数无效 |
\n
| visible | boolean | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 该项是否显示，默认显示 |"
},
"PagesOptionsTabbarList_iconfont"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| text | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字库 Unicode 码 |
\n
| selectedText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 选中后字库 Unicode 码 |
\n
| fontSize | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标字号(px) |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标选中颜色 |"
,
"description"
:
"字体图标，优先级高于 iconPath"
},
"tabBar_midButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| width | string |
\"
80px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的宽度，tabBar 其它项为减去此宽度后平分，默认值为与其它项平分宽度 |
\n
| height | string |
\"
80px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的高度，可以大于 tabBar 高度，达到中间凸起的效果 |
\n
| text | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的文字 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的图片路径 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 图标默认宽度（高度等比例缩放） |
\n
| backgroundImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的背景图片路径 |
\n
| iconfont | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 字体图标，优先级高于 iconPath |"
,
"description"
:
"中间按钮 仅在 list 项为偶数时有效"
},
"pages_topWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面路径 |
\n
| style | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#topwindow-matchmedia) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"上窗体"
},
"topWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_leftWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面路径 |
\n
| style | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#leftwindow-matchmedia) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"左窗体"
},
"leftWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_rightWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面路径 |
\n
| style | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#rightwindow-matchmedia) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"右窗体"
},
"rightWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_condition"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| current | number | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 当前激活的模式，list节点的索引值。 |
\n
| list | Array
\\
<[PagesConditionItem](#pagesconditionitem)> | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动模式列表 |"
,
"description"
:
"启动模式"
},
"PagesConditionItem"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| name | string | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动模式名称 |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动页面路径 |
\n
| query | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动参数，可在页面的 onLoad 函数里获得 |"
},
"PagesSubPackages"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| root | string | - | 是 | - | 子包的根目录 |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | - | 子包由哪些页面组成 |"
},
"pages_easycom"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| autoscan | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 是否开启自动扫描，开启后将会自动扫描符合components/组件名称/组件名称.vue/uvue目录结构的组件 |
\n
| custom | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 以正则方式自定义组件匹配规则。如果autoscan不能满足需求，可以使用custom自定义匹配规则 |"
,
"description"
:
"组件自动引入规则"
},
"pages_uniIdRouter"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| loginPage | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 登录页面路径 |
\n
| resToLogin | boolean | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 是否开启自动根据响应体判断跳转登录页面，默认true（开启） |
\n
| needLogin | Array
\\
<string,[string.PageURIString](/uts/data-type.md#ide-string)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | - |"
,
"description"
:
"根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router)"
},
"tutorial"
:
"## 参见
\n
[相关 Bug](https://issues.dcloud.net.cn/?mid=collocation.pages_json)"
}
\ No newline at end of file
{
"pages"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| globalStyle | [globalStyle 配置项列表](#pages-globalstyle) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 默认页面的窗口表现 |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 页面路径及窗口表现 |
\n
| tabBar | [tabBar 配置项列表](#pages-tabbar) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 底部 tab 的表现 |
\n
| topWindow | [topWindow 配置项列表](#pages-topwindow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 上窗体 |
\n
| leftWindow | [leftWindow 配置项列表](#pages-leftwindow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 左窗体 |
\n
| rightWindow | [rightWindow 配置项列表](#pages-rightwindow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 右窗体 |
\n
| condition | [condition 配置项列表](#pages-condition) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动模式 |
\n
| subPackages | Array
\\
<[PagesSubPackages](#pagessubpackages)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 分包加载配置 |
\n
| preloadRule | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 声明分包预下载的规则 |
\n
| workers | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 使用 Worker 处理多线程任务时，设置 Worker 代码放置的目录 |
\n
| easycom | [easycom 配置项列表](#pages-easycom) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 组件自动引入规则 |
\n
| uniIdRouter | [uniIdRouter 配置项列表](#pages-uniidrouter) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router) |
\n
| entryPagePath | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
√
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 默认启动首页 |"
},
"pages_globalStyle"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | string ([string.ThemeJsonString](/uts/data-type.md#ide-string)) |
\"
black
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题颜色，仅支持 black/white（支付宝小程序不支持，请使用 [my.setNavigationBar](https://opendocs.alipay.com/mini/api/xwq8e6)）。 |
\n
| navigationBarTitleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题文字内容 |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
3.99
\"
,
\"
4.18
\"
]]}' /> | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.11
\"
,
\"
x
\"
,
\"
4.0
\"
,
\"
4.11
\"
]]}' /> | 页面容器背景色 |
\n
| backgroundTextStyle | string ([string.ThemeJsonString](/uts/data-type.md#ide-string)) |
\"
dark
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.31
\"
,
\"
4.31
\"
]]}' /> | 下拉 loading 的样式，仅支持 dark / light |
\n
| enablePullDownRefresh | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏点击穿透 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.13
\"
,
\"
4.25
\"
]]}' /> | 横屏配置，屏幕旋转设置，仅支持 auto / portrait / landscape 详见 [响应显示区域变化](https://uniapp.dcloud.net.cn/collocation/pages.html#globalstyle)。 |
\n
| hideStatusBar | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统顶部状态栏 |
\n
| hideBottomNavigationIndicator | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统底部导航栏 |
\n
| androidThreeButtonNavigationTranslucent | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
]]}' /> | 页面内容是否可以渲染到虚拟按键区域 |
\n
| animationType | 'slide-in-right'
\\
| 'slide-in-left'
\\
| 'slide-in-top'
\\
| 'slide-in-bottom'
\\
| 'fade-in'
\\
| 'zoom-out'
\\
| 'zoom-fade-out'
\\
| 'pop-in' |
\"
pop-in
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
,
\"
x
\"
]]}' /> | 窗口显示的动画效果，详见：[窗口动画](https://uniapp.dcloud.net.cn/api/router.html#animation)。 |
\n
| animationDuration | number | 300 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口显示动画的持续时间，单位为 ms |
\n
| allowsBounceVertical | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否允许向下拉拽。默认 YES。如果需要下拉刷新，值必须为YES |
\n
| usingComponents | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 引用小程序组件，参考 [小程序组件](https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html)。 |
\n
| renderingMode | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 同层渲染，webrtc(实时音视频) 无法正常时尝试配置 seperated 强制关掉同层 |
\n
| leftWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 leftWindow时，默认是否显示 leftWindow |
\n
| topWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 topWindow时，默认是否显示 topWindow |
\n
| rightWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 rightWindow时，默认是否显示 rightWindow |
\n
| rpxCalcMaxDeviceWidth | number | 960 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | rpx 计算所支持的最大设备宽度，单位 px |
\n
| rpxCalcBaseDeviceWidth | number | 375 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | rpx 计算使用的基准设备宽度，设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算，单位 px |
\n
| rpxCalcIncludeWidth | number | 750 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | rpx 计算特殊处理的值，始终按实际的设备宽度计算，单位 rpx |
\n
| dynamicRpx | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 动态 rpx，屏幕大小变化会重新渲染 rpx |
\n
| maxWidth | number | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 单位px，当浏览器可见区域宽度大于maxWidth时，两侧留白，当小于等于maxWidth时，页面铺满；不同页面支持配置不同的maxWidth；maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |
\n
| app-plus | [app-plus 配置项列表](#globalstyle-app-plus) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 5+ App 特有配置 |
\n
| h5 | [h5 配置项列表](#globalstyle-h5) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | H5 特有配置 |
\n
| mp-alipay | [mp-alipay 配置项列表](#globalstyle-mp-alipay) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 支付宝小程序特有配置 |
\n
| mp-weixin | [mp-weixin 配置项列表](#globalstyle-mp-weixin) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 微信小程序特有配置 |
\n
| mp-baidu | [mp-baidu 配置项列表](#globalstyle-mp-baidu) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 百度小程序特有配置 |
\n
| mp-toutiao | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 头条小程序特有配置 |
\n
| mp-qq | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | QQ小程序特有配置 |
\n
| mp-kuaishou | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 快手小程序特有配置 |
\n
| mp-jd | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 设置编译到 mp-jd 平台的特定样式 |
\n
| mp-lark | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 飞书小程序特有配置 |"
,
"description"
:
"默认页面的窗口表现"
},
"globalStyle_app-plus"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗体背景色。无论vue页面还是nvue页面，在App上都有一个父级原生窗体，该窗体的背景色生效时间快于页面里的css生效时间，vue 页面需要将 body 背景色设为透明 |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏，详见:[导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView)。 |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生子窗体，详见:[原生子窗体](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVues)。 |
\n
| bounce | 'none'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'all' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面回弹效果，设置为
\"
none
\"
时关闭效果。仅支持 app-vue（nvue Android无页面级bounce效果，仅list、recycle-list、waterfall等滚动组件有bounce效果） |
\n
| popGesture | 'close'
\\
| 'none' |
\"
close
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 侧滑返回功能，可选值：
\"
close
\"
（启用侧滑返回）、
\"
none
\"
（禁用侧滑返回）。 |
\n
| softinputNavBar | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | iOS软键盘上完成工具栏的显示模式，设置为
\"
none
\"
时关闭工具栏。 |
\n
| softinputmode | 'nothing'
\\
| 'adjustPan'
\\
| 'adjustResize' |
\"
adjustPan
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 软键盘弹出模式，支持 adjustResize、adjustPan 两种模式 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |
\n
| scrollIndicator | 'all'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'none' |
\"
all
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否显示滚动条，设置为
\"
none
\"
时不显示滚动条。 |
\n
| animationType | 'slide-in-right'
\\
| 'slide-in-left'
\\
| 'slide-in-top'
\\
| 'slide-in-bottom'
\\
| 'fade-in'
\\
| 'zoom-out'
\\
| 'zoom-fade-out'
\\
| 'pop-in' |
\"
pop-in
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
,
\"
x
\"
]]}' /> | 窗口显示的动画效果，详见：[窗口动画](https://uniapp.dcloud.net.cn/api/router.html#animation)。 |
\n
| animationDuration | number | 300 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口显示动画的持续时间，单位为 ms |"
,
"description"
:
"5+ App 特有配置"
},
"app-plus_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#f7f7f7
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 背景颜色，支持16进制颜色或RGBA颜色(仅悬浮导航栏支持RGBA颜色)。 |
\n
| buttons | Array
\\
<[PageStyleAppPlusTitleNViewButton](#pagestyleappplustitlenviewbutton)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 自定义按钮(纯nvue即render:native时暂不支持)，详见 [buttons](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-buttons)。 |
\n
| titleColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#000000
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字颜色 |
\n
| titleOverflow | 'clip'
\\
| 'ellipsis' |
\"
ellipsis
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字超出显示区域时处理方式。
\"
clip
\"
-超出显示区域时内容裁剪；
\"
ellipsis
\"
-超出显示区域时尾部显示省略标记（...）。 |
\n
| titleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字内容 |
\n
| titleSize | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字字体大小 |
\n
| type | 'defaultValue'
\\
| 'transparent'
\\
| 'float' |
\"
defaultValue
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏样式。
\"
default
\"
-默认样式；
\"
transparent
\"
-滚动透明渐变；
\"
float
\"
-悬浮导航栏。 |
\n
| tags | array | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生 View 增强，详见：[5+ View 控件](http://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.ViewDrawTagStyles)。 |
\n
| searchInput | [searchInput 配置项列表](#titlenview-searchinput) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生导航栏上的搜索框配置，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-searchinput)。 |
\n
| homeButton | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏控件是否显示Home按钮 |
\n
| autoBackButton | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏控件是否显示左侧返回按钮 |
\n
| backButton | [backButton 配置项列表](#titlenview-backbutton) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 返回按钮的样式，详见：[backButton](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView-backButtonStyles)。 |
\n
| backgroundImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 支持以下类型： 背景图片路径 - 如
\"
./img/t.png
\"
，仅支持本地文件路径， 相对路径，相对于当前页面的host位置，根据实际标题栏宽高拉伸绘制； 渐变色 - 仅支持线性渐变，两种颜色的渐变，如“linear-gradient(to top, #a80077, #66ff00)”， 其中第一个参数为渐变方向，可取值：
\"
to right
\"
表示从左向右渐变，
\"
to left
\"
表示从右向左渐变，
\"
to bottom
\"
表示从上到下渐变，
\"
to top
\"
表示从下到上渐变，
\"
to bottom right
\"
表示从左上角到右下角，
\"
to top left
\"
表示从右下角到左上角。 |
\n
| backgroundRepeat | 'repeat'
\\
| 'repeat-x'
\\
| 'repeat-y'
\\
| 'no-repeat' |
\"
no-repeat
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 仅在backgroundImage设置为图片路径时有效。 可取值：
\"
repeat
\"
- 背景图片在垂直方向和水平方向平铺；
\"
repeat-x
\"
- 背景图片在水平方向平铺，垂直方向拉伸；
\"
repeat-y
\"
- 背景图片在垂直方向平铺，水平方向拉伸；
\"
no-repeat
\"
- 背景图片在垂直方向和水平方向都拉伸。 默认使用
\"
no-repeat
\"
。 |
\n
| titleAlign | 'center'
\\
| 'left'
\\
| 'auto' |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 可取值：
\"
center
\"
-居中对齐；
\"
left
\"
-居左对齐；
\"
auto
\"
-根据平台自动选择（Android平台居左对齐，iOS平台居中对齐） |
\n
| blurEffect | 'dark'
\\
| 'extralight'
\\
| 'light'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 此效果将会高斯模糊显示标题栏后的内容，仅在type为
\"
transparent
\"
或
\"
float
\"
时有效。 可取值：
\"
dark
\"
- 暗风格模糊，对应iOS原生UIBlurEffectStyleDark效果；
\"
extralight
\"
- 高亮风格模糊，对应iOS原生UIBlurEffectStyleExtraLight效果；
\"
light
\"
- 亮风格模糊，对应iOS原生UIBlurEffectStyleLight效果；
\"
none
\"
- 无模糊效果。 注意：使用模糊效果时应避免设置背景颜色，设置背景颜色可能覆盖模糊效果。 |
\n
| coverage | string |
\"
132px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏控件变化作用范围，仅在type值为transparent时有效，页面滚动时标题栏背景透明度将发生变化。 当页面滚动到指定偏移量时标题栏背景变为完全不透明。 支持百分比、像素值 |
\n
| splitLine | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题栏的底部分割线([SplitLineStyles](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView-splitLineStyles)))，设置此属性则在标题栏控件的底部显示分割线，可配置颜色值及高度。 设置此属性值为undefined或null则隐藏分割线。 默认不显示底部分割线 |
\n
| subtitleColor | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 副标题文字颜色，颜色值格式为
\"
#RRGGBB
\"
和
\"
rgba(R,G,B,A)
\"
，如
\"
#FF0000
\"
表示标题文字颜色为红色。 默认值与主标题文字颜色一致 |
\n
| subtitleSize | string |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 副标题文字字体大小，字体大小单位为像素，如
\"
14px
\"
表示字体大小为14像素，auto表示自动计算，约为12像素。 |
\n
| subtitleOverflow | 'clip'
\\
| 'ellipsis' |
\"
ellipsis
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题文字超出显示区域时处理方式，可取值：
\"
clip
\"
- 超出显示区域时内容裁剪；
\"
ellipsis
\"
- 超出显示区域时尾部显示省略标记（...）。 |
\n
| subtitleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 副标题文字内容，设置副标后将显示两行标题，副标显示在主标题（titleText）下方。 注意：设置副标题后将居左显示 |
\n
| titleIcon | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题图标，图标路径如
\"
./img/t.png
\"
，仅支持本地文件路径， 相对路径，相对于当前页面的host位置，固定宽高为逻辑像素值
\"
34px
\"
。 要求图片的宽高相同。 注意：设置标题图标后标题将居左显示。 |
\n
| titleIconRadius | string |
\"
无圆角
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 标题图标圆角，取值格式为
\"
XXpx
\"
，其中XX为像素值（逻辑像素），如
\"
10px
\"
表示10像素半径圆角。 |"
,
"description"
:
"导航栏，详见:[导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView)。"
},
"PageStyleAppPlusTitleNViewButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| type | 'forward'
\\
| 'back'
\\
| 'share'
\\
| 'favorite'
\\
| 'home'
\\
| 'menu'
\\
| 'close'
\\
| 'none' |
\"
none
\"
| 否 | - | 按钮样式，可取值见：[buttons 样式](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-buttons-type) |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
默认与标题文字颜色一致
\"
| 否 | - | 按钮上文字颜色 |
\n
| colorPressed | string |
\"
默认值为 color 属性值自动调整透明度为 0.3
\"
| 否 | - | 按下状态按钮文字颜色 |
\n
| float | 'right'
\\
| 'left' |
\"
right
\"
| 否 | - | 按钮在标题栏上的显示位置，可取值
\"
left
\"
、
\"
right
\"
|
\n
| fontWeight | 'normal'
\\
| 'bold' |
\"
normal
\"
| 否 | - | 按钮上文字的粗细。可取值
\"
normal
\"
-标准字体、
\"
bold
\"
-加粗字体。 |
\n
| fontSize | string | - | 否 | - | 按钮上文字大小 |
\n
| fontSrc | string | - | 否 | - | 按钮上文字使用的字体文件路径。不支持网络地址，请统一使用本地地址。 |
\n
| select | boolean | false | 否 | - | 是否显示选择指示图标（向下箭头），常用于城市选择 |
\n
| text | string | - | 否 | - | 按钮上显示的文字。使用字体图标时 unicode 字符表示必须
\"\\
u
\"
开头，如
\"
\"
（注意不能写成
\"\\
e123
\"
）。 |
\n
| width | string |
\"
44px
\"
| 否 | - | 按钮的宽度，可取值：
\"
*px
\"
- 逻辑像素值，如
\"
10px
\"
表示10逻辑像素值，不支持rpx。按钮的内容居中显示；
\"
auto
\"
- 自定计算宽度，根据内容自动调整按钮宽度 |"
},
"titleNView_searchInput"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| autoFocus | boolean | false | 否 | - | 是否自动获取焦点 |
\n
| align | 'left'
\\
| 'right'
\\
| 'center' |
\"
center
\"
| 否 | - | 非输入状态下文本的对齐方式。可取值：
\"
left
\"
- 居左对齐；
\"
right
\"
- 居右对齐；
\"
center
\"
- 居中对齐。 |
\n
| backgroundColor | string |
\"
rgba(255,255,255,0.5)
\"
| 否 | - | 背景颜色 |
\n
| borderRadius | string |
\"
0px
\"
| 否 | - | 输入框的圆角半径，取值格式为
\"
XXpx
\"
，其中XX为像素值（逻辑像素），不支持rpx。 |
\n
| placeholder | string | - | 否 | - | 提示文本 |
\n
| placeholderColor | string |
\"
#cccccc
\"
| 否 | - | 提示文本颜色 |
\n
| disabled | boolean | false | 否 | - | 是否可输入 |"
,
"description"
:
"原生导航栏上的搜索框配置，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titlenview-searchinput)。"
},
"titleNView_backButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | string |
\"
none
\"
| 否 | - | 背景颜色，仅在标题栏type=transparent时生效，当标题栏透明时按钮显示的背景颜色。 可取值#RRGGBB和rgba格式颜色字符串，默认值为灰色半透明。 |
\n
| badgeText | string | - | 否 | - | 角标文本，最多显示3个字符，超过则显示为... |
\n
| color | string |
\"
窗口标题栏控件的标题文字颜色。
\"
| 否 | - | 图标和标题颜色，可取值：
\"
#RRGGBB
\"
格式字符串，如
\"
#FF0000
\"
表示红色；
\"
rgba(R,G,B,A)
\"
，其中R/G/B分别代表红色值/绿色值/蓝色值，正整数类型，取值范围为0-255，A为透明度，浮点数类型，取值范围为0-1（0为全透明，1为不透明），如
\"
rgba(255,0,0,0.5)
\"
，表示红色半透明。 |
\n
| colorPressed | string | - | 否 | - | 按下状态按钮文字颜色，可取值：
\"
#RRGGBB
\"
格式字符串，如
\"
#FF0000
\"
表示红色；
\"
rgba(R,G,B,A)
\"
，其中R/G/B分别代表红色值/绿色值/蓝色值，正整数类型，取值范围为0-255，A为透明度，浮点数类型，取值范围为0-1（0为全透明，1为不透明），如
\"
rgba(255,0,0,0.5)
\"
，表示红色半透明。 默认值为color属性值自动调整透明度为0.3。 |
\n
| fontWeight | string |
\"
normal
\"
| 否 | - | 返回图标的粗细，可取值：
\"
normal
\"
- 标准字体；
\"
bold
\"
- 加粗字体。 |
\n
| fontSize | string | - | 否 | - | 返回图标文字大小，可取值：字体高度像素值，数字加
\"
px
\"
格式字符串，如
\"
22px
\"
。 窗口标题栏为透明样式（type=
\"
transparent
\"
）时，默认值为
\"
22px
\"
； 窗口标题栏为默认样式（type=
\"
default
\"
）时，默认值为
\"
27px
\"
。 |
\n
| redDot | boolean | false | 否 | - | 是否显示红点，设置为true则显示红点，false则不显示红点。默认值为false。 注意：当设置了角标文本时红点不显示。 |
\n
| title | string | - | 否 | - | 返回按钮上的标题，显示在返回图标（字体图标）后，默认为空字符串。 |
\n
| titleWeight | 'normal'
\\
| 'bold' |
\"
normal
\"
| 否 | - | 返回按钮上标题的粗细，可取值：
\"
normal
\"
- 标准字体；
\"
bold
\"
- 加粗字体。 |"
,
"description"
:
"返回按钮的样式，详见：[backButton](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView-backButtonStyles)。"
},
"PageStyleAppPlusSubNVues"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| id | string | - | 否 | - | subNVue 原生子窗体的标识 |
\n
| path | string ([string.NPageURIString](/uts/data-type.md#ide-string)) | - | 否 | - | 配置 nvue 文件路径，nvue 文件需放置到使用 subNvue 的页面文件目录下 |
\n
| type | 'popup'
\\
| 'navigationBar' | - | 否 | - | 内置样式 |
\n
| style | [style 配置项列表](#pagestyleappplussubnvues-style) | - | 否 | - | subNVue 原生子窗体的样式，配置项参考下方[subNVuesStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVuesStyle) |"
},
"PageStyleAppPlusSubNVues_style"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| position | 'static'
\\
| 'absolute'
\\
| 'dock' |
\"
absolute
\"
| 否 | - | 原生子窗体的排版位置，排版位置决定原生子窗体在父窗口中的定位方式。 可取值：
\"
static
\"
，原生子窗体在页面中正常定位，如果页面存在滚动条则随窗口内容滚动；
\"
absolute
\"
，原生子窗体在页面中绝对定位，如果页面存在滚动条不随窗口内容滚动；
\"
dock
\"
，原生子窗体在页面中停靠，停靠的位置由dock属性值决定。 默认值为
\"
absolute
\"
。 |
\n
| dock | 'top'
\\
| 'bottom'
\\
| 'right'
\\
| 'left' |
\"
bottom
\"
| 否 | - | 原生子窗体的停靠方式,仅当原生子窗体
\"
position
\"
属性值设置为
\"
dock
\"
时才生效，可取值：
\"
top
\"
，原生子窗体停靠则页面顶部；
\"
bottom
\"
，原生子窗体停靠在页面底部；
\"
right
\"
，原生子窗体停靠在页面右侧；
\"
left
\"
，原生子窗体停靠在页面左侧。 默认值为
\"
bottom
\"
。 |
\n
| mask | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
rgba(0,0,0,0.5)
\"
| 否 | - | 原生子窗体的遮罩层,仅当原生子窗体
\"
type
\"
属性值设置为
\"
popup
\"
时才生效，可取值： rgba格式字符串，定义纯色遮罩层样式，如
\"
rgba(0,0,0,0.5)
\"
，表示黑色半透明； |
\n
| width | string |
\"
100%
\"
| 否 | - | 原生子窗体的宽度,支持百分比、像素值，默认为100%。未设置width属性值时，可同时设置left和right属性值改变窗口的默认宽度。 |
\n
| height | string |
\"
100%
\"
| 否 | - | 原生子窗体的高度,支持百分比、像素值，默认为100%。 当未设置height属性值时，优先通过top和bottom属性值来计算原生子窗体的高度。 |
\n
| top | string |
\"
0px
\"
| 否 | - | 原生子窗体垂直向下的偏移量，支持百分比、像素值，默认值为0px。 未设置top属性值时，优先通过bottom和height属性值来计算原生子窗体的top位置。 |
\n
| bottom | string | - | 否 | - | 原生子窗体垂直向上偏移量,支持百分比、像素值，默认值无值（根据top和height属性值来自动计算）。 当同时设置了top和height值时，忽略此属性值； 当未设置height值时，可通过top和bottom属性值来确定原生子窗体的高度。 |
\n
| left | string |
\"
0px
\"
| 否 | - | 原生子窗体水平向左的偏移量，支持百分比、像素值，默认值为0px。 未设置left属性值时，优先通过right和width属性值来计算原生子窗体的left位置。 |
\n
| right | string | - | 否 | - | 原生子窗体水平向右的偏移量，支持百分比、像素值，默认无值（根据left和width属性值来自动计算）。 当设置了left和width值时，忽略此属性值； 当未设置width值时，可通过left和bottom属性值来确定原生子窗体的宽度。 |
\n
| margin | string | - | 否 | - | 原生子窗体的边距，用于定位原生子窗体的位置，支持auto，auto表示居中。若设置了left、right、top、bottom则对应的边距值失效。 |
\n
| zindex | number | - | 否 | - | 原生子窗体的窗口的堆叠顺序值，拥有更高堆叠顺序的窗口总是会处于堆叠顺序较低的窗口的前面，拥有相同堆叠顺序的窗口后调用show方法则在前面。 |
\n
| background | string |
\"
#ffffff
\"
| 否 | - | 窗口的背景颜色,Android平台4.0以上系统才支持“transparent”背景透明样式。比如subnvue为圆角时需要设置为transparent才能看到正确的效果 |"
,
"description"
:
"subNVue 原生子窗体的样式，配置项参考下方[subNVuesStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVuesStyle)"
},
"app-plus_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| support | boolean | false | 否 | - | 是否开启窗口的下拉刷新功能 |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#2BD009
\"
| 否 | - | 颜色值格式为
\"
#RRGGBB
\"
，仅
\"
circle
\"
样式下拉刷新支持此属性。 |
\n
| style | 'defaultValue'
\\
| 'circle' |
\"
Android 平台为 circle；iOS 平台为 default。
\"
| 否 | - | 可取值：
\"
default
\"
——经典下拉刷新样式（下拉拖动时页面内容跟随）；
\"
circle
\"
——圆圈样式下拉刷新控件样式（下拉拖动时仅刷新控件跟随）。 |
\n
| height | string | - | 否 | - | 窗口的下拉刷新控件进入刷新状态的拉拽高度。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
，不支持 rpx。 |
\n
| range | string | - | 否 | - | 窗口可下拉拖拽的范围。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
，不支持 rpx。 |
\n
| offset | string |
\"
0px
\"
| 否 | - | 下拉刷新控件的起始位置。仅对
\"
circle
\"
样式下拉刷新控件有效，用于定义刷新控件下拉时的起始位置。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
，不支持rpx。如使用了非原生title且需要原生下拉刷新，一般都使用circle方式并将offset调至自定义title的高度 |
\n
| contentdown | [contentdown 配置项列表](#pulltorefresh-contentdown) | - | 否 | - | 目前支持一个属性：caption——在下拉可刷新状态时下拉刷新控件上显示的标题内容。仅对
\"
default
\"
样式下拉刷新控件有效。 |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | - | 目前支持一个属性：caption——在释放可刷新状态时下拉刷新控件上显示的标题内容。仅对
\"
default
\"
样式下拉刷新控件有效。 |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | - | 目前支持一个属性：caption——在正在刷新状态时下拉刷新控件上显示的标题内容。仅对
\"
default
\"
样式下拉刷新控件有效。 |"
,
"description"
:
"下拉刷新"
},
"pullToRefresh_contentdown"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在下拉可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentover"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在释放可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentrefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在正在刷新状态时下拉刷新控件显示的内容"
},
"globalStyle_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |"
,
"description"
:
"H5 特有配置"
},
"h5_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#f7f7f7
\"
| 否 | - | 背景颜色，颜色值格式为
\"
#RRGGBB
\"
。 |
\n
| buttons | array | - | 否 | - | 自定义按钮，参考 [buttons](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-titlenview-buttons)。 |
\n
| titleColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#000000
\"
| 否 | - | 标题文字颜色 |
\n
| titleText | string | - | 否 | - | 标题文字内容 |
\n
| titleSize | string | - | 否 | - | 标题文字字体大小 |
\n
| type | 'defaultValue'
\\
| 'transparent' |
\"
defaultValue
\"
| 否 | - | 导航栏样式。
\"
default
\"
-默认样式；
\"
transparent
\"
-透明渐变。 |
\n
| searchInput | object | - | 否 | - | 导航栏上的搜索框样式，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-searchinput)。 |"
,
"description"
:
"导航栏设置"
},
"h5_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| support | boolean | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否开启窗口的下拉刷新功能 |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 颜色值格式为
\"
#RRGGBB
\"
，仅
\"
circle
\"
样式下拉刷新支持此属性。 |
\n
| type | 'defaultValue'
\\
| 'circle' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件样式 |
\n
| height | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口的下拉刷新控件进入刷新状态的拉拽高度。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
。 |
\n
| range | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口可下拉拖拽的范围。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
。 |
\n
| offset | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新控件的起始位置。仅对
\"
circle
\"
样式下拉刷新控件有效，用于定义刷新控件下拉时的起始位置。支持百分比，如
\"
10%
\"
；像素值，如
\"
50px
\"
。 |
\n
| contentdown | [contentdown 配置项列表](#pulltorefresh-contentdown) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 在下拉可刷新状态时下拉刷新控件显示的内容 |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 在释放可刷新状态时下拉刷新控件显示的内容 |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 在正在刷新状态时下拉刷新控件显示的内容 |"
,
"description"
:
"下拉刷新"
},
"globalStyle_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 是否允许向下拉拽。支持 YES / NO |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | - | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 导航栏点击穿透 |
\n
| showTitleLoading | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 是否进入时显示导航栏的 loading。支持 YES / NO |
\n
| titleImage | string | - | 否 | - | 导航栏图片地址，替换导航栏标题，必须为https的图片链接地址 |
\n
| backgroundImageUrl | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图链接 |
\n
| backgroundImageColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图底色 |
\n
| gestureBack | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 支付宝小程序 iOS 用，是否支持手势返回。支持 YES / NO |
\n
| enableScrollBar | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 支付宝小程序 Android 用，是否显示 WebView 滚动条。支持 YES / NO。 |"
,
"description"
:
"支付宝小程序特有配置"
},
"globalStyle_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | - | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 |
\n
| backgroundColorTop | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| backgroundColorBottom | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| restartStrategy | 'homePage'
\\
| 'homePageAndLatestPage' |
\"
homePage
\"
| 否 | - | 重新启动策略配置。支持 homePage / homePageAndLatestPage |
\n
| initialRenderingCache | 'static'
\\
| 'dynamic' | - | 否 | - | 页面初始渲染缓存配置。支持 static / dynamic |
\n
| visualEffectInBackground | 'none'
\\
| 'hidden' |
\"
none
\"
| 否 | - | 切入系统后台时，隐藏页面内容，保护用户隐私。支持 hidden / none |
\n
| handleWebviewPreload | 'static'
\\
| 'manual'
\\
| 'none' |
\"
static
\"
| 否 | - | 控制预加载下个页面的时机。支持 static / manual / auto |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |"
,
"description"
:
"微信小程序特有配置"
},
"globalStyle_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| textSizeAdjust | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | - | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应 |"
,
"description"
:
"百度小程序特有配置"
},
"PagesOptionsPage"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 配置页面路径 |
\n
| style | [style 配置项列表](#pagesoptionspage-style) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。 |
\n
| needLogin | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 是否需要登录才可访问 |"
},
"PagesOptionsPage_style"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | 'white'
\\
| 'black' |
\"
black
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题颜色，仅支持 black/white |
\n
| navigationBarTitleText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏标题文字内容 |
\n
| navigationBarShadow | [navigationBarShadow 配置项列表](#style-navigationbarshadow) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style) |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| disableScroll | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 设置为 true 则页面整体不能上下滚动（bounce效果），只在页面配置中有效，在globalStyle中设置无效(仅 IOS 支持)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
3.99
\"
,
\"
4.18
\"
]]}' /> | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.11
\"
,
\"
4.41
\"
,
\"
4.0
\"
,
\"
4.11
\"
]]}' /> | 页面容器背景色 |
\n
| backgroundTextStyle | 'dark'
\\
| 'light' |
\"
dark
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.31
\"
,
\"
4.31
\"
]]}' /> | 下拉 loading 的样式，仅支持 dark/light |
\n
| enablePullDownRefresh | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
4.13
\"
,
\"
4.25
\"
]]}' /> | 页面旋转设置，支持 auto 设备自适应 / portrait 竖向 / landscape 横向 |
\n
| hideStatusBar | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统顶部状态栏 |
\n
| hideBottomNavigationIndicator | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.31
\"
,
\"
4.33
\"
]]}' /> | 是否隐藏系统底部导航栏 |
\n
| androidThreeButtonNavigationTranslucent | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
]]}' /> | 页面内容是否可以渲染到虚拟按键区域 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| disableSwipeBack | boolean | false | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
]]}' /> | 是否禁用右滑手势关闭页面 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏点击穿透 |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |
\n
| app-plus | [app-plus 配置项列表](#style-app-plus) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 编译到 App 平台的特定样式 |
\n
| h5 | [h5 配置项列表](#style-h5) | - | 否 | - | 编译到 H5 平台的特定样式 |
\n
| mp-alipay | [mp-alipay 配置项列表](#style-mp-alipay) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 支付宝小程序特有配置 |
\n
| mp-weixin | [mp-weixin 配置项列表](#style-mp-weixin) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 微信小程序特有配置 |
\n
| mp-baidu | [mp-baidu 配置项列表](#style-mp-baidu) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 百度小程序特有配置 |
\n
| mp-toutiao | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 头条小程序特有配置 |
\n
| mp-qq | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | QQ小程序特有配置 |
\n
| mp-kuaishou | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 快手小程序特有配置 |
\n
| mp-jd | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 设置编译到 mp-jd 平台的特定样式 |
\n
| mp-lark | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 飞书小程序特有配置 |
\n
| usingComponents | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 引用小程序组件，参考 [小程序组件https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html#小程序自定义组件支持)。 |
\n
| leftWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 leftWindow时，当前页面是否显示 leftWindow |
\n
| topWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 topWindow时，当前页面是否显示 topWindow |
\n
| rightWindow | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当存在 rightWindow时，当前页面是否显示 rightWindow |
\n
| maxWidth | number | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 单位px，当浏览器可见区域宽度大于maxWidth时，两侧留白，当小于等于maxWidth时，页面铺满；不同页面支持配置不同的maxWidth；maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |"
,
"description"
:
"配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。"
},
"style_navigationBarShadow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| colorType | 'grey'
\\
| 'blue'
\\
| 'green'
\\
| 'orange'
\\
| 'red'
\\
| 'yellow' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 阴影的颜色，支持：grey、blue、green、orange、red、yellow |"
,
"description"
:
"导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)"
},
"style_app-plus"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗体背景色。无论vue页面还是nvue页面，在App上都有一个父级原生窗体，该窗体的背景色生效时间快于页面里的css生效时间，vue 页面需要将 body 背景色设为透明 |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏，详见:[导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-titleNView)。 |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 原生子窗体，详见:[原生子窗体](https://uniapp.dcloud.net.cn/collocation/pages.html?id=app-subNVues)。 |
\n
| bounce | 'none'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'all' | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 页面回弹效果，设置为
\"
none
\"
时关闭效果。仅支持 app-vue（nvue Android无页面级bounce效果，仅list、recycle-list、waterfall等滚动组件有bounce效果） |
\n
| popGesture | 'close'
\\
| 'none' |
\"
close
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 侧滑返回功能，可选值：
\"
close
\"
（启用侧滑返回）、
\"
none
\"
（禁用侧滑返回）。 |
\n
| softinputNavBar | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | iOS软键盘上完成工具栏的显示模式，设置为
\"
none
\"
时关闭工具栏。 |
\n
| softinputmode | 'nothing'
\\
| 'adjustPan'
\\
| 'adjustResize' |
\"
adjustPan
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 软键盘弹出模式，支持 adjustResize、adjustPan 两种模式 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |
\n
| scrollIndicator | 'all'
\\
| 'vertical'
\\
| 'horizontal'
\\
| 'none' |
\"
all
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否显示滚动条，设置为
\"
none
\"
时不显示滚动条。 |
\n
| animationType | 'slide-in-right'
\\
| 'slide-in-left'
\\
| 'slide-in-top'
\\
| 'slide-in-bottom'
\\
| 'fade-in'
\\
| 'zoom-out'
\\
| 'zoom-fade-out'
\\
| 'pop-in' |
\"
pop-in
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
4.18
\"
,
\"
x
\"
]]}' /> | 窗口显示的动画效果，详见：[窗口动画](https://uniapp.dcloud.net.cn/api/router.html#animation)。 |
\n
| animationDuration | number | 300 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 窗口显示动画的持续时间，单位为 ms |"
,
"description"
:
"编译到 App 平台的特定样式"
},
"style_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 下拉刷新 |"
,
"description"
:
"编译到 H5 平台的特定样式"
},
"style_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 是否允许向下拉拽。支持 YES / NO |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | - | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 导航栏点击穿透 |
\n
| showTitleLoading | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 是否进入时显示导航栏的 loading。支持 YES / NO |
\n
| titleImage | string | - | 否 | - | 导航栏图片地址，替换导航栏标题，必须为https的图片链接地址 |
\n
| backgroundImageUrl | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图链接 |
\n
| backgroundImageColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | - | 下拉露出显示的背景图底色 |
\n
| gestureBack | 'YES'
\\
| 'NO' |
\"
No
\"
| 否 | - | 支付宝小程序 iOS 用，是否支持手势返回。支持 YES / NO |
\n
| enableScrollBar | 'YES'
\\
| 'NO' |
\"
YES
\"
| 否 | - | 支付宝小程序 Android 用，是否显示 WebView 滚动条。支持 YES / NO。 |"
,
"description"
:
"支付宝小程序特有配置"
},
"style_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | - | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 |
\n
| backgroundColorTop | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| backgroundColorBottom | HexColor |
\"
#ffffff
\"
| 否 | - | 顶部窗口的背景色，仅 iOS 支持 |
\n
| restartStrategy | 'homePage'
\\
| 'homePageAndLatestPage' |
\"
homePage
\"
| 否 | - | 重新启动策略配置。支持 homePage / homePageAndLatestPage |
\n
| initialRenderingCache | 'static'
\\
| 'dynamic' | - | 否 | - | 页面初始渲染缓存配置。支持 static / dynamic |
\n
| visualEffectInBackground | 'none'
\\
| 'hidden' |
\"
none
\"
| 否 | - | 切入系统后台时，隐藏页面内容，保护用户隐私。支持 hidden / none |
\n
| handleWebviewPreload | 'static'
\\
| 'manual'
\\
| 'none' |
\"
static
\"
| 否 | - | 控制预加载下个页面的时机。支持 static / manual / auto |
\n
| enableUcssReset | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 是否启用ucss样式覆盖 |"
,
"description"
:
"微信小程序特有配置"
},
"style_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| textSizeAdjust | 'auto'
\\
| 'none' |
\"
auto
\"
| 否 | - | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应 |"
,
"description"
:
"百度小程序特有配置"
},
"pages_tabBar"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 上的文字默认颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 上的文字选中时的颜色 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 的背景色 |
\n
| borderStyle | string ([string.ThemeJsonString](/uts/data-type.md#ide-string)) |
\"
black
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
4.0
\"
,
\"
4.11
\"
]]}' /> | tabbar 上边框的颜色，可选值 black、white，black对应颜色rgba(0,0,0,0.33)，white对应颜色rgba(255,255,255,0.33)。 |
\n
| blurEffect | 'dark'
\\
| 'extralight'
\\
| 'light'
\\
| 'none' |
\"
none
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | IOS 高斯模糊效果，可选值 dark/extralight/light/none（参考:[使用说明](https://uniapp.dcloud.net.cn//tutorial/app-blureffect.html)） |
\n
| list | Array
\\
<[PagesOptionsTabbarList](#pagesoptionstabbarlist)> | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 的列表，详见 list 属性说明，最少2个、最多5个 tab |
\n
| position | 'top'
\\
| 'bottom' |
\"
bottom
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
4.41
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | tabbar 的位置,可选值 bottom、top。 |
\n
| fontSize | string |
\"
10px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 文字默认大小 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 图标默认宽度（高度等比例缩放） |
\n
| spacing | string |
\"
3px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 图标和文字的间距 |
\n
| height | string |
\"
50px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | tabBar 默认高度 |
\n
| midButton | [midButton 配置项列表](#tabbar-midbutton) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮 仅在 list 项为偶数时有效 |
\n
| iconfontSrc | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | list设置 iconfont 属性时，需要指定字体文件路径 |
\n
| backgroundImage | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 设置背景图片，优先级高于 backgroundColor |
\n
| backgroundRepeat | 'repeat'
\\
| 'repeat-x'
\\
| 'repeat-y'
\\
| 'no-repeat' |
\"
no-repeat
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 设置标题栏的背景图平铺方式 |
\n
| redDotColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | tabbar上红点颜色 |"
,
"description"
:
"底部 tab 的表现"
},
"PagesOptionsTabbarList"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| iconfont | [iconfont 配置项列表](#pagesoptionstabbarlist-iconfont) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标，优先级高于 iconPath |
\n
| pagePath | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 页面路径，必须在 pages 中先定义 |
\n
| text | string | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | tab 上按钮文字，在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px，当 position 为 top 时，此参数无效，不支持网络图片，不支持字体图标 |
\n
| selectedIconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 选中时的图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px ，当 position 为 top 时，此参数无效 |
\n
| visible | boolean | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 该项是否显示，默认显示 |"
},
"PagesOptionsTabbarList_iconfont"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| text | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字库 Unicode 码 |
\n
| selectedText | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 选中后字库 Unicode 码 |
\n
| fontSize | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标字号(px) |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
3.9
\"
,
\"
4.18
\"
]]}' /> | 字体图标选中颜色 |"
,
"description"
:
"字体图标，优先级高于 iconPath"
},
"tabBar_midButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| width | string |
\"
80px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的宽度，tabBar 其它项为减去此宽度后平分，默认值为与其它项平分宽度 |
\n
| height | string |
\"
80px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的高度，可以大于 tabBar 高度，达到中间凸起的效果 |
\n
| text | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的文字 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的图片路径 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 图标默认宽度（高度等比例缩放） |
\n
| backgroundImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 中间按钮的背景图片路径 |
\n
| iconfont | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
x
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 字体图标，优先级高于 iconPath |"
,
"description"
:
"中间按钮 仅在 list 项为偶数时有效"
},
"pages_topWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面路径 |
\n
| style | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#topwindow-matchmedia) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"上窗体"
},
"topWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_leftWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面路径 |
\n
| style | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#leftwindow-matchmedia) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"左窗体"
},
"leftWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_rightWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面路径 |
\n
| style | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#rightwindow-matchmedia) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"右窗体"
},
"rightWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
x
\"
,
\"
x
\"
,
\"
x
\"
]]}' /> | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_condition"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| current | number | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 当前激活的模式，list节点的索引值。 |
\n
| list | Array
\\
<[PagesConditionItem](#pagesconditionitem)> | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动模式列表 |"
,
"description"
:
"启动模式"
},
"PagesConditionItem"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| name | string | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动模式名称 |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动页面路径 |
\n
| query | string | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
4.41
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 启动参数，可在页面的 onLoad 函数里获得 |"
},
"PagesSubPackages"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| root | string | - | 是 | - | 子包的根目录 |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | - | 子包由哪些页面组成 |"
},
"pages_easycom"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| autoscan | boolean | true | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 是否开启自动扫描，开启后将会自动扫描符合components/组件名称/组件名称.vue/uvue目录结构的组件 |
\n
| custom | object | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.9
\"
,
\"
4.11
\"
]]}' /> | 以正则方式自定义组件匹配规则。如果autoscan不能满足需求，可以使用custom自定义匹配规则 |"
,
"description"
:
"组件自动引入规则"
},
"pages_uniIdRouter"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| loginPage | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 登录页面路径 |
\n
| resToLogin | boolean | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | 是否开启自动根据响应体判断跳转登录页面，默认true（开启） |
\n
| needLogin | Array
\\
<string,[string.PageURIString](/uts/data-type.md#ide-string)> | - | 否 | <CompatibilityTable table='{
\"
headers
\"
:[{
\"
title
\"
:
\"
Web
\"
},{
\"
title
\"
:
\"
微信小程序
\"
},{
\"
title
\"
:
\"
Android
\"
},{
\"
title
\"
:
\"
iOS
\"
}],
\"
rows
\"
:[[
\"
4.0
\"
,
\"
√
\"
,
\"
3.99
\"
,
\"
4.11
\"
]]}' /> | - |"
,
"description"
:
"根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router)"
},
"tutorial"
:
"## 参见
\n
[相关 Bug](https://issues.dcloud.net.cn/?mid=collocation.pages_json)"
}
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑！
取消
想要评论请
注册
或
登录
