Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-uni-app-x-zh
提交
45a486a9
U
unidocs-uni-app-x-zh
项目概览
DCloud
/
unidocs-uni-app-x-zh
通知
144
Star
2
Fork
33
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
9
列表
看板
标记
里程碑
合并请求
11
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-uni-app-x-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
9
Issue
9
列表
看板
标记
里程碑
合并请求
11
合并请求
11
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
45a486a9
编写于
5月 09, 2024
作者:
D
DCloud_LXH
浏览文件
操作
浏览文件
下载
差异文件
Merge branch 'master' into vue
上级
d95ca23a
e85161ab
变更
11
显示空白变更内容
内联
并排
Showing
11 changed file
with
60 addition
and
21 deletion
+60
-21
docs/.vuepress/utils/cssJson.json
docs/.vuepress/utils/cssJson.json
+1
-1
docs/.vuepress/utils/customTypeJson.json
docs/.vuepress/utils/customTypeJson.json
+1
-1
docs/.vuepress/utils/pagesJson.json
docs/.vuepress/utils/pagesJson.json
+1
-1
docs/.vuepress/utils/utsApiJson.json
docs/.vuepress/utils/utsApiJson.json
+1
-1
docs/.vuepress/utils/utsComJson.json
docs/.vuepress/utils/utsComJson.json
+1
-1
docs/api/get-current-pages.md
docs/api/get-current-pages.md
+5
-4
docs/api/unicloud/database.md
docs/api/unicloud/database.md
+2
-0
docs/component/input.md
docs/component/input.md
+12
-0
docs/component/textarea.md
docs/component/textarea.md
+9
-3
docs/readme.md
docs/readme.md
+1
-1
docs/select.md
docs/select.md
+26
-8
未找到文件。
docs/.vuepress/utils/cssJson.json
浏览文件 @
45a486a9
因为 它太大了无法显示 source diff 。你可以改为
查看blob
。
docs/.vuepress/utils/customTypeJson.json
浏览文件 @
45a486a9
因为 它太大了无法显示 source diff 。你可以改为
查看blob
。
docs/.vuepress/utils/pagesJson.json
浏览文件 @
45a486a9
{
"pages"
:{
"compatibility"
:
"**pages.json 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| globalStyle | 3.9 | 4.11 | 4.0 |
\n
| topWindow | x | x | 4.0 |
\n
| leftWindow | x | x | 4.0 |
\n
| rightWindow | x | x | 4.0 |
\n
| pages | 3.9 | 4.11 | 4.0 |
\n
| tabBar | 3.9 | 4.11 | 4.0 |
\n
| condition | 3.9 | 4.11 | 4.0 |
\n
| subPackages | x | x | 4.0 |
\n
| workers | x | x | 4.0 |
\n
| preloadRule | x | x | 4.0 |
\n
| easycom | 3.9 | 4.11 | 4.0 |
\n
| uniIdRouter | 3.99 | 4.11 | 4.0 |
\n
| entryPagePath | x | x | 4.0 |"
,
"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) | - | 否 | 底部 tab 的表现 |
\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) | - | 否 | 根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router) |
\n
| entryPagePath | string | - | 否 | 默认启动首页，新增于HBuilderX 3.7.0 |"
},
"pages_globalStyle"
:{
"compatibility"
:
"**globalStyle 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTextStyle | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTitleText | 3.9 | 4.11 | 4.0 |
\n
| navigationStyle | 3.9 | 4.11 | 4.0 |
\n
| backgroundColor | 3.99 | x | x |
\n
| backgroundColorContent | 4.0 | 4.11 | 4.11 |
\n
| enablePullDownRefresh | 3.9 | 4.11 | 4.0 |
\n
| onReachBottomDistance | x | x | 4.0 |
\n
| backgroundColorTop | x | x | 4.0 |
\n
| backgroundColorBottom | x | x | 4.0 |
\n
| titleImage | x | x | 4.0 |
\n
| transparentTitle | x | x | 4.0 |
\n
| titlePenetrate | x | x | 4.0 |
\n
| pageOrientation | 4.13 | x | x |
\n
| usingComponents | x | x | 4.0 |
\n
| leftWindow | x | x | 4.0 |
\n
| topWindow | x | x | 4.0 |
\n
| rightWindow | x | x | 4.0 |
\n
| rpxCalcMaxDeviceWidth | x | x | 4.0 |
\n
| rpxCalcBaseDeviceWidth | x | x | 4.0 |
\n
| rpxCalcIncludeWidth | x | x | 4.0 |
\n
| maxWidth | x | x | 4.0 |
\n
| h5 | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | 'white'
\\
| 'black' |
\"
black
\"
| 否 | 导航栏标题颜色，仅支持 black/white（支付宝小程序不支持，请使用 [my.setNavigationBar](https://opendocs.alipay.com/mini/api/xwq8e6)）。 |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容 |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 页面容器背景色 |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | 导航栏点击穿透 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | 横屏配置，屏幕旋转设置，仅支持 auto / portrait / landscape 详见 [响应显示区域变化](https://uniapp.dcloud.net.cn/collocation/pages.html#globalstyle)。 |
\n
| usingComponents | object | - | 否 | 引用小程序组件，参考 [小程序组件](https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html)。 |
\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
| maxWidth | number | - | 否 | 单位px，当浏览器可见区域宽度大于maxWidth时，两侧留白，当小于等于maxWidth时，页面铺满；不同页面支持配置不同的maxWidth；maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |
\n
| h5 | [h5 配置项列表](#globalstyle-h5) | - | 否 | H5 特有配置 |"
,
"description"
:
"默认页面的窗口表现"
},
"globalStyle_h5"
:{
"compatibility"
:
"**h5 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| titleNView | x | x | 4.0 |
\n
| pullToRefresh | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | 下拉刷新 |"
,
"description"
:
"H5 特有配置"
},
"h5_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#f7f7f7
\"
| 否 | 背景颜色，颜色值格式为
\"
#RRGGBB
\"
。 |
\n
| buttons | array | - | 否 | 自定义按钮，参考 [buttons](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-titlenview-buttons)。 |
\n
| titleColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#000000
\"
| 否 | 标题文字颜色 |
\n
| titleText | string | - | 否 | 标题文字内容 |
\n
| titleSize | string | - | 否 | 标题文字字体大小 |
\n
| type | 'defaultValue'
\\
| 'transparent' |
\"
defaultValue
\"
| 否 | 导航栏样式。
\"
default
\"
-默认样式；
\"
transparent
\"
-透明渐变。 |
\n
| searchInput | object | - | 否 | 导航栏上的搜索框样式，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-searchinput)。 |"
,
"description"
:
"导航栏设置"
},
"h5_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| support | boolean | - | 否 | 是否开启窗口的下拉刷新功能 |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | 颜色值格式为
\"
#RRGGBB
\"
，仅
\"
circle
\"
样式下拉刷新支持此属性。 |
\n
| type | 'defaultValue'
\\
| '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) | - | 否 | 在正在刷新状态时下拉刷新控件显示的内容 |"
,
"description"
:
"下拉刷新"
},
"pullToRefresh_contentdown"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在下拉可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentover"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在释放可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentrefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在正在刷新状态时下拉刷新控件显示的内容"
},
"pages_topWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#topwindow-matchmedia) | - | 否 | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"上窗体"
},
"topWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_leftWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#leftwindow-matchmedia) | - | 否 | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"左窗体"
},
"leftWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_rightWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#rightwindow-matchmedia) | - | 否 | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"右窗体"
},
"rightWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"PagesOptionsPage"
:{
"compatibility"
:
"**PagesOptionsPage 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| path | 3.9 | 4.11 | 4.0 |
\n
| style | 3.9 | 4.11 | 4.0 |
\n
| needLogin | 3.99 | 4.11 | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | 配置页面路径 |
\n
| style | [style 配置项列表](#pagesoptionspage-style) | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。 |
\n
| needLogin | boolean | false | 否 | 是否需要登录才可访问 |"
},
"PagesOptionsPage_style"
:{
"compatibility"
:
"**style 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTextStyle | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTitleText | 3.9 | 4.11 | 4.0 |
\n
| navigationBarShadow | x | x | 4.0 |
\n
| navigationStyle | 3.9 | 4.11 | 4.0 |
\n
| backgroundColor | 3.99 | 4.11 | x |
\n
| backgroundColorContent | 4.0 | 4.11 | 4.11 |
\n
| backgroundTextStyle | x | x | 4.0 |
\n
| enablePullDownRefresh | 3.9 | 4.11 | 4.0 |
\n
| onReachBottomDistance | x | x | 4.0 |
\n
| pageOrientation | 4.13 | x | x |
\n
| backgroundColorTop | x | x | 4.0 |
\n
| backgroundColorBottom | x | x | 4.0 |
\n
| titleImage | x | x | 4.0 |
\n
| transparentTitle | x | x | 4.0 |
\n
| titlePenetrate | x | x | 4.0 |
\n
| usingComponents | x | x | 4.0 |
\n
| leftWindow | x | x | 4.0 |
\n
| topWindow | x | x | 4.0 |
\n
| rightWindow | x | x | 4.0 |
\n
| maxWidth | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | 'white'
\\
| 'black' |
\"
black
\"
| 否 | 导航栏标题颜色，仅支持 black/white |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容 |
\n
| navigationBarShadow | [navigationBarShadow 配置项列表](#style-navigationbarshadow) | - | 否 | 导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style) |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 页面容器背景色 |
\n
| backgroundTextStyle | 'dark'
\\
| 'light' |
\"
dark
\"
| 否 | 下拉 loading 的样式，仅支持 dark/light |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | 页面旋转设置，支持 auto 设备自适应 / portrait 竖向 / landscape 横向 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | 导航栏点击穿透 |
\n
| h5 | [h5 配置项列表](#style-h5) | - | 否 | 编译到 H5 平台的特定样式 |
\n
| usingComponents | object | - | 否 | 引用小程序组件，参考 [小程序组件https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html#小程序自定义组件支持)。 |
\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(可选) |"
,
"description"
:
"配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。"
},
"style_navigationBarShadow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| colorType | 'grey'
\\
| 'blue'
\\
| 'green'
\\
| 'orange'
\\
| 'red'
\\
| 'yellow' | - | 否 | 阴影的颜色，支持：grey、blue、green、orange、red、yellow |"
,
"description"
:
"导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)"
},
"style_h5"
:{
"compatibility"
:
"**h5 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| titleNView | x | x | 4.0 |
\n
| pullToRefresh | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | 下拉刷新 |"
,
"description"
:
"编译到 H5 平台的特定样式"
},
"pages_tabBar"
:{
"compatibility"
:
"**tabBar 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| color | 3.9 | 4.11 | 4.0 |
\n
| selectedColor | 3.9 | 4.11 | 4.0 |
\n
| backgroundColor | 3.9 | 4.11 | 4.0 |
\n
| borderStyle | x | x | 4.0 |
\n
| blurEffect | x | x | 4.0 |
\n
| list | 3.9 | 4.11 | 4.0 |
\n
| fontSize | x | x | 4.0 |
\n
| iconWidth | x | x | 4.0 |
\n
| spacing | x | x | 4.0 |
\n
| height | x | x | 4.0 |
\n
| midButton | x | x | 4.0 |
\n
| iconfontSrc | x | x | 4.0 |
\n
| backgroundImage | 3.9 | 4.11 | x |
\n
| backgroundRepeat | 3.9 | 4.11 | x |
\n
| redDotColor | 3.9 | 4.11 | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | tab 上的文字默认颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | tab 上的文字选中时的颜色 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | tab 的背景色 |
\n
| borderStyle | string |
\"
black
\"
| 否 | tabbar 上边框的颜色，可选值 black、white（App、H5 也支持其他颜色值）。 |
\n
| blurEffect | 'dark'
\\
| 'extralight'
\\
| 'light'
\\
| 'none' |
\"
none
\"
| 否 | IOS 高斯模糊效果，可选值 dark/extralight/light/none（参考:[使用说明](https://uniapp.dcloud.net.cn//tutorial/app-blureffect.html)） |
\n
| list | Array
\\
<[PagesOptionsTabbarList](#pagesoptionstabbarlist)> | - | 是 | tab 的列表，详见 list 属性说明，最少2个、最多5个 tab |
\n
| fontSize | string |
\"
10px
\"
| 否 | 文字默认大小 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | 图标默认宽度（高度等比例缩放） |
\n
| spacing | string |
\"
3px
\"
| 否 | 图标和文字的间距 |
\n
| height | string |
\"
50px
\"
| 否 | tabBar 默认高度 |
\n
| midButton | [midButton 配置项列表](#tabbar-midbutton) | - | 否 | 中间按钮 仅在 list 项为偶数时有效 |
\n
| iconfontSrc | string | - | 否 | list设置 iconfont 属性时，需要指定字体文件路径 |
\n
| backgroundImage | string | - | 否 | 设置背景图片，优先级高于 backgroundColor |
\n
| backgroundRepeat | 'repeat'
\\
| 'repeat-x'
\\
| 'repeat-y'
\\
| 'no-repeat' |
\"
no-repeat
\"
| 否 | 设置标题栏的背景图平铺方式 |
\n
| redDotColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | tabbar上红点颜色 |"
,
"description"
:
"底部 tab 的表现"
},
"PagesOptionsTabbarList"
:{
"compatibility"
:
"**PagesOptionsTabbarList 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| iconfont | 3.9 | 4.11 | 4.0 |
\n
| pagePath | 3.9 | 4.11 | 4.0 |
\n
| text | 3.9 | 4.11 | 4.0 |
\n
| iconPath | 3.9 | 4.11 | 4.0 |
\n
| selectedIconPath | 3.9 | 4.11 | 4.0 |
\n
| visible | 3.9 | 4.11 | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| iconfont | [iconfont 配置项列表](#pagesoptionstabbarlist-iconfont) | - | 否 | 字体图标，优先级高于 iconPath |
\n
| pagePath | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | 页面路径，必须在 pages 中先定义 |
\n
| text | string | - | 是 | tab 上按钮文字，在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px，当 position 为 top 时，此参数无效，不支持网络图片，不支持字体图标 |
\n
| selectedIconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 选中时的图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px ，当 position 为 top 时，此参数无效 |
\n
| visible | boolean | - | 否 | 该项是否显示，默认显示 |"
},
"PagesOptionsTabbarList_iconfont"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| text | string | - | 否 | 字库 Unicode 码 |
\n
| selectedText | string | - | 否 | 选中后字库 Unicode 码 |
\n
| fontSize | string | - | 否 | 字体图标字号(px) |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | 字体图标颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | 字体图标选中颜色 |"
,
"description"
:
"字体图标，优先级高于 iconPath"
},
"tabBar_midButton"
:{
"compatibility"
:
"**midButton 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| width | x | x | 4.0 |
\n
| height | x | x | 4.0 |
\n
| text | x | x | 4.0 |
\n
| iconPath | x | x | 4.0 |
\n
| iconWidth | x | x | 4.0 |
\n
| backgroundImage | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| width | string |
\"
80px
\"
| 否 | 中间按钮的宽度，tabBar 其它项为减去此宽度后平分，默认值为与其它项平分宽度 |
\n
| height | string |
\"
80px
\"
| 否 | 中间按钮的高度，可以大于 tabBar 高度，达到中间凸起的效果 |
\n
| text | string | - | 否 | 中间按钮的文字 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 中间按钮的图片路径 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | 图标默认宽度（高度等比例缩放） |
\n
| backgroundImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 中间按钮的背景图片路径 |"
,
"description"
:
"中间按钮 仅在 list 项为偶数时有效"
},
"pages_condition"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| current | number | - | 是 | 当前激活的模式，list节点的索引值。 |
\n
| list | Array
\\
<[PagesConditionItem](#pagesconditionitem)> | - | 是 | 启动模式列表 |"
,
"description"
:
"启动模式"
},
"PagesConditionItem"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| name | string | - | 是 | 启动模式名称 |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | 启动页面路径 |
\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 ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 否 | 登录页面路径 |
\n
| resToLogin | boolean | - | 否 | 是否开启自动根据响应体判断跳转登录页面，默认true（开启） |
\n
| needLogin | Array
\\
<string,[string.PageURIString](/uts/data-type.md#ide-string)> | - | 否 | - |"
,
"description"
:
"根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router)"
},
"tutorial"
:
"## 参见
\n
[相关 Bug](https://issues.dcloud.net.cn/?mid=collocation.pages_json)"
}
{
"pages"
:{
"compatibility"
:
"**pages.json 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| globalStyle | 3.9 | 4.11 | 4.0 |
\n
| topWindow | x | x | 4.0 |
\n
| leftWindow | x | x | 4.0 |
\n
| rightWindow | x | x | 4.0 |
\n
| pages | 3.9 | 4.11 | 4.0 |
\n
| tabBar | 3.9 | 4.11 | 4.0 |
\n
| condition | 3.9 | 4.11 | 4.0 |
\n
| subPackages | x | x | 4.0 |
\n
| workers | x | x | 4.0 |
\n
| preloadRule | x | x | 4.0 |
\n
| easycom | 3.9 | 4.11 | 4.0 |
\n
| uniIdRouter | 3.99 | 4.11 | 4.0 |
\n
| entryPagePath | x | x | 4.0 |"
,
"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) | - | 否 | 底部 tab 的表现 |
\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) | - | 否 | 根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router) |
\n
| entryPagePath | string | - | 否 | 默认启动首页，新增于HBuilderX 3.7.0 |"
},
"pages_globalStyle"
:{
"compatibility"
:
"**globalStyle 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTextStyle | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTitleText | 3.9 | 4.11 | 4.0 |
\n
| navigationStyle | 3.9 | 4.11 | 4.0 |
\n
| backgroundColor | 3.99 | x | x |
\n
| backgroundColorContent | 4.0 | 4.11 | 4.11 |
\n
| enablePullDownRefresh | 3.9 | 4.11 | 4.0 |
\n
| onReachBottomDistance | x | x | 4.0 |
\n
| backgroundColorTop | x | x | 4.0 |
\n
| backgroundColorBottom | x | x | 4.0 |
\n
| titleImage | x | x | 4.0 |
\n
| transparentTitle | x | x | 4.0 |
\n
| titlePenetrate | x | x | 4.0 |
\n
| pageOrientation | 4.13 | x | x |
\n
| usingComponents | x | x | 4.0 |
\n
| leftWindow | x | x | 4.0 |
\n
| topWindow | x | x | 4.0 |
\n
| rightWindow | x | x | 4.0 |
\n
| rpxCalcMaxDeviceWidth | x | x | 4.0 |
\n
| rpxCalcBaseDeviceWidth | x | x | 4.0 |
\n
| rpxCalcIncludeWidth | x | x | 4.0 |
\n
| maxWidth | x | x | 4.0 |
\n
| h5 | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | 'white'
\\
| 'black' |
\"
black
\"
| 否 | 导航栏标题颜色，仅支持 black/white（支付宝小程序不支持，请使用 [my.setNavigationBar](https://opendocs.alipay.com/mini/api/xwq8e6)）。 |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容 |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 页面容器背景色 |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | 导航栏点击穿透 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | 横屏配置，屏幕旋转设置，仅支持 auto / portrait / landscape 详见 [响应显示区域变化](https://uniapp.dcloud.net.cn/collocation/pages.html#globalstyle)。 |
\n
| usingComponents | object | - | 否 | 引用小程序组件，参考 [小程序组件](https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html)。 |
\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
| maxWidth | number | - | 否 | 单位px，当浏览器可见区域宽度大于maxWidth时，两侧留白，当小于等于maxWidth时，页面铺满；不同页面支持配置不同的maxWidth；maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选) |
\n
| h5 | [h5 配置项列表](#globalstyle-h5) | - | 否 | H5 特有配置 |"
,
"description"
:
"默认页面的窗口表现"
},
"globalStyle_h5"
:{
"compatibility"
:
"**h5 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| titleNView | x | x | 4.0 |
\n
| pullToRefresh | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | 下拉刷新 |"
,
"description"
:
"H5 特有配置"
},
"h5_titleNView"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#f7f7f7
\"
| 否 | 背景颜色，颜色值格式为
\"
#RRGGBB
\"
。 |
\n
| buttons | array | - | 否 | 自定义按钮，参考 [buttons](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-titlenview-buttons)。 |
\n
| titleColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#000000
\"
| 否 | 标题文字颜色 |
\n
| titleText | string | - | 否 | 标题文字内容 |
\n
| titleSize | string | - | 否 | 标题文字字体大小 |
\n
| type | 'defaultValue'
\\
| 'transparent' |
\"
defaultValue
\"
| 否 | 导航栏样式。
\"
default
\"
-默认样式；
\"
transparent
\"
-透明渐变。 |
\n
| searchInput | object | - | 否 | 导航栏上的搜索框样式，详见：[searchInput](https://uniapp.dcloud.net.cn/collocation/pages.html?id=h5-searchinput)。 |"
,
"description"
:
"导航栏设置"
},
"h5_pullToRefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| support | boolean | - | 否 | 是否开启窗口的下拉刷新功能 |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | 颜色值格式为
\"
#RRGGBB
\"
，仅
\"
circle
\"
样式下拉刷新支持此属性。 |
\n
| type | 'defaultValue'
\\
| '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) | - | 否 | 在正在刷新状态时下拉刷新控件显示的内容 |"
,
"description"
:
"下拉刷新"
},
"pullToRefresh_contentdown"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在下拉可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentover"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在释放可刷新状态时下拉刷新控件显示的内容"
},
"pullToRefresh_contentrefresh"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| caption | string | - | 否 | 下拉刷新控件上显示的标题内容 |"
,
"description"
:
"在正在刷新状态时下拉刷新控件显示的内容"
},
"pages_topWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#topwindow-matchmedia) | - | 否 | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"上窗体"
},
"topWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_leftWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#leftwindow-matchmedia) | - | 否 | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"左窗体"
},
"leftWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"pages_rightWindow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string | - | 否 | 配置页面路径 |
\n
| style | object | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://uniapp.dcloud.net.cn/collocation/pages.html?id=style) |
\n
| matchMedia | [matchMedia 配置项列表](#rightwindow-matchmedia) | - | 否 | 配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia) |"
,
"description"
:
"右窗体"
},
"rightWindow_matchMedia"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| minWidth | number | 768 | 否 | 当设备可见区域宽度 minWidth 时，显示该 window+ |"
,
"description"
:
"配置显示该窗口的规则，配置项参考下方 [matchMedia](https://uniapp.dcloud.net.cn/collocation/pages.html?id=matchmedia)"
},
"PagesOptionsPage"
:{
"compatibility"
:
"**PagesOptionsPage 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| path | 3.9 | 4.11 | 4.0 |
\n
| style | 3.9 | 4.11 | 4.0 |
\n
| needLogin | 3.99 | 4.11 | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | 配置页面路径 |
\n
| style | [style 配置项列表](#pagesoptionspage-style) | - | 否 | 配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。 |
\n
| needLogin | boolean | false | 否 | 是否需要登录才可访问 |"
},
"PagesOptionsPage_style"
:{
"compatibility"
:
"**style 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTextStyle | 3.9 | 4.11 | 4.0 |
\n
| navigationBarTitleText | 3.9 | 4.11 | 4.0 |
\n
| navigationBarShadow | x | x | 4.0 |
\n
| navigationStyle | 3.9 | 4.11 | 4.0 |
\n
| backgroundColor | 3.99 | 4.11 | x |
\n
| backgroundColorContent | 4.0 | 4.11 | 4.11 |
\n
| backgroundTextStyle | x | x | 4.0 |
\n
| enablePullDownRefresh | 3.9 | 4.11 | 4.0 |
\n
| onReachBottomDistance | x | x | 4.0 |
\n
| pageOrientation | 4.13 | x | x |
\n
| backgroundColorTop | x | x | 4.0 |
\n
| backgroundColorBottom | x | x | 4.0 |
\n
| titleImage | x | x | 4.0 |
\n
| transparentTitle | x | x | 4.0 |
\n
| titlePenetrate | x | x | 4.0 |
\n
| usingComponents | x | x | 4.0 |
\n
| leftWindow | x | x | 4.0 |
\n
| topWindow | x | x | 4.0 |
\n
| rightWindow | x | x | 4.0 |
\n
| maxWidth | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| navigationBarBackgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | `app`: #F8F8F8<br/>`web`: #F8F8F8<br/>`mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-lark、mp-jd`: #000000<br/>`mp-alipay、mp-kuaishou`: #ffffff | 否 | 导航栏背景颜色（同状态栏背景色） |
\n
| navigationBarTextStyle | 'white'
\\
| 'black' |
\"
black
\"
| 否 | 导航栏标题颜色，仅支持 black/white |
\n
| navigationBarTitleText | string | - | 否 | 导航栏标题文字内容 |
\n
| navigationBarShadow | [navigationBarShadow 配置项列表](#style-navigationbarshadow) | - | 否 | 导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style) |
\n
| navigationStyle | 'default'
\\
| 'custom' |
\"
default
\"
| 否 | 导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看[使用注意](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 下拉刷新显示出来的窗口的背景色（无下拉刷新时，此颜色无效果） |
\n
| backgroundColorContent | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 页面容器背景色 |
\n
| backgroundTextStyle | 'dark'
\\
| 'light' |
\"
dark
\"
| 否 | 下拉 loading 的样式，仅支持 dark/light |
\n
| enablePullDownRefresh | boolean | false | 否 | 是否开启下拉刷新，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| onReachBottomDistance | number | 50 | 否 | 页面上拉触底事件触发时距页面底部距离，单位只支持px，详见[页面生命周期](https://doc.dcloud.net.cn/uni-app-x/page.html)。 |
\n
| pageOrientation | 'auto'
\\
| 'portrait'
\\
| 'landscape' |
\"
portrait
\"
| 否 | 页面旋转设置，支持 auto 设备自适应 / portrait 竖向 / landscape 横向 |
\n
| backgroundColorTop | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 顶部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| backgroundColorBottom | string ([string.ColorString](/uts/data-type.md#ide-string)) |
\"
#ffffff
\"
| 否 | 底部窗口的背景色(bounce回弹区域), 仅 iOS 平台 |
\n
| titleImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址 |
\n
| transparentTitle | 'always'
\\
| 'auto'
\\
| 'none' |
\"
none
\"
| 否 | 导航栏整体（前景、背景）透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明 |
\n
| titlePenetrate | 'YES'
\\
| 'NO' |
\"
NO
\"
| 否 | 导航栏点击穿透 |
\n
| h5 | [h5 配置项列表](#style-h5) | - | 否 | 编译到 H5 平台的特定样式 |
\n
| usingComponents | object | - | 否 | 引用小程序组件，参考 [小程序组件https://uniapp.dcloud.net.cn/tutorial/miniprogram-subject.html#小程序自定义组件支持)。 |
\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(可选) |"
,
"description"
:
"配置页面窗口表现，配置项参考下方 [pageStyle](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)。"
},
"style_navigationBarShadow"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| colorType | 'grey'
\\
| 'blue'
\\
| 'green'
\\
| 'orange'
\\
| 'red'
\\
| 'yellow' | - | 否 | 阴影的颜色，支持：grey、blue、green、orange、red、yellow |"
,
"description"
:
"导航栏阴影，配置参考下方 [导航栏阴影](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)"
},
"style_h5"
:{
"compatibility"
:
"**h5 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| titleNView | x | x | 4.0 |
\n
| pullToRefresh | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| titleNView | [titleNView 配置项列表](#h5-titlenview) | - | 否 | 导航栏设置 |
\n
| pullToRefresh | [pullToRefresh 配置项列表](#h5-pulltorefresh) | - | 否 | 下拉刷新 |"
,
"description"
:
"编译到 H5 平台的特定样式"
},
"pages_tabBar"
:{
"compatibility"
:
"**tabBar 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| color | 3.9 | 4.11 | 4.0 |
\n
| selectedColor | 3.9 | 4.11 | 4.0 |
\n
| backgroundColor | 3.9 | 4.11 | 4.0 |
\n
| borderStyle | 4.0 | x | 4.0 |
\n
| blurEffect | x | x | 4.0 |
\n
| list | 3.9 | 4.11 | 4.0 |
\n
| fontSize | x | x | 4.0 |
\n
| iconWidth | x | x | 4.0 |
\n
| spacing | x | x | 4.0 |
\n
| height | x | x | 4.0 |
\n
| midButton | x | x | 4.0 |
\n
| iconfontSrc | x | x | 4.0 |
\n
| backgroundImage | 3.9 | 4.11 | x |
\n
| backgroundRepeat | 3.9 | 4.11 | x |
\n
| redDotColor | 3.9 | 4.11 | x |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | tab 上的文字默认颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | tab 上的文字选中时的颜色 |
\n
| backgroundColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 是 | tab 的背景色 |
\n
| borderStyle | string |
\"
black
\"
| 否 | tabbar 上边框的颜色，可选值 black、white（App、H5 也支持其他颜色值）。 |
\n
| blurEffect | 'dark'
\\
| 'extralight'
\\
| 'light'
\\
| 'none' |
\"
none
\"
| 否 | IOS 高斯模糊效果，可选值 dark/extralight/light/none（参考:[使用说明](https://uniapp.dcloud.net.cn//tutorial/app-blureffect.html)） |
\n
| list | Array
\\
<[PagesOptionsTabbarList](#pagesoptionstabbarlist)> | - | 是 | tab 的列表，详见 list 属性说明，最少2个、最多5个 tab |
\n
| fontSize | string |
\"
10px
\"
| 否 | 文字默认大小 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | 图标默认宽度（高度等比例缩放） |
\n
| spacing | string |
\"
3px
\"
| 否 | 图标和文字的间距 |
\n
| height | string |
\"
50px
\"
| 否 | tabBar 默认高度 |
\n
| midButton | [midButton 配置项列表](#tabbar-midbutton) | - | 否 | 中间按钮 仅在 list 项为偶数时有效 |
\n
| iconfontSrc | string | - | 否 | list设置 iconfont 属性时，需要指定字体文件路径 |
\n
| backgroundImage | string | - | 否 | 设置背景图片，优先级高于 backgroundColor |
\n
| backgroundRepeat | 'repeat'
\\
| 'repeat-x'
\\
| 'repeat-y'
\\
| 'no-repeat' |
\"
no-repeat
\"
| 否 | 设置标题栏的背景图平铺方式 |
\n
| redDotColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | tabbar上红点颜色 |"
,
"description"
:
"底部 tab 的表现"
},
"PagesOptionsTabbarList"
:{
"compatibility"
:
"**PagesOptionsTabbarList 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| iconfont | 3.9 | 4.11 | 4.0 |
\n
| pagePath | 3.9 | 4.11 | 4.0 |
\n
| text | 3.9 | 4.11 | 4.0 |
\n
| iconPath | 3.9 | 4.11 | 4.0 |
\n
| selectedIconPath | 3.9 | 4.11 | 4.0 |
\n
| visible | 3.9 | 4.11 | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| iconfont | [iconfont 配置项列表](#pagesoptionstabbarlist-iconfont) | - | 否 | 字体图标，优先级高于 iconPath |
\n
| pagePath | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | 页面路径，必须在 pages 中先定义 |
\n
| text | string | - | 是 | tab 上按钮文字，在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px，当 position 为 top 时，此参数无效，不支持网络图片，不支持字体图标 |
\n
| selectedIconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 选中时的图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px ，当 position 为 top 时，此参数无效 |
\n
| visible | boolean | - | 否 | 该项是否显示，默认显示 |"
},
"PagesOptionsTabbarList_iconfont"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| text | string | - | 否 | 字库 Unicode 码 |
\n
| selectedText | string | - | 否 | 选中后字库 Unicode 码 |
\n
| fontSize | string | - | 否 | 字体图标字号(px) |
\n
| color | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | 字体图标颜色 |
\n
| selectedColor | string ([string.ColorString](/uts/data-type.md#ide-string)) | - | 否 | 字体图标选中颜色 |"
,
"description"
:
"字体图标，优先级高于 iconPath"
},
"tabBar_midButton"
:{
"compatibility"
:
"**midButton 兼容性**
\n
| | Android | iOS | web |
\n
| :- | :- | :- | :- |
\n
| width | x | x | 4.0 |
\n
| height | x | x | 4.0 |
\n
| text | x | x | 4.0 |
\n
| iconPath | x | x | 4.0 |
\n
| iconWidth | x | x | 4.0 |
\n
| backgroundImage | x | x | 4.0 |"
,
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| width | string |
\"
80px
\"
| 否 | 中间按钮的宽度，tabBar 其它项为减去此宽度后平分，默认值为与其它项平分宽度 |
\n
| height | string |
\"
80px
\"
| 否 | 中间按钮的高度，可以大于 tabBar 高度，达到中间凸起的效果 |
\n
| text | string | - | 否 | 中间按钮的文字 |
\n
| iconPath | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 中间按钮的图片路径 |
\n
| iconWidth | string |
\"
24px
\"
| 否 | 图标默认宽度（高度等比例缩放） |
\n
| backgroundImage | string ([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 否 | 中间按钮的背景图片路径 |"
,
"description"
:
"中间按钮 仅在 list 项为偶数时有效"
},
"pages_condition"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| current | number | - | 是 | 当前激活的模式，list节点的索引值。 |
\n
| list | Array
\\
<[PagesConditionItem](#pagesconditionitem)> | - | 是 | 启动模式列表 |"
,
"description"
:
"启动模式"
},
"PagesConditionItem"
:{
"table"
:
"| 属性 | 类型 | 默认值 | 必填 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| name | string | - | 是 | 启动模式名称 |
\n
| path | string ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 是 | 启动页面路径 |
\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 ([string.PageURIString](/uts/data-type.md#ide-string)) | - | 否 | 登录页面路径 |
\n
| resToLogin | boolean | - | 否 | 是否开启自动根据响应体判断跳转登录页面，默认true（开启） |
\n
| needLogin | Array
\\
<string,[string.PageURIString](/uts/data-type.md#ide-string)> | - | 否 | - |"
,
"description"
:
"根据用户登录状态、页面是否要求登录、以及接口返回的用户token验证状态自动跳转登录页面。详细教程：[详见](https://doc.dcloud.net.cn/uniCloud/uni-id/summary.html#uni-id-router)"
},
"tutorial"
:
"## 参见
\n
[相关 Bug](https://issues.dcloud.net.cn/?mid=collocation.pages_json)"
}
\ No newline at end of file
\ No newline at end of file
docs/.vuepress/utils/utsApiJson.json
浏览文件 @
45a486a9
因为 它太大了无法显示 source diff 。你可以改为
查看blob
。
docs/.vuepress/utils/utsComJson.json
浏览文件 @
45a486a9
因为 它太大了无法显示 source diff 。你可以改为
查看blob
。
docs/api/get-current-pages.md
浏览文件 @
45a486a9
...
@@ -12,12 +12,13 @@
...
@@ -12,12 +12,13 @@
当前版本仅支持的属性，后续实现其他属性
当前版本仅支持的属性，后续实现其他属性
|属性 |类型 |默认值 |描述 |
|属性 |类型 |Android|iOS |web |默认值 |描述 |
|:-: |:-: |:-: |:-: |
|:-: |:-: |:-: |:-: |:-: |:-: |:-: |
|enablePullDownRefresh|Boolean| |是否开启下拉刷新，详见页面
[
生命周期
](
https://uniapp.dcloud.net.cn/tutorial/page.html#lifecycle
)
。 |
|enablePullDownRefresh |Boolean|4.13 |4.13 |4.13 |false |是否开启下拉刷新，详见页面
[
生命周期
](
https://uniapp.dcloud.net.cn/tutorial/page.html#lifecycle
)
。 |
|backgroundColorContent |string |4.15 |4.15 |x |#ffffff|页面容器背景色 |
**注意事项**
**注意事项**
-
app-ios平台
需要在page.json中设置页面的
`enablePullDownRefresh`
为
`true`
才可以通过
`$setPageStyle`
动态开启或关闭页面下拉刷新
-
app-ios平台
：在page.json 中设置页面
`enablePullDownRefresh`
为
`false`
时，无法通过
`$setPageStyle`
方法动态开启页面下拉刷新 (app-ios平台在
`HBuilderX-4.15`
版本已修复该问题)
-
web端由于会自动优化未使用的特性，如果整个项目中都没有使用到
`enablePullDownRefresh`
，那么此属性也无法动态切换
-
web端由于会自动优化未使用的特性，如果整个项目中都没有使用到
`enablePullDownRefresh`
，那么此属性也无法动态切换
<!-- UTSAPIJSON.getCurrentPages.example -->
<!-- UTSAPIJSON.getCurrentPages.example -->
...
...
docs/api/unicloud/database.md
浏览文件 @
45a486a9
...
@@ -4,6 +4,8 @@ uniCloud.databaseForJQL()是客户端访问云数据库的API，即[clientDB](ht
...
@@ -4,6 +4,8 @@ uniCloud.databaseForJQL()是客户端访问云数据库的API，即[clientDB](ht
-
暂不支持泛型传递
-
暂不支持泛型传递
-
暂不支持multiSend
-
暂不支持multiSend
-
暂不支持getOne
-
暂不支持调用
`db.command.aggregate`
**和uni-app项目的差异**
**和uni-app项目的差异**
...
...
docs/component/input.md
浏览文件 @
45a486a9
...
@@ -31,6 +31,18 @@
...
@@ -31,6 +31,18 @@
在web端平台，输入框上推逻辑是由浏览器自动完成的，属性
`adjust-position`
无效。
在web端平台，输入框上推逻辑是由浏览器自动完成的，属性
`adjust-position`
无效。
但iOS safari软键盘弹出时，整个页面会上推而不是挤压，导致pages.json配置的导航栏会上移到屏幕之外。
但iOS safari软键盘弹出时，整个页面会上推而不是挤压，导致pages.json配置的导航栏会上移到屏幕之外。
## inputmode说明
inputmode 兼容性：Chrome >= 66、Edge >= 79、Firefox >= 95、Chrome Android >= 66、Firefox for Android >= 79、Safari on iOS >= 12.2、WebView Android >= 66
input组件有 inputmode 和 type、comfirm-tye 3个相似的属性，它们的区别详解如下：
-
type：在 uni-app 和小程序中仅仅是输入框，定义 input 的工作方式，此值决定可输入什么值。比如 number 只能输入数字。
-
comfirm-type：定义键盘右下角按键的文字
-
inputmode：inputmode 属性是当使用某些值时会对键盘所作出的优化。
同时使用 inputmode 和 comfirm-type 时，若设值冲突，键盘右下角按键类型由 comfirm-type 决定。type 属性和 inputmode 属性并不冲突
## Tips
## Tips
-
从uni-app x 4.0起，App-Android平台 input 点击输入框外的屏幕会自动收起软键盘。
-
从uni-app x 4.0起，App-Android平台 input 点击输入框外的屏幕会自动收起软键盘。
-
从uni-app x 4.0起，App-Android平台 input 的 font-size 默认值统一为 16px。
-
从uni-app x 4.0起，App-Android平台 input 的 font-size 默认值统一为 16px。
docs/component/textarea.md
浏览文件 @
45a486a9
...
@@ -19,9 +19,15 @@ input和textarea组件都一个属性`adjust-position`，默认为true，即软
...
@@ -19,9 +19,15 @@ input和textarea组件都一个属性`adjust-position`，默认为true，即软
因为此处内容与input重复，详见
[
input文档
](
input.md#adjust-position
)
因为此处内容与input重复，详见
[
input文档
](
input.md#adjust-position
)
## inputmode说明
inputmode 兼容性：Chrome >= 66、Edge >= 79、Firefox >= 95、Chrome Android >= 66、Firefox for Android >= 79、Safari on iOS >= 12.2、WebView Android >= 66
## Tips
## Tips
-
从
uni-app x 4.0 起，App-Android平台 textarea 点击输入框外的屏幕会自动收起软键盘。
*
uni-app x 4.0 起，App-Android平台 textarea 点击输入框外的屏幕会自动收起软键盘。
*
从
uni-app x 4.0 起，App-Android平台 textarea 的 font-size 默认值统一为 16px，line-height 默认值为 1.2em，width 默认值为300px。
*
uni-app x 4.0 起，App-Android平台 textarea 的 font-size 默认值统一为 16px，line-height 默认值为 1.2em，width 默认值为300px。
*
在Android 9以下的系统版本，样式
`line-height`
点击键盘换行时行间距设置无效，此问题是Android系统的的bug，后续解决
。
*
uni-app x 4.15 起，App-iOS平台 textarea 软键盘默认右下角改为 return(换行) ，换行时，键盘不会收起
。
*
由于Android系统限制，textarea的键盘右下角按钮只能是
`换行`
，所以暂时不提供
`confirm-type`
属性。
*
由于Android系统限制，textarea的键盘右下角按钮只能是
`换行`
，所以暂时不提供
`confirm-type`
属性。
*
当软键盘右下角为 换行 时，confirm-hold 恒为 true，设置为false也不生效，即按下 换行 时，软键盘不会消失。
*
在Android 9以下的系统版本，样式
`line-height`
点击键盘换行时行间距设置无效，此问题是Android系统的的bug，后续解决。
docs/readme.md
浏览文件 @
45a486a9
...
@@ -276,7 +276,7 @@ uni-app x支持npm，但npm的大多数库是for web的，无法跨端，这些
...
@@ -276,7 +276,7 @@ uni-app x支持npm，但npm的大多数库是for web的，无法跨端，这些
-
平台支持：Android、Web、iOS版已发布。小程序、鸿蒙还未支持。虽然uts语言支持swift，可以写原生插件，但uvue的iOS版目前只上线了js逻辑层，还未发布swift逻辑层。
-
平台支持：Android、Web、iOS版已发布。小程序、鸿蒙还未支持。虽然uts语言支持swift，可以写原生插件，但uvue的iOS版目前只上线了js逻辑层，还未发布swift逻辑层。
-
小程序平台，目前也可以通过编译到H5，在小程序的web-view里临时替代使用
-
小程序平台，目前也可以通过编译到H5，在小程序的web-view里临时替代使用
-
目前不支持：
横屏切换、暗黑模式
、自定义路由、多语言、无障碍
-
目前不支持：
暗黑模式（一些三方组件库自行实现了主题切换）
、自定义路由、多语言、无障碍
-
目前不支持国际区账户创建和打包uni-app x，仅大陆区开发者账户可用。
-
目前不支持国际区账户创建和打包uni-app x，仅大陆区开发者账户可用。
::: info
::: info
...
...
docs/select.md
浏览文件 @
45a486a9
...
@@ -291,7 +291,7 @@ DCloud做了很多年跨平台开发，uni-app在web和小程序平台取得了
...
@@ -291,7 +291,7 @@ DCloud做了很多年跨平台开发，uni-app在web和小程序平台取得了
这个思路的转换使得uni-app x超越了其他跨平台开发框架。
这个思路的转换使得uni-app x超越了其他跨平台开发框架。
在
web端编译为js，在小程序端编译为wxml等，在app
端编译为kotlin。
在
Web端编译为js，在小程序端编译为wxml等，在Android
端编译为kotlin。
每个平台都只是帮开发者换种一致的写法而已，运行的代码都是该平台原生的代码。
每个平台都只是帮开发者换种一致的写法而已，运行的代码都是该平台原生的代码。
然而在2年前，这条路线有2个巨大的风险：
然而在2年前，这条路线有2个巨大的风险：
...
@@ -353,7 +353,7 @@ DCloud做了很多年跨平台开发，uni-app在web和小程序平台取得了
...
@@ -353,7 +353,7 @@ DCloud做了很多年跨平台开发，uni-app在web和小程序平台取得了
|uni-app x |强类型 |无 |无 |无 |较小 |较低 |
|uni-app x |强类型 |无 |无 |无 |较小 |较低 |
|原生应用 |强类型 |无 |无 |无 |较小 |较低 |
|原生应用 |强类型 |无 |无 |无 |较小 |较低 |
当然，作为一个客观的分析，这里需要强调uni-app x刚刚面世，还有很多不成熟的地方
，比如前文diss微信的暗黑模式，其实截止到目前uni-app x还不支持暗黑模式。甚至iOS版现在只能开发uts插件，还不能做完整iOS应用
。
当然，作为一个客观的分析，这里需要强调uni-app x刚刚面世，还有很多不成熟的地方。
[
需求墙
](
https://vote.dcloud.net.cn/#/?name=uni-app%20x
)
里都是uni-app x该做还未做的。也欢迎大家投票。
[
需求墙
](
https://vote.dcloud.net.cn/#/?name=uni-app%20x
)
里都是uni-app x该做还未做的。也欢迎大家投票。
...
@@ -363,11 +363,29 @@ uni-app x这个技术路线是产业真正需要的东西，随着产品的迭
...
@@ -363,11 +363,29 @@ uni-app x这个技术路线是产业真正需要的东西，随着产品的迭
**让跨平台开发不如原生，成为历史**
。
**让跨平台开发不如原生，成为历史**
。
欢迎体验uni-app x的示例应用，感受它的启动速度，渲染流畅度。
欢迎体验 hello uni-app x 示例应用，Android、iOS、Web 三个平台都有，可以亲身感受它的启动速度，渲染流畅度。
源码在：
[
https://gitcode.net/dcloud/hello-uni-app-x/
](
https://gitcode.net/dcloud/hello-uni-app-x/
)
；打包后的apk扫描下面的二维码。
<div
class=
"quick"
>
<div
style=
"margin-top: 20px;justify-content: space-around;"
>
<a
href="https://hellouniappx.dcloud.net.cn"
target="_blank"
style="display: flex; align-items: center;flex-direction: column;margin: 0 5px 20px;width:160px;"
one-link-mark="yes"
>
<div
class=
"barcode-img-box"
>
<img
src="https://web-ext-storage.dcloud.net.cn/uni-app-x/hello-uniappx-qrcode.png"
width="160"
loading="lazy"
/>
</div>
<b>
hello uni-app x
</b>
</a>
</div>
</div>
源码在：
[
https://gitcode.net/dcloud/hello-uni-app-x/
](
https://gitcode.net/dcloud/hello-uni-app-x/
)
这个示例里有几个例子非常考验通信性能，除了也内置了slider-100外，另一个是“模版-scroll-view自定义滚动吸顶”，在滚动时实时修改元素top值始终为一个固定值，一点都不抖动。
这个示例里有几个例子非常考验通信性能，除了也内置了slider-100外，另一个是“模版-scroll-view自定义滚动吸顶”，在滚动时实时修改元素top值始终为一个固定值，一点都不抖动。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑！
取消
想要评论请
注册
或
登录
