From 8fee383b8f7dd1ff2920cd291cd33587ac188644 Mon Sep 17 00:00:00 2001 From: DCloud_LXH <283700113@qq.com> Date: Mon, 20 May 2024 18:26:39 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=87=E6=A1=A3=E5=A4=84=E7=90=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/capturescreen.md | 10 ++--- docs/api/choose-image.md | 4 +- .../api/create-request-permission-listener.md | 4 +- docs/api/create-rewarded-video-ad.md | 4 +- docs/api/create-video-context.md | 4 +- docs/api/create-webview-context.md | 4 +- docs/api/download-file.md | 4 +- docs/api/env.md | 6 +-- docs/api/event-bus.md | 18 ++++---- docs/api/exit.md | 8 ++-- docs/api/facial-recognition-verify.md | 8 ++-- docs/api/get-app-authorize-setting.md | 6 +-- docs/api/get-app-base-info.md | 6 +-- docs/api/get-app.md | 6 +-- docs/api/get-battery-info.md | 10 ++--- docs/api/get-current-pages.md | 6 ++- docs/api/get-device-info.md | 6 +-- docs/api/get-element.md | 4 +- docs/api/get-file-system-manager.md | 8 ++-- docs/api/get-launch-options-sync.md | 6 +-- docs/api/get-location.md | 4 +- docs/api/get-network-type.md | 6 +-- docs/api/get-performance.md | 4 +- docs/api/get-provider.md | 6 +-- docs/api/get-system-info.md | 8 ++-- docs/api/get-system-setting.md | 6 +-- docs/api/get-univerify-manager.md | 6 +-- docs/api/get-window-info.md | 8 ++-- docs/api/install-apk.md | 6 +-- docs/api/interceptor.md | 10 ++--- docs/api/load-font-face.md | 10 ++--- docs/api/memory.md | 10 ++--- docs/api/navigator.md | 22 +++++----- docs/api/nodes-info.md | 4 +- docs/api/page-scroll-to.md | 6 +-- docs/api/preview-image.md | 10 ++--- docs/api/prompt.md | 22 +++++----- docs/api/pull-down-refresh.md | 10 ++--- docs/api/push.md | 22 +++++----- docs/api/request-payment.md | 10 ++--- docs/api/request.md | 4 +- docs/api/rpx2px.md | 6 +-- docs/api/save-image-to-photos-album.md | 6 +-- docs/api/set-navigation-bar-color.md | 6 +-- docs/api/set-navigation-bar-title.md | 6 +-- docs/api/set-tabbar.md | 34 +++++++-------- docs/api/storage.md | 42 +++++++++---------- docs/api/upload-file.md | 4 +- docs/api/websocket-global.md | 28 ++++++------- docs/api/websocket.md | 30 ++++++------- docs/api/wifi.md | 42 +++++++++---------- docs/component/animation-view.md | 5 +-- docs/component/button.md | 4 +- docs/component/canvas.md | 4 +- docs/component/checkbox-group.md | 8 ++-- docs/component/form.md | 4 +- docs/component/image.md | 4 +- docs/component/input.md | 4 +- docs/component/list-view.md | 8 ++-- docs/component/navigator.md | 4 +- docs/component/nested-scroll-body.md | 4 +- docs/component/nested-scroll-header.md | 4 +- docs/component/picker-view.md | 8 ++-- docs/component/progress.md | 4 +- docs/component/radio-group.md | 8 ++-- docs/component/rich-text.md | 4 +- docs/component/scroll-view.md | 4 +- docs/component/slider.md | 4 +- docs/component/sticky.md | 8 ++-- docs/component/swiper.md | 8 ++-- docs/component/switch.md | 4 +- docs/component/text.md | 4 +- docs/component/textarea.md | 4 +- docs/component/unicloud-db.md | 4 +- docs/component/video.md | 4 +- docs/component/view.md | 4 +- docs/component/web-view.md | 4 +- docs/vue/composition-api.md | 2 +- docs/vue/options-api.md | 2 +- 79 files changed, 333 insertions(+), 330 deletions(-) diff --git a/docs/api/capturescreen.md b/docs/api/capturescreen.md index 3083ace7..eec90059 100644 --- a/docs/api/capturescreen.md +++ b/docs/api/capturescreen.md @@ -2,24 +2,24 @@ + + - - ## uni.offUserCaptureScreen(callback?) @offusercapturescreen + + - - @@ -27,4 +27,4 @@ ## tips -- 本文的截屏指手机自带的截屏事件的监听和取消监听，由用户操作手机按键触发。App平台如需通过代码对view截屏，另见API [takeSnapshot](../dom/element.md#takesnapshot) \ No newline at end of file +- 本文的截屏指手机自带的截屏事件的监听和取消监听，由用户操作手机按键触发。App平台如需通过代码对view截屏，另见API [takeSnapshot](../dom/element.md#takesnapshot) diff --git a/docs/api/choose-image.md b/docs/api/choose-image.md index 1dc57287..2fffcaf1 100644 --- a/docs/api/choose-image.md +++ b/docs/api/choose-image.md @@ -2,12 +2,12 @@ + + - - diff --git a/docs/api/create-request-permission-listener.md b/docs/api/create-request-permission-listener.md index 8ebf0f07..28abaeda 100644 --- a/docs/api/create-request-permission-listener.md +++ b/docs/api/create-request-permission-listener.md @@ -2,6 +2,8 @@ + + app-android平台，可使用本API监听应用权限申请确认框的弹出和关闭。不管是哪处的业务代码在申请权限，当弹出和关闭权限申请确认框时均会触发本监听事件。 华为应用市场审核时要求：`APP在调用终端权限时，应同步告知用户申请该权限的目的`。此时即可使用本API，在app.uvue里全局监听。 @@ -25,7 +27,7 @@ app-android平台，可使用本API监听应用权限申请确认框的弹出和 - + diff --git a/docs/api/create-rewarded-video-ad.md b/docs/api/create-rewarded-video-ad.md index ed454e9c..50fc3770 100644 --- a/docs/api/create-rewarded-video-ad.md +++ b/docs/api/create-rewarded-video-ad.md @@ -2,6 +2,8 @@ + + @@ -14,8 +16,6 @@ - - diff --git a/docs/api/create-video-context.md b/docs/api/create-video-context.md index 4a89ff2d..b8a399a0 100644 --- a/docs/api/create-video-context.md +++ b/docs/api/create-video-context.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/api/create-webview-context.md b/docs/api/create-webview-context.md index 6b6afa74..845dc139 100644 --- a/docs/api/create-webview-context.md +++ b/docs/api/create-webview-context.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/api/download-file.md b/docs/api/download-file.md index ae073290..52dd1b7d 100644 --- a/docs/api/download-file.md +++ b/docs/api/download-file.md @@ -2,6 +2,8 @@ + + 下载文件常见场景是apk的下载更新，[app升级中心](https://doc.dcloud.net.cn/uniCloud/upgrade-center.html)是一个现成的开源项目，实现下载进度在通知栏显示等复杂交互，可直接使用。 @@ -17,8 +19,6 @@ - - diff --git a/docs/api/env.md b/docs/api/env.md index b88c53e4..5f38c76b 100644 --- a/docs/api/env.md +++ b/docs/api/env.md @@ -2,14 +2,14 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/event-bus.md b/docs/api/event-bus.md index 8d65e8d7..6cfa8d1a 100644 --- a/docs/api/event-bus.md +++ b/docs/api/event-bus.md @@ -2,60 +2,60 @@ + + - - ## uni.$off(eventName, callback) @$off + + - - ## uni.$once(eventName, callback) @$once + + - - ## uni.$emit(eventName, args?) @$emit + + - - - \ No newline at end of file + diff --git a/docs/api/exit.md b/docs/api/exit.md index ddea4a56..2a1df179 100644 --- a/docs/api/exit.md +++ b/docs/api/exit.md @@ -2,12 +2,12 @@ + + - - 本API仅Android App生效。 Android平台的应用退出分热退出和冷退出。 @@ -16,7 +16,7 @@ Android平台的应用退出分热退出和冷退出。 基本上主流Android App都是热退出。本API也是热退出。 -热退出，即通知了os：这个App用户不用了，在os需要时可以回收。如果在os回收之前，用户又启动这个App，会感觉启动速度更快一些。 +热退出，即通知了os：这个App用户不用了，在os需要时可以回收。如果在os回收之前，用户又启动这个App，会感觉启动速度更快一些。 @@ -26,7 +26,7 @@ Android平台的应用退出分热退出和冷退出。 -## 切换应用到后台@back +## 切换应用到后台@back 有的Android App，点back后不询问用户，直接隐藏到了后台。这种做法占用手机的资源一些，但确实也有一些App是这么做的。 diff --git a/docs/api/facial-recognition-verify.md b/docs/api/facial-recognition-verify.md index fac2a151..03bf52bf 100644 --- a/docs/api/facial-recognition-verify.md +++ b/docs/api/facial-recognition-verify.md @@ -13,24 +13,24 @@ uni-id-pages，已经内置实人认证，从云端到客户端均已开发好 + + - - ## uni.startFacialRecognitionVerify(faceStyle) @startfacialrecognitionverify + + - - diff --git a/docs/api/get-app-authorize-setting.md b/docs/api/get-app-authorize-setting.md index 849f5c4c..c614033d 100644 --- a/docs/api/get-app-authorize-setting.md +++ b/docs/api/get-app-authorize-setting.md @@ -2,18 +2,18 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/get-app-base-info.md b/docs/api/get-app-base-info.md index 6ab455be..d0aee967 100644 --- a/docs/api/get-app-base-info.md +++ b/docs/api/get-app-base-info.md @@ -2,18 +2,18 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/get-app.md b/docs/api/get-app.md index 51c4ef2f..95d67427 100644 --- a/docs/api/get-app.md +++ b/docs/api/get-app.md @@ -2,14 +2,14 @@ + + - - @@ -18,4 +18,4 @@ - \ No newline at end of file + diff --git a/docs/api/get-battery-info.md b/docs/api/get-battery-info.md index a1a6d0e9..c399722c 100644 --- a/docs/api/get-battery-info.md +++ b/docs/api/get-battery-info.md @@ -2,32 +2,32 @@ + + - - ## uni.getBatteryInfoSync() @getbatteryinfosync + + - - - \ No newline at end of file + diff --git a/docs/api/get-current-pages.md b/docs/api/get-current-pages.md index 96e0125a..0fbf3ee9 100644 --- a/docs/api/get-current-pages.md +++ b/docs/api/get-current-pages.md @@ -2,6 +2,8 @@ + + @@ -17,7 +19,7 @@ |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|页面容器背景色 | -**注意事项** +**注意事项** - web端由于会自动摇树优化未使用的特性，如果整个项目中都没有使用到下拉刷新`enablePullDownRefresh`，那么下拉刷新功能会被摇掉，此时设置打开下拉刷新将无效。 - app-android平台的页面是activity，不支持`backgroundColorContent`设为透明。 - 4.15版本前，app-ios平台在page.json 中设置页面 `enablePullDownRefresh` 为 `false` 时，无法通过 `$setPageStyle` 方法动态开启页面下拉刷新。新版已修复该问题。 @@ -25,7 +27,7 @@ - + diff --git a/docs/api/get-device-info.md b/docs/api/get-device-info.md index e2298d75..8b2982de 100644 --- a/docs/api/get-device-info.md +++ b/docs/api/get-device-info.md @@ -2,6 +2,8 @@ + + @@ -10,12 +12,10 @@ - - - \ No newline at end of file + diff --git a/docs/api/get-element.md b/docs/api/get-element.md index 5a1bbe47..55973458 100644 --- a/docs/api/get-element.md +++ b/docs/api/get-element.md @@ -2,6 +2,8 @@ + + **注意：** \ 本方法获取的元素，是页面栈栈顶的页面的元素，而不是执行本方法代码所在的页面的元素。\ 因为uni是全局api，只有`this.$refs`才能和页面绑定。\ @@ -42,8 +44,6 @@ - - diff --git a/docs/api/get-file-system-manager.md b/docs/api/get-file-system-manager.md index 4a87d398..07626b27 100644 --- a/docs/api/get-file-system-manager.md +++ b/docs/api/get-file-system-manager.md @@ -2,6 +2,8 @@ + + 文件管理器对象，用于操作应用可访问的本地文件空间，在app平台是应用沙盒目录。 可实现目录和文件的创建、删除、改名或改路径、遍历目录、获取文件信息、读写文件。 @@ -17,10 +19,8 @@ - - -### 特殊说明 -app-ios平台暂时仅支持在uvue文件中使用文件管理器对象，uts插件中暂不支持 +### 特殊说明 +app-ios平台暂时仅支持在uvue文件中使用文件管理器对象，uts插件中暂不支持 app-android平台API不支持代码包文件目录 diff --git a/docs/api/get-launch-options-sync.md b/docs/api/get-launch-options-sync.md index d4b04bcf..5b006c7b 100644 --- a/docs/api/get-launch-options-sync.md +++ b/docs/api/get-launch-options-sync.md @@ -2,18 +2,18 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/get-location.md b/docs/api/get-location.md index c074a3d0..91501f91 100644 --- a/docs/api/get-location.md +++ b/docs/api/get-location.md @@ -2,12 +2,12 @@ + + - - ### 注意 uni-app x的标准基座定位仅支持wgs84坐标系、不支持逆地址解析、且某些老型号国产Android机因gms问题不支持系统定位、国产Rom可能不支持高度信息。 diff --git a/docs/api/get-network-type.md b/docs/api/get-network-type.md index 21bcb6af..6c41c8d4 100644 --- a/docs/api/get-network-type.md +++ b/docs/api/get-network-type.md @@ -2,18 +2,18 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/get-performance.md b/docs/api/get-performance.md index c6913c86..fda43d3a 100644 --- a/docs/api/get-performance.md +++ b/docs/api/get-performance.md @@ -2,12 +2,12 @@ + + - - diff --git a/docs/api/get-provider.md b/docs/api/get-provider.md index e1effa20..1acf760c 100644 --- a/docs/api/get-provider.md +++ b/docs/api/get-provider.md @@ -2,16 +2,16 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/get-system-info.md b/docs/api/get-system-info.md index c5a21b5d..693bdcf2 100644 --- a/docs/api/get-system-info.md +++ b/docs/api/get-system-info.md @@ -4,6 +4,8 @@ + + uni-app 提供了异步(`uni.getSystemInfo`)和同步(`uni.getSystemInfoSync`)的2个API获取系统信息。 按照运行环境层级排序，从底层向上，systemInfo有6个概念： @@ -24,22 +26,20 @@ uni-app 提供了异步(`uni.getSystemInfo`)和同步(`uni.getSystemInfoSync`) - - ## uni.getSystemInfoSync() @getsysteminfosync + + - - diff --git a/docs/api/get-system-setting.md b/docs/api/get-system-setting.md index cf1abec9..a9a29fa4 100644 --- a/docs/api/get-system-setting.md +++ b/docs/api/get-system-setting.md @@ -2,18 +2,18 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/get-univerify-manager.md b/docs/api/get-univerify-manager.md index 732673e9..c3c401c4 100644 --- a/docs/api/get-univerify-manager.md +++ b/docs/api/get-univerify-manager.md @@ -2,6 +2,8 @@ + + App一键登陆，封装了个推的一键登陆sdk，其内部再次封装了中国三大电信运营商提供的sdk。通过运营商提供的服务，可以在手机sim卡信号正常的情况下，通过云端接口获取到当前用户的手机号。 App一键登陆是替代短信验证码登录的更优选择：对开发者而言更便宜、对用户而言体验更好。 @@ -17,8 +19,6 @@ uni-id-pages，已经内置一键登陆，从云端到客户端均已开发好 - - ## cause个推sdk错误码及运营商错误码汇总 @@ -211,4 +211,4 @@ uni-id-pages，已经内置一键登陆，从云端到客户端均已开发好 - \ No newline at end of file + diff --git a/docs/api/get-window-info.md b/docs/api/get-window-info.md index f79fe2b1..25e4fe7b 100644 --- a/docs/api/get-window-info.md +++ b/docs/api/get-window-info.md @@ -2,13 +2,13 @@ + + - + - - @@ -16,4 +16,4 @@ - \ No newline at end of file + diff --git a/docs/api/install-apk.md b/docs/api/install-apk.md index c7de2e19..a970e74d 100644 --- a/docs/api/install-apk.md +++ b/docs/api/install-apk.md @@ -2,14 +2,14 @@ + + 安装Apk最常见的场景是App的升级，更推荐使用uni的[App升级中心](https://doc.dcloud.net.cn/uniCloud/upgrade-center.html)，这是一个云端一体开源项目，想达到该项目的体验细节需要大量代码，不如直接拿走使用。 - - @@ -19,4 +19,4 @@ - \ No newline at end of file + diff --git a/docs/api/interceptor.md b/docs/api/interceptor.md index 8157b7fa..80595d8e 100644 --- a/docs/api/interceptor.md +++ b/docs/api/interceptor.md @@ -2,24 +2,24 @@ + + - - ## uni.removeInterceptor(name, interceptor?) @removeinterceptor + + - - @@ -31,4 +31,4 @@ ## Tips@tips * 目前仅以下接口支持拦截器：navigateTo、redirectTo、reLaunch、switchTab、navigateBack、loadFontFace、pageScrollTo、startPullDownRefresh、setNavigationBarColor、setNavigationBarTitle、setTabBarBadge、removeTabBarBadge、setTabBarItem、setTabBarStyle、hideTabBar、showTabBar、showTabBarRedDot、hideTabBarRedDot -* 如需拦截request，可在插件市场搜索[拦截器插件](https://ext.dcloud.net.cn/search?q=%E6%8B%A6%E6%88%AA%E5%99%A8&uni-appx=1) \ No newline at end of file +* 如需拦截request，可在插件市场搜索[拦截器插件](https://ext.dcloud.net.cn/search?q=%E6%8B%A6%E6%88%AA%E5%99%A8&uni-appx=1) diff --git a/docs/api/load-font-face.md b/docs/api/load-font-face.md index 3a5d56fc..77a3939a 100644 --- a/docs/api/load-font-face.md +++ b/docs/api/load-font-face.md @@ -2,9 +2,13 @@ + + -#### 注意事项 + + +#### 注意事项 - app-ios平台加载字体一定是全局生效，不支持通过global属性设置为非全局生效 - family属性指定自定义字体路径时，必须使用`url()`包裹。可能某些平台不包裹也可以生效，但标准规范是包裹，按标准写法才能全端生效。如下： ```uts @@ -23,12 +27,8 @@ uni.loadFontFace({ 不同平台支持的字体格式不同，另见[css字体](../css/font-family.md) - - - - diff --git a/docs/api/memory.md b/docs/api/memory.md index 071ce2a6..32c6c2e4 100644 --- a/docs/api/memory.md +++ b/docs/api/memory.md @@ -2,26 +2,26 @@ + + - - ## uni.offMemoryWarning(callback?) @offmemorywarning + + - - - \ No newline at end of file + diff --git a/docs/api/navigator.md b/docs/api/navigator.md index f6a450a9..c433e4f1 100644 --- a/docs/api/navigator.md +++ b/docs/api/navigator.md @@ -2,70 +2,70 @@ + + - - ## uni.redirectTo(options) @redirectto + + - - ## uni.reLaunch(options) @relaunch + + - - ## uni.switchTab(options) @switchtab + + - - ## uni.navigateBack(options?) @navigateback + + - - @@ -86,4 +86,4 @@ A页面跳转到B页面时，有两种方式给B页面传递信息： * ``switchTab`` 只能打开 ``tabBar`` 页面。 * ``reLaunch`` 可以打开任意页面。 * 页面底部的 ``tabBar`` 由页面决定，即只要是定义为 ``tabBar`` 的页面，底部都有 ``tabBar``。 -* 不能在首页 ```onReady``` 之前进行页面跳转。 \ No newline at end of file +* 不能在首页 ```onReady``` 之前进行页面跳转。 diff --git a/docs/api/nodes-info.md b/docs/api/nodes-info.md index a033211d..a20dd4f6 100644 --- a/docs/api/nodes-info.md +++ b/docs/api/nodes-info.md @@ -2,6 +2,8 @@ + + **selector 说明：** @@ -27,8 +29,6 @@ - - diff --git a/docs/api/page-scroll-to.md b/docs/api/page-scroll-to.md index 5d89b6e9..fd622720 100644 --- a/docs/api/page-scroll-to.md +++ b/docs/api/page-scroll-to.md @@ -2,6 +2,8 @@ + + 可以滚动到指定的scrollTop值处，也可以滚动到指定的目标元素处（通过css选择器selector）, 仅支持一级 class app-uvue下，只有页面的根元素为scroll-view时，本API才生效。[详见](../css/README.md#pagescroll) @@ -14,8 +16,6 @@ app-uvue下，只有页面的根元素为scroll-view时，本API才生效。[详 - - **selector 语法** @@ -49,4 +49,4 @@ uni.pageScrollTo({ - \ No newline at end of file + diff --git a/docs/api/preview-image.md b/docs/api/preview-image.md index a0c13bc4..396db518 100644 --- a/docs/api/preview-image.md +++ b/docs/api/preview-image.md @@ -2,32 +2,32 @@ + + - - ## uni.closePreviewImage(options) @closepreviewimage + + - - - \ No newline at end of file + diff --git a/docs/api/prompt.md b/docs/api/prompt.md index 6b151f55..fefd8511 100644 --- a/docs/api/prompt.md +++ b/docs/api/prompt.md @@ -2,14 +2,14 @@ + + - - #### 注意事项 #### @@ -20,9 +20,9 @@ 如果设置了`position` 字段，`uni.showToast` 会采用系统弹窗方案，即弹窗与页面无绑定关系。 页面关闭后，弹出中的/等待弹出的`Toast`会继续展示。 -系统弹窗在部分系统（比如 MIUI,Google）可能会有应用图标前缀。 +系统弹窗在部分系统（比如 MIUI,Google）可能会有应用图标前缀。 -系统弹窗在部分系统（比如 鸿蒙 4.0以上）可能不支持顶部和居中展示。 +系统弹窗在部分系统（比如 鸿蒙 4.0以上）可能不支持顶部和居中展示。 @@ -30,34 +30,36 @@ + + - - ## uni.showModal(options) @showmodal + + - - ## uni.showActionSheet(options) @showactionsheet + + itemList，即actionsheet的列表项，在app和小程序上最多6项，超出会报错。在web上超出不报错，列表区变为可滚动。 @@ -66,8 +68,6 @@ itemList，即actionsheet的列表项，在app和小程序上最多6项，超出 - - @@ -77,4 +77,4 @@ itemList，即actionsheet的列表项，在app和小程序上最多6项，超出 ## Bug & Tips@tips -- 目前web和App的弹窗UI风格不统一，后续会修复 \ No newline at end of file +- 目前web和App的弹窗UI风格不统一，后续会修复 diff --git a/docs/api/pull-down-refresh.md b/docs/api/pull-down-refresh.md index 3f1dcd58..96b9de88 100644 --- a/docs/api/pull-down-refresh.md +++ b/docs/api/pull-down-refresh.md @@ -2,18 +2,20 @@ + + - - ## uni.stopPullDownRefresh() @stoppulldownrefresh + + 使用： 1. 首先pages.json里配置了页面可下拉刷新`"enablePullDownRefresh": true` 2. 当用户下拉页面时触发页面生命周期`onPullDownRefresh` @@ -27,12 +29,10 @@ - - - \ No newline at end of file + diff --git a/docs/api/push.md b/docs/api/push.md index 740f84b6..afe98d9f 100644 --- a/docs/api/push.md +++ b/docs/api/push.md @@ -16,24 +16,24 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于 + + - - ## uni.onPushMessage(callback) @onpushmessage + + - - ### 注意事项 @@ -44,24 +44,24 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于 + + - - ## uni.getChannelManager() @getchannelmanager + + - - ### 注意事项 @@ -87,12 +87,12 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于 + + - - @@ -170,4 +170,4 @@ channelManager.setPushChannel({ * uni-app x 的push模块仅支持uni-push2，不再支持uni-push1。但不要误会这不是强绑uniCloud的付费行为。而是DCloud的所有云服务都将统一纳入到uniCloud体系管理，开发者在开通uni-push2后，也可以拿到mastersecret，然后在自己的服务器去直接连接个推服务器。另外uniCloud的免费版也足够很多开发者使用。 * uni-push是一个独立的模块，在标准基座中并不包含。开发push需要首先编写push相关代码，然后打包自定义基座，根据摇树规则，打出的自定义基座才会包含push模块。详见[摇树](../collocation/manifest-modules.md#treeshaking) * 创建本地通知栏，理论上可以和个推的服务无关。但目前也都包含在push模块里了。如果您不需要服务器推送，只需要本地创建通知栏，也需要打包push模块才行。 -* 部分手机创建本地通知时，App如果在后台状态，点击通知消息并不会拉起App，原因是厂商增加了后台弹窗权限，需要用户手动打开此权限。 \ No newline at end of file +* 部分手机创建本地通知时，App如果在后台状态，点击通知消息并不会拉起App，原因是厂商增加了后台弹窗权限，需要用户手动打开此权限。 diff --git a/docs/api/request-payment.md b/docs/api/request-payment.md index 73a71f1c..502ed12f 100644 --- a/docs/api/request-payment.md +++ b/docs/api/request-payment.md @@ -2,6 +2,8 @@ + + uni.requestPayment是一个统一各平台的客户端支付API，客户端均使用本API调用支付。 本API运行在各端时，会自动转换为各端的原生支付调用API。 @@ -49,8 +51,6 @@ uni.requestPayment是一个统一各平台的客户端支付API，客户端均 - - ### cause支付sdk错误码汇总 @@ -117,10 +117,10 @@ uni.requestPayment是一个统一各平台的客户端支付API，客户端均 #### iOS平台微信支付参数说明： - `appid`：微信开放平台申请的应用ID（AppID） - `universalLink`：iOS平台通用链接（Universal Link） - 在iOS平台微信支付使用的通用链接，必须与微信开放平台 “管理中心” > “应用详情” > “开发信息” 中的“Universal Links”项中配置一致，更多详情参考 + 在iOS平台微信支付使用的通用链接，必须与微信开放平台 “管理中心” > “应用详情” > “开发信息” 中的“Universal Links”项中配置一致，更多详情参考 [通用链接（Universal Link）](https://uniapp.dcloud.net.cn/tutorial/app-ios-capabilities.html#通用链接-universal-link), [一键生成iOS通用链接](https://uniapp.dcloud.io/api/plugins/universal-links), [模块配置](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-payment) - - **注意** + + **注意** - 配置后需提交云端打包后才能生效，真机运行时请使用[自定义调试基座](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground) - 同资源文件（Bundle Resources）配置类似，iOS平台需要配置`uniapp-entitlements`文件， 详见[uniapp-entitlements 配置](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#uniapp-entitlements-%E9%85%8D%E7%BD%AE) diff --git a/docs/api/request.md b/docs/api/request.md index e5781880..085a143d 100644 --- a/docs/api/request.md +++ b/docs/api/request.md @@ -2,12 +2,12 @@ + + - - diff --git a/docs/api/rpx2px.md b/docs/api/rpx2px.md index a9e410b1..2aff05ce 100644 --- a/docs/api/rpx2px.md +++ b/docs/api/rpx2px.md @@ -2,14 +2,14 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/save-image-to-photos-album.md b/docs/api/save-image-to-photos-album.md index 5c2e86cf..e8db746f 100644 --- a/docs/api/save-image-to-photos-album.md +++ b/docs/api/save-image-to-photos-album.md @@ -2,18 +2,18 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/set-navigation-bar-color.md b/docs/api/set-navigation-bar-color.md index ae060a71..32687b0e 100644 --- a/docs/api/set-navigation-bar-color.md +++ b/docs/api/set-navigation-bar-color.md @@ -2,6 +2,8 @@ + + 注意当pages.json中设置导航栏为custom时： 1. 状态栏的背景色将恒为透明。此时无法通过本API设置状态栏背景色。开发者可自行在状态栏区域放置view，设置背景色。 2. 本API设置前景色frontColor时，会修改状态栏的前景色。 @@ -12,12 +14,10 @@ - - - \ No newline at end of file + diff --git a/docs/api/set-navigation-bar-title.md b/docs/api/set-navigation-bar-title.md index 90561372..e0b40813 100644 --- a/docs/api/set-navigation-bar-title.md +++ b/docs/api/set-navigation-bar-title.md @@ -2,14 +2,14 @@ + + - - - \ No newline at end of file + diff --git a/docs/api/set-tabbar.md b/docs/api/set-tabbar.md index 6448192e..a301f474 100644 --- a/docs/api/set-tabbar.md +++ b/docs/api/set-tabbar.md @@ -2,114 +2,114 @@ + + - - ## uni.removeTabBarBadge(options) @removetabbarbadge + + - - ## uni.setTabBarItem(options) @settabbaritem + + - - ## uni.setTabBarStyle(options) @settabbarstyle + + - - ## uni.hideTabBar(options?) @hidetabbar + + - - ## uni.showTabBar(options?) @showtabbar + + - - ## uni.showTabBarRedDot(options) @showtabbarreddot + + - - ## uni.hideTabBarRedDot(options) @hidetabbarreddot + + - - - \ No newline at end of file + diff --git a/docs/api/storage.md b/docs/api/storage.md index 4cde6e0d..c6e9ce4f 100644 --- a/docs/api/storage.md +++ b/docs/api/storage.md @@ -19,42 +19,42 @@ uni-app的Storage在不同端的实现不同： + + - - ## uni.setStorageSync(key, data) @setstoragesync + + - - ## uni.getStorage(options) @getstorage + + - - > 注意：获取一个不存在的 key 会触发 fail 回调，返回错误信息为 "getStorage:fail data not found" 的错误。 @@ -63,14 +63,14 @@ uni-app的Storage在不同端的实现不同： + + - - > 注意：同步方法获取一个不存在的 key 会返回空字符串，而不是 null @@ -79,88 +79,88 @@ uni-app的Storage在不同端的实现不同： + + - - ## uni.getStorageInfoSync() @getstorageinfosync + + - - ## uni.removeStorage(options) @removestorage + + - - ## uni.removeStorageSync(key) @removestoragesync + + - - ## uni.clearStorage(option?) @clearstorage + + - - ## uni.clearStorageSync() @clearstoragesync + + - - - \ No newline at end of file + diff --git a/docs/api/upload-file.md b/docs/api/upload-file.md index faa824f0..606f2bce 100644 --- a/docs/api/upload-file.md +++ b/docs/api/upload-file.md @@ -2,6 +2,8 @@ + + 推荐上传到uniCloud，uniCloud提供了更便宜CDN和更好的易用性，[详见](https://doc.dcloud.net.cn/uniCloud/storage.html) @@ -10,8 +12,6 @@ - - diff --git a/docs/api/websocket-global.md b/docs/api/websocket-global.md index eb55a660..c9b45e3d 100644 --- a/docs/api/websocket-global.md +++ b/docs/api/websocket-global.md @@ -2,56 +2,56 @@ + + - - ## uni.onSocketOpen(options) @onsocketopen + + - - ## uni.onSocketError(callback) @onsocketerror + + - - ## uni.sendSocketMessage(options) @sendsocketmessage + + - - ## 注意事项 @@ -62,42 +62,42 @@ + + - - ## uni.closeSocket(options) @closesocket + + - - ## uni.onSocketClose(callback) @onsocketclose + + - - diff --git a/docs/api/websocket.md b/docs/api/websocket.md index b9da054d..3cbf7e9f 100644 --- a/docs/api/websocket.md +++ b/docs/api/websocket.md @@ -2,100 +2,100 @@ + + - - ## uni.onSocketOpen(options) @onsocketopen + + - - ## uni.onSocketError(callback) @onsocketerror + + - - ## uni.sendSocketMessage(options) @sendsocketmessage + + - - ## uni.onSocketMessage(callback) @onsocketmessage + + - - ## uni.closeSocket(options) @closesocket + + - - ## uni.onSocketClose(callback) @onsocketclose + + - - - \ No newline at end of file + diff --git a/docs/api/wifi.md b/docs/api/wifi.md index dd025932..4fdc248f 100644 --- a/docs/api/wifi.md +++ b/docs/api/wifi.md @@ -2,122 +2,122 @@ + + - - ## uni.stopWifi(option) @stopwifi + + - - ## uni.connectWifi(option) @connectwifi + + - - ## uni.getWifiList(option) @getwifilist + + - - ## uni.onGetWifiList(UniWifiCallback) @ongetwifilist + + - - ## uni.offGetWifiList(UniWifiCallback) @offgetwifilist + + - - ## uni.getConnectedWifi(option) @getconnectedwifi + + - - ## uni.onWifiConnected(UniWifiCallback) @onwificonnected + + - - ## uni.onWifiConnectedWithPartialInfo(UniWifiCallback) @onwificonnectedwithpartialinfo + + - - ## uni.offWifiConnected(callback?) @offwificonnected + + - - - \ No newline at end of file + diff --git a/docs/component/animation-view.md b/docs/component/animation-view.md index f81355dc..fdc1ce0e 100644 --- a/docs/component/animation-view.md +++ b/docs/component/animation-view.md @@ -2,17 +2,16 @@ + + 标准基座并不包含本插件，下载插件后需编写调用代码并打包自定义基座才可运行。 - - - diff --git a/docs/component/button.md b/docs/component/button.md index 37e20ec3..8d0f691a 100644 --- a/docs/component/button.md +++ b/docs/component/button.md @@ -2,14 +2,14 @@ + + - - - 在web平台，由于0.5px有兼容性问题，button的边框使用伪类实现。 - 在app平台，HBuilderX4.02及以上版本调整为原生实现button组件，默认边框不占高度，解决button实际渲染宽高与Web端不一致的问题；HBuilderX4.01及以下版本封装text实现button组件，由于不支持伪类，默认边框使用 border 样式实现，会导致button的实际的渲染宽高在app端比web端多1px。 - button的默认边框宽度为0.5px，当type属性为plain时，边框宽度是1px，此时在web平台button实际的渲染宽高会大于其他类型1px，在app平台button实际的渲染高度与其他类型一致。 diff --git a/docs/component/canvas.md b/docs/component/canvas.md index 8e77caa0..b8c63b92 100644 --- a/docs/component/canvas.md +++ b/docs/component/canvas.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/component/checkbox-group.md b/docs/component/checkbox-group.md index da4cc7f7..959331bc 100644 --- a/docs/component/checkbox-group.md +++ b/docs/component/checkbox-group.md @@ -2,14 +2,14 @@ + + - - @@ -21,14 +21,14 @@ + + - - diff --git a/docs/component/form.md b/docs/component/form.md index 4bdbeaf8..ad2cecb6 100644 --- a/docs/component/form.md +++ b/docs/component/form.md @@ -2,14 +2,14 @@ + + - - ## form内容项控制逻辑 form组件的内容子组件包括：input、textarea、checkbox、radio、switch、slider，以及负责提交或重置的button组件。 diff --git a/docs/component/image.md b/docs/component/image.md index e4ba2c6f..ee183567 100644 --- a/docs/component/image.md +++ b/docs/component/image.md @@ -2,6 +2,8 @@ + + @@ -51,8 +53,6 @@ app端支持的图片格式如下： 安卓端image组件内部使用facebook的[fresco](https://github.com/facebook/fresco)库(2.5.0)，自带缓存策略，也会自动清理缓存。 iOS端image组件内部使用[SDWebImage](https://github.com/SDWebImage/SDWebImage)库(5.10.0)，自带缓存策略，默认7天缓存，缓存过期后会自动清理。 - - #### App平台 - App-Android平台由于默认启用了图片缩放（即根据组件实际宽高加载图片，以节省内存），所以可能导致load事件返回的图片尺寸并非图片原始尺寸。 diff --git a/docs/component/input.md b/docs/component/input.md index fed7c4c6..c64650d4 100644 --- a/docs/component/input.md +++ b/docs/component/input.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/component/list-view.md b/docs/component/list-view.md index 6568b586..20055982 100644 --- a/docs/component/list-view.md +++ b/docs/component/list-view.md @@ -2,6 +2,8 @@ + + 在App中，基于recycle-view的list，才能实现长列表的资源自动回收，以保障列表加载很多项目时，屏幕外的资源被有效回收。list-view就是基于recycle-view的list组件。 每个list由1个父组件list-view及若干子组件list-item构成。仅有有限子组件可识别，[见下](#children-tags) @@ -51,8 +53,6 @@ scroll-view开启嵌套模式后，list-view 可作为内层滚动视图与外 设置内层 list-view 的 `associative-container` 属性为 "nested-scroll-view"，开启内层 list-view 支持与外层 scroll-view 嵌套滚动 - - @@ -63,6 +63,8 @@ scroll-view开启嵌套模式后，list-view 可作为内层滚动视图与外 + + ### list-item复用机制 @@ -104,8 +106,6 @@ scroll-view开启嵌套模式后，list-view 可作为内层滚动视图与外 - - diff --git a/docs/component/navigator.md b/docs/component/navigator.md index eea785f0..e0e9b13e 100644 --- a/docs/component/navigator.md +++ b/docs/component/navigator.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/component/nested-scroll-body.md b/docs/component/nested-scroll-body.md index 146496d5..3bc99ffc 100644 --- a/docs/component/nested-scroll-body.md +++ b/docs/component/nested-scroll-body.md @@ -2,6 +2,8 @@ + + @@ -19,8 +21,6 @@ scroll-view 嵌套场景中。内层 scroll-view 滚动时无法与外层 scroll + `nested-scroll-body` 组件只能渲染在 `nested-scroll-header`组件下面 + 外层 scroll-view 的子节点中只能有一个 `nested-scroll-body` - - diff --git a/docs/component/nested-scroll-header.md b/docs/component/nested-scroll-header.md index 76e8d43f..024be9e7 100644 --- a/docs/component/nested-scroll-header.md +++ b/docs/component/nested-scroll-header.md @@ -2,6 +2,8 @@ + + @@ -18,8 +20,6 @@ scroll-view 嵌套场景中。外层 scroll-view 滚动时无法与内层 scroll + `nested-scroll-header` 组件不支持复数子节点，渲染时会取其第一个子节点来渲染 + `nested-scroll-header` 组件只能渲染在 `nested-scroll-body`组件上面 - - diff --git a/docs/component/picker-view.md b/docs/component/picker-view.md index aea4451b..3e295d23 100644 --- a/docs/component/picker-view.md +++ b/docs/component/picker-view.md @@ -2,14 +2,14 @@ + + - - @@ -21,14 +21,14 @@ + + - - diff --git a/docs/component/progress.md b/docs/component/progress.md index 094f5a21..98b1d107 100644 --- a/docs/component/progress.md +++ b/docs/component/progress.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/component/radio-group.md b/docs/component/radio-group.md index 23cd93f1..cd0fe071 100644 --- a/docs/component/radio-group.md +++ b/docs/component/radio-group.md @@ -2,14 +2,14 @@ + + - - @@ -21,14 +21,14 @@ + + - - diff --git a/docs/component/rich-text.md b/docs/component/rich-text.md index 24a85edd..5c193a71 100644 --- a/docs/component/rich-text.md +++ b/docs/component/rich-text.md @@ -2,6 +2,8 @@ + + ### 支持的HTML标签和属性 |HTML |属性 |样式 | |-------|-------|-------| @@ -28,8 +30,6 @@ - - diff --git a/docs/component/scroll-view.md b/docs/component/scroll-view.md index 915de46a..d6f5c631 100644 --- a/docs/component/scroll-view.md +++ b/docs/component/scroll-view.md @@ -2,6 +2,8 @@ + + @@ -132,8 +134,6 @@ onNestedPreScroll(event: NestedPreScrollEvent) { **具体代码请参考：**[nested-scroll嵌套滚动示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/template/long-list/long-list.uvue) - - #### App平台 + App平台scroll-x、scroll-y属性不支持同时设置为true, 同时设置true时仅scroll-y生效，4.0版本开始scroll-x、scroll-y已废弃，请使用direction属性。 diff --git a/docs/component/slider.md b/docs/component/slider.md index a7c7d15d..184eff75 100644 --- a/docs/component/slider.md +++ b/docs/component/slider.md @@ -2,14 +2,14 @@ + + - - ## tips show-value属性设为true后，会在横条右侧显示一个数字。 diff --git a/docs/component/sticky.md b/docs/component/sticky.md index ace8a2a6..616d330e 100644 --- a/docs/component/sticky.md +++ b/docs/component/sticky.md @@ -2,6 +2,8 @@ + + @@ -33,8 +35,6 @@ + sticky-header组件不支持css。仅支持padding属性控制子元素位置。其他排版需求要交给子元素实现 + 同时存在多sticky-header组件请使用sticky-section组件充当父容器控制吸顶业务 - - @@ -45,6 +45,8 @@ + + @@ -78,8 +80,6 @@ + sticky-section组件是虚拟组件不会真实渲染。仅支持padding属性控制子元素位置。其他排版需求要交给子元素实现 + Android平台sticky-section组件作为list-view的子元素时需要注意，sticky-section子元素仅支持sticky-header、list-item，其他元素无法正常显示 - - diff --git a/docs/component/swiper.md b/docs/component/swiper.md index 580e37f0..1fad76ea 100644 --- a/docs/component/swiper.md +++ b/docs/component/swiper.md @@ -2,14 +2,14 @@ + + - - @@ -20,14 +20,14 @@ + + - - diff --git a/docs/component/switch.md b/docs/component/switch.md index 5400d6e9..1af8fead 100644 --- a/docs/component/switch.md +++ b/docs/component/switch.md @@ -2,6 +2,8 @@ + + type为checkbox只有微信小程序和Web平台支持。一般建议使用标准的[checkbox组件](checkbox-group.md) @@ -10,8 +12,6 @@ type为checkbox只有微信小程序和Web平台支持。一般建议使用标 - - diff --git a/docs/component/text.md b/docs/component/text.md index 76075df6..6db5747d 100644 --- a/docs/component/text.md +++ b/docs/component/text.md @@ -2,6 +2,8 @@ + + 在app-uvue和app-nvue中，文本只能写在text中，而不能写在view的text区域。文本样式的控制也应该在text组件上写style，而不是在view的样式里写。 虽然app-uvue中写在view的text区域的文字，也会被编译器自动包裹一层text组件，看起来也可以使用。但这样会造成无法修改该text文字的样式，详见uvue的[样式不继承](../css/README.md#stylenoextends)章节。 @@ -12,8 +14,6 @@ - - - App-Android平台文本换行规则（表现在文本断行位置等）可能和浏览器有差异。 ## 子组件 diff --git a/docs/component/textarea.md b/docs/component/textarea.md index 76cf37a2..9bce263c 100644 --- a/docs/component/textarea.md +++ b/docs/component/textarea.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/component/unicloud-db.md b/docs/component/unicloud-db.md index 285c7fab..3d0912c4 100644 --- a/docs/component/unicloud-db.md +++ b/docs/component/unicloud-db.md @@ -2,14 +2,14 @@ + + - - diff --git a/docs/component/video.md b/docs/component/video.md index 06c48f2e..25875131 100644 --- a/docs/component/video.md +++ b/docs/component/video.md @@ -2,6 +2,8 @@ + + @@ -20,8 +22,6 @@ app端支持的视频格式如下： - [x] flv - [x] m3u8 (本地m3u8文件安卓端需3.99+，iOS端需4.11+) - - #### App平台 App-Android平台video组件使用ijkplayer库实现：[https://github.com/bilibili/ijkplayer](https://github.com/bilibili/ijkplayer)； diff --git a/docs/component/view.md b/docs/component/view.md index d7a36a37..9f83ed70 100644 --- a/docs/component/view.md +++ b/docs/component/view.md @@ -2,6 +2,8 @@ + + #### 说明 @@ -13,8 +15,6 @@ - - #### App平台@app - HBuilder4.0以下版本`hover-class`属性App端与微信小程序效果一样，手指按下进入`hover-class`状态后，手指移动就会取消`hover-class`状态 - HBuilder4.0及以上版本App端调整为手指在view范围内移动不会取消`hover-class`状态，手指移动到view范围之外才会取消`hover-class`状态 diff --git a/docs/component/web-view.md b/docs/component/web-view.md index 54a2b9d4..2d56b2ed 100644 --- a/docs/component/web-view.md +++ b/docs/component/web-view.md @@ -2,14 +2,14 @@ + + - - - web平台web-view组件底层使用iframe实现，会有浏览器安全策略限制。一般不推荐在web平台使用web-view组件，如确需使用，且需要通信，请自行根据iframe的浏览器规范进行通信。 - web和小程序平台上，web-view是全屏的，即页面只能显示一个铺满的web-view。 - app/web平台的web-view组件可以自由调整大小和位置。在uni-app x 4.0以前，默认宽、高为0px，页面中使用时需设置相应的 css 属性控制组件宽高才能正常显示。从4.0起改为默认宽高100%。 diff --git a/docs/vue/composition-api.md b/docs/vue/composition-api.md index 42a4394e..420d4e9b 100644 --- a/docs/vue/composition-api.md +++ b/docs/vue/composition-api.md @@ -409,7 +409,7 @@ #### 兼容性 @component-lifecycle-compatibility - + #### onMounted、onUnmounted 使用注意事项 @mounted-unmounted-tips diff --git a/docs/vue/options-api.md b/docs/vue/options-api.md index 90263775..dc53cf4d 100644 --- a/docs/vue/options-api.md +++ b/docs/vue/options-api.md @@ -148,7 +148,7 @@ #### 兼容性 @component-lifecycle-compatibility - + #### mounted、unmounted 使用注意事项 @mounted-unmounted-tips -- GitLab