Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
enjoyphenix
unidocs-zh
提交
5d159f82
unidocs-zh
项目概览
enjoyphenix
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
5d159f82
编写于
10月 11, 2023
作者:
G
git_robot
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新 maniFestJson.json、pagesJson.json
上级
b892ec3b
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
2 addition
and
2 deletion
+2
-2
docs/.vuepress/utils/maniFestJson.json
docs/.vuepress/utils/maniFestJson.json
+1
-1
docs/.vuepress/utils/pagesJson.json
docs/.vuepress/utils/pagesJson.json
+1
-1
未找到文件。
docs/.vuepress/utils/maniFestJson.json
浏览文件 @
5d159f82
{
"manifest"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| appid | string | - | [DCloud AppID 使用说明](https://ask.dcloud.net.cn/article/35907) | - |
\n
| name | string | - | 应用名称 | - |
\n
| description | string | - | 应用描述 | - |
\n
| versionName | string | - | 应用版本名称 | - |
\n
| versionCode | integer | - | 应用版本号,必须是整数,取值范围1~2147483647;升级时必须高于上一次设置的值。 | - |
\n
| locale | string | - | 默认语言<br/>`` | - |
\n
| fallbackLocale | string | - | 默认回退语言<br/>`` | - |
\n
| uni-app-x | [uni-app-x 配置项列表](#manifest-uni-app-x) | - | 存在uni-app-x节点则表示为uni-app x项目 | - |
\n
| app | [app 配置项列表](#manifest-app) | - | App端(原生App)配置 | - |"
,
"description"
:
"[配置指南](http://uniapp.dcloud.io/manifest)"
},
"manifest_uni-app-x"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| flex-direction | string | column | uvue页面默认flex排列方向<br/>`row` : 从左到右<br/>`row-reverse` : 从右到左<br/>`column` : 从上到下<br/>`column-reverse` : 与 column 相反 | - |"
,
"description"
:
"存在uni-app-x节点则表示为uni-app x项目"
},
"manifest_app"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| distribute | [distribute 配置项列表](#app-distribute) | - | App端发布配置 | - |"
,
"description"
:
"App端(原生App)配置"
},
"app_distribute"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| syncDebug | boolean | - | 是否为自定义调试基座 | - |
\n
| icons | [icons 配置项列表](#distribute-icons) | - | iOS、Android应用图标配置。云打包后生效,建议在HBuilderX中 manifest.json 的可视化界面操作,不推荐手动在源码视图中修改。 | - |
\n
| android | [android 配置项列表](#distribute-android) | - | App-Android端发布配置 | - |
\n
| ios | [ios 配置项列表](#distribute-ios) | - | IOS配置 | - |"
,
"description"
:
"App端发布配置"
},
"distribute_icons"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| android | [android 配置项列表](#icons-android) | - | Android图标配置 | - |
\n
| ios | [ios 配置项列表](#icons-ios) | - | iOS图标配置 | - |"
,
"description"
:
"iOS、Android应用图标配置。云打包后生效,建议在HBuilderX中 manifest.json 的可视化界面操作,不推荐手动在源码视图中修改。"
},
"icons_android"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| hdpi | string | - | 高分屏设备程序图标,分辨率要求72x72 | - |
\n
| xhdpi | string | - | 720P高分屏设备程序图标,分辨率要求96x96 | - |
\n
| xxhdpi | string | - | 1080P高分屏设备程序图标,分辨率要求144x144 | - |
\n
| xxxhdpi | string | - | 2K屏设备程序图标,分辨率要求192x192 | - |"
},
"icons_ios"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| appstore | string | - | 提交app store使用的图标 1024x1024 | - |
\n
| iphone | [iphone 配置项列表](#ios-iphone) | - | iPhone图标配置 | - |
\n
| ipad | [ipad 配置项列表](#ios-ipad) | - | iPad图标配置 | - |"
},
"ios_iphone"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| app@2x | string | - | iOS9.0+ 程序图标(2x) | - |
\n
| app@3x | string | - | iOS9.0+ 程序图标(3x) | - |
\n
| spotlight@2x | string | - | iOS9.0+ Spotlight图标(2x) | - |
\n
| spotlight@3x | string | - | iOS9.0+ Spotlight图标(3x) | - |
\n
| settings@2x | string | - | iOS9.0+ Settings设置图标(2x) | - |
\n
| settings@3x | string | - | iOS9.0+ Settings设置图标(3x) | - |
\n
| notification@2x | string | - | iOS9.0+ 通知栏图标(2x) | - |
\n
| notification@3x | string | - | iOS9.0+ 通知栏图标(3x) | - |"
},
"ios_ipad"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| app | string | - | iOS9.0+ 程序图标 | - |
\n
| app@2x | string | - | iOS9.0+ 程序图标(2x) | - |
\n
| proapp@2x | string | - | iOS9.0+ 程序图标(3x) | - |
\n
| spotlight | string | - | iOS9.0+ Spotlight图标 | - |
\n
| spotlight@2x | string | - | iOS9.0+ Spotlight图标(2x) | - |
\n
| settings | string | - | iOS9.0+ Settings设置图标 | - |
\n
| settings@2x | string | - | iOS9.0+ Settings设置图标(2x) | - |
\n
| notification | string | - | iOS9.0+ 通知栏图标 | - |
\n
| notification@2x | string | - | iOS9.0+ 通知栏图标(2x) | - |"
},
"distribute_android"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| minSdkVersion | integer | - | 应用兼容的最低Android版本(API等级);[参考文档](https://uniapp.dcloud.io/tutorial/app-android-minsdkversion) | - |
\n
| targetSdkVersion | integer | - | 应用适配的目标Android版本(API等级),部分应用市场要求设置较高的targetSdkVersion才能提交审核;[参考文档](https://uniapp.dcloud.io/tutorial/app-android-targetsdkversion) | - |
\n
| abiFilters | Array
\\
<'armeabi-v7a'
\\
| 'arm64-v8a'
\\
| 'x86'
\\
| 'x86_64'> | [
\"
arm64-v8a
\"
,
\"
x86_64
\"\\
] | [参考文档](https://uniapp.dcloud.io/tutorial/app-android-abifilters) | - |"
,
"description"
:
"App-Android端发布配置"
},
"distribute_ios"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- |
\n
| appid | string | - | iOS Bundle ID | 3.9.0 |"
}}
\ No newline at end of file
{
"manifest"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| appid | string | - | [DCloud AppID 使用说明](https://ask.dcloud.net.cn/article/35907) |
\n
| name | string | - | 应用名称 |
\n
| description | string | - | 应用描述 |
\n
| versionName | string | - | 应用版本名称 |
\n
| versionCode | integer | - | 应用版本号,必须是整数,取值范围1~2147483647;升级时必须高于上一次设置的值。 |
\n
| locale | string | - | 默认语言<br/>`` |
\n
| fallbackLocale | string | - | 默认回退语言<br/>`` |
\n
| uni-app-x | [uni-app-x 配置项列表](#manifest-uni-app-x) | - | 存在uni-app-x节点则表示为uni-app x项目 |
\n
| app | [app 配置项列表](#manifest-app) | - | App端(原生App)配置 |"
,
"description"
:
"[配置指南](http://uniapp.dcloud.io/manifest)"
},
"manifest_uni-app-x"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| flex-direction | string | column | uvue页面默认flex排列方向<br/>`row` : 从左到右<br/>`row-reverse` : 从右到左<br/>`column` : 从上到下<br/>`column-reverse` : 与 column 相反 |"
,
"description"
:
"存在uni-app-x节点则表示为uni-app x项目"
},
"manifest_app"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| distribute | [distribute 配置项列表](#app-distribute) | - | App端发布配置 |"
,
"description"
:
"App端(原生App)配置"
},
"app_distribute"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| syncDebug | boolean | - | 是否为自定义调试基座 |
\n
| icons | [icons 配置项列表](#distribute-icons) | - | iOS、Android应用图标配置。云打包后生效,建议在HBuilderX中 manifest.json 的可视化界面操作,不推荐手动在源码视图中修改。 |
\n
| android | [android 配置项列表](#distribute-android) | - | App-Android端发布配置 |
\n
| ios | [ios 配置项列表](#distribute-ios) | - | IOS配置 |"
,
"description"
:
"App端发布配置"
},
"distribute_icons"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| android | [android 配置项列表](#icons-android) | - | Android图标配置 |
\n
| ios | [ios 配置项列表](#icons-ios) | - | iOS图标配置 |"
,
"description"
:
"iOS、Android应用图标配置。云打包后生效,建议在HBuilderX中 manifest.json 的可视化界面操作,不推荐手动在源码视图中修改。"
},
"icons_android"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| hdpi | string | - | 高分屏设备程序图标,分辨率要求72x72 |
\n
| xhdpi | string | - | 720P高分屏设备程序图标,分辨率要求96x96 |
\n
| xxhdpi | string | - | 1080P高分屏设备程序图标,分辨率要求144x144 |
\n
| xxxhdpi | string | - | 2K屏设备程序图标,分辨率要求192x192 |"
},
"icons_ios"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| appstore | string | - | 提交app store使用的图标 1024x1024 |
\n
| iphone | [iphone 配置项列表](#ios-iphone) | - | iPhone图标配置 |
\n
| ipad | [ipad 配置项列表](#ios-ipad) | - | iPad图标配置 |"
},
"ios_iphone"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| app@2x | string | - | iOS9.0+ 程序图标(2x) |
\n
| app@3x | string | - | iOS9.0+ 程序图标(3x) |
\n
| spotlight@2x | string | - | iOS9.0+ Spotlight图标(2x) |
\n
| spotlight@3x | string | - | iOS9.0+ Spotlight图标(3x) |
\n
| settings@2x | string | - | iOS9.0+ Settings设置图标(2x) |
\n
| settings@3x | string | - | iOS9.0+ Settings设置图标(3x) |
\n
| notification@2x | string | - | iOS9.0+ 通知栏图标(2x) |
\n
| notification@3x | string | - | iOS9.0+ 通知栏图标(3x) |"
},
"ios_ipad"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| app | string | - | iOS9.0+ 程序图标 |
\n
| app@2x | string | - | iOS9.0+ 程序图标(2x) |
\n
| proapp@2x | string | - | iOS9.0+ 程序图标(3x) |
\n
| spotlight | string | - | iOS9.0+ Spotlight图标 |
\n
| spotlight@2x | string | - | iOS9.0+ Spotlight图标(2x) |
\n
| settings | string | - | iOS9.0+ Settings设置图标 |
\n
| settings@2x | string | - | iOS9.0+ Settings设置图标(2x) |
\n
| notification | string | - | iOS9.0+ 通知栏图标 |
\n
| notification@2x | string | - | iOS9.0+ 通知栏图标(2x) |"
},
"distribute_android"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| minSdkVersion | integer | - | 应用兼容的最低Android版本(API等级);[参考文档](https://uniapp.dcloud.io/tutorial/app-android-minsdkversion) |
\n
| targetSdkVersion | integer | - | 应用适配的目标Android版本(API等级),部分应用市场要求设置较高的targetSdkVersion才能提交审核;[参考文档](https://uniapp.dcloud.io/tutorial/app-android-targetsdkversion) |
\n
| abiFilters | Array
\\
<'armeabi-v7a'
\\
| 'arm64-v8a'
\\
| 'x86'
\\
| 'x86_64'> | [
\"
arm64-v8a
\"
,
\"
x86_64
\"\\
] | [参考文档](https://uniapp.dcloud.io/tutorial/app-android-abifilters) |"
,
"description"
:
"App-Android端发布配置"
},
"distribute_ios"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| appid | string | - | iOS Bundle ID |"
}}
\ No newline at end of file
docs/.vuepress/utils/pagesJson.json
浏览文件 @
5d159f82
{
"pages"
:{
"compatibility"
:
"**pages.json 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| pages | 5.0 | √ | √ | 10.0 | √ | x |
\n
| subPackages | 5.0 | √ | x | 10.0 | √ | x |
\n
| workers | x | x | x | x | x | x |
\n
| preloadRule | x | x | x | x | x | x |
\n
| easycom | 5.0 | >=2.5.5 | √ | 10.0 | >=2.5.5 | x |
\n
| uniIdRouter | 5.0 | >=3.5.0 | x | 10.0 | >=3.5.0 | x |
\n
| entryPagePath | x | x | x | x | x | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| globalStyle | [globalStyle 配置项列表](#pages-globalstyle) | - | 否 | - | - |
\n
| topWindow | [topWindow 配置项列表](#pages-topwindow) | - | 否 | - | - |
\n
| leftWindow | [leftWindow 配置项列表](#pages-leftwindow) | - | 否 | - | - |
\n
| rightWindow | [rightWindow 配置项列表](#pages-rightwindow) | - | 否 | - | - |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | 页面路径及窗口表现 | - |
\n
| tabBar | [tabBar 配置项列表](#pages-tabbar) | - | 否 | - | - |
\n
| condition | [condition 配置项列表](#pages-condition) | - | 否 | - | - |
\n
| subPackages | Array
\\
<[PagesSubPackages](#pagessubpackages)> | - | 否 | 分包加载配置 | - |
\n
| workers | string | - | 否 | 使用 Worker 处理多线程任务时,设置 Worker 代码放置的目录 | - |
\n
| preloadRule | object | - | 否 | 声明分包预下载的规则 | - |
\n
| easycom | [easycom 配置项列表](#pages-easycom) | - | 否 | 组件自动引入规则 | - |
\n
| uniIdRouter | [uniIdRouter 配置项列表](#pages-uniidrouter) | - | 否 | 根据用户登录状态、页面是否要求登录自动跳转登录页面 | - |
\n
| entryPagePath | string | - | 否 | 默认启动首页,新增于HBuilderX 3.7.0 | - |"
},
"pages_globalStyle"
:{
"compatibility"
:
"**globalStyle 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTextStyle | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTitleText | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationStyle | 5.0 | >=2.0.3 | √ | 10.0 | >=2.0.3 | x |
\n
| backgroundColor | x | x | x | x | x | x |
\n
| backgroundTextStyle | x | x | x | x | x | x |
\n
| enablePullDownRefresh | 5.0 | √ | √ | 10.0 | √ | x |
\n
| onReachBottomDistance | 5.0 | √ | x | 10.0 | √ | x |
\n
| backgroundColorTop | x | x | x | 10.0 | √ | x |
\n
| backgroundColorBottom | x | x | x | 10.0 | √ | x |
\n
| titleImage | 5.0 | √ | x | 10.0 | √ | x |
\n
| transparentTitle | 5.0 | √ | x | 10.0 | √ | x |
\n
| titlePenetrate | x | x | x | x | x | x |
\n
| pageOrientation | 5.0 | >=2.4.7 | x | 10.0 | >=2.4.7 | x |
\n
| animationType | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationDuration | 5.0 | √ | x | 10.0 | √ | x |
\n
| allowsBounceVertical | x | x | x | x | x | x |
\n
| usingComponents | 5.0 | √ | x | 10.0 | √ | x |
\n
| renderingMode | x | x | x | x | x | x |
\n
| leftWindow | x | x | x | x | x | x |
\n
| topWindow | x | x | x | x | x | x |
\n
| rightWindow | x | x | x | x | x | x |
\n
| rpxCalcMaxDeviceWidth | 5.0 | √ | x | 10.0 | √ | x |
\n
| rpxCalcBaseDeviceWidth | 5.0 | √ | x | 10.0 | √ | x |
\n
| rpxCalcIncludeWidth | 5.0 | √ | x | 10.0 | √ | x |
\n
| dynamicRpx | 5.0 | >=3.2.13 | x | 10.0 | >=3.2.13 | x |
\n
| maxWidth | x | x | x | x | x | x |
\n
| mp-tuotiao | x | x | x | x | x | x |
\n
| mp-qq | x | x | x | x | x | x |
\n
| mp-kuaishou | x | x | x | x | x | x |
\n
| mp-jd | x | x | x | x | x | x |
\n
| mp-lark | x | x | x | x | x | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | HexColor | APP与H5为#F8F8F8,小程序平台请参考相应小程序文档 | 否 | 导航栏背景颜色(同状态栏背景色) | - |
\n
| navigationBarTextStyle | string | black | 否 | 导航栏标题颜色,仅支持 black/white(支付宝小程序不支持,请使用 [my.setNavigationBar](https://opendocs.alipay.com/mini/api/xwq8e6))。<br/>`white` <br/>`black` | - |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容 | - |
\n
| navigationStyle | string | default | 否 | 导航栏样式,仅支持 default/custom。custom即取消默认的原生导航栏,需看[使用注意](/collocation/page.md?id=customnav)。<br/>`default` <br/>`custom` | - |
\n
| backgroundColor | string | #ffffff | 否 | 下拉显示出来的窗口的背景色<br/>`HBuilderX.ColorString` | - |
\n
| backgroundTextStyle | string | dark | 否 | 下拉 loading 的样式,仅支持 dark / light<br/>`dark` <br/>`light` | - |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新,详见[页面生命周期](/tutorial/page.md?id=lifecycle)。 | - |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离,单位只支持px,详见[页面生命周期](/tutorial/page.md?id=lifecycle)。 | - |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 | - |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 | - |
\n
| titleImage | string | - | 否 | 导航栏图片地址(替换当前文字标题),支付宝小程序内必须使用https的图片链接地址<br/>`HBuilderX.ImageURIString` | - |
\n
| transparentTitle | string | none | 否 | 导航栏整体(前景、背景)透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` | - |
\n
| titlePenetrate | string | NO | 否 | 导航栏点击穿透<br/>`YES` <br/>`NO` | - |
\n
| pageOrientation | string | portrait | 否 | 横屏配置,屏幕旋转设置,仅支持 auto / portrait / landscape 详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)。<br/>`auto` <br/>`portrait` <br/>`landscape` | - |
\n
| animationType | string | pop-in | 否 | 窗口显示的动画效果,详见:[窗口动画](/api/router.md?id=animation)。<br/>`slide-in-right` <br/>`slide-in-left` <br/>`slide-in-top` <br/>`slide-in-bottom` <br/>`fade-in` <br/>`zoom-out` <br/>`zoom-fade-out` <br/>`pop-in` | - |
\n
| animationDuration | number | 300 | 否 | 窗口显示动画的持续时间,单位为 ms | - |
\n
| allowsBounceVertical | string | YES | 否 | 是否允许向下拉拽。默认 YES。如果需要下拉刷新,值必须为YES<br/>`YES` <br/>`NO` | - |
\n
| usingComponents | object | - | 否 | 引用小程序组件,参考 [小程序组件](/tutorial/miniprogram-subject.md?id=小程序自定义组件支持)。 | - |
\n
| renderingMode | string | - | 否 | 同层渲染,webrtc(实时音视频) 无法正常时尝试配置 seperated 强制关掉同层 | - |
\n
| leftWindow | boolean | true | 否 | 当存在 leftWindow时,默认是否显示 leftWindow | - |
\n
| topWindow | boolean | true | 否 | 当存在 topWindow时,默认是否显示 topWindow | - |
\n
| rightWindow | boolean | true | 否 | 当存在 rightWindow时,默认是否显示 rightWindow | - |
\n
| rpxCalcMaxDeviceWidth | number | 960 | 否 | rpx 计算所支持的最大设备宽度,单位 px | - |
\n
| rpxCalcBaseDeviceWidth | number | 375 | 否 | rpx 计算使用的基准设备宽度,设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算,单位 px | - |
\n
| rpxCalcIncludeWidth | number | 750 | 否 | rpx 计算特殊处理的值,始终按实际的设备宽度计算,单位 rpx | - |
\n
| dynamicRpx | boolean | false | 否 | 动态 rpx,屏幕大小变化会重新渲染 rpx | - |
\n
| maxWidth | number | - | 否 | 单位px,当浏览器可见区域宽度大于maxWidth时,两侧留白,当小于等于maxWidth时,页面铺满;不同页面支持配置不同的maxWidth;maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) | - |
\n
| app-plus | [app-plus 配置项列表](#globalstyle-app-plus) | - | 否 | - | - |
\n
| h5 | [h5 配置项列表](#globalstyle-h5) | - | 否 | - | - |
\n
| mp-alipay | [mp-alipay 配置项列表](#globalstyle-mp-alipay) | - | 否 | - | - |
\n
| mp-weixin | [mp-weixin 配置项列表](#globalstyle-mp-weixin) | - | 否 | - | - |
\n
| mp-baidu | [mp-baidu 配置项列表](#globalstyle-mp-baidu) | - | 否 | - | - |
\n
| mp-tuotiao | object | - | 否 | 头条小程序特有配置 | - |
\n
| mp-qq | object | - | 否 | QQ小程序特有配置 | - |
\n
| mp-kuaishou | object | - | 否 | 快手小程序特有配置 | - |
\n
| mp-jd | object | - | 否 | 设置编译到 mp-jd 平台的特定样式 | - |
\n
| mp-lark | object | - | 否 | 飞书小程序特有配置 | - |"
},
"globalStyle_app-plus"
:{
"compatibility"
:
"**app-plus 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| background | 5.0 | √ | x | 10.0 | √ | x |
\n
| subNVues | 5.0 | >=1.9.10 | x | 10.0 | >=1.9.10 | x |
\n
| bounce | 5.0 | √ | x | 10.0 | √ | x |
\n
| popGesture | x | x | x | 10.0 | √ | x |
\n
| softinputNavBar | x | x | x | 10.0 | √ | x |
\n
| softinputmode | 5.0 | √ | x | 10.0 | √ | x |
\n
| scrollIndicator | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationType | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationDuration | 5.0 | √ | x | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | HexColor | #ffffff | 否 | 窗体背景色。无论vue页面还是nvue页面,在App上都有一个父级原生窗体,该窗体的背景色生效时间快于页面里的css生效时间,vue 页面需要将 body 背景色设为透明 | - |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | - | - |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | 原生子窗体,详见:[原生子窗体](/collocation/page.md?id=app-subNVues)。 | - |
\n
| bounce | string | - | 否 | 页面回弹效果,设置为
\"
none
\"
时关闭效果。仅支持 app-vue(nvue Android无页面级bounce效果,仅list、recycle-list、waterfall等滚动组件有bounce效果)<br/>`none` <br/>`vertical` <br/>`horizontal` <br/>`all` | - |
\n
| popGesture | string | close | 否 | 侧滑返回功能,可选值:
\"
close
\"
(启用侧滑返回)、
\"
none
\"
(禁用侧滑返回)。<br/>`close` <br/>`none` | - |
\n
| softinputNavBar | string | auto | 否 | iOS软键盘上完成工具栏的显示模式,设置为
\"
none
\"
时关闭工具栏。<br/>`auto` <br/>`none` | - |
\n
| softinputmode | string | adjustPan | 否 | 软键盘弹出模式,支持 adjustResize、adjustPan 两种模式<br/>`nothing` <br/>`adjustPan` <br/>`adjustResize` | - |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | - | - |
\n
| scrollIndicator | string | - | 否 | 是否显示滚动条,设置为
\"
none
\"
时不显示滚动条。 | - |
\n
| animationType | string | pop-in | 否 | 窗口显示的动画效果,详见:[窗口动画](/api/router?id=animation)。<br/>`slide-in-right` <br/>`slide-in-left` <br/>`slide-in-top` <br/>`slide-in-bottom` <br/>`fade-in` <br/>`zoom-out` <br/>`zoom-fade-out` <br/>`pop-in` | - |
\n
| animationDuration | number | 300 | 否 | 窗口显示动画的持续时间,单位为 ms | - |"
},
"app-plus_titleNView"
:{
"compatibility"
:
"**titleNView 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | 5.0 | √ | x | 10.0 | √ | x |
\n
| buttons | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleColor | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleOverflow | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleText | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleSize | 5.0 | √ | x | 10.0 | √ | x |
\n
| type | 5.0 | √ | x | 10.0 | √ | x |
\n
| tags | 5.0 | √ | x | 10.0 | √ | x |
\n
| homeButton | 5.0 | √ | x | 10.0 | √ | x |
\n
| autoBackButton | 5.0 | >=2.6.3 | x | 10.0 | >=2.6.3 | x |
\n
| backgroundImage | 5.0 | >=2.6.3 | x | 10.0 | >=2.6.3 | x |
\n
| backgroundRepeat | 5.0 | >=2.6.3 | x | 10.0 | >=2.6.3 | x |
\n
| titleAlign | 5.0 | >=2.6.3 | x | 10.0 | >=2.6.3 | x |
\n
| blurEffect | 5.0 | >=2.4.3 | x | 10.0 | >=2.4.3 | x |
\n
| coverage | 5.0 | √ | x | 10.0 | √ | x |
\n
| splitLine | 5.0 | >=2.6.6 | x | 10.0 | >=2.6.6 | x |
\n
| subtitleColor | 5.0 | >=2.6.6 | x | 10.0 | >=2.6.6 | x |
\n
| subtitleSize | 5.0 | >=2.6.6 | x | 10.0 | >=2.6.6 | x |
\n
| subtitleOverflow | 5.0 | >=2.6.6 | x | 10.0 | >=2.6.6 | x |
\n
| subtitleText | 5.0 | >=2.6.6 | x | 10.0 | >=2.6.6 | x |
\n
| titleIcon | 5.0 | >=2.6.6 | x | 10.0 | >=2.6.6 | x |
\n
| titleIconRadius | 5.0 | >=2.6.6 | x | 10.0 | >=2.6.6 | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | string | #f7f7f7 | 否 | 背景颜色,支持16进制颜色或RGBA颜色(仅悬浮导航栏支持RGBA颜色)。<br/>`HBuilderX.ColorString` | - |
\n
| buttons | Array
\\
<[PageStyleAppPlusTitleNViewButton](#pagestyleappplustitlenviewbutton)> | - | 否 | 自定义按钮(纯nvue即render:native时暂不支持),详见 [buttons](/collocation/page.md?id=app-titlenview-buttons)。 | - |
\n
| titleColor | string | #000000 | 否 | 标题文字颜色<br/>`HBuilderX.ColorString` | - |
\n
| titleOverflow | string | ellipsis | 否 | 标题文字超出显示区域时处理方式。
\"
clip
\"
-超出显示区域时内容裁剪;
\"
ellipsis
\"
-超出显示区域时尾部显示省略标记(...)。<br/>`clip` <br/>`ellipsis` | - |
\n
| titleText | string | - | 否 | 标题文字内容<br/>`HBuilderX.VueI18NKeyString` | - |
\n
| titleSize | string | - | 否 | 标题文字字体大小 | - |
\n
| type | string | default | 否 | 导航栏样式。
\"
default
\"
-默认样式;
\"
transparent
\"
-滚动透明渐变;
\"
float
\"
-悬浮导航栏。<br/>`default` <br/>`transparent` <br/>`float` | - |
\n
| tags | array | - | 否 | 原生 View 增强,详见:[5+ View 控件](http://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.ViewDrawTagStyles)。 | - |
\n
| searchInput | [searchInput 配置项列表](#titlenview-searchinput) | - | 否 | - | - |
\n
| homeButton | boolean | false | 否 | 标题栏控件是否显示Home按钮 | - |
\n
| autoBackButton | boolean | true | 否 | 标题栏控件是否显示左侧返回按钮 | - |
\n
| backButton | [backButton 配置项列表](#titlenview-backbutton) | - | 否 | - | - |
\n
| backgroundImage | string | - | 否 | 支持以下类型: 背景图片路径 - 如
\"
./img/t.png
\"
,仅支持本地文件路径, 相对路径,相对于当前页面的host位置,根据实际标题栏宽高拉伸绘制; 渐变色 - 仅支持线性渐变,两种颜色的渐变,如“linear-gradient(to top, #a80077, #66ff00)”, 其中第一个参数为渐变方向,可取值:
\"
to right
\"
表示从左向右渐变,
\"
to left
\"
表示从右向左渐变,
\"
to bottom
\"
表示从上到下渐变,
\"
to top
\"
表示从下到上渐变,
\"
to bottom right
\"
表示从左上角到右下角,
\"
to top left
\"
表示从右下角到左上角。<br/>`HBuilderX.ImageURIString` | - |
\n
| backgroundRepeat | string | no-repeat | 否 | 仅在backgroundImage设置为图片路径时有效。 可取值:
\"
repeat
\"
- 背景图片在垂直方向和水平方向平铺;
\"
repeat-x
\"
- 背景图片在水平方向平铺,垂直方向拉伸;
\"
repeat-y
\"
- 背景图片在垂直方向平铺,水平方向拉伸;
\"
no-repeat
\"
- 背景图片在垂直方向和水平方向都拉伸。 默认使用
\"
no-repeat
\"
。<br/>`repeat` <br/>`repeat-x` <br/>`repeat-y` <br/>`no-repeat` | - |
\n
| titleAlign | string | auto | 否 | 可取值:
\"
center
\"
-居中对齐;
\"
left
\"
-居左对齐;
\"
auto
\"
-根据平台自动选择(Android平台居左对齐,iOS平台居中对齐)<br/>`center` <br/>`left` <br/>`auto` | - |
\n
| blurEffect | string | none | 否 | 此效果将会高斯模糊显示标题栏后的内容,仅在type为
\"
transparent
\"
或
\"
float
\"
时有效。 可取值:
\"
dark
\"
- 暗风格模糊,对应iOS原生UIBlurEffectStyleDark效果;
\"
extralight
\"
- 高亮风格模糊,对应iOS原生UIBlurEffectStyleExtraLight效果;
\"
light
\"
- 亮风格模糊,对应iOS原生UIBlurEffectStyleLight效果;
\"
none
\"
- 无模糊效果。 注意:使用模糊效果时应避免设置背景颜色,设置背景颜色可能覆盖模糊效果。<br/>`dark` <br/>`extralight` <br/>`light` <br/>`none` | - |
\n
| coverage | string | 132px | 否 | 标题栏控件变化作用范围,仅在type值为transparent时有效,页面滚动时标题栏背景透明度将发生变化。 当页面滚动到指定偏移量时标题栏背景变为完全不透明。 支持百分比、像素值 | - |
\n
| splitLine | boolean | false | 否 | 标题栏的底部分割线([SplitLineStyles](/collocation/page.md?id=app-titleNView-splitLineStyles))),设置此属性则在标题栏控件的底部显示分割线,可配置颜色值及高度。 设置此属性值为undefined或null则隐藏分割线。 默认不显示底部分割线 | - |
\n
| subtitleColor | string | - | 否 | 副标题文字颜色,颜色值格式为
\"
#RRGGBB
\"
和
\"
rgba(R,G,B,A)
\"
,如
\"
#FF0000
\"
表示标题文字颜色为红色。 默认值与主标题文字颜色一致 | - |
\n
| subtitleSize | string | auto | 否 | 副标题文字字体大小,字体大小单位为像素,如
\"
14px
\"
表示字体大小为14像素,auto表示自动计算,约为12像素。 | - |
\n
| subtitleOverflow | string | ellipsis | 否 | 标题文字超出显示区域时处理方式,可取值:
\"
clip
\"
- 超出显示区域时内容裁剪;
\"
ellipsis
\"
- 超出显示区域时尾部显示省略标记(...)。<br/>`clip` <br/>`ellipsis` | - |
\n
| subtitleText | string | - | 否 | 副标题文字内容,设置副标后将显示两行标题,副标显示在主标题(titleText)下方。 注意:设置副标题后将居左显示 | - |
\n
| titleIcon | string | - | 否 | 标题图标,图标路径如
\"
./img/t.png
\"
,仅支持本地文件路径, 相对路径,相对于当前页面的host位置,固定宽高为逻辑像素值
\"
34px
\"
。 要求图片的宽高相同。 注意:设置标题图标后标题将居左显示。 | - |
\n
| titleIconRadius | string | 无圆角 | 否 | 标题图标圆角,取值格式为
\"
XXpx
\"
,其中XX为像素值(逻辑像素),如
\"
10px
\"
表示10像素半径圆角。 | - |"
},
"PageStyleAppPlusTitleNViewButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| type | string | none | 否 | 按钮样式,可取值见:[buttons 样式](/collocation/page.md?id=app-titlenview-buttons-type)<br/>`forward` <br/>`back` <br/>`share` <br/>`favorite` <br/>`home` <br/>`menu` <br/>`close` <br/>`none` | - |
\n
| color | string | 默认与标题文字颜色一致 | 否 | 按钮上文字颜色<br/>`HBuilderX.ColorString` | - |
\n
| colorPressed | string | 默认值为 color 属性值自动调整透明度为 0.3 | 否 | 按下状态按钮文字颜色 | - |
\n
| float | string | right | 否 | 按钮在标题栏上的显示位置,可取值
\"
left
\"
、
\"
right
\"
<br/>`right` <br/>`left` | - |
\n
| fontWeight | string | normal | 否 | 按钮上文字的粗细。可取值
\"
normal
\"
-标准字体、
\"
bold
\"
-加粗字体。<br/>`normal` <br/>`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 | string | center | 否 | 非输入状态下文本的对齐方式。可取值:
\"
left
\"
- 居左对齐;
\"
right
\"
- 居右对齐;
\"
center
\"
- 居中对齐。<br/>`left` <br/>`right` <br/>`center` | - |
\n
| backgroundColor | string | rgba(255,255,255,0.5) | 否 | 背景颜色 | - |
\n
| borderRadius | string | 0px | 否 | 输入框的圆角半径,取值格式为
\"
XXpx
\"
,其中XX为像素值(逻辑像素),不支持rpx。 | - |
\n
| placeholder | string | - | 否 | 提示文本<br/>`HBuilderX.VueI18NKeyString` | - |
\n
| placeholderColor | string | #cccccc | 否 | 提示文本颜色 | - |
\n
| disabled | boolean | false | 否 | 是否可输入 | - |"
},
"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 | string | normal | 否 | 返回按钮上标题的粗细,可取值:
\"
normal
\"
- 标准字体;
\"
bold
\"
- 加粗字体。 | - |"
},
"PageStyleAppPlusSubNVues"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| id | string | - | 否 | subNVue 原生子窗体的标识 | - |
\n
| path | string | - | 否 | 配置 nvue 文件路径,nvue 文件需放置到使用 subNvue 的页面文件目录下<br/>`HBuilderX.NPageURIString` | - |
\n
| type | string | - | 否 | 内置样式<br/>`popup` <br/>`navigationBar` | - |
\n
| style | [style 配置项列表](#pagestyleappplussubnvues-style) | - | 否 | - | - |"
},
"PageStyleAppPlusSubNVues_style"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| position | string | absolute | 否 | 原生子窗体的排版位置,排版位置决定原生子窗体在父窗口中的定位方式。 可取值:
\"
static
\"
,原生子窗体在页面中正常定位,如果页面存在滚动条则随窗口内容滚动;
\"
absolute
\"
,原生子窗体在页面中绝对定位,如果页面存在滚动条不随窗口内容滚动;
\"
dock
\"
,原生子窗体在页面中停靠,停靠的位置由dock属性值决定。 默认值为
\"
absolute
\"
。<br/>`static` <br/>`absolute` <br/>`dock` | - |
\n
| dock | string | bottom | 否 | 原生子窗体的停靠方式,仅当原生子窗体
\"
position
\"
属性值设置为
\"
dock
\"
时才生效,可取值:
\"
top
\"
,原生子窗体停靠则页面顶部;
\"
bottom
\"
,原生子窗体停靠在页面底部;
\"
right
\"
,原生子窗体停靠在页面右侧;
\"
left
\"
,原生子窗体停靠在页面左侧。 默认值为
\"
bottom
\"
。<br/>`top` <br/>`bottom` <br/>`right` <br/>`left` | - |
\n
| mask | string | rgba(0,0,0,0.5) | 否 | 原生子窗体的遮罩层,仅当原生子窗体
\"
type
\"
属性值设置为
\"
popup
\"
时才生效,可取值: rgba格式字符串,定义纯色遮罩层样式,如
\"
rgba(0,0,0,0.5)
\"
,表示黑色半透明;<br/>`HBuilderX.ColorString` | - |
\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才能看到正确的效果 | - |"
},
"app-plus_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| support | boolean | false | 否 | 是否开启窗口的下拉刷新功能 | - |
\n
| color | string | #2BD009 | 否 | 颜色值格式为
\"
#RRGGBB
\"
,仅
\"
circle
\"
样式下拉刷新支持此属性。<br/>`HBuilderX.ColorString` | - |
\n
| style | string | Android 平台为 circle;iOS 平台为 default。 | 否 | 可取值:
\"
default
\"
——经典下拉刷新样式(下拉拖动时页面内容跟随);
\"
circle
\"
——圆圈样式下拉刷新控件样式(下拉拖动时仅刷新控件跟随)。<br/>`default` <br/>`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) | - | 否 | - | - |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | - | - |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | - | - |"
},
"pullToRefresh_contentdown"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 | - |"
},
"pullToRefresh_contentover"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 | - |"
},
"pullToRefresh_contentrefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 | - |"
},
"globalStyle_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | - | - |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | - | - |"
},
"h5_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | string | #f7f7f7 | 否 | 背景颜色,颜色值格式为
\"
#RRGGBB
\"
。<br/>`HBuilderX.ColorString` | - |
\n
| buttons | array | - | 否 | 自定义按钮,参考 [buttons](/collocation/pages.md?id=h5-titlenview-buttons)。 | - |
\n
| titleColor | string | #000000 | 否 | 标题文字颜色<br/>`HBuilderX.ColorString` | - |
\n
| titleText | string | - | 否 | 标题文字内容 | - |
\n
| titleSize | string | - | 否 | 标题文字字体大小 | - |
\n
| type | string | default | 否 | 导航栏样式。
\"
default
\"
-默认样式;
\"
transparent
\"
-透明渐变。<br/>`default` <br/>`transparent` | - |
\n
| searchInput | object | - | 否 | 导航栏上的搜索框样式,详见:[searchInput](/collocation/pages.md?id=h5-searchinput)。 | - |"
},
"h5_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| support | boolean | - | 否 | 是否开启窗口的下拉刷新功能 | - |
\n
| color | string | - | 否 | 颜色值格式为
\"
#RRGGBB
\"
,仅
\"
circle
\"
样式下拉刷新支持此属性。<br/>`HBuilderX.ColorString` | - |
\n
| type | string | - | 否 | 下拉刷新控件样式<br/>`default` <br/>`circle` | - |
\n
| height | string | - | 否 | 窗口的下拉刷新控件进入刷新状态的拉拽高度。支持百分比,如
\"
10%
\"
;像素值,如
\"
50px
\"
。 | - |
\n
| range | string | - | 否 | 窗口可下拉拖拽的范围。支持百分比,如
\"
10%
\"
;像素值,如
\"
50px
\"
。 | - |
\n
| offset | string | - | 否 | 下拉刷新控件的起始位置。仅对
\"
circle
\"
样式下拉刷新控件有效,用于定义刷新控件下拉时的起始位置。支持百分比,如
\"
10%
\"
;像素值,如
\"
50px
\"
。 | - |
\n
| contentdown | [contentdown 配置项列表](#pulltorefresh-contentdown) | - | 否 | - | - |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | - | - |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | - | - |"
},
"globalStyle_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | string | YES | 否 | 是否允许向下拉拽。支持 YES / NO<br/>`YES` <br/>`NO` | - |
\n
| transparentTitle | string | none | 否 | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` | - |
\n
| titlePenetrate | string | No | 否 | 导航栏点击穿透 | - |
\n
| showTitleLoading | string | No | 否 | 是否进入时显示导航栏的 loading。支持 YES / NO<br/>`YES` <br/>`NO` | - |
\n
| titleImage | string | - | 否 | 导航栏图片地址,替换导航栏标题,必须为https的图片链接地址 | - |
\n
| backgroundImageUrl | string | - | 否 | 下拉露出显示的背景图链接<br/>`HBuilderX.ImageURIString` | - |
\n
| backgroundImageColor | string | - | 否 | 下拉露出显示的背景图底色<br/>`HBuilderX.ColorString` | - |
\n
| gestureBack | string | No | 否 | 支付宝小程序 iOS 用,是否支持手势返回。支持 YES / NO<br/>`YES` <br/>`NO` | - |
\n
| enableScrollBar | string | YES | 否 | 支付宝小程序 Android 用,是否显示 WebView 滚动条。支持 YES / NO。<br/>`YES` <br/>`NO` | - |"
},
"globalStyle_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 | - |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 | - |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 | - |
\n
| restartStrategy | string | homePage | 否 | 重新启动策略配置。支持 homePage / homePageAndLatestPage<br/>`homePage` <br/>`homePageAndLatestPage` | - |
\n
| initialRenderingCache | string | - | 否 | 页面初始渲染缓存配置。支持 static / dynamic<br/>`static` <br/>`dynamic` | - |
\n
| visualEffectInBackground | string | none | 否 | 切入系统后台时,隐藏页面内容,保护用户隐私。支持 hidden / none<br/>`none` <br/>`hidden` | - |
\n
| handleWebviewPreload | string | static | 否 | 控制预加载下个页面的时机。支持 static / manual / auto<br/>`static` <br/>`manual` <br/>`none` | - |"
},
"globalStyle_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| textSizeAdjust | string | auto | 否 | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应<br/>`auto` <br/>`none` | - |"
},
"pages_topWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 | - |
\n
| style | object | - | 否 | 配置页面窗口表现,配置项参考下方 [pageStyle](/collocation/pages.md?id=style) | - |
\n
| matchMedia | [matchMedia 配置项列表](#topwindow-matchmedia) | - | 否 | 配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia) | - |"
},
"topWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 >= minWidth 时,显示该 window | - |"
,
"description"
:
"配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia)"
},
"pages_leftWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 | - |
\n
| style | object | - | 否 | 配置页面窗口表现,配置项参考下方 [pageStyle](/collocation/pages.md?id=style) | - |
\n
| matchMedia | [matchMedia 配置项列表](#leftwindow-matchmedia) | - | 否 | 配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia) | - |"
},
"leftWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 >= minWidth 时,显示该 window | - |"
,
"description"
:
"配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia)"
},
"pages_rightWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 | - |
\n
| style | object | - | 否 | 配置页面窗口表现,配置项参考下方 [pageStyle](/collocation/pages.md?id=style) | - |
\n
| matchMedia | [matchMedia 配置项列表](#rightwindow-matchmedia) | - | 否 | 配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia) | - |"
},
"rightWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 >= minWidth 时,显示该 window | - |"
,
"description"
:
"配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia)"
},
"PagesOptionsPage"
:{
"compatibility"
:
"**PagesOptionsPage 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| path | 5.0 | √ | √ | 10.0 | √ | x |
\n
| needLogin | 5.0 | √ | √ | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| path | string | - | 是 | 配置页面路径<br/>`HBuilderX.PageURIString` | - |
\n
| style | [style 配置项列表](#pagesoptionspage-style) | - | 否 | - | - |
\n
| needLogin | boolean | false | 否 | 是否需要登录才可访问 | - |"
},
"PagesOptionsPage_style"
:{
"compatibility"
:
"**style 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTextStyle | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTitleText | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarShadow | 5.0 | √ | x | 10.0 | √ | x |
\n
| navigationStyle | 5.0 | >=2.0.3 | √ | 10.0 | >=2.0.3 | x |
\n
| disableScroll | x | x | x | x | x | x |
\n
| backgroundColor | x | x | x | x | x | x |
\n
| backgroundTextStyle | 5.0 | √ | x | 10.0 | √ | x |
\n
| enablePullDownRefresh | 5.0 | √ | √ | 10.0 | √ | x |
\n
| onReachBottomDistance | 5.0 | √ | x | 10.0 | √ | x |
\n
| backgroundColorTop | x | x | x | 10.0 | √ | x |
\n
| backgroundColorBottom | x | x | x | 10.0 | √ | x |
\n
| disableSwipeBack | x | x | x | 10.0 | >=3.4.0 | x |
\n
| titleImage | 5.0 | √ | x | 10.0 | √ | x |
\n
| transparentTitle | 5.0 | √ | x | 10.0 | √ | x |
\n
| titlePenetrate | x | x | x | x | x | x |
\n
| mp-tuotiao | x | x | x | x | x | x |
\n
| mp-qq | x | x | x | x | x | x |
\n
| mp-kuaishou | x | x | x | x | x | x |
\n
| mp-jd | x | x | x | x | x | x |
\n
| mp-lark | x | x | x | x | x | x |
\n
| usingComponents | 5.0 | √ | x | 10.0 | √ | x |
\n
| leftWindow | x | x | x | x | x | x |
\n
| topWindow | x | x | x | x | x | x |
\n
| rightWindow | x | x | x | x | x | x |
\n
| maxWidth | x | x | x | x | x | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | HexColor | APP与H5为#F8F8F8,小程序平台请参考相应小程序文档 | 否 | 导航栏背景颜色(同状态栏背景色) | - |
\n
| navigationBarTextStyle | string | black | 否 | 导航栏标题颜色,仅支持 black/white<br/>`white` <br/>`black` | - |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容<br/>`HBuilderX.VueI18NKeyString` | - |
\n
| navigationBarShadow | [navigationBarShadow 配置项列表](#style-navigationbarshadow) | - | 否 | 导航栏阴影,配置参考下方 [导航栏阴影](/collocation/page.md?id=navigationBarShadow) | - |
\n
| navigationStyle | string | default | 否 | 导航栏样式,仅支持 default/custom。custom即取消默认的原生导航栏,需看[使用注意](/collocation/page.md?id=customnav)。<br/>`default` <br/>`custom` | - |
\n
| disableScroll | boolean | false | 否 | 设置为 true 则页面整体不能上下滚动(bounce效果),只在页面配置中有效,在globalStyle中设置无效(仅 IOS 支持)。 | - |
\n
| backgroundColor | HexColor | #ffffff | 否 | 窗口的背景色 | - |
\n
| backgroundTextStyle | string | dark | 否 | 下拉 loading 的样式,仅支持 dark/light<br/>`dark` <br/>`light` | - |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新,详见[页面生命周期](/tutorial/page.md#lifecycle)。 | - |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离,单位只支持px,详见[页面生命周期](/tutorial/page.md?id=lifecycle)。 | - |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 | - |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 | - |
\n
| disableSwipeBack | boolean | false | 否 | 是否禁用滑动返回 | - |
\n
| titleImage | string | - | 否 | 导航栏图片地址(替换当前文字标题),支付宝小程序内必须使用https的图片链接地址<br/>`HBuilderX.ImageURIString` | - |
\n
| transparentTitle | string | none | 否 | 导航栏整体(前景、背景)透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` | - |
\n
| titlePenetrate | string | NO | 否 | 导航栏点击穿透<br/>`YES` <br/>`NO` | - |
\n
| app-plus | [app-plus 配置项列表](#style-app-plus) | - | 否 | - | - |
\n
| h5 | [h5 配置项列表](#style-h5) | - | 否 | - | - |
\n
| mp-alipay | [mp-alipay 配置项列表](#style-mp-alipay) | - | 否 | - | - |
\n
| mp-weixin | [mp-weixin 配置项列表](#style-mp-weixin) | - | 否 | - | - |
\n
| mp-baidu | [mp-baidu 配置项列表](#style-mp-baidu) | - | 否 | - | - |
\n
| mp-tuotiao | object | - | 否 | 头条小程序特有配置 | - |
\n
| mp-qq | object | - | 否 | QQ小程序特有配置 | - |
\n
| mp-kuaishou | object | - | 否 | 快手小程序特有配置 | - |
\n
| mp-jd | object | - | 否 | 设置编译到 mp-jd 平台的特定样式 | - |
\n
| mp-lark | object | - | 否 | 飞书小程序特有配置 | - |
\n
| usingComponents | object | - | 否 | 引用小程序组件,参考 [小程序组件](/tutorial/miniprogram-subject.md?id=小程序自定义组件支持)。 | - |
\n
| leftWindow | boolean | true | 否 | 当存在 leftWindow时,当前页面是否显示 leftWindow | - |
\n
| topWindow | boolean | true | 否 | 当存在 topWindow时,当前页面是否显示 topWindow | - |
\n
| rightWindow | boolean | true | 否 | 当存在 rightWindow时,当前页面是否显示 rightWindow | - |
\n
| maxWidth | number | - | 否 | 单位px,当浏览器可见区域宽度大于maxWidth时,两侧留白,当小于等于maxWidth时,页面铺满;不同页面支持配置不同的maxWidth;maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) | - |"
},
"style_navigationBarShadow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| colorType | string | - | 否 | 阴影的颜色,支持:grey、blue、green、orange、red、yellow | - |"
,
"description"
:
"导航栏阴影,配置参考下方 [导航栏阴影](/collocation/page.md?id=navigationBarShadow)"
},
"style_app-plus"
:{
"compatibility"
:
"**app-plus 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| background | 5.0 | √ | x | 10.0 | √ | x |
\n
| subNVues | 5.0 | >=1.9.10 | x | 10.0 | >=1.9.10 | x |
\n
| bounce | 5.0 | √ | x | 10.0 | √ | x |
\n
| popGesture | x | x | x | 10.0 | √ | x |
\n
| softinputNavBar | x | x | x | 10.0 | √ | x |
\n
| softinputmode | 5.0 | √ | x | 10.0 | √ | x |
\n
| scrollIndicator | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationType | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationDuration | 5.0 | √ | x | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| background | HexColor | #ffffff | 否 | 窗体背景色。无论vue页面还是nvue页面,在App上都有一个父级原生窗体,该窗体的背景色生效时间快于页面里的css生效时间,vue 页面需要将 body 背景色设为透明 | - |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | - | - |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | 原生子窗体,详见:[原生子窗体](/collocation/page.md?id=app-subNVues)。 | - |
\n
| bounce | string | - | 否 | 页面回弹效果,设置为
\"
none
\"
时关闭效果。仅支持 app-vue(nvue Android无页面级bounce效果,仅list、recycle-list、waterfall等滚动组件有bounce效果)<br/>`none` <br/>`vertical` <br/>`horizontal` <br/>`all` | - |
\n
| popGesture | string | close | 否 | 侧滑返回功能,可选值:
\"
close
\"
(启用侧滑返回)、
\"
none
\"
(禁用侧滑返回)。<br/>`close` <br/>`none` | - |
\n
| softinputNavBar | string | auto | 否 | iOS软键盘上完成工具栏的显示模式,设置为
\"
none
\"
时关闭工具栏。<br/>`auto` <br/>`none` | - |
\n
| softinputmode | string | adjustPan | 否 | 软键盘弹出模式,支持 adjustResize、adjustPan 两种模式<br/>`nothing` <br/>`adjustPan` <br/>`adjustResize` | - |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | - | - |
\n
| scrollIndicator | string | - | 否 | 是否显示滚动条,设置为
\"
none
\"
时不显示滚动条。 | - |
\n
| animationType | string | pop-in | 否 | 窗口显示的动画效果,详见:[窗口动画](/api/router?id=animation)。<br/>`slide-in-right` <br/>`slide-in-left` <br/>`slide-in-top` <br/>`slide-in-bottom` <br/>`fade-in` <br/>`zoom-out` <br/>`zoom-fade-out` <br/>`pop-in` | - |
\n
| animationDuration | number | 300 | 否 | 窗口显示动画的持续时间,单位为 ms | - |"
},
"style_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | - | - |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | - | - |"
},
"style_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | string | YES | 否 | 是否允许向下拉拽。支持 YES / NO<br/>`YES` <br/>`NO` | - |
\n
| transparentTitle | string | none | 否 | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` | - |
\n
| titlePenetrate | string | No | 否 | 导航栏点击穿透 | - |
\n
| showTitleLoading | string | No | 否 | 是否进入时显示导航栏的 loading。支持 YES / NO<br/>`YES` <br/>`NO` | - |
\n
| titleImage | string | - | 否 | 导航栏图片地址,替换导航栏标题,必须为https的图片链接地址 | - |
\n
| backgroundImageUrl | string | - | 否 | 下拉露出显示的背景图链接<br/>`HBuilderX.ImageURIString` | - |
\n
| backgroundImageColor | string | - | 否 | 下拉露出显示的背景图底色<br/>`HBuilderX.ColorString` | - |
\n
| gestureBack | string | No | 否 | 支付宝小程序 iOS 用,是否支持手势返回。支持 YES / NO<br/>`YES` <br/>`NO` | - |
\n
| enableScrollBar | string | YES | 否 | 支付宝小程序 Android 用,是否显示 WebView 滚动条。支持 YES / NO。<br/>`YES` <br/>`NO` | - |"
},
"style_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 | - |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 | - |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 | - |
\n
| restartStrategy | string | homePage | 否 | 重新启动策略配置。支持 homePage / homePageAndLatestPage<br/>`homePage` <br/>`homePageAndLatestPage` | - |
\n
| initialRenderingCache | string | - | 否 | 页面初始渲染缓存配置。支持 static / dynamic<br/>`static` <br/>`dynamic` | - |
\n
| visualEffectInBackground | string | none | 否 | 切入系统后台时,隐藏页面内容,保护用户隐私。支持 hidden / none<br/>`none` <br/>`hidden` | - |
\n
| handleWebviewPreload | string | static | 否 | 控制预加载下个页面的时机。支持 static / manual / auto<br/>`static` <br/>`manual` <br/>`none` | - |"
},
"style_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| textSizeAdjust | string | auto | 否 | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应<br/>`auto` <br/>`none` | - |"
},
"pages_tabBar"
:{
"compatibility"
:
"**tabBar 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| color | 5.0 | √ | √ | 10.0 | √ | x |
\n
| selectedColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| backgroundColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| borderStyle | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| blurEffect | 5.0 | >=2.4.0 | x | 10.0 | >=2.4.0 | x |
\n
| list | 5.0 | √ | √ | 10.0 | √ | x |
\n
| position | x | x | x | x | x | x |
\n
| fontSize | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| iconWidth | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| spacing | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| height | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| iconfontSrc | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| backgroundImage | 5.0 | √ | √ | 10.0 | √ | x |
\n
| backgroundRepeat | 5.0 | √ | √ | 10.0 | √ | x |
\n
| redDotColor | 5.0 | √ | √ | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| color | string | - | 是 | tab 上的文字默认颜色<br/>`HBuilderX.ColorString` | - |
\n
| selectedColor | string | - | 是 | tab 上的文字选中时的颜色<br/>`HBuilderX.ColorString` | - |
\n
| backgroundColor | string | - | 是 | tab 的背景色<br/>`HBuilderX.ColorString` | - |
\n
| borderStyle | string | - | 否 | tabbar 上边框的颜色,可选值 black/white(App、H5 也支持其他颜色值)。 | - |
\n
| blurEffect | string | none | 否 | IOS 高斯模糊效果,可选值 dark/extralight/light/none(参考:[使用说明](/tutorial/app-blureffect.md))<br/>`dark` <br/>`extralight` <br/>`light` <br/>`none` | - |
\n
| list | Array
\\
<[PagesOptionsTabbarList](#pagesoptionstabbarlist)> | - | 是 | tab 的列表,详见 list 属性说明,最少2个、最多5个 tab | - |
\n
| position | string | bottom | 否 | tabbar 的位置,可选值 bottom、top。<br/>`top` <br/>`bottom` | - |
\n
| fontSize | string | 10px | 否 | 文字默认大小 | - |
\n
| iconWidth | string | 24px | 否 | 图标默认宽度(高度等比例缩放) | - |
\n
| spacing | string | 3px | 否 | 图标和文字的间距 | - |
\n
| height | string | 50px | 否 | tabBar 默认高度 | - |
\n
| midButton | [midButton 配置项列表](#tabbar-midbutton) | - | 否 | tabBar 默认高度 | - |
\n
| iconfontSrc | string | - | 否 | list设置 iconfont 属性时,需要指定字体文件路径 | - |
\n
| backgroundImage | string | - | 否 | 设置背景图片,优先级高于 backgroundColor | - |
\n
| backgroundRepeat | string | - | 否 | 设置标题栏的背景图平铺方式<br/>`repeat` <br/>`repeat-x` <br/>`repeat-y` <br/>`no-repeat` | - |
\n
| redDotColor | string | - | 否 | tabbar上红点颜色<br/>`HBuilderX.ColorString` | - |"
},
"PagesOptionsTabbarList"
:{
"compatibility"
:
"**PagesOptionsTabbarList 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| iconfont | 5.0 | >=3.4.4 | √ | 10.0 | >=3.4.4 | x |
\n
| pagePath | 5.0 | √ | √ | 10.0 | √ | x |
\n
| text | 5.0 | √ | √ | 10.0 | √ | x |
\n
| iconPath | 5.0 | √ | √ | 10.0 | √ | x |
\n
| selectedIconPath | 5.0 | √ | √ | 10.0 | √ | x |
\n
| visible | 5.0 | >=3.2.10 | √ | 10.0 | >=3.2.10 | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| iconfont | [iconfont 配置项列表](#pagesoptionstabbarlist-iconfont) | - | 否 | 字体图标,优先级高于 iconPath | - |
\n
| pagePath | string | - | 是 | 页面路径,必须在 pages 中先定义<br/>`HBuilderX.PageURIString` | - |
\n
| text | string | - | 是 | tab 上按钮文字,在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标<br/>`HBuilderX.VueI18NKeyString` | - |
\n
| iconPath | string | - | 否 | 图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,当 position 为 top 时,此参数无效,不支持网络图片,不支持字体图标<br/>`HBuilderX.ImageURIString` | - |
\n
| selectedIconPath | string | - | 否 | 选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 position 为 top 时,此参数无效<br/>`HBuilderX.ImageURIString` | - |
\n
| visible | string | - | 否 | 该项是否显示,默认显示 | - |"
},
"PagesOptionsTabbarList_iconfont"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| text | string | - | 否 | 字库 Unicode 码 | - |
\n
| selectedText | string | - | 否 | 选中后字库 Unicode 码 | - |
\n
| fontSize | string | - | 否 | 字体图标字号(px) | - |
\n
| color | string | - | 否 | 字体图标颜色<br/>`HBuilderX.ColorString` | - |
\n
| selectedColor | string | - | 否 | 字体图标选中颜色<br/>`HBuilderX.ColorString` | - |"
,
"description"
:
"字体图标,优先级高于 iconPath"
},
"tabBar_midButton"
:{
"compatibility"
:
"**midButton 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| width | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| height | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| text | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| iconPath | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| iconWidth | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| backgroundImage | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |
\n
| iconfont | 5.0 | >=2.3.4 | x | 10.0 | >=2.3.4 | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| width | string | 80px | 否 | 中间按钮的宽度,tabBar 其它项为减去此宽度后平分,默认值为与其它项平分宽度 | - |
\n
| height | string | 80px | 否 | 中间按钮的高度,可以大于 tabBar 高度,达到中间凸起的效果 | - |
\n
| text | string | - | 否 | 中间按钮的文字 | - |
\n
| iconPath | string | - | 否 | 中间按钮的图片路径<br/>`HBuilderX.ImageURIString` | - |
\n
| iconWidth | string | 24px | 否 | 图标默认宽度(高度等比例缩放) | - |
\n
| backgroundImage | string | - | 否 | 中间按钮的背景图片路径<br/>`HBuilderX.ImageURIString` | - |
\n
| iconfont | object | - | 否 | 字体图标,优先级高于 iconPath | - |"
,
"description"
:
"tabBar 默认高度"
},
"pages_condition"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| current | number | - | 是 | 当前激活的模式,list节点的索引值。 | - |
\n
| list | Array
\\
<[PagesConditionItem](#pagesconditionitem)> | - | 是 | 启动模式列表 | - |"
},
"PagesConditionItem"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| name | string | - | 是 | 启动模式名称 | - |
\n
| path | string | - | 是 | 启动页面路径<br/>`HBuilderX.PageURIString` | - |
\n
| query | string | - | 否 | 启动参数,可在页面的 onLoad 函数里获得 | - |"
},
"PagesSubPackages"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| root | string | - | 是 | 子包的根目录 | - |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | 子包由哪些页面组成 | - |"
},
"pages_easycom"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| autoscan | boolean | true | 否 | 是否开启自动扫描,开启后将会自动扫描符合components/组件名称/组件名称.vue/uvue目录结构的组件 | - |
\n
| custom | object | - | 否 | 以正则方式自定义组件匹配规则。如果autoscan不能满足需求,可以使用custom自定义匹配规则 | - |"
,
"description"
:
"组件自动引入规则"
},
"pages_uniIdRouter"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 | 最低版本 |
\n
| :- | :- | :- | :- | :- | :- |
\n
| loginPage | string | - | 否 | 登录页面路径<br/>`HBuilderX.PageURIString` | - |
\n
| resToLogin | boolean | - | 否 | 是否开启自动根据响应体判断跳转登录页面,默认true(开启) | - |
\n
| needLogin | Array
\\
<'HBuilderX.PageURIString'> | - | 否 | - | - |"
,
"description"
:
"根据用户登录状态、页面是否要求登录自动跳转登录页面"
}}
\ No newline at end of file
{
"pages"
:{
"compatibility"
:
"**pages.json 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| pages | 5.0 | √ | √ | 10.0 | √ | x |
\n
| subPackages | 5.0 | √ | x | 10.0 | √ | x |
\n
| workers | x | x | x | x | x | x |
\n
| preloadRule | x | x | x | x | x | x |
\n
| easycom | 5.0 | 2.5.5+ | √ | 10.0 | 2.5.5+ | x |
\n
| uniIdRouter | 5.0 | 3.5.0+ | x | 10.0 | 3.5.0+ | x |
\n
| entryPagePath | x | x | x | x | x | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| globalStyle | [globalStyle 配置项列表](#pages-globalstyle) | - | 否 | - |
\n
| topWindow | [topWindow 配置项列表](#pages-topwindow) | - | 否 | - |
\n
| leftWindow | [leftWindow 配置项列表](#pages-leftwindow) | - | 否 | - |
\n
| rightWindow | [rightWindow 配置项列表](#pages-rightwindow) | - | 否 | - |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | 页面路径及窗口表现 |
\n
| tabBar | [tabBar 配置项列表](#pages-tabbar) | - | 否 | - |
\n
| condition | [condition 配置项列表](#pages-condition) | - | 否 | - |
\n
| subPackages | Array
\\
<[PagesSubPackages](#pagessubpackages)> | - | 否 | 分包加载配置 |
\n
| workers | string | - | 否 | 使用 Worker 处理多线程任务时,设置 Worker 代码放置的目录 |
\n
| preloadRule | object | - | 否 | 声明分包预下载的规则 |
\n
| easycom | [easycom 配置项列表](#pages-easycom) | - | 否 | 组件自动引入规则 |
\n
| uniIdRouter | [uniIdRouter 配置项列表](#pages-uniidrouter) | - | 否 | 根据用户登录状态、页面是否要求登录自动跳转登录页面 |
\n
| entryPagePath | string | - | 否 | 默认启动首页,新增于HBuilderX 3.7.0 |"
},
"pages_globalStyle"
:{
"compatibility"
:
"**globalStyle 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTextStyle | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTitleText | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationStyle | 5.0 | 2.0.3+ | √ | 10.0 | 2.0.3+ | x |
\n
| backgroundColor | x | x | x | x | x | x |
\n
| backgroundTextStyle | x | x | x | x | x | x |
\n
| enablePullDownRefresh | 5.0 | √ | √ | 10.0 | √ | x |
\n
| onReachBottomDistance | 5.0 | √ | x | 10.0 | √ | x |
\n
| backgroundColorTop | x | x | x | 10.0 | √ | x |
\n
| backgroundColorBottom | x | x | x | 10.0 | √ | x |
\n
| titleImage | 5.0 | √ | x | 10.0 | √ | x |
\n
| transparentTitle | 5.0 | √ | x | 10.0 | √ | x |
\n
| titlePenetrate | x | x | x | x | x | x |
\n
| pageOrientation | 5.0 | 2.4.7+ | x | 10.0 | 2.4.7+ | x |
\n
| animationType | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationDuration | 5.0 | √ | x | 10.0 | √ | x |
\n
| allowsBounceVertical | x | x | x | x | x | x |
\n
| usingComponents | 5.0 | √ | x | 10.0 | √ | x |
\n
| renderingMode | x | x | x | x | x | x |
\n
| leftWindow | x | x | x | x | x | x |
\n
| topWindow | x | x | x | x | x | x |
\n
| rightWindow | x | x | x | x | x | x |
\n
| rpxCalcMaxDeviceWidth | 5.0 | √ | x | 10.0 | √ | x |
\n
| rpxCalcBaseDeviceWidth | 5.0 | √ | x | 10.0 | √ | x |
\n
| rpxCalcIncludeWidth | 5.0 | √ | x | 10.0 | √ | x |
\n
| dynamicRpx | 5.0 | 3.2.13+ | x | 10.0 | 3.2.13+ | x |
\n
| maxWidth | x | x | x | x | x | x |
\n
| mp-tuotiao | x | x | x | x | x | x |
\n
| mp-qq | x | x | x | x | x | x |
\n
| mp-kuaishou | x | x | x | x | x | x |
\n
| mp-jd | x | x | x | x | x | x |
\n
| mp-lark | x | x | x | x | x | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | HexColor | APP与H5为#F8F8F8,小程序平台请参考相应小程序文档 | 否 | 导航栏背景颜色(同状态栏背景色) |
\n
| navigationBarTextStyle | string | black | 否 | 导航栏标题颜色,仅支持 black/white(支付宝小程序不支持,请使用 [my.setNavigationBar](https://opendocs.alipay.com/mini/api/xwq8e6))。<br/>`white` <br/>`black` |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容 |
\n
| navigationStyle | string | default | 否 | 导航栏样式,仅支持 default/custom。custom即取消默认的原生导航栏,需看[使用注意](/collocation/page.md?id=customnav)。<br/>`default` <br/>`custom` |
\n
| backgroundColor | string | #ffffff | 否 | 下拉显示出来的窗口的背景色<br/>`HBuilderX.ColorString` |
\n
| backgroundTextStyle | string | dark | 否 | 下拉 loading 的样式,仅支持 dark / light<br/>`dark` <br/>`light` |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新,详见[页面生命周期](/tutorial/page.md?id=lifecycle)。 |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离,单位只支持px,详见[页面生命周期](/tutorial/page.md?id=lifecycle)。 |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| titleImage | string | - | 否 | 导航栏图片地址(替换当前文字标题),支付宝小程序内必须使用https的图片链接地址<br/>`HBuilderX.ImageURIString` |
\n
| transparentTitle | string | none | 否 | 导航栏整体(前景、背景)透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` |
\n
| titlePenetrate | string | NO | 否 | 导航栏点击穿透<br/>`YES` <br/>`NO` |
\n
| pageOrientation | string | portrait | 否 | 横屏配置,屏幕旋转设置,仅支持 auto / portrait / landscape 详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)。<br/>`auto` <br/>`portrait` <br/>`landscape` |
\n
| animationType | string | pop-in | 否 | 窗口显示的动画效果,详见:[窗口动画](/api/router.md?id=animation)。<br/>`slide-in-right` <br/>`slide-in-left` <br/>`slide-in-top` <br/>`slide-in-bottom` <br/>`fade-in` <br/>`zoom-out` <br/>`zoom-fade-out` <br/>`pop-in` |
\n
| animationDuration | number | 300 | 否 | 窗口显示动画的持续时间,单位为 ms |
\n
| allowsBounceVertical | string | YES | 否 | 是否允许向下拉拽。默认 YES。如果需要下拉刷新,值必须为YES<br/>`YES` <br/>`NO` |
\n
| usingComponents | object | - | 否 | 引用小程序组件,参考 [小程序组件](/tutorial/miniprogram-subject.md?id=小程序自定义组件支持)。 |
\n
| renderingMode | string | - | 否 | 同层渲染,webrtc(实时音视频) 无法正常时尝试配置 seperated 强制关掉同层 |
\n
| leftWindow | boolean | true | 否 | 当存在 leftWindow时,默认是否显示 leftWindow |
\n
| topWindow | boolean | true | 否 | 当存在 topWindow时,默认是否显示 topWindow |
\n
| rightWindow | boolean | true | 否 | 当存在 rightWindow时,默认是否显示 rightWindow |
\n
| rpxCalcMaxDeviceWidth | number | 960 | 否 | rpx 计算所支持的最大设备宽度,单位 px |
\n
| rpxCalcBaseDeviceWidth | number | 375 | 否 | rpx 计算使用的基准设备宽度,设备实际宽度超出 rpx 计算所支持的最大设备宽度时将按基准宽度计算,单位 px |
\n
| rpxCalcIncludeWidth | number | 750 | 否 | rpx 计算特殊处理的值,始终按实际的设备宽度计算,单位 rpx |
\n
| dynamicRpx | boolean | false | 否 | 动态 rpx,屏幕大小变化会重新渲染 rpx |
\n
| maxWidth | number | - | 否 | 单位px,当浏览器可见区域宽度大于maxWidth时,两侧留白,当小于等于maxWidth时,页面铺满;不同页面支持配置不同的maxWidth;maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |
\n
| app-plus | [app-plus 配置项列表](#globalstyle-app-plus) | - | 否 | - |
\n
| h5 | [h5 配置项列表](#globalstyle-h5) | - | 否 | - |
\n
| mp-alipay | [mp-alipay 配置项列表](#globalstyle-mp-alipay) | - | 否 | - |
\n
| mp-weixin | [mp-weixin 配置项列表](#globalstyle-mp-weixin) | - | 否 | - |
\n
| mp-baidu | [mp-baidu 配置项列表](#globalstyle-mp-baidu) | - | 否 | - |
\n
| mp-tuotiao | object | - | 否 | 头条小程序特有配置 |
\n
| mp-qq | object | - | 否 | QQ小程序特有配置 |
\n
| mp-kuaishou | object | - | 否 | 快手小程序特有配置 |
\n
| mp-jd | object | - | 否 | 设置编译到 mp-jd 平台的特定样式 |
\n
| mp-lark | object | - | 否 | 飞书小程序特有配置 |"
},
"globalStyle_app-plus"
:{
"compatibility"
:
"**app-plus 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| background | 5.0 | √ | x | 10.0 | √ | x |
\n
| subNVues | 5.0 | 1.9.10+ | x | 10.0 | 1.9.10+ | x |
\n
| bounce | 5.0 | √ | x | 10.0 | √ | x |
\n
| popGesture | x | x | x | 10.0 | √ | x |
\n
| softinputNavBar | x | x | x | 10.0 | √ | x |
\n
| softinputmode | 5.0 | √ | x | 10.0 | √ | x |
\n
| scrollIndicator | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationType | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationDuration | 5.0 | √ | x | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| background | HexColor | #ffffff | 否 | 窗体背景色。无论vue页面还是nvue页面,在App上都有一个父级原生窗体,该窗体的背景色生效时间快于页面里的css生效时间,vue 页面需要将 body 背景色设为透明 |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | - |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | 原生子窗体,详见:[原生子窗体](/collocation/page.md?id=app-subNVues)。 |
\n
| bounce | string | - | 否 | 页面回弹效果,设置为
\"
none
\"
时关闭效果。仅支持 app-vue(nvue Android无页面级bounce效果,仅list、recycle-list、waterfall等滚动组件有bounce效果)<br/>`none` <br/>`vertical` <br/>`horizontal` <br/>`all` |
\n
| popGesture | string | close | 否 | 侧滑返回功能,可选值:
\"
close
\"
(启用侧滑返回)、
\"
none
\"
(禁用侧滑返回)。<br/>`close` <br/>`none` |
\n
| softinputNavBar | string | auto | 否 | iOS软键盘上完成工具栏的显示模式,设置为
\"
none
\"
时关闭工具栏。<br/>`auto` <br/>`none` |
\n
| softinputmode | string | adjustPan | 否 | 软键盘弹出模式,支持 adjustResize、adjustPan 两种模式<br/>`nothing` <br/>`adjustPan` <br/>`adjustResize` |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | - |
\n
| scrollIndicator | string | - | 否 | 是否显示滚动条,设置为
\"
none
\"
时不显示滚动条。 |
\n
| animationType | string | pop-in | 否 | 窗口显示的动画效果,详见:[窗口动画](/api/router?id=animation)。<br/>`slide-in-right` <br/>`slide-in-left` <br/>`slide-in-top` <br/>`slide-in-bottom` <br/>`fade-in` <br/>`zoom-out` <br/>`zoom-fade-out` <br/>`pop-in` |
\n
| animationDuration | number | 300 | 否 | 窗口显示动画的持续时间,单位为 ms |"
},
"app-plus_titleNView"
:{
"compatibility"
:
"**titleNView 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| backgroundColor | 5.0 | √ | x | 10.0 | √ | x |
\n
| buttons | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleColor | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleOverflow | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleText | 5.0 | √ | x | 10.0 | √ | x |
\n
| titleSize | 5.0 | √ | x | 10.0 | √ | x |
\n
| type | 5.0 | √ | x | 10.0 | √ | x |
\n
| tags | 5.0 | √ | x | 10.0 | √ | x |
\n
| homeButton | 5.0 | √ | x | 10.0 | √ | x |
\n
| autoBackButton | 5.0 | 2.6.3+ | x | 10.0 | 2.6.3+ | x |
\n
| backgroundImage | 5.0 | 2.6.3+ | x | 10.0 | 2.6.3+ | x |
\n
| backgroundRepeat | 5.0 | 2.6.3+ | x | 10.0 | 2.6.3+ | x |
\n
| titleAlign | 5.0 | 2.6.3+ | x | 10.0 | 2.6.3+ | x |
\n
| blurEffect | 5.0 | 2.4.3+ | x | 10.0 | 2.4.3+ | x |
\n
| coverage | 5.0 | √ | x | 10.0 | √ | x |
\n
| splitLine | 5.0 | 2.6.6+ | x | 10.0 | 2.6.6+ | x |
\n
| subtitleColor | 5.0 | 2.6.6+ | x | 10.0 | 2.6.6+ | x |
\n
| subtitleSize | 5.0 | 2.6.6+ | x | 10.0 | 2.6.6+ | x |
\n
| subtitleOverflow | 5.0 | 2.6.6+ | x | 10.0 | 2.6.6+ | x |
\n
| subtitleText | 5.0 | 2.6.6+ | x | 10.0 | 2.6.6+ | x |
\n
| titleIcon | 5.0 | 2.6.6+ | x | 10.0 | 2.6.6+ | x |
\n
| titleIconRadius | 5.0 | 2.6.6+ | x | 10.0 | 2.6.6+ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| backgroundColor | string | #f7f7f7 | 否 | 背景颜色,支持16进制颜色或RGBA颜色(仅悬浮导航栏支持RGBA颜色)。<br/>`HBuilderX.ColorString` |
\n
| buttons | Array
\\
<[PageStyleAppPlusTitleNViewButton](#pagestyleappplustitlenviewbutton)> | - | 否 | 自定义按钮(纯nvue即render:native时暂不支持),详见 [buttons](/collocation/page.md?id=app-titlenview-buttons)。 |
\n
| titleColor | string | #000000 | 否 | 标题文字颜色<br/>`HBuilderX.ColorString` |
\n
| titleOverflow | string | ellipsis | 否 | 标题文字超出显示区域时处理方式。
\"
clip
\"
-超出显示区域时内容裁剪;
\"
ellipsis
\"
-超出显示区域时尾部显示省略标记(...)。<br/>`clip` <br/>`ellipsis` |
\n
| titleText | string | - | 否 | 标题文字内容<br/>`HBuilderX.VueI18NKeyString` |
\n
| titleSize | string | - | 否 | 标题文字字体大小 |
\n
| type | string | default | 否 | 导航栏样式。
\"
default
\"
-默认样式;
\"
transparent
\"
-滚动透明渐变;
\"
float
\"
-悬浮导航栏。<br/>`default` <br/>`transparent` <br/>`float` |
\n
| tags | array | - | 否 | 原生 View 增强,详见:[5+ View 控件](http://www.html5plus.org/doc/zh_cn/nativeobj.html#plus.nativeObj.ViewDrawTagStyles)。 |
\n
| searchInput | [searchInput 配置项列表](#titlenview-searchinput) | - | 否 | - |
\n
| homeButton | boolean | false | 否 | 标题栏控件是否显示Home按钮 |
\n
| autoBackButton | boolean | true | 否 | 标题栏控件是否显示左侧返回按钮 |
\n
| backButton | [backButton 配置项列表](#titlenview-backbutton) | - | 否 | - |
\n
| backgroundImage | string | - | 否 | 支持以下类型: 背景图片路径 - 如
\"
./img/t.png
\"
,仅支持本地文件路径, 相对路径,相对于当前页面的host位置,根据实际标题栏宽高拉伸绘制; 渐变色 - 仅支持线性渐变,两种颜色的渐变,如“linear-gradient(to top, #a80077, #66ff00)”, 其中第一个参数为渐变方向,可取值:
\"
to right
\"
表示从左向右渐变,
\"
to left
\"
表示从右向左渐变,
\"
to bottom
\"
表示从上到下渐变,
\"
to top
\"
表示从下到上渐变,
\"
to bottom right
\"
表示从左上角到右下角,
\"
to top left
\"
表示从右下角到左上角。<br/>`HBuilderX.ImageURIString` |
\n
| backgroundRepeat | string | no-repeat | 否 | 仅在backgroundImage设置为图片路径时有效。 可取值:
\"
repeat
\"
- 背景图片在垂直方向和水平方向平铺;
\"
repeat-x
\"
- 背景图片在水平方向平铺,垂直方向拉伸;
\"
repeat-y
\"
- 背景图片在垂直方向平铺,水平方向拉伸;
\"
no-repeat
\"
- 背景图片在垂直方向和水平方向都拉伸。 默认使用
\"
no-repeat
\"
。<br/>`repeat` <br/>`repeat-x` <br/>`repeat-y` <br/>`no-repeat` |
\n
| titleAlign | string | auto | 否 | 可取值:
\"
center
\"
-居中对齐;
\"
left
\"
-居左对齐;
\"
auto
\"
-根据平台自动选择(Android平台居左对齐,iOS平台居中对齐)<br/>`center` <br/>`left` <br/>`auto` |
\n
| blurEffect | string | none | 否 | 此效果将会高斯模糊显示标题栏后的内容,仅在type为
\"
transparent
\"
或
\"
float
\"
时有效。 可取值:
\"
dark
\"
- 暗风格模糊,对应iOS原生UIBlurEffectStyleDark效果;
\"
extralight
\"
- 高亮风格模糊,对应iOS原生UIBlurEffectStyleExtraLight效果;
\"
light
\"
- 亮风格模糊,对应iOS原生UIBlurEffectStyleLight效果;
\"
none
\"
- 无模糊效果。 注意:使用模糊效果时应避免设置背景颜色,设置背景颜色可能覆盖模糊效果。<br/>`dark` <br/>`extralight` <br/>`light` <br/>`none` |
\n
| coverage | string | 132px | 否 | 标题栏控件变化作用范围,仅在type值为transparent时有效,页面滚动时标题栏背景透明度将发生变化。 当页面滚动到指定偏移量时标题栏背景变为完全不透明。 支持百分比、像素值 |
\n
| splitLine | boolean | false | 否 | 标题栏的底部分割线([SplitLineStyles](/collocation/page.md?id=app-titleNView-splitLineStyles))),设置此属性则在标题栏控件的底部显示分割线,可配置颜色值及高度。 设置此属性值为undefined或null则隐藏分割线。 默认不显示底部分割线 |
\n
| subtitleColor | string | - | 否 | 副标题文字颜色,颜色值格式为
\"
#RRGGBB
\"
和
\"
rgba(R,G,B,A)
\"
,如
\"
#FF0000
\"
表示标题文字颜色为红色。 默认值与主标题文字颜色一致 |
\n
| subtitleSize | string | auto | 否 | 副标题文字字体大小,字体大小单位为像素,如
\"
14px
\"
表示字体大小为14像素,auto表示自动计算,约为12像素。 |
\n
| subtitleOverflow | string | ellipsis | 否 | 标题文字超出显示区域时处理方式,可取值:
\"
clip
\"
- 超出显示区域时内容裁剪;
\"
ellipsis
\"
- 超出显示区域时尾部显示省略标记(...)。<br/>`clip` <br/>`ellipsis` |
\n
| subtitleText | string | - | 否 | 副标题文字内容,设置副标后将显示两行标题,副标显示在主标题(titleText)下方。 注意:设置副标题后将居左显示 |
\n
| titleIcon | string | - | 否 | 标题图标,图标路径如
\"
./img/t.png
\"
,仅支持本地文件路径, 相对路径,相对于当前页面的host位置,固定宽高为逻辑像素值
\"
34px
\"
。 要求图片的宽高相同。 注意:设置标题图标后标题将居左显示。 |
\n
| titleIconRadius | string | 无圆角 | 否 | 标题图标圆角,取值格式为
\"
XXpx
\"
,其中XX为像素值(逻辑像素),如
\"
10px
\"
表示10像素半径圆角。 |"
},
"PageStyleAppPlusTitleNViewButton"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| type | string | none | 否 | 按钮样式,可取值见:[buttons 样式](/collocation/page.md?id=app-titlenview-buttons-type)<br/>`forward` <br/>`back` <br/>`share` <br/>`favorite` <br/>`home` <br/>`menu` <br/>`close` <br/>`none` |
\n
| color | string | 默认与标题文字颜色一致 | 否 | 按钮上文字颜色<br/>`HBuilderX.ColorString` |
\n
| colorPressed | string | 默认值为 color 属性值自动调整透明度为 0.3 | 否 | 按下状态按钮文字颜色 |
\n
| float | string | right | 否 | 按钮在标题栏上的显示位置,可取值
\"
left
\"
、
\"
right
\"
<br/>`right` <br/>`left` |
\n
| fontWeight | string | normal | 否 | 按钮上文字的粗细。可取值
\"
normal
\"
-标准字体、
\"
bold
\"
-加粗字体。<br/>`normal` <br/>`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 | string | center | 否 | 非输入状态下文本的对齐方式。可取值:
\"
left
\"
- 居左对齐;
\"
right
\"
- 居右对齐;
\"
center
\"
- 居中对齐。<br/>`left` <br/>`right` <br/>`center` |
\n
| backgroundColor | string | rgba(255,255,255,0.5) | 否 | 背景颜色 |
\n
| borderRadius | string | 0px | 否 | 输入框的圆角半径,取值格式为
\"
XXpx
\"
,其中XX为像素值(逻辑像素),不支持rpx。 |
\n
| placeholder | string | - | 否 | 提示文本<br/>`HBuilderX.VueI18NKeyString` |
\n
| placeholderColor | string | #cccccc | 否 | 提示文本颜色 |
\n
| disabled | boolean | false | 否 | 是否可输入 |"
},
"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 | string | normal | 否 | 返回按钮上标题的粗细,可取值:
\"
normal
\"
- 标准字体;
\"
bold
\"
- 加粗字体。 |"
},
"PageStyleAppPlusSubNVues"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| id | string | - | 否 | subNVue 原生子窗体的标识 |
\n
| path | string | - | 否 | 配置 nvue 文件路径,nvue 文件需放置到使用 subNvue 的页面文件目录下<br/>`HBuilderX.NPageURIString` |
\n
| type | string | - | 否 | 内置样式<br/>`popup` <br/>`navigationBar` |
\n
| style | [style 配置项列表](#pagestyleappplussubnvues-style) | - | 否 | - |"
},
"PageStyleAppPlusSubNVues_style"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| position | string | absolute | 否 | 原生子窗体的排版位置,排版位置决定原生子窗体在父窗口中的定位方式。 可取值:
\"
static
\"
,原生子窗体在页面中正常定位,如果页面存在滚动条则随窗口内容滚动;
\"
absolute
\"
,原生子窗体在页面中绝对定位,如果页面存在滚动条不随窗口内容滚动;
\"
dock
\"
,原生子窗体在页面中停靠,停靠的位置由dock属性值决定。 默认值为
\"
absolute
\"
。<br/>`static` <br/>`absolute` <br/>`dock` |
\n
| dock | string | bottom | 否 | 原生子窗体的停靠方式,仅当原生子窗体
\"
position
\"
属性值设置为
\"
dock
\"
时才生效,可取值:
\"
top
\"
,原生子窗体停靠则页面顶部;
\"
bottom
\"
,原生子窗体停靠在页面底部;
\"
right
\"
,原生子窗体停靠在页面右侧;
\"
left
\"
,原生子窗体停靠在页面左侧。 默认值为
\"
bottom
\"
。<br/>`top` <br/>`bottom` <br/>`right` <br/>`left` |
\n
| mask | string | rgba(0,0,0,0.5) | 否 | 原生子窗体的遮罩层,仅当原生子窗体
\"
type
\"
属性值设置为
\"
popup
\"
时才生效,可取值: rgba格式字符串,定义纯色遮罩层样式,如
\"
rgba(0,0,0,0.5)
\"
,表示黑色半透明;<br/>`HBuilderX.ColorString` |
\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才能看到正确的效果 |"
},
"app-plus_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| support | boolean | false | 否 | 是否开启窗口的下拉刷新功能 |
\n
| color | string | #2BD009 | 否 | 颜色值格式为
\"
#RRGGBB
\"
,仅
\"
circle
\"
样式下拉刷新支持此属性。<br/>`HBuilderX.ColorString` |
\n
| style | string | Android 平台为 circle;iOS 平台为 default。 | 否 | 可取值:
\"
default
\"
——经典下拉刷新样式(下拉拖动时页面内容跟随);
\"
circle
\"
——圆圈样式下拉刷新控件样式(下拉拖动时仅刷新控件跟随)。<br/>`default` <br/>`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) | - | 否 | - |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | - |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | - |"
},
"pullToRefresh_contentdown"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
},
"pullToRefresh_contentover"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
},
"pullToRefresh_contentrefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
},
"globalStyle_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | - |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | - |"
},
"h5_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| backgroundColor | string | #f7f7f7 | 否 | 背景颜色,颜色值格式为
\"
#RRGGBB
\"
。<br/>`HBuilderX.ColorString` |
\n
| buttons | array | - | 否 | 自定义按钮,参考 [buttons](/collocation/pages.md?id=h5-titlenview-buttons)。 |
\n
| titleColor | string | #000000 | 否 | 标题文字颜色<br/>`HBuilderX.ColorString` |
\n
| titleText | string | - | 否 | 标题文字内容 |
\n
| titleSize | string | - | 否 | 标题文字字体大小 |
\n
| type | string | default | 否 | 导航栏样式。
\"
default
\"
-默认样式;
\"
transparent
\"
-透明渐变。<br/>`default` <br/>`transparent` |
\n
| searchInput | object | - | 否 | 导航栏上的搜索框样式,详见:[searchInput](/collocation/pages.md?id=h5-searchinput)。 |"
},
"h5_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| support | boolean | - | 否 | 是否开启窗口的下拉刷新功能 |
\n
| color | string | - | 否 | 颜色值格式为
\"
#RRGGBB
\"
,仅
\"
circle
\"
样式下拉刷新支持此属性。<br/>`HBuilderX.ColorString` |
\n
| type | string | - | 否 | 下拉刷新控件样式<br/>`default` <br/>`circle` |
\n
| height | string | - | 否 | 窗口的下拉刷新控件进入刷新状态的拉拽高度。支持百分比,如
\"
10%
\"
;像素值,如
\"
50px
\"
。 |
\n
| range | string | - | 否 | 窗口可下拉拖拽的范围。支持百分比,如
\"
10%
\"
;像素值,如
\"
50px
\"
。 |
\n
| offset | string | - | 否 | 下拉刷新控件的起始位置。仅对
\"
circle
\"
样式下拉刷新控件有效,用于定义刷新控件下拉时的起始位置。支持百分比,如
\"
10%
\"
;像素值,如
\"
50px
\"
。 |
\n
| contentdown | [contentdown 配置项列表](#pulltorefresh-contentdown) | - | 否 | - |
\n
| contentover | [contentover 配置项列表](#pulltorefresh-contentover) | - | 否 | - |
\n
| contentrefresh | [contentrefresh 配置项列表](#pulltorefresh-contentrefresh) | - | 否 | - |"
},
"globalStyle_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | string | YES | 否 | 是否允许向下拉拽。支持 YES / NO<br/>`YES` <br/>`NO` |
\n
| transparentTitle | string | none | 否 | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` |
\n
| titlePenetrate | string | No | 否 | 导航栏点击穿透 |
\n
| showTitleLoading | string | No | 否 | 是否进入时显示导航栏的 loading。支持 YES / NO<br/>`YES` <br/>`NO` |
\n
| titleImage | string | - | 否 | 导航栏图片地址,替换导航栏标题,必须为https的图片链接地址 |
\n
| backgroundImageUrl | string | - | 否 | 下拉露出显示的背景图链接<br/>`HBuilderX.ImageURIString` |
\n
| backgroundImageColor | string | - | 否 | 下拉露出显示的背景图底色<br/>`HBuilderX.ColorString` |
\n
| gestureBack | string | No | 否 | 支付宝小程序 iOS 用,是否支持手势返回。支持 YES / NO<br/>`YES` <br/>`NO` |
\n
| enableScrollBar | string | YES | 否 | 支付宝小程序 Android 用,是否显示 WebView 滚动条。支持 YES / NO。<br/>`YES` <br/>`NO` |"
},
"globalStyle_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 |
\n
| restartStrategy | string | homePage | 否 | 重新启动策略配置。支持 homePage / homePageAndLatestPage<br/>`homePage` <br/>`homePageAndLatestPage` |
\n
| initialRenderingCache | string | - | 否 | 页面初始渲染缓存配置。支持 static / dynamic<br/>`static` <br/>`dynamic` |
\n
| visualEffectInBackground | string | none | 否 | 切入系统后台时,隐藏页面内容,保护用户隐私。支持 hidden / none<br/>`none` <br/>`hidden` |
\n
| handleWebviewPreload | string | static | 否 | 控制预加载下个页面的时机。支持 static / manual / auto<br/>`static` <br/>`manual` <br/>`none` |"
},
"globalStyle_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| textSizeAdjust | string | auto | 否 | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应<br/>`auto` <br/>`none` |"
},
"pages_topWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现,配置项参考下方 [pageStyle](/collocation/pages.md?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#topwindow-matchmedia) | - | 否 | 配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia) |"
},
"topWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时,显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia)"
},
"pages_leftWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现,配置项参考下方 [pageStyle](/collocation/pages.md?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#leftwindow-matchmedia) | - | 否 | 配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia) |"
},
"leftWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时,显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia)"
},
"pages_rightWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现,配置项参考下方 [pageStyle](/collocation/pages.md?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#rightwindow-matchmedia) | - | 否 | 配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia) |"
},
"rightWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时,显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则,配置项参考下方 [matchMedia](/collocation/pages.md?id=matchmedia)"
},
"PagesOptionsPage"
:{
"compatibility"
:
"**PagesOptionsPage 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| path | 5.0 | √ | √ | 10.0 | √ | x |
\n
| needLogin | 5.0 | √ | √ | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 是 | 配置页面路径<br/>`HBuilderX.PageURIString` |
\n
| style | [style 配置项列表](#pagesoptionspage-style) | - | 否 | - |
\n
| needLogin | boolean | false | 否 | 是否需要登录才可访问 |"
},
"PagesOptionsPage_style"
:{
"compatibility"
:
"**style 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTextStyle | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarTitleText | 5.0 | √ | √ | 10.0 | √ | x |
\n
| navigationBarShadow | 5.0 | √ | x | 10.0 | √ | x |
\n
| navigationStyle | 5.0 | 2.0.3+ | √ | 10.0 | 2.0.3+ | x |
\n
| disableScroll | x | x | x | x | x | x |
\n
| backgroundColor | x | x | x | x | x | x |
\n
| backgroundTextStyle | 5.0 | √ | x | 10.0 | √ | x |
\n
| enablePullDownRefresh | 5.0 | √ | √ | 10.0 | √ | x |
\n
| onReachBottomDistance | 5.0 | √ | x | 10.0 | √ | x |
\n
| backgroundColorTop | x | x | x | 10.0 | √ | x |
\n
| backgroundColorBottom | x | x | x | 10.0 | √ | x |
\n
| disableSwipeBack | x | x | x | 10.0 | 3.4.0+ | x |
\n
| titleImage | 5.0 | √ | x | 10.0 | √ | x |
\n
| transparentTitle | 5.0 | √ | x | 10.0 | √ | x |
\n
| titlePenetrate | x | x | x | x | x | x |
\n
| mp-tuotiao | x | x | x | x | x | x |
\n
| mp-qq | x | x | x | x | x | x |
\n
| mp-kuaishou | x | x | x | x | x | x |
\n
| mp-jd | x | x | x | x | x | x |
\n
| mp-lark | x | x | x | x | x | x |
\n
| usingComponents | 5.0 | √ | x | 10.0 | √ | x |
\n
| leftWindow | x | x | x | x | x | x |
\n
| topWindow | x | x | x | x | x | x |
\n
| rightWindow | x | x | x | x | x | x |
\n
| maxWidth | x | x | x | x | x | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | HexColor | APP与H5为#F8F8F8,小程序平台请参考相应小程序文档 | 否 | 导航栏背景颜色(同状态栏背景色) |
\n
| navigationBarTextStyle | string | black | 否 | 导航栏标题颜色,仅支持 black/white<br/>`white` <br/>`black` |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容<br/>`HBuilderX.VueI18NKeyString` |
\n
| navigationBarShadow | [navigationBarShadow 配置项列表](#style-navigationbarshadow) | - | 否 | 导航栏阴影,配置参考下方 [导航栏阴影](/collocation/page.md?id=navigationBarShadow) |
\n
| navigationStyle | string | default | 否 | 导航栏样式,仅支持 default/custom。custom即取消默认的原生导航栏,需看[使用注意](/collocation/page.md?id=customnav)。<br/>`default` <br/>`custom` |
\n
| disableScroll | boolean | false | 否 | 设置为 true 则页面整体不能上下滚动(bounce效果),只在页面配置中有效,在globalStyle中设置无效(仅 IOS 支持)。 |
\n
| backgroundColor | HexColor | #ffffff | 否 | 窗口的背景色 |
\n
| backgroundTextStyle | string | dark | 否 | 下拉 loading 的样式,仅支持 dark/light<br/>`dark` <br/>`light` |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新,详见[页面生命周期](/tutorial/page.md#lifecycle)。 |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离,单位只支持px,详见[页面生命周期](/tutorial/page.md?id=lifecycle)。 |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| disableSwipeBack | boolean | false | 否 | 是否禁用滑动返回 |
\n
| titleImage | string | - | 否 | 导航栏图片地址(替换当前文字标题),支付宝小程序内必须使用https的图片链接地址<br/>`HBuilderX.ImageURIString` |
\n
| transparentTitle | string | none | 否 | 导航栏整体(前景、背景)透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` |
\n
| titlePenetrate | string | NO | 否 | 导航栏点击穿透<br/>`YES` <br/>`NO` |
\n
| app-plus | [app-plus 配置项列表](#style-app-plus) | - | 否 | - |
\n
| h5 | [h5 配置项列表](#style-h5) | - | 否 | - |
\n
| mp-alipay | [mp-alipay 配置项列表](#style-mp-alipay) | - | 否 | - |
\n
| mp-weixin | [mp-weixin 配置项列表](#style-mp-weixin) | - | 否 | - |
\n
| mp-baidu | [mp-baidu 配置项列表](#style-mp-baidu) | - | 否 | - |
\n
| mp-tuotiao | object | - | 否 | 头条小程序特有配置 |
\n
| mp-qq | object | - | 否 | QQ小程序特有配置 |
\n
| mp-kuaishou | object | - | 否 | 快手小程序特有配置 |
\n
| mp-jd | object | - | 否 | 设置编译到 mp-jd 平台的特定样式 |
\n
| mp-lark | object | - | 否 | 飞书小程序特有配置 |
\n
| usingComponents | object | - | 否 | 引用小程序组件,参考 [小程序组件](/tutorial/miniprogram-subject.md?id=小程序自定义组件支持)。 |
\n
| leftWindow | boolean | true | 否 | 当存在 leftWindow时,当前页面是否显示 leftWindow |
\n
| topWindow | boolean | true | 否 | 当存在 topWindow时,当前页面是否显示 topWindow |
\n
| rightWindow | boolean | true | 否 | 当存在 rightWindow时,当前页面是否显示 rightWindow |
\n
| maxWidth | number | - | 否 | 单位px,当浏览器可见区域宽度大于maxWidth时,两侧留白,当小于等于maxWidth时,页面铺满;不同页面支持配置不同的maxWidth;maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |"
},
"style_navigationBarShadow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| colorType | string | - | 否 | 阴影的颜色,支持:grey、blue、green、orange、red、yellow |"
,
"description"
:
"导航栏阴影,配置参考下方 [导航栏阴影](/collocation/page.md?id=navigationBarShadow)"
},
"style_app-plus"
:{
"compatibility"
:
"**app-plus 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| background | 5.0 | √ | x | 10.0 | √ | x |
\n
| subNVues | 5.0 | 1.9.10+ | x | 10.0 | 1.9.10+ | x |
\n
| bounce | 5.0 | √ | x | 10.0 | √ | x |
\n
| popGesture | x | x | x | 10.0 | √ | x |
\n
| softinputNavBar | x | x | x | 10.0 | √ | x |
\n
| softinputmode | 5.0 | √ | x | 10.0 | √ | x |
\n
| scrollIndicator | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationType | 5.0 | √ | x | 10.0 | √ | x |
\n
| animationDuration | 5.0 | √ | x | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| background | HexColor | #ffffff | 否 | 窗体背景色。无论vue页面还是nvue页面,在App上都有一个父级原生窗体,该窗体的背景色生效时间快于页面里的css生效时间,vue 页面需要将 body 背景色设为透明 |
\n
| titleNView | [titleNView 配置项列表](#app-plus-titlenview) | - | 否 | - |
\n
| subNVues | Array
\\
<[PageStyleAppPlusSubNVues](#pagestyleappplussubnvues)> | - | 否 | 原生子窗体,详见:[原生子窗体](/collocation/page.md?id=app-subNVues)。 |
\n
| bounce | string | - | 否 | 页面回弹效果,设置为
\"
none
\"
时关闭效果。仅支持 app-vue(nvue Android无页面级bounce效果,仅list、recycle-list、waterfall等滚动组件有bounce效果)<br/>`none` <br/>`vertical` <br/>`horizontal` <br/>`all` |
\n
| popGesture | string | close | 否 | 侧滑返回功能,可选值:
\"
close
\"
(启用侧滑返回)、
\"
none
\"
(禁用侧滑返回)。<br/>`close` <br/>`none` |
\n
| softinputNavBar | string | auto | 否 | iOS软键盘上完成工具栏的显示模式,设置为
\"
none
\"
时关闭工具栏。<br/>`auto` <br/>`none` |
\n
| softinputmode | string | adjustPan | 否 | 软键盘弹出模式,支持 adjustResize、adjustPan 两种模式<br/>`nothing` <br/>`adjustPan` <br/>`adjustResize` |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#app-plus-pulltorefresh) | - | 否 | - |
\n
| scrollIndicator | string | - | 否 | 是否显示滚动条,设置为
\"
none
\"
时不显示滚动条。 |
\n
| animationType | string | pop-in | 否 | 窗口显示的动画效果,详见:[窗口动画](/api/router?id=animation)。<br/>`slide-in-right` <br/>`slide-in-left` <br/>`slide-in-top` <br/>`slide-in-bottom` <br/>`fade-in` <br/>`zoom-out` <br/>`zoom-fade-out` <br/>`pop-in` |
\n
| animationDuration | number | 300 | 否 | 窗口显示动画的持续时间,单位为 ms |"
},
"style_h5"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | - |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | - |"
},
"style_mp-alipay"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| allowsBounceVertical | string | YES | 否 | 是否允许向下拉拽。支持 YES / NO<br/>`YES` <br/>`NO` |
\n
| transparentTitle | string | none | 否 | 导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明<br/>`always` <br/>`auto` <br/>`none` |
\n
| titlePenetrate | string | No | 否 | 导航栏点击穿透 |
\n
| showTitleLoading | string | No | 否 | 是否进入时显示导航栏的 loading。支持 YES / NO<br/>`YES` <br/>`NO` |
\n
| titleImage | string | - | 否 | 导航栏图片地址,替换导航栏标题,必须为https的图片链接地址 |
\n
| backgroundImageUrl | string | - | 否 | 下拉露出显示的背景图链接<br/>`HBuilderX.ImageURIString` |
\n
| backgroundImageColor | string | - | 否 | 下拉露出显示的背景图底色<br/>`HBuilderX.ColorString` |
\n
| gestureBack | string | No | 否 | 支付宝小程序 iOS 用,是否支持手势返回。支持 YES / NO<br/>`YES` <br/>`NO` |
\n
| enableScrollBar | string | YES | 否 | 支付宝小程序 Android 用,是否显示 WebView 滚动条。支持 YES / NO。<br/>`YES` <br/>`NO` |"
},
"style_mp-weixin"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| homeButton | boolean | false | 否 | 在非首页、非页面栈最底层页面或非tabbar内页面中的导航栏展示home键 |
\n
| backgroundColorTop | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 |
\n
| backgroundColorBottom | HexColor | #ffffff | 否 | 顶部窗口的背景色,仅 iOS 支持 |
\n
| restartStrategy | string | homePage | 否 | 重新启动策略配置。支持 homePage / homePageAndLatestPage<br/>`homePage` <br/>`homePageAndLatestPage` |
\n
| initialRenderingCache | string | - | 否 | 页面初始渲染缓存配置。支持 static / dynamic<br/>`static` <br/>`dynamic` |
\n
| visualEffectInBackground | string | none | 否 | 切入系统后台时,隐藏页面内容,保护用户隐私。支持 hidden / none<br/>`none` <br/>`hidden` |
\n
| handleWebviewPreload | string | static | 否 | 控制预加载下个页面的时机。支持 static / manual / auto<br/>`static` <br/>`manual` <br/>`none` |"
},
"style_mp-baidu"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| textSizeAdjust | string | auto | 否 | 小程序页面是否禁止响应字体大小的设。支持 auto 默认响应 / none 不响应<br/>`auto` <br/>`none` |"
},
"pages_tabBar"
:{
"compatibility"
:
"**tabBar 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| color | 5.0 | √ | √ | 10.0 | √ | x |
\n
| selectedColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| backgroundColor | 5.0 | √ | √ | 10.0 | √ | x |
\n
| borderStyle | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| blurEffect | 5.0 | 2.4.0+ | x | 10.0 | 2.4.0+ | x |
\n
| list | 5.0 | √ | √ | 10.0 | √ | x |
\n
| position | x | x | x | x | x | x |
\n
| fontSize | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| iconWidth | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| spacing | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| height | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| iconfontSrc | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| backgroundImage | 5.0 | √ | √ | 10.0 | √ | x |
\n
| backgroundRepeat | 5.0 | √ | √ | 10.0 | √ | x |
\n
| redDotColor | 5.0 | √ | √ | 10.0 | √ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| color | string | - | 是 | tab 上的文字默认颜色<br/>`HBuilderX.ColorString` |
\n
| selectedColor | string | - | 是 | tab 上的文字选中时的颜色<br/>`HBuilderX.ColorString` |
\n
| backgroundColor | string | - | 是 | tab 的背景色<br/>`HBuilderX.ColorString` |
\n
| borderStyle | string | - | 否 | tabbar 上边框的颜色,可选值 black/white(App、H5 也支持其他颜色值)。 |
\n
| blurEffect | string | none | 否 | IOS 高斯模糊效果,可选值 dark/extralight/light/none(参考:[使用说明](/tutorial/app-blureffect.md))<br/>`dark` <br/>`extralight` <br/>`light` <br/>`none` |
\n
| list | Array
\\
<[PagesOptionsTabbarList](#pagesoptionstabbarlist)> | - | 是 | tab 的列表,详见 list 属性说明,最少2个、最多5个 tab |
\n
| position | string | bottom | 否 | tabbar 的位置,可选值 bottom、top。<br/>`top` <br/>`bottom` |
\n
| fontSize | string | 10px | 否 | 文字默认大小 |
\n
| iconWidth | string | 24px | 否 | 图标默认宽度(高度等比例缩放) |
\n
| spacing | string | 3px | 否 | 图标和文字的间距 |
\n
| height | string | 50px | 否 | tabBar 默认高度 |
\n
| midButton | [midButton 配置项列表](#tabbar-midbutton) | - | 否 | tabBar 默认高度 |
\n
| iconfontSrc | string | - | 否 | list设置 iconfont 属性时,需要指定字体文件路径 |
\n
| backgroundImage | string | - | 否 | 设置背景图片,优先级高于 backgroundColor |
\n
| backgroundRepeat | string | - | 否 | 设置标题栏的背景图平铺方式<br/>`repeat` <br/>`repeat-x` <br/>`repeat-y` <br/>`no-repeat` |
\n
| redDotColor | string | - | 否 | tabbar上红点颜色<br/>`HBuilderX.ColorString` |"
},
"PagesOptionsTabbarList"
:{
"compatibility"
:
"**PagesOptionsTabbarList 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| iconfont | 5.0 | 3.4.4+ | √ | 10.0 | 3.4.4+ | x |
\n
| pagePath | 5.0 | √ | √ | 10.0 | √ | x |
\n
| text | 5.0 | √ | √ | 10.0 | √ | x |
\n
| iconPath | 5.0 | √ | √ | 10.0 | √ | x |
\n
| selectedIconPath | 5.0 | √ | √ | 10.0 | √ | x |
\n
| visible | 5.0 | 3.2.10+ | √ | 10.0 | 3.2.10+ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| iconfont | [iconfont 配置项列表](#pagesoptionstabbarlist-iconfont) | - | 否 | 字体图标,优先级高于 iconPath |
\n
| pagePath | string | - | 是 | 页面路径,必须在 pages 中先定义<br/>`HBuilderX.PageURIString` |
\n
| text | string | - | 是 | tab 上按钮文字,在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标<br/>`HBuilderX.VueI18NKeyString` |
\n
| iconPath | string | - | 否 | 图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,当 position 为 top 时,此参数无效,不支持网络图片,不支持字体图标<br/>`HBuilderX.ImageURIString` |
\n
| selectedIconPath | string | - | 否 | 选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 position 为 top 时,此参数无效<br/>`HBuilderX.ImageURIString` |
\n
| visible | string | - | 否 | 该项是否显示,默认显示 |"
},
"PagesOptionsTabbarList_iconfont"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| text | string | - | 否 | 字库 Unicode 码 |
\n
| selectedText | string | - | 否 | 选中后字库 Unicode 码 |
\n
| fontSize | string | - | 否 | 字体图标字号(px) |
\n
| color | string | - | 否 | 字体图标颜色<br/>`HBuilderX.ColorString` |
\n
| selectedColor | string | - | 否 | 字体图标选中颜色<br/>`HBuilderX.ColorString` |"
,
"description"
:
"字体图标,优先级高于 iconPath"
},
"tabBar_midButton"
:{
"compatibility"
:
"**midButton 兼容性**
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| width | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| height | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| text | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| iconPath | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| iconWidth | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| backgroundImage | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |
\n
| iconfont | 5.0 | 2.3.4+ | x | 10.0 | 2.3.4+ | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| width | string | 80px | 否 | 中间按钮的宽度,tabBar 其它项为减去此宽度后平分,默认值为与其它项平分宽度 |
\n
| height | string | 80px | 否 | 中间按钮的高度,可以大于 tabBar 高度,达到中间凸起的效果 |
\n
| text | string | - | 否 | 中间按钮的文字 |
\n
| iconPath | string | - | 否 | 中间按钮的图片路径<br/>`HBuilderX.ImageURIString` |
\n
| iconWidth | string | 24px | 否 | 图标默认宽度(高度等比例缩放) |
\n
| backgroundImage | string | - | 否 | 中间按钮的背景图片路径<br/>`HBuilderX.ImageURIString` |
\n
| iconfont | object | - | 否 | 字体图标,优先级高于 iconPath |"
,
"description"
:
"tabBar 默认高度"
},
"pages_condition"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| current | number | - | 是 | 当前激活的模式,list节点的索引值。 |
\n
| list | Array
\\
<[PagesConditionItem](#pagesconditionitem)> | - | 是 | 启动模式列表 |"
},
"PagesConditionItem"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| name | string | - | 是 | 启动模式名称 |
\n
| path | string | - | 是 | 启动页面路径<br/>`HBuilderX.PageURIString` |
\n
| query | string | - | 否 | 启动参数,可在页面的 onLoad 函数里获得 |"
},
"PagesSubPackages"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| root | string | - | 是 | 子包的根目录 |
\n
| pages | Array
\\
<[PagesOptionsPage](#pagesoptionspage)> | - | 是 | 子包由哪些页面组成 |"
},
"pages_easycom"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| autoscan | boolean | true | 否 | 是否开启自动扫描,开启后将会自动扫描符合components/组件名称/组件名称.vue/uvue目录结构的组件 |
\n
| custom | object | - | 否 | 以正则方式自定义组件匹配规则。如果autoscan不能满足需求,可以使用custom自定义匹配规则 |"
,
"description"
:
"组件自动引入规则"
},
"pages_uniIdRouter"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| loginPage | string | - | 否 | 登录页面路径<br/>`HBuilderX.PageURIString` |
\n
| resToLogin | boolean | - | 否 | 是否开启自动根据响应体判断跳转登录页面,默认true(开启) |
\n
| needLogin | Array
\\
<'HBuilderX.PageURIString'> | - | 否 | - |"
,
"description"
:
"根据用户登录状态、页面是否要求登录自动跳转登录页面"
}}
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录