提交 28caf0fd 编写于 作者: D DCloud_LXH

chore: UniPage

上级 6e9c7aa9
......@@ -16,38 +16,6 @@ UniPage对象强化了开发者对页面的管理功能,并且支持在uts插
<!-- UTSAPIJSON.getCurrentPages.returnValue -->
::: warning 注意
- HBuilderX 4.31+,$getPageStyle和$setPageStyle不再需要加前缀$。
- 使用`选项式 API` 时,不可创建 `route``options` 同名响应式变量,否则会覆盖当前 `page 实例` 的同名属性。
- 4.31 前仅 `Web``iOS(非 uts 插件)` 端支持通过 `page.$vm` 获取 vue 实例。\
4.31+ 仅 `iOS uts 插件` 环境不支持通过 `page.vm` 获取 vue 实例。
:::
**PageStyle**
支持当前页面 `style` 节点属性
|属性 |类型 |Android|iOS |web |默认值 |
|:-: |:-: |:-: |:-: |:-: |:-: |
|enablePullDownRefresh |Boolean|4.13 |4.13 |4.13 |false |
|backgroundColorContent |String |4.15 |4.15 |4.18 |#ffffff|
|navigationBarBackgroundColor |String |4.18 |4.18 |4.18 |#007AFF|
|navigationBarTextStyle |String |4.18 |4.18 |4.18 |white |
|navigationBarTitleText |String |4.18 |4.18 |4.18 | |
|navigationStyle |String |x |x |4.18 |default|
|backgroundColor |String |4.18 |4.18 |x |#ffffff|
|backgroundTextStyle |String |4.31 |4.31 |x |dark |
|onReachBottomDistance |Number |x |x |4.18 |50 |
|pageOrientation |String |4.18 |4.25 |x |auto |
|disableSwipeBack |Boolean|x |4.18 |x |false |
|hideStatusBar |Boolean |4.31 |x |x |false
|hideBottomNavigationIndicator |Boolean |4.31 |x |x |false
**注意事项**
- web端由于会自动摇树优化未使用的特性,如果整个项目中都没有使用到下拉刷新`enablePullDownRefresh`,那么下拉刷新功能会被摇掉,此时设置打开下拉刷新将无效。
- app-android平台的页面是activity,不支持`backgroundColorContent`设为透明。
- 4.15版本前,app-ios平台在page.json 中设置页面 `enablePullDownRefresh``false` 时,无法通过 `$setPageStyle` 方法动态开启页面下拉刷新。新版已修复该问题。
<!-- UTSAPIJSON.getCurrentPages.example -->
<!-- UTSAPIJSON.getCurrentPages.tutorial -->
......
......@@ -6,8 +6,6 @@
<!-- CUSTOMTYPEJSON.UniPage.param -->
<!-- CUSTOMTYPEJSON.UniPage.compatibility -->
<!-- CUSTOMTYPEJSON.UniPage.example -->
......@@ -37,6 +35,38 @@
<!-- CUSTOMTYPEJSON.UniPage.methods.setPageStyle.tutorial -->
::: warning 注意
- HBuilderX 4.31+,$getPageStyle和$setPageStyle不再需要加前缀$。
- 使用`选项式 API` 时,不可创建 `route``options` 同名响应式变量,否则会覆盖当前 `page 实例` 的同名属性。
- 4.31 前仅 `Web``iOS(非 uts 插件)` 端支持通过 `page.$vm` 获取 vue 实例。\
4.31+ 仅 `iOS uts 插件` 环境不支持通过 `page.vm` 获取 vue 实例。
:::
**PageStyle**
支持当前页面 `style` 节点属性
|属性 |类型 |Android|iOS |web |默认值 |
|:-: |:-: |:-: |:-: |:-: |:-: |
|enablePullDownRefresh |Boolean|4.13 |4.13 |4.13 |false |
|backgroundColorContent |String |4.15 |4.15 |4.18 |#ffffff|
|navigationBarBackgroundColor |String |4.18 |4.18 |4.18 |#007AFF|
|navigationBarTextStyle |String |4.18 |4.18 |4.18 |white |
|navigationBarTitleText |String |4.18 |4.18 |4.18 | |
|navigationStyle |String |x |x |4.18 |default|
|backgroundColor |String |4.18 |4.18 |x |#ffffff|
|backgroundTextStyle |String |4.31 |4.31 |x |dark |
|onReachBottomDistance |Number |x |x |4.18 |50 |
|pageOrientation |String |4.18 |4.25 |x |auto |
|disableSwipeBack |Boolean|x |4.18 |x |false |
|hideStatusBar |Boolean |4.31 |x |x |false
|hideBottomNavigationIndicator |Boolean |4.31 |x |x |false
**注意事项**
- web端由于会自动摇树优化未使用的特性,如果整个项目中都没有使用到下拉刷新`enablePullDownRefresh`,那么下拉刷新功能会被摇掉,此时设置打开下拉刷新将无效。
- app-android平台的页面是activity,不支持`backgroundColorContent`设为透明。
- 4.15版本前,app-ios平台在page.json 中设置页面 `enablePullDownRefresh``false` 时,无法通过 `$setPageStyle` 方法动态开启页面下拉刷新。新版已修复该问题。
<!-- CUSTOMTYPEJSON.UniPage.methods.getParentPage.name -->
<!-- CUSTOMTYPEJSON.UniPage.methods.getParentPage.description -->
......@@ -132,4 +162,3 @@
<!-- CUSTOMTYPEJSON.UniPage.methods.$getPageStyle.returnValue -->
<!-- CUSTOMTYPEJSON.UniPage.methods.$getPageStyle.tutorial -->
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册