Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
a3b4e422
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3183
Star
105
Fork
807
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
69
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
69
合并请求
69
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
a3b4e422
编写于
10月 11, 2023
作者:
G
git_robot
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新 maniFestJson.json、pagesJson.json
上级
1d56fbce
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
1 addition
and
1 deletion
+1
-1
docs/.vuepress/utils/pagesJson.json
docs/.vuepress/utils/pagesJson.json
+1
-1
未找到文件。
docs/.vuepress/utils/pagesJson.json
浏览文件 @
a3b4e422
{
"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"
:
"根据用户登录状态、页面是否要求登录自动跳转登录页面"
}}
{
"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/pages.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/pages.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/pages.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/pages.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/pages.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/pages.md?id=navigationBarShadow) |
\n
| navigationStyle | string | default | 否 | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](/collocation/pages.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/pages.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/pages.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
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑！
取消
想要评论请
注册
或
登录
