diff --git a/README.md b/README.md index 0c700860875f481ca6d67b8deaf7d728d46f1f52..2b33ed47d913a281dcf4cc0526670f14c96e57eb 100644 --- a/README.md +++ b/README.md @@ -73,7 +73,7 @@ - 答:不是。大量开发者用uni-app只做一个端,详见[案例](https://uniapp.dcloud.io/case)。对于开发者而言,一个优秀工具在手,做什么都不愁。 - 问:uni-app以后会不会变更开源协议,转向收费? -- 答:官方承诺永远不会变更开源协议。无论HBuilderX、uni-app、5+app,面向中国人永久免费。 +- 答:官方承诺永远不会变更开源协议。无论HBuilderX、uni-app、App,面向中国人永久免费。 ## 更多资料 diff --git a/docs/api/canvas/CanvasContext.md b/docs/api/canvas/CanvasContext.md index b5dac710281aa7f67959f03b9ed13b00e6a31671..7223a0eb5f1260834dec530b122ceb93596587a3 100644 --- a/docs/api/canvas/CanvasContext.md +++ b/docs/api/canvas/CanvasContext.md @@ -65,7 +65,7 @@ App-nvue下如需使用canvas,暂未封装为uni API,可参考[文档](https 在绘制新形状时应用的合成操作的类型。目前安卓版本只适用于 `fill` 填充块的合成,用于 `stroke` 线段的合成效果都是 `source-over`。 目前支持的操作有 -* 5+App和H5端:source-over、destination-over、source-in、destination-in、source-out、destination-out、source-atop、destination-atop、lighter、darker、xor、copy +* App和H5端:source-over、destination-over、source-in、destination-in、source-out、destination-out、source-atop、destination-atop、lighter、darker、xor、copy * 微信小程序安卓端:xor, source-over, source-atop, destination-out, lighter, overlay, darken, lighten, hard-light * 微信小程序iOS端:xor, source-over, source-atop, destination-over, destination-out, lighter, multiply, overlay, darken, lighten, color-dodge, color-burn, hard-light, soft-light, difference, exclusion, saturation, luminosity @@ -73,7 +73,7 @@ App-nvue下如需使用canvas,暂未封装为uni API,可参考[文档](https **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |√|√|√|√|√|√| diff --git a/docs/api/canvas/canvasToTempFilePath.md b/docs/api/canvas/canvasToTempFilePath.md index 58eddbd3929f3d9f123f14a70aedc760820a7006..283de0d395523a3bb47f35f9311793052df8bb7d 100644 --- a/docs/api/canvas/canvasToTempFilePath.md +++ b/docs/api/canvas/canvasToTempFilePath.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|√|√|x([CanvasContext.toTempFilePath](https://opendocs.alipay.com/mini/api/rod3ti))|√|√|√| diff --git a/docs/api/extend/native-plugin.md b/docs/api/extend/native-plugin.md index fd2cdeacaf9c29aa352c84a703d161f03f92799c..de121bd9c87e74b4c8c582e0271ba0064079204d 100644 --- a/docs/api/extend/native-plugin.md +++ b/docs/api/extend/native-plugin.md @@ -4,7 +4,7 @@ 平台差异说明: -* 5+App +* App 自 HXuilderX1.4 版本起,``uni-app`` 支持引入原生插件,使用方式如下: diff --git a/docs/api/file/file.md b/docs/api/file/file.md index 2c0de5313d6f35d71cfe4086010dd84f150a1e45..f7cb8c5ec33f8553f0002900181dbb8be393e340 100644 --- a/docs/api/file/file.md +++ b/docs/api/file/file.md @@ -3,7 +3,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| @@ -45,7 +45,7 @@ uni.chooseImage({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| @@ -87,7 +87,7 @@ uni.getSavedFileList({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|x|√| @@ -125,7 +125,7 @@ uni.getSavedFileInfo({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| @@ -160,7 +160,7 @@ uni.getSavedFileList({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| @@ -187,7 +187,7 @@ uni.getSavedFileList({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| @@ -223,8 +223,8 @@ uni.downloadFile({ |平台|打开方式| |:-|:-| |小程序|在小程序的入口应用内打开| -|5+App iOS|在当前应用内打开| -|5+App Android|调用系统相关应用打开,无相关应用则不能打开| +|App iOS|在当前应用内打开| +|App Android|调用系统相关应用打开,无相关应用则不能打开| |H5|使用浏览器打开,当前浏览器不支持则不能打开| **Tips** diff --git a/docs/api/media/audio-context.md b/docs/api/media/audio-context.md index cc5677634abd927fa69d807e24b399bf1a9e4e70..78ff0bb55c6520ab014842666a0c38459a86186f 100644 --- a/docs/api/media/audio-context.md +++ b/docs/api/media/audio-context.md @@ -3,7 +3,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|√|√|x|√|√|√| diff --git a/docs/api/media/background-audio-manager.md b/docs/api/media/background-audio-manager.md index 63c5b605ae99526d42dc676486384965b83b77e5..5d5261f433c75ddce63c1148baa5194888e1100f 100644 --- a/docs/api/media/background-audio-manager.md +++ b/docs/api/media/background-audio-manager.md @@ -3,7 +3,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|x|√|√|√| diff --git a/docs/api/media/image.md b/docs/api/media/image.md index 4f1b476e8ce4e0e6c4e85d96b15a6ab2aaf9d151..1eac7232931825fd44dae98506d96b1df4335e53 100644 --- a/docs/api/media/image.md +++ b/docs/api/media/image.md @@ -10,15 +10,15 @@ App端如需要更丰富的相机拍照API(如直接调用前置摄像头) |参数名|类型|必填|说明|平台差异说明| |:-|:-|:-|:-|:-| |count|Number|否|最多可以选择的图片张数,默认9|见下方说明| -|sizeType|Array<String>|否|original 原图,compressed 压缩图,默认二者都有|5+App、微信小程序、支付宝小程序、百度小程序| +|sizeType|Array<String>|否|original 原图,compressed 压缩图,默认二者都有|App、微信小程序、支付宝小程序、百度小程序| |sourceType|Array<String>|否|album 从相册选图,camera 使用相机,默认二者都有。如需直接开相机或直接选相册,请只使用一个选项|| |success|Function|是|成功则返回图片的本地文件路径列表 tempFilePaths|| -|fail|Function|否|接口调用失败的回调函数|小程序、5+App| +|fail|Function|否|接口调用失败的回调函数|小程序、App| |complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)| | **Tips** -- count 值在 H5 平台的表现,基于浏览器本身的规范。目前测试的结果来看,只能限制单选/多选,并不能限制数量。并且,在实际的手机浏览器很少有能够支持多选的。 +- count 值在 H5 平台的表现,基于浏览器本身的规范。目前测试的结果来看,只能限制单选/多选,并不能限制数量。并且,在实际的手机浏览器很少有能够支持多选的。 - sourceType 在H5端对应`input`的`capture`属性,设置为`['album']`无效,依然可以使用相机。 - 可以通过用户授权API来判断用户是否给应用授予相册或摄像头的访问权限[https://uniapp.dcloud.io/api/other/authorize](https://uniapp.dcloud.io/api/other/authorize) @@ -60,9 +60,9 @@ uni.chooseImage({ |:-|:-|:-|:-|:-| |current|String/Number|详见下方说明|详见下方说明|| |urls|Array<String>|是|需要预览的图片链接列表|| -|indicator|String|否|图片指示器样式,可取值:"default" - 底部圆点指示器; "number" - 顶部数字指示器; "none" - 不显示指示器。|5+App| -|loop|Boolean|否|是否可循环预览,默认值为 false|5+App| -|longPressActions|Object|否|长按图片显示操作菜单,如不填默认为**保存相册**,1.9.5 起支持。|5+App| +|indicator|String|否|图片指示器样式,可取值:"default" - 底部圆点指示器; "number" - 顶部数字指示器; "none" - 不显示指示器。|App| +|loop|Boolean|否|是否可循环预览,默认值为 false|App| +|longPressActions|Object|否|长按图片显示操作菜单,如不填默认为**保存相册**|App 1.9.5+| |success|Function|否|接口调用成功的回调函数|| |fail|Function|否|接口调用失败的回调函数|| |complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)| | @@ -134,7 +134,7 @@ uni.chooseImage({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |√|√|√|√|√|√| @@ -193,7 +193,7 @@ uni.chooseImage({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序 +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序 |:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√| @@ -239,7 +239,7 @@ uni.chooseImage({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序 +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序 |:-:|:-:|:-:|:-:|:-:|:-:| |1.9.7+ [自定义组件编译模式](https://ask.dcloud.net.cn/article/35843)|x|√|√|√(基础库版本>=3.110.3)|√| diff --git a/docs/api/media/record-manager.md b/docs/api/media/record-manager.md index 03234fd3a09907890bf578ccac5e8c4a9caec172..bda78e24ef55e5b25e28af1cf4d488166441624c 100644 --- a/docs/api/media/record-manager.md +++ b/docs/api/media/record-manager.md @@ -3,7 +3,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|x|√|√|√| @@ -18,7 +18,7 @@ |onStart|callback|录音开始事件|| |onPause|callback|录音暂停事件|| |onStop|callback|录音停止事件,会回调文件地址|| -|onFrameRecorded|callback|已录制完指定帧大小的文件,会回调录音分片结果数据。如果设置了 frameSize ,则会回调此事件|5+App 暂不支持| +|onFrameRecorded|callback|已录制完指定帧大小的文件,会回调录音分片结果数据。如果设置了 frameSize ,则会回调此事件|App 暂不支持| |onError|callback|录音错误事件, 会回调错误信息| | **start(options) 说明** diff --git a/docs/api/other/choose-address.md b/docs/api/other/choose-address.md index 5e121377b2e51999335d4c04982d5bdcb3712aed..a47dc8398a4485d2459be15e18be8c261d1fcdf8 100644 --- a/docs/api/other/choose-address.md +++ b/docs/api/other/choose-address.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|√|x| diff --git a/docs/api/other/get-extconfig.md b/docs/api/other/get-extconfig.md index 7bce3d799b1bcd818267dd60e4ca4d18c0634d1d..b9980a7d26c6de45f1f9325703b28dd5c35f590f 100644 --- a/docs/api/other/get-extconfig.md +++ b/docs/api/other/get-extconfig.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|√|x| @@ -45,7 +45,7 @@ if (uni.getExtConfig) { **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|√|x| diff --git a/docs/api/other/getAccountInfoSync.md b/docs/api/other/getAccountInfoSync.md index 08c8fda74368ae15663b80f511a4807e2ef672a6..f7900e828c030051ee43d20b05bd3837b9fcf15e 100644 --- a/docs/api/other/getAccountInfoSync.md +++ b/docs/api/other/getAccountInfoSync.md @@ -5,7 +5,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|√| diff --git a/docs/api/other/invoice-title.md b/docs/api/other/invoice-title.md index 71bbe04c21c1484390ee7c4e96476e9020e4d7e0..0758c4c0b2594f61729b3c8d29f68549eaf3b33b 100644 --- a/docs/api/other/invoice-title.md +++ b/docs/api/other/invoice-title.md @@ -6,7 +6,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|x| diff --git a/docs/api/other/open-miniprogram.md b/docs/api/other/open-miniprogram.md index e34b98cb8b8c5e1fdb756629f1307667255995b2..b8e48370622616ec8c034eb1a72720fa149f19b0 100644 --- a/docs/api/other/open-miniprogram.md +++ b/docs/api/other/open-miniprogram.md @@ -46,7 +46,7 @@ uni.navigateToMiniProgram({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|√|√| diff --git a/docs/api/other/requestSubscribeMessage.md b/docs/api/other/requestSubscribeMessage.md index 8870bf78b18fe90492594927eafafc4b59e51b73..f65dd576dc2a6f2a318e7d660d38d77a9c8666dd 100644 --- a/docs/api/other/requestSubscribeMessage.md +++ b/docs/api/other/requestSubscribeMessage.md @@ -3,7 +3,7 @@ **平台差异说明** -|5+App|H5 |微信小程序 |支付宝小程序 |百度小程序 |头条小程序 |QQ小程序 | +|App|H5 |微信小程序 |支付宝小程序 |百度小程序 |头条小程序 |QQ小程序 | |:-: |:-:|:-: |:-: |:-: |:-: |:-: | |x |x |基础库版本>=2.8.2|x |x |x |x | diff --git a/docs/api/other/set-enable-debug.md b/docs/api/other/set-enable-debug.md index 3053a9a89e975ff206e381946079bf79c6f59d16..07c0d6489268680e58dbc73fb708705c61b8e978 100644 --- a/docs/api/other/set-enable-debug.md +++ b/docs/api/other/set-enable-debug.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|√| diff --git a/docs/api/other/setting.md b/docs/api/other/setting.md index 3429d902c748ca74fcac28dc14f4f8c020385ba5..35549be26afee72bcfed57252047ceb785a36aa8 100644 --- a/docs/api/other/setting.md +++ b/docs/api/other/setting.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|√|√| @@ -35,7 +35,7 @@ uni.openSetting({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|√|√| diff --git a/docs/api/other/template.md b/docs/api/other/template.md index 087a25dca667f38a8384c637cd2b8d96e38060d3..e385548af47704e8941e748e594b58f6f7ecf85a 100644 --- a/docs/api/other/template.md +++ b/docs/api/other/template.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|x| @@ -66,7 +66,7 @@ POST https://openapi.baidu.com/rest/2.0/smartapp/template/templateadd?access_tok **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|x| @@ -120,7 +120,7 @@ POST https://openapi.baidu.com/rest/2.0/smartapp/template/templatedel?access_tok **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|x| @@ -229,7 +229,7 @@ POST https://openapi.baidu.com/rest/2.0/smartapp/template/libraryget?access_toke **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|x| @@ -318,7 +318,7 @@ POST https://openapi.baidu.com/rest/2.0/smartapp/template/librarylist?access_tok **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|x| @@ -416,7 +416,7 @@ POST https://openapi.baidu.com/rest/2.0/smartapp/template/templatelist?access_to **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|x| @@ -549,7 +549,7 @@ POST https://openapi.baidu.com/rest/2.0/smartapp/template/templatedel?access_tok **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|x|√|x|x|x| diff --git a/docs/api/other/update.md b/docs/api/other/update.md index 4acc78c2ecc9960f3b6b7afd89ccf12bc9c63754..114a1a9c12413fe7d248cf43c0073b17438294f3 100644 --- a/docs/api/other/update.md +++ b/docs/api/other/update.md @@ -8,7 +8,7 @@ App的更新不使用本API,另见文档: **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|√|√| diff --git a/docs/api/plugins/login.md b/docs/api/plugins/login.md index beae565c6948c13892033b53910ad994e965ed4d..85462c7e69f9ef1d9a6af7fb7c7c6c4052b4d6ef 100644 --- a/docs/api/plugins/login.md +++ b/docs/api/plugins/login.md @@ -101,7 +101,7 @@ uni.login({ |zh_TW|繁体中文| |en|英文| -**注意:**在小程序 withCredentials 为 true 时或是在 5+App 调用 uni.getUserInfo,要求此前有调用过 uni.login 且登录态尚未过期。 +**注意:**在小程序 withCredentials 为 true 时或是在 App 调用 uni.getUserInfo,要求此前有调用过 uni.login 且登录态尚未过期。 **success 返回参数说明** @@ -119,7 +119,7 @@ uni.login({ |参数|类型|说明|平台差异说明| |:-|:-|:-|| |nickName|String|用户昵称|| -|openId|String|该服务商唯一用户标识|5+App| +|openId|String|该服务商唯一用户标识|App| |avatarUrl|String|用户头像| | 除了以上三个必有的信息外,不同服务供应商返回的其它信息会存在差异。 diff --git a/docs/api/plugins/payment.md b/docs/api/plugins/payment.md index f8b46bae4682f70a3d752f5be70345ebbb9bff4a..24d48f561dd15c5a7b98ce04eaf7e1ff40dcbc69 100644 --- a/docs/api/plugins/payment.md +++ b/docs/api/plugins/payment.md @@ -11,7 +11,7 @@ uni.requestPayment是一个统一各平台的客户端支付API,不管是在 **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|[说明](/api/plugins/payment?id=h5-payment)|√|√|√|√|√| @@ -20,7 +20,7 @@ uni.requestPayment是一个统一各平台的客户端支付API,不管是在 |参数名|类型|必填|说明|平台差异说明| |:-|:-|:-|:-|| |provider|String|是|服务提供商,通过 [uni.getProvider](/api/plugins/provider) 获取。|| -|orderInfo|String/Object|是|订单数据,[注意事项](/api/plugins/payment?id=orderinfo)|5+App、支付宝小程序、百度小程序、头条小程序| +|orderInfo|String/Object|是|订单数据,[注意事项](/api/plugins/payment?id=orderinfo)|App、支付宝小程序、百度小程序、头条小程序| |timeStamp|String|微信小程序必填|时间戳从1970年1月1日至今的秒数,即当前的时间。|微信小程序| |nonceStr|String|微信小程序必填|随机字符串,长度为32个字符以下。|微信小程序| |package|String|微信小程序必填|统一下单接口返回的 prepay_id 参数值,提交格式如:prepay_id=xx。|微信小程序| @@ -41,7 +41,7 @@ uni.requestPayment是一个统一各平台的客户端支付API,不管是在 #### orderInfo 注意事项@orderInfo 1. 百度小程序的 orderInfo 为 Object 类型,详细的数据结构,参考:[百度收银台支付](https://smartprogram.baidu.com/docs/develop/api/open_payment/#requestPolymerPayment/)。 2. 支付宝小程序的 orderInfo(支付宝的规范为 tradeNO) 为 String 类型,表示支付宝交易号。 -3. 头条小程序的 orderInfo 为 Object 类型,详见:[发起头条支付](https://developer.toutiao.com/dev/cn/mini-app/develop/open-capacity/payment/pay) +3. 头条小程序的 orderInfo 为 Object 类型,详见:[发起头条支付](https://developer.toutiao.com/dev/cn/mini-app/develop/open-capacity/payment/pay) 4. 由于头条新版支付接口要求版本较高,在不支持新版支付接口的情况下仍会对应旧版支付接口,此时 orderInfo 对应头条小程序 data, 详见:[头条支付旧版接口](https://developer.toutiao.com/dev/cn/mini-app/develop/open-capacity/payment/requestpayment-deprecated)。用户可以使用 tt.pay 判断是否支持新版接口。另外需要注意头条小程序在`1.35.0+`版本基础库支持了 canIUse ,在`1.19.4+`版本基础库支持了新版支付接口 tt.pay ,所以应避免使用 canIUse 判断是否为新版接口。 5. App端,支付宝支付和微信支付 orderInfo 均为 String 类型。 6. App端,苹果应用内支付 orderInfo 为Object 类型,{productid: 'productid'}。 diff --git a/docs/api/plugins/push.md b/docs/api/plugins/push.md index 888c9714fa061d6e7d8cfef74ec827cf81d4da0a..a7cbeefdf7ffe57b63483b0f439f88909499b451 100644 --- a/docs/api/plugins/push.md +++ b/docs/api/plugins/push.md @@ -49,7 +49,7 @@ 开启推送 平台差异说明: -- 5+App +- App **OBJECT 参数说明** @@ -87,7 +87,7 @@ uni.getProvider({ **平台差异说明** -- 5+App +- App **OBJECT 参数说明** @@ -115,7 +115,7 @@ uni.unsubscribePush({ **平台差异说明** -- 5+App +- App **OBJECT 参数说明** @@ -147,7 +147,7 @@ uni.onPush({ **平台差异说明** -- 5+App +- App **OBJECT 参数说明** diff --git a/docs/api/plugins/share.md b/docs/api/plugins/share.md index 4df6b14fbf27251a2f009a3ed9ce79f5730e668d..3ecbfc768327681ffdbfd0e9d529494d4f699657 100644 --- a/docs/api/plugins/share.md +++ b/docs/api/plugins/share.md @@ -215,7 +215,7 @@ uni.share({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|√| @@ -263,7 +263,7 @@ export default { **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|√| @@ -283,7 +283,7 @@ export default { **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|x|√| diff --git a/docs/api/request/network-file.md b/docs/api/request/network-file.md index 8755fc65af338d5087b4a15c530c32e8c81763ae..d272f87607ef7b052d6c290d3e3e028a9c83c926 100644 --- a/docs/api/request/network-file.md +++ b/docs/api/request/network-file.md @@ -9,7 +9,7 @@ |参数名|类型|必填|说明|平台差异说明| |:-|:-|:-|:-|:-| |url|String|是|开发者服务器 url|| -|files|Array|否|需要上传的文件列表。**使用 files 时,filePath 和 name 不生效。**|5+App| +|files|Array|否|需要上传的文件列表。**使用 files 时,filePath 和 name 不生效。**|App| |fileType|String|见平台差异说明|文件类型,image/video/audio|仅支付宝小程序,且必填。| |filePath|String|是|要上传文件资源的路径。|| |name|String|是|文件对应的 key , 开发者在服务器端通过这个 key 可以获取到文件二进制内容|| @@ -21,7 +21,7 @@ **注意**: -- 5+App支持多文件上传,微信小程序只支持单文件上传,传多个文件需要反复调用本API。所以跨端的写法就是循环调用本API。 +- App支持多文件上传,微信小程序只支持单文件上传,传多个文件需要反复调用本API。所以跨端的写法就是循环调用本API。 - hello uni-app中的客服反馈,支持多图上传。[uni-app插件市场](https://ext.dcloud.net.cn/)中也有多个封装的组件。 - App平台选择和上传非图像、视频文件,参考[https://ask.dcloud.net.cn/article/35547](https://ask.dcloud.net.cn/article/35547) - 网络请求的 ``超时时间`` 可以统一在 ``manifest.json`` 中配置 [networkTimeout](/collocation/manifest?id=networktimeout)。 @@ -86,12 +86,12 @@ uploadTask.abort(); **uploadTask 对象的方法列表** |方法|参数|说明| -|:-|:-|:-| +|:-|:-|:-| |abort||中断上传任务| -|onProgressUpdate|callback|监听上传进度变化| -|onHeadersReceived|callback|监听 HTTP Response Header 事件。会比请求完成事件更早,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/UploadTask.onHeadersReceived.html)| -|offProgressUpdate|callback|取消监听上传进度变化事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/UploadTask.offProgressUpdate.html)| -|offHeadersReceived|callback|取消监听 HTTP Response Header 事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/UploadTask.offHeadersReceived.html)| +|onProgressUpdate|callback|监听上传进度变化| +|onHeadersReceived|callback|监听 HTTP Response Header 事件。会比请求完成事件更早,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/UploadTask.onHeadersReceived.html)| +|offProgressUpdate|callback|取消监听上传进度变化事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/UploadTask.offProgressUpdate.html)| +|offHeadersReceived|callback|取消监听 HTTP Response Header 事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/UploadTask.offHeadersReceived.html)| **onProgressUpdate 返回参数说明** @@ -192,12 +192,12 @@ downloadTask.abort(); **downloadTask 对象的方法列表** |方法|参数|说明|最低版本| -|:-|:-|:-|:-| +|:-|:-|:-|:-| |abort||中断下载任务|*| |onProgressUpdate|callback|监听下载进度变化|*| -|onHeadersReceived|callback|监听 HTTP Response Header 事件,会比请求完成事件更早,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/DownloadTask.onHeadersReceived.html)| -|offProgressUpdate|callback|取消监听下载进度变化事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/DownloadTask.offProgressUpdate.html)| -|offHeadersReceived|callback|取消监听 HTTP Response Header 事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/DownloadTask.offHeadersReceived.html)| +|onHeadersReceived|callback|监听 HTTP Response Header 事件,会比请求完成事件更早,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/DownloadTask.onHeadersReceived.html)| +|offProgressUpdate|callback|取消监听下载进度变化事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/DownloadTask.offProgressUpdate.html)| +|offHeadersReceived|callback|取消监听 HTTP Response Header 事件,仅`微信小程序平台`支持,[规范详情](https://developers.weixin.qq.com/miniprogram/dev/api/DownloadTask.offHeadersReceived.html)| **onProgressUpdate 返回参数说明** diff --git a/docs/api/request/request.md b/docs/api/request/request.md index 442e20e6b18067592cecd28b974ba1052ab5fdc8..c5855b95c7a2c28524f0ad8b3544509cfe1409d3 100644 --- a/docs/api/request/request.md +++ b/docs/api/request/request.md @@ -8,13 +8,13 @@ |参数名|类型|必填|默认值|说明|平台差异说明| |:-|:-|:-|:-|:-|:-| |url|String|是||开发者服务器接口地址|| -|data|Object/String/ArrayBuffer|否||请求的参数|5+App(自定义组件编译模式)不支持ArrayBuffer类型| +|data|Object/String/ArrayBuffer|否||请求的参数|App(自定义组件编译模式)不支持ArrayBuffer类型| |header|Object|否||设置请求的 header,header 中不能设置 Referer。|| |method|String|否|GET|有效值详见下方说明|| |timeout|Number|否|30000|超时时间,单位 ms|支付宝小程序| |dataType|String|否|json |如果设为 json,会尝试对返回的数据做一次 JSON.parse|| -|responseType|String|否|text |设置响应的数据类型。合法值:text、arraybuffer|5+App和支付宝小程序不支持| -|sslVerify|Boolean|否|true|验证 ssl 证书|仅5+App安卓端支持(HBuilderX 2.3.3+)| +|responseType|String|否|text |设置响应的数据类型。合法值:text、arraybuffer|App和支付宝小程序不支持| +|sslVerify|Boolean|否|true|验证 ssl 证书|仅App安卓端支持(HBuilderX 2.3.3+)| |success|Function|否||收到开发者服务成功返回的回调函数|| |fail|Function|否||接口调用失败的回调函数|| |complete|Function|否||接口调用结束的回调函数(调用成功、失败都会执行)| | @@ -23,7 +23,7 @@ 必须大写,有效值在不同平台差异说明不同。 -|method|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|method|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |GET|√|√|√|√|√|√| |POST|√|√|√|√|√|√| diff --git a/docs/api/router.md b/docs/api/router.md index 3cac888d66711aa2de90cd66cce6392f268da30a..5467f8ff7818534d5b0191adc0e9d412cc39a935 100644 --- a/docs/api/router.md +++ b/docs/api/router.md @@ -7,8 +7,8 @@ |参数|类型|必填|默认值|说明|平台差异说明| |:-|:-|:-|:-|:-|:-| |url|String|是||需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 'path?key=value&key2=value2',path为下一个页面的路径,下一个页面的onLoad函数可得到传递的参数|:-| -|animationType|String|否|pop-in|窗口显示的动画效果,详见:[窗口动画](api/router?id=animation)|5+App| -|animationDuration|Number|否|300|窗口动画持续时间,单位为 ms|5+App| +|animationType|String|否|pop-in|窗口显示的动画效果,详见:[窗口动画](api/router?id=animation)|App| +|animationDuration|Number|否|300|窗口动画持续时间,单位为 ms|App| |success|Function|否||接口调用成功的回调函数|| |fail|Function|否||接口调用失败的回调函数|| |complete|Function|否||接口调用结束的回调函数(调用成功、失败都会执行)| | @@ -145,8 +145,8 @@ uni.switchTab({ |参数|类型|必填|默认值|说明|平台差异说明| |:-|:-|:-|:-|:-|:-| |delta|Number|否|1|返回的页面数,如果 delta 大于现有页面数,则返回到首页。|| -|animationType|String|否|pop-out|窗口关闭的动画效果,详见:[窗口动画](api/router?id=animation)|5+App| -|animationDuration|Number|否|300|窗口关闭动画的持续时间,单位为 ms|5+App| +|animationType|String|否|pop-out|窗口关闭的动画效果,详见:[窗口动画](api/router?id=animation)|App| +|animationDuration|Number|否|300|窗口关闭动画的持续时间,单位为 ms|App| **示例** diff --git a/docs/api/system/accelerometer.md b/docs/api/system/accelerometer.md index cfb50cfeacbee371cfd101fa6d2f4878d1ff7ae4..8e6734b1fae269cc8b9a3098cf23353efda92bfa 100644 --- a/docs/api/system/accelerometer.md +++ b/docs/api/system/accelerometer.md @@ -28,7 +28,7 @@ uni.onAccelerometerChange(function (res) { **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |√|√|√|x|√|√| diff --git a/docs/api/system/ble.md b/docs/api/system/ble.md index 04fe45ff7a01616a1ab294cef645b441b189a7da..f32e3067edfe1f363bf1f2d0f34876276c06d3fa 100644 --- a/docs/api/system/ble.md +++ b/docs/api/system/ble.md @@ -1,6 +1,6 @@ **低功耗蓝牙 API 平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|x|x|x| diff --git a/docs/api/system/bluetooth.md b/docs/api/system/bluetooth.md index 8aa4f2c74f62d9a4ee4ce17948d2cc316971a8bc..bdd8130d17e34245a5ab25323a188c8488c0fb4f 100644 --- a/docs/api/system/bluetooth.md +++ b/docs/api/system/bluetooth.md @@ -1,6 +1,6 @@ **蓝牙 API 平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|x|x|x| diff --git a/docs/api/system/brightness.md b/docs/api/system/brightness.md index 7a764e3b68e6dbc097abbf03592cd5264ffa3e9e..1cc3d93bf762798615bf98cbbee6856c3d91d23d 100644 --- a/docs/api/system/brightness.md +++ b/docs/api/system/brightness.md @@ -3,7 +3,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|x|√| @@ -32,7 +32,7 @@ uni.setScreenBrightness({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|x|√| @@ -65,7 +65,7 @@ uni.getScreenBrightness({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| diff --git a/docs/api/system/capture-screen.md b/docs/api/system/capture-screen.md index 17bdd4d6f637de499ebe1c370758a0de6cdd1cda..401cf8fc4dd30dcd2bec72f2c8c74794779ccb66 100644 --- a/docs/api/system/capture-screen.md +++ b/docs/api/system/capture-screen.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|√|√| diff --git a/docs/api/system/clipboard.md b/docs/api/system/clipboard.md index 5b8edb6862e9e53f5218bc31277e695a100f7534..ffa2d653d82b4e472e200670d788ceca267ed687 100644 --- a/docs/api/system/clipboard.md +++ b/docs/api/system/clipboard.md @@ -1,6 +1,6 @@ **剪贴板 API 平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| ### uni.setClipboardData(OBJECT) diff --git a/docs/api/system/compass.md b/docs/api/system/compass.md index 95c14152020069490580da970b90d682bfc032e8..938b435fded4694c05762316921edb2c36bd4dc2 100644 --- a/docs/api/system/compass.md +++ b/docs/api/system/compass.md @@ -23,7 +23,7 @@ uni.onCompassChange(function (res) { **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|√|√|x|√|√|√| diff --git a/docs/api/system/gyroscope.md b/docs/api/system/gyroscope.md index cbfb07941a24e4de5c71085cd05bc41c2aa4e260..566bb7adc3fad7ae608358f6361151d2f9e38c9b 100644 --- a/docs/api/system/gyroscope.md +++ b/docs/api/system/gyroscope.md @@ -6,7 +6,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|x|x| @@ -30,7 +30,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|x|x| @@ -47,7 +47,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|x|x| diff --git a/docs/api/system/ibeacon.md b/docs/api/system/ibeacon.md index bf6008048171be0fbb3b845ac28c7bd9b322837a..9cb26a16b036f0c92134c433b19f2c1af1cd1e3f 100644 --- a/docs/api/system/ibeacon.md +++ b/docs/api/system/ibeacon.md @@ -1,6 +1,6 @@ **iBeacon API 平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|x|x|x| diff --git a/docs/api/system/info.md b/docs/api/system/info.md index b9795f1a0fd1b89ea3cc9869fab26e379a813d73..bc2070c21b51e888ecfa1b85148aae17e526b0b6 100644 --- a/docs/api/system/info.md +++ b/docs/api/system/info.md @@ -13,15 +13,15 @@ |参数|说明|平台差异说明| |:-|:-|:-| -|brand|手机品牌|5+App、微信小程序、百度小程序、头条小程序、QQ小程序| +|brand|手机品牌|App、微信小程序、百度小程序、头条小程序、QQ小程序| |model|手机型号|| |pixelRatio|设备像素比|| |screenWidth|屏幕宽度|| |screenHeight|屏幕高度|| |windowWidth|可使用窗口宽度|| |windowHeight|可使用窗口高度|| -|windowTop|可使用窗口的顶部位置|5+App、H5| -|windowBottom|可使用窗口的底部位置|5+App、H5| +|windowTop|可使用窗口的顶部位置|App、H5| +|windowBottom|可使用窗口的底部位置|App、H5| |statusBarHeight|状态栏的高度|头条小程序不支持| |navigationBarHeight|导航栏的高度|百度小程序| |titleBarHeight|标题栏高度|支付宝小程序| @@ -50,7 +50,7 @@ |bluetoothEnabled | 蓝牙的系统开关 |微信小程序| |locationEnabled | 地理位置的系统开关 |微信小程序| |wifiEnabled | Wi-Fi 的系统开关 |微信小程序| -|safeArea|在竖屏正方向下的安全区域|5+App、H5、微信小程序| +|safeArea|在竖屏正方向下的安全区域|App、H5、微信小程序| **Tips** - 屏幕高度=状态栏高度+原生导航栏高度+可使用窗口高度+原生tabbar高度 @@ -92,15 +92,15 @@ uni.getSystemInfo({ |参数|说明|平台差异说明| |:-|:-|:-| -|brand|手机品牌|5+App、微信小程序、百度小程序、头条小程序、QQ小程序| +|brand|手机品牌|App、微信小程序、百度小程序、头条小程序、QQ小程序| |model|手机型号|| |pixelRatio|设备像素比|| |screenWidth|屏幕宽度|| |screenHeight|屏幕高度|| |windowWidth|可使用窗口宽度|| |windowHeight|可使用窗口高度|| -|windowTop|可使用窗口的顶部位置|5+App、H5| -|windowBottom|可使用窗口的底部位置|5+App、H5| +|windowTop|可使用窗口的顶部位置|App、H5| +|windowBottom|可使用窗口的底部位置|App、H5| |statusBarHeight|状态栏的高度|头条小程序不支持| |navigationBarHeight|导航栏的高度|百度小程序| |titleBarHeight|标题栏高度|支付宝小程序| @@ -129,7 +129,7 @@ uni.getSystemInfo({ |bluetoothEnabled | 蓝牙的系统开关 |微信小程序| |locationEnabled | 地理位置的系统开关 |微信小程序| |wifiEnabled | Wi-Fi 的系统开关 |微信小程序| -|safeArea|在竖屏正方向下的安全区域|5+App、H5、微信小程序| +|safeArea|在竖屏正方向下的安全区域|App、H5、微信小程序| **Tips** - 使用注意同上getSystemInfo @@ -192,7 +192,7 @@ Android10以上,部分国产手机支持OAID,详见[匿名设备标识符( 平台差异说明 -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√| diff --git a/docs/api/system/memory.md b/docs/api/system/memory.md index ef52f66f20061ecc5044f74428a06762bbfbd532..bf3790b43f6e121357fc798d202953c50eebc785 100644 --- a/docs/api/system/memory.md +++ b/docs/api/system/memory.md @@ -6,7 +6,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|√|√|x|√| diff --git a/docs/api/system/network.md b/docs/api/system/network.md index 661c8265d40ebc37aefb254c2a82186acf3aa8f1..e68978f116a03a9e3c3b50652dc01256f5cb2ec4 100644 --- a/docs/api/system/network.md +++ b/docs/api/system/network.md @@ -23,7 +23,7 @@ |2g|2g 网络|| |3g|3g 网络|| |4g|4g 网络|| -|ethernet|有线网络|5+App| +|ethernet|有线网络|App| |unknown|Android 下不常见的网络类型|| |none|无网络| | diff --git a/docs/api/ui/animation.md b/docs/api/ui/animation.md index b0b619a7e5fe941c5092de505fa45b1c826abe29..f193275932bee885588aae3099d0a43d64de8ca2 100644 --- a/docs/api/ui/animation.md +++ b/docs/api/ui/animation.md @@ -4,12 +4,12 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|HBuilderX 2.0.4+|√|√|√|√|√| +|√|HBuilderX 2.0.4+|√|√|√|√|√| -**注意:** -- export 方法每次调用后会清掉之前的动画操作 +**注意:** +- export 方法每次调用后会清掉之前的动画操作 - nvue 暂不支持 **OBJECT参数说明:** diff --git a/docs/api/ui/bgcolor.md b/docs/api/ui/bgcolor.md index 637b86a507682c414d0be8a3fe02cf478b4f9ca6..ff558416c3bc6d3c3b4ce90c8df0a2e42642954b 100644 --- a/docs/api/ui/bgcolor.md +++ b/docs/api/ui/bgcolor.md @@ -4,7 +4,7 @@ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|√| @@ -35,7 +35,7 @@ uni.setBackgroundColor({ **平台差异说明** -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |x|x|√|x|√|x|√| diff --git a/docs/api/ui/menuButton.md b/docs/api/ui/menuButton.md index e307b7325fcf9303024157a1d08ab2b67754def5..bd21f46891c986979b9e05c9b28d2fc4f70fe0f7 100644 --- a/docs/api/ui/menuButton.md +++ b/docs/api/ui/menuButton.md @@ -2,30 +2,30 @@ 在小程序平台,如果原生导航栏被隐藏,仍然在右上角会有一个悬浮按钮,微信下也被称为胶囊按钮。本API用于获取小程序下该菜单按钮的布局位置信息,方便开发者布局顶部内容时避开该按钮。 -坐标信息以屏幕左上角为原点。 - -**平台差异说明** - -|5+App |H5 |微信小程序 |支付宝小程序 |百度小程序 |头条小程序 |QQ小程序 | -|:-: |:-:|:-: |:-: |:-: |:-: |:-: | +坐标信息以屏幕左上角为原点。 + +**平台差异说明** + +|App |H5 |微信小程序 |支付宝小程序 |百度小程序 |头条小程序 |QQ小程序 | +|:-: |:-:|:-: |:-: |:-: |:-: |:-: | |x |x |√ |x |√ |√ |√ | - -**返回值说明** - -|属性 |类型 |说明 | -|width |number |宽度,单位:px | -|height |number |高度,单位:px | -|top |number |上边界坐标,单位:px | -|right |number |右边界坐标,单位:px | -|bottom |number |下边界坐标,单位:px | -|left |number |左边界坐标,单位:px | - -**示例** - -```javascript - let menuButtonInfo = uni.getMenuButtonBoundingClientRect() + +**返回值说明** + +|属性 |类型 |说明 | +|width |number |宽度,单位:px | +|height |number |高度,单位:px | +|top |number |上边界坐标,单位:px | +|right |number |右边界坐标,单位:px | +|bottom |number |下边界坐标,单位:px | +|left |number |左边界坐标,单位:px | + +**示例** + +```javascript + let menuButtonInfo = uni.getMenuButtonBoundingClientRect() ``` -**注意** +**注意** - 支付宝小程序:其逻辑与微信小程序不同,它提供了菜单点击后按钮的自定义功能,可以选择显示那些系统按钮,[规范详情](https://docs.alipay.com/mini/api/optionmenuitem) diff --git a/docs/api/ui/navigationbar.md b/docs/api/ui/navigationbar.md index c5170e027a7927c8e8dad4e0fe455ebccd1f06fc..4c4ebeb49b348fecdb582cb0f5765e69626d85ae 100644 --- a/docs/api/ui/navigationbar.md +++ b/docs/api/ui/navigationbar.md @@ -34,7 +34,7 @@ uni.setNavigationBarTitle({ |参数|类型|必填|说明|平台差异说明| |:-|:-|:-|:-|:-| -|frontColor|String|是|前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000|5+App、H5、微信小程序、百度小程序| +|frontColor|String|是|前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000|App、H5、微信小程序、百度小程序| |backgroundColor|String|是|背景颜色值,有效值为十六进制颜色|| |animation|Object|否|动画效果,{duration,timingFunc}|微信小程序、百度小程序| |success|Function|否|接口调用成功的回调函数|| diff --git a/docs/api/ui/window.md b/docs/api/ui/window.md index 4afd970cee0c186e56bba9ab88e931f7849a7e0a..23063b295f94698c9cdd76a354ae7077aef3465d 100644 --- a/docs/api/ui/window.md +++ b/docs/api/ui/window.md @@ -5,7 +5,7 @@ **平台差异说明** -|5+App|H5|微信小程序 |支付宝小程序|百度小程序|头条小程序|QQ小程序| +|App|H5|微信小程序 |支付宝小程序|百度小程序|头条小程序|QQ小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√(nvue不支持)|√|√|x|x|x|√| @@ -35,7 +35,7 @@ uni.onWindowResize((res) => { 平台差异说明 -|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| +|App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序| |:-:|:-:|:-:|:-:|:-:|:-:| |√|√|√|x|x|x| diff --git a/docs/api/window/window.md b/docs/api/window/window.md index 33599c0c62f17f6dc855265aac4547799d010085..8985cb2aa2520ba38786b69bd2fc71cb3764b672 100644 --- a/docs/api/window/window.md +++ b/docs/api/window/window.md @@ -9,7 +9,7 @@ |方法|描述|平台说明| |---|---|---| -|page.$getAppWebview()|获取当前页面的webview对象实例|5+App| +|page.$getAppWebview()|获取当前页面的webview对象实例|App| |page.route|获取当前页面的路由| | Tips: @@ -25,9 +25,9 @@ Tips: 但`uni-app`框架有自己的窗口管理机制,请不要自己创建和销毁webview,如有需求覆盖子窗体上去,请使用[原生子窗体subNvue](/api/window/subNVues)。 -**注意:此方法仅 5+app 支持** +**注意:此方法仅 App 支持** -**示例:** +**示例:** 获取当前页面 webview 的对象实例 ```javascript @@ -44,8 +44,8 @@ export default { // #endif } } -``` - +``` + 获取指定页面 webview 的对象实例 `getCurrentPages()`可以得到所有页面对象,然后根据数组,可以取指定的页面webview对象 diff --git a/docs/collocation/frame/window.md b/docs/collocation/frame/window.md index d51751e96ad15355f75f1900d75aadfc610f3a3a..0f9140d8c380ef3fa05a4e9cd9faa50eaf16a794 100644 --- a/docs/collocation/frame/window.md +++ b/docs/collocation/frame/window.md @@ -13,66 +13,66 @@ console.log(app.globalData) - 不要在定义于 `App()` 内的函数中,或调用 `App` 前调用 `getApp()` ,可以通过 `this.$scope` 获取对应的app实例 - 通过 `getApp()` 获取实例之后,不要私自调用生命周期函数。 - v3模式加速了首页`nvue`的启动速度,当在首页`nvue`中使用`getApp()`不一定可以获取真正的`App`对象。对此v3版本提供了`const app = getApp({allowDefault: true})`用来获取原始的`App`对象,可以用来在首页对`globalData`等初始化 - -### getCurrentPages() - -```getCurrentPages()``` 函数用于获取当前页面栈的实例,以数组形式按栈的顺序给出,第一个元素为首页,最后一个元素为当前页面。 - -**注意:** ``getCurrentPages()``仅用于展示页面栈的情况,请勿修改页面栈,以免造成页面状态错误。 - -每个页面实例的方法属性列表: - -|方法|描述|平台说明| -|---|---|---| -|page.$getAppWebview()|获取当前页面的webview对象实例|5+App| -|page.route|获取当前页面的路由| | - -Tips: -* ``navigateTo``, ``redirectTo`` 只能打开非 tabBar 页面。 -* ``switchTab`` 只能打开 ``tabBar`` 页面。 -* ``reLaunch`` 可以打开任意页面。 -* 页面底部的 ``tabBar`` 由页面决定,即只要是定义为 ``tabBar`` 的页面,底部都有 ``tabBar``。 -* 不能在 ```App.vue``` 里面进行页面跳转。 - -### $getAppWebview() - -```uni-app``` 在 ```getCurrentPages()```获得的页面里内置了一个方法 ```$getAppWebview()``` 可以得到当前webview的对象实例,从而实现对 webview 更强大的控制。在 html5Plus 中,plus.webview具有强大的控制能力,可参考:[WebviewObject](http://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject)。 - -但`uni-app`框架有自己的窗口管理机制,请不要自己创建和销毁webview,如有需求覆盖子窗体上去,请使用[原生子窗体subNvue](/api/window/subNVues)。 - -**注意:此方法仅 5+app 支持** - + +### getCurrentPages() + +```getCurrentPages()``` 函数用于获取当前页面栈的实例,以数组形式按栈的顺序给出,第一个元素为首页,最后一个元素为当前页面。 + +**注意:** ``getCurrentPages()``仅用于展示页面栈的情况,请勿修改页面栈,以免造成页面状态错误。 + +每个页面实例的方法属性列表: + +|方法|描述|平台说明| +|---|---|---| +|page.$getAppWebview()|获取当前页面的webview对象实例|App| +|page.route|获取当前页面的路由| | + +Tips: +* ``navigateTo``, ``redirectTo`` 只能打开非 tabBar 页面。 +* ``switchTab`` 只能打开 ``tabBar`` 页面。 +* ``reLaunch`` 可以打开任意页面。 +* 页面底部的 ``tabBar`` 由页面决定,即只要是定义为 ``tabBar`` 的页面,底部都有 ``tabBar``。 +* 不能在 ```App.vue``` 里面进行页面跳转。 + +### $getAppWebview() + +```uni-app``` 在 ```getCurrentPages()```获得的页面里内置了一个方法 ```$getAppWebview()``` 可以得到当前webview的对象实例,从而实现对 webview 更强大的控制。在 html5Plus 中,plus.webview具有强大的控制能力,可参考:[WebviewObject](http://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject)。 + +但`uni-app`框架有自己的窗口管理机制,请不要自己创建和销毁webview,如有需求覆盖子窗体上去,请使用[原生子窗体subNvue](/api/window/subNVues)。 + +**注意:此方法仅 App 支持** + **示例:** - -获取当前页面 webview 的对象实例 -```javascript -export default { - data() { - return { - title: 'Hello' - } - }, - onLoad() { - // #ifdef APP-PLUS - const currentWebview = this.$mp.page.$getAppWebview(); //此对象相当于html5plus里的plus.webview.currentWebview()。在uni-app里,直接使用plus.webview.currentWebview()无效 - currentWebview.setBounce({position:{top:'100px'},changeoffset:{top:'0px'}}); //动态重设bounce效果 - // #endif - } -} + +获取当前页面 webview 的对象实例 +```javascript +export default { + data() { + return { + title: 'Hello' + } + }, + onLoad() { + // #ifdef APP-PLUS + const currentWebview = this.$mp.page.$getAppWebview(); //此对象相当于html5plus里的plus.webview.currentWebview()。在uni-app里,直接使用plus.webview.currentWebview()无效 + currentWebview.setBounce({position:{top:'100px'},changeoffset:{top:'0px'}}); //动态重设bounce效果 + // #endif + } +} +``` + +获取指定页面 webview 的对象实例 + +`getCurrentPages()`可以得到所有页面对象,然后根据数组,可以取指定的页面webview对象 +```javascript +var pages = getCurrentPages(); +var page = pages[pages.length - 1]; +// #ifdef APP-PLUS +var currentWebview = page.$getAppWebview(); +console.log(currentWebview.id);//获得当前webview的id +console.log(currentWebview.isVisible());//查询当前webview是否可见 +); +// #endif ``` -获取指定页面 webview 的对象实例 - -`getCurrentPages()`可以得到所有页面对象,然后根据数组,可以取指定的页面webview对象 -```javascript -var pages = getCurrentPages(); -var page = pages[pages.length - 1]; -// #ifdef APP-PLUS -var currentWebview = page.$getAppWebview(); -console.log(currentWebview.id);//获得当前webview的id -console.log(currentWebview.isVisible());//查询当前webview是否可见 -); -// #endif -``` - uni-app自带的web-view组件,是页面中新插入的一个子webview。获取该对象的方法见:[https://ask.dcloud.net.cn/article/35036](https://ask.dcloud.net.cn/article/35036) \ No newline at end of file diff --git a/docs/collocation/manifest.md b/docs/collocation/manifest.md index 2de0fd67f153b21eeaed59e8a91fc7c67e6316ec..7ce0936c6ef4950b5b9eb1bc9b7b2d889f247764 100644 --- a/docs/collocation/manifest.md +++ b/docs/collocation/manifest.md @@ -12,7 +12,7 @@ |transformPx|Boolean|true|是否转换项目的px,为true时将px转换为rpx,为false时,px为传统的实际像素|| |networkTimeout|Object||网络超时时间,[详见](/collocation/manifest?id=networktimeout)|| |debug|Boolean|false|是否开启 debug 模式,开启后调试信息以 ``info`` 的形式给出,其信息有页面的注册,页面路由,数据更新,事件触发等|| -|app-plus|Object||[5+App 特有配置](/collocation/manifest?id=app-plus)|| +|app-plus|Object||[App 特有配置](/collocation/manifest?id=app-plus)|| |h5|Object||[H5 特有配置](/collocation/manifest?id=h5)|| |quickapp|Object||快应用特有配置,即将支持|| |mp-weixin|Object||[微信小程序特有配置](/collocation/manifest?id=mp-weixin)|| @@ -42,9 +42,9 @@ |属性|类型|说明|最低版本| |:-|:-|:-|:-| -|splashscreen|Object|5+App 启动界面信息,[详见](/collocation/manifest?id=splashscreen)|| +|splashscreen|Object|App 启动界面信息,[详见](/collocation/manifest?id=splashscreen)|| |modules|Object|权限模块,[详见](/collocation/manifest?id=modules)|| -|distribute|Object|5+App 发布信息,[详见](/collocation/manifest?id=distribute)|| +|distribute|Object|App 发布信息,[详见](/collocation/manifest?id=distribute)|| |usingComponents|Boolean|是否启用自定义组件模式,默认为false,[编译模式区别详情](https://ask.dcloud.net.cn/article/35843)|1.9.0+| |nvueCompiler|String|切换 nvue 编译模式,可选值,`weex` :老编译模式,`uni-app`: 新编译模式,默认为 `weex` 。[编译模式区别详情](http://ask.dcloud.net.cn/article/36074)|2.0.3+| |renderer|String|可不加载基于 webview 的运行框架,减少包体积、提升启动速度。可选值 `native`| App-nvue 2.2.0+| @@ -357,13 +357,13 @@ Tips:关于摇树优化(treeShaking)原理及优化结果,参考:[http |:- |:- |:- | |usingComponents |Boolean| 是否启用自定义组件模式,`v2.0+`,默认为false,[编译模式区别详情](https://ask.dcloud.net.cn/article/35843) | |component2 |Boolean| 是否启用 `component2` 编译,默认为false,[查看详情](https://docs.alipay.com/mini/framework/custom-component-overview) | -|axmlStrictCheck |Boolean| 是否启用 `axml` 严格语法检查,默认为false | -|enableParallelLoader |Boolean| 是否启用多进程编译,默认为false | -|enableDistFileMinify |Boolean| 是否压缩编译产物(仅在真机预览/真机调试时生效),默认为false | - -**注意** - -- 以上选项对应支付宝小程序内的`mini.project.json`,但是在支付宝小程序IDE启动的情况下中修改这个文件可能并不会生效,后续支付宝应该会修复这个问题 +|axmlStrictCheck |Boolean| 是否启用 `axml` 严格语法检查,默认为false | +|enableParallelLoader |Boolean| 是否启用多进程编译,默认为false | +|enableDistFileMinify |Boolean| 是否压缩编译产物(仅在真机预览/真机调试时生效),默认为false | + +**注意** + +- 以上选项对应支付宝小程序内的`mini.project.json`,但是在支付宝小程序IDE启动的情况下中修改这个文件可能并不会生效,后续支付宝应该会修复这个问题 ### mp-baidu @@ -431,19 +431,19 @@ mp-qq只支持自定义组件模式,不存在usingComponents配置 + 静态文件:分包下支持 static 等静态资源拷贝,即分包目录内放置的静态资源不会被打包到主包中,也不可在主包中使用 + js文件:当某个 js 仅被一个分包引用时,该 js 会被打包到该分包内,否则仍打到主包(即被主包引用,或被超过 1 个分包引用) + 自定义组件:若某个自定义组件仅被一个分包引用时,且未放入到分包内,编译时会输出提示信息 - + **分包内静态文件示例** - -``` + +``` "subPackages": [{ "root": "pages/sub", "pages": [{ "path": "index/index" }] -}] -``` - -以上面的分包为例,放在每个分包root对应目录下的静态文件会被打包到此分包内。 +}] +``` + +以上面的分包为例,放在每个分包root对应目录下的静态文件会被打包到此分包内。 ### 完整 manifest.json @@ -454,7 +454,7 @@ mp-qq只支持自定义组件模式,不存在usingComponents配置 "description": "应用描述", "versionName": "1.0.0", "versionCode": "100", - // app-plus 节点是 5+App 特有配置,推荐在 HBuilderX 的 manifest.json 可视化界面操作完成配置。 + // app-plus 节点是 App 特有配置,推荐在 HBuilderX 的 manifest.json 可视化界面操作完成配置。 "app-plus": { // HBuilderX->manifest.json->模块权限配置 "modules": { @@ -759,7 +759,7 @@ mp-qq只支持自定义组件模式,不存在usingComponents配置 } } ``` -更多配置相关的说明,请参考 [manifest.json文档说明](https://ask.dcloud.net.cn/article/94) 中的描述。可能节点的位置与普通的 5+App 有差异,请按照配置的名称进行对应。 +更多配置相关的说明,请参考 [manifest.json文档说明](https://ask.dcloud.net.cn/article/94) 中的描述。可能节点的位置与普通的 App 有差异,请按照配置的名称进行对应。 # FAQ Q:iOS 应用调用相机等权限时,弹出的提示语如何修改? diff --git a/docs/collocation/pages.md b/docs/collocation/pages.md index 437450c989f6b91576ac6a281afaef4e543269bb..f46c15d9ed0f7d87da14c7fea6b3b4312de63e8d 100644 --- a/docs/collocation/pages.md +++ b/docs/collocation/pages.md @@ -7,7 +7,7 @@ |属性|类型|必填|描述|平台兼容| |:-|:-|:-|:-|:-| |[globalStyle](/collocation/pages?id=globalstyle)|Object|否|设置默认页面的窗口表现|| -|[pages](/collocation/pages?id=pages)|Object Array|是|设置页面路径及窗口表现|| +|[pages](/collocation/pages?id=pages)|Object Array|是|设置页面路径及窗口表现|| |[easycom](/collocation/pages?id=easycom)|Object|否|组件自动引入规则|2.5.0+| |[tabBar](/collocation/pages?id=tabbar)|Object|否|设置底部 tab 的表现|| |[condition](/collocation/pages?id=condition)|Object|否|启动模式配置|| @@ -49,7 +49,7 @@ "backgroundColor": "#F8F8F8", "usingComponents":{ "collapse-tree-item":"/components/collapse-tree-item" - }, + }, "pageOrientation": "portrait"//横屏配置,全局屏幕旋转设置(仅 APP/微信/QQ小程序),支持 auto / portrait / landscape }, "tabBar": { @@ -80,9 +80,9 @@ "iconWidth": "24px", "backgroundImage": "static/image/midButton_backgroundImage.png" } - }, - "easycom": { - "uni-(.*)": "@/components/uni-$1/uni-$1.vue" + }, + "easycom": { + "uni-(.*)": "@/components/uni-$1/uni-$1.vue" } } ``` @@ -295,7 +295,7 @@ - 页面支持通过配置 navigationStyle为custom,或titleNView为false,来禁用原生导航栏。一旦禁用原生导航,请注意阅读[自定义导航注意事项](/collocation/pages?id=customnav)。 - `titleNView` 不能设置 `autoBackButton`、`homeButton`等属性 -- `titleNView` 的 `type` 值为 `transparent` 时,导航栏为滚动透明渐变导航栏,默认只有button,滚动后标题栏底色和title文字会渐变出现; `type` 为 `float` 时,导航栏为悬浮标题栏,此时页面内容上顶到了屏幕顶部,包括状态栏,但导航栏悬浮盖在页面上方,一般这种场景会同时设置导航栏的背景色为rgba半透明颜色。 +- `titleNView` 的 `type` 值为 `transparent` 时,导航栏为滚动透明渐变导航栏,默认只有button,滚动后标题栏底色和title文字会渐变出现; `type` 为 `float` 时,导航栏为悬浮标题栏,此时页面内容上顶到了屏幕顶部,包括状态栏,但导航栏悬浮盖在页面上方,一般这种场景会同时设置导航栏的背景色为rgba半透明颜色。 - `titleNView` 的 `type` 值为 `transparent` 时,App-nvue 2.4.4+ 支持 - 在 `titleNView` 配置 `buttons` 后,监听按钮的点击事件,vue 页面及 nvue 的uni-app编译模式参考:[onNavigationBarButtonTap](/frame?id=页面生命周期)、nvue 的weex编译模式参考:[uni.onNavigationBarButtonTap](/use-weex?id=onnavigationbarbuttontap) - 在 `titleNView` 配置 `searchInput` 后,相关的事件监听参考:[onNavigationBarSearchInputChanged 等](/frame?id=页面生命周期) @@ -658,23 +658,23 @@ h5 平台下拉刷新动画,只有 circle 类型。 ## FAQ - Q:如何取消原生导航栏?或自定义导航 - A:参考[导航栏开发指南](http://ask.dcloud.net.cn/article/34921) - -# easycom -自`2.5.0`版本开始uni-app支持在`pages.json`内使用`easycom`以正则匹配的方式自动引入组件。 - -**使用示例** - -``` + +# easycom +自`2.5.0`版本开始uni-app支持在`pages.json`内使用`easycom`以正则匹配的方式自动引入组件。 + +**使用示例** + +``` "easycom": { "uni-(.*)": "@/components/uni-$1/uni-$1.vue" -} -``` - -**说明** -- `easycom`方式引入的组件无需在页面内`import`,也不需要在`components`内声明,即可在任意页面使用 -- `easycom`方式引入组件不是全局引入,而是局部引入。例如在H5端只有加载相应页面才会加载使用的组件 -- 在组件名完全一致的情况下,`easycom`引入的优先级低于手动引入(区分连字符形式与驼峰形式) -- 考虑到编译速度,直接修改`easycom`不会触发重新编译,需要改动页面内容触发。 +} +``` + +**说明** +- `easycom`方式引入的组件无需在页面内`import`,也不需要在`components`内声明,即可在任意页面使用 +- `easycom`方式引入组件不是全局引入,而是局部引入。例如在H5端只有加载相应页面才会加载使用的组件 +- 在组件名完全一致的情况下,`easycom`引入的优先级低于手动引入(区分连字符形式与驼峰形式) +- 考虑到编译速度,直接修改`easycom`不会触发重新编译,需要改动页面内容触发。 # tabBar 如果应用是一个多 tab 应用,可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页。 @@ -708,7 +708,7 @@ h5 平台下拉刷新动画,只有 circle 类型。 |属性|类型|必填|说明| |:-|:-|:-|:-| |pagePath|String|是|页面路径,必须在 pages 中先定义| -|text|String|是|tab 上按钮文字,在 5+APP 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标| +|text|String|是|tab 上按钮文字,在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标| |iconPath|String|否|图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,当 postion 为 top 时,此参数无效,不支持网络图片,不支持字体图标| |selectedIconPath|String|否|选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 postion 为 top 时,此参数无效| @@ -779,7 +779,7 @@ midButton没有pagePath,需监听点击事件,自行处理点击后的行为 |path|String|是|启动页面路径| |query|String|否|启动参数,可在页面的 [onLoad](use?id=页面生命周期) 函数里获得| -**注意:** 在 5+App 里真机运行可直接打开配置的页面,微信开发者工具里需要手动改变编译模式,如下图: +**注意:** 在 App 里真机运行可直接打开配置的页面,微信开发者工具里需要手动改变编译模式,如下图:
条件编译写法 | 说明 |
---|---|
#ifdef APP-PLUS 需条件编译的代码 #endif | 仅出现在 5+App 平台下的代码 |
#ifndef H5 需条件编译的代码 #endif | 除了 H5 平台,其它平台均存在的代码 |
#ifdef H5 || MP-WEIXIN 需条件编译的代码 #endif | 仅在 H5 平台或微信小程序平台存在的代码 |
// #ifdef %PLATFORM%
-平台特有的API实现
-// #endif
-
-
-示例,如下代码仅在 5+App 下出现:
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-7.png)
-
-示例,如下代码不会在 H5 平台上出现:
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-6.png)
-
-除了支持单个平台的条件编译外,还支持**多平台**同时编译,使用 || 来分隔平台名称。
-
-示例,如下代码会在 5+App 和 H5 平台上出现:
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-5.png)
-
+## 条件编译
+
+条件编译是用特殊的注释作为标记,在编译时根据这些特殊的注释,将注释里面的代码编译到不同平台。
+
+**写法:**以 #ifdef 或 #ifndef 加 %PLATFORM% 开头,以 #endif 结尾。
+* #ifdef:if defined 仅在某平台存在
+* #ifndef:if not defined 除了某平台均存在
+* %PLATFORM%:平台名称
+
+条件编译写法 | 说明 |
---|---|
#ifdef APP-PLUS 需条件编译的代码 #endif | 仅出现在 App 平台下的代码 |
#ifndef H5 需条件编译的代码 #endif | 除了 H5 平台,其它平台均存在的代码 |
#ifdef H5 || MP-WEIXIN 需条件编译的代码 #endif | 仅在 H5 平台或微信小程序平台存在的代码 |
// #ifdef %PLATFORM%
+平台特有的API实现
+// #endif
+
+
+示例,如下代码仅在 App 下出现:
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-7.png)
+
+示例,如下代码不会在 H5 平台上出现:
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-6.png)
+
+除了支持单个平台的条件编译外,还支持**多平台**同时编译,使用 || 来分隔平台名称。
+
+示例,如下代码会在 App 和 H5 平台上出现:
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-5.png)
+
### 组件的条件编译
-<!-- #ifdef %PLATFORM% -->
-平台特有的组件
-<!-- #endif -->
-
+<!-- #ifdef %PLATFORM% -->
+平台特有的组件
+<!-- #endif -->
+
示例,如下广告组件仅会在微信小程序中出现:
-
-![uniapp](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-1.1.png)
-
-### 样式的条件编译
-/* #ifdef %PLATFORM% */
-平台特有样式
-/* #endif */
-
-**注意:** 样式的条件编译,无论是 css 还是 sass/scss/less/stylus 等预编译语言中,必须使用 `/*注释*/` 的写法。
-
-正确写法
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-2.png)
-
-错误写法
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-3.png)
-
-### pages.json 的条件编译
-下面的页面,只有运行至 5+App 时才会编译进去。
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-4.png)
-
-不同平台下的特有功能,以及小程序平台的分包,都可以通过 pages.json 的条件编译来更好地实现。这样,就不会在其它平台产生多余的资源,进而减小包体积。
-
-json的条件编译,如不同平台的key名称相同,cli项目下开发者自己安装的校验器会报错,需自行关闭这些校验器对json相同key的校验规则。如果使用HBuilderX的校验器,无需在意此问题,HBuilderX的语法校验器为此优化过。
-
-### static 目录的条件编译
-
-在不同平台,引用的静态资源可能也存在差异,通过 static 的的条件编译可以解决此问题,static 目录下新建不同平台的专有目录(目录名称同 `%PLATFORM%` 值域,但字母均为小写),专有目录下的静态资源只有在特定平台才会编译进去。
-
-如以下目录结构,``a.png`` 只有在微信小程序平台才会编译进去,``b.png`` 在所有平台都会被编译。
-
-
-
-┌─static
-│ ├─mp-weixin
-│ │ └─a.png
-│ └─b.png
-├─main.js
-├─App.vue
-├─manifest.json
-└─pages.json
-
-
-
-### 整体目录条件编译
-
-如果想把各平台的页面文件更彻底的分开,也可以在uni-app项目根目录创建`platforms`目录,然后在下面进一步创建APP-PLUS、MP-WEIXIN等子目录,存放不同平台的文件。
-
-### HBuilderX 支持
-
-HBuilderX 为 ``uni-app`` 的条件编译提供了丰富的支持:
-
-**代码块支持**
-
-在 HBuilderX 中开发 ``uni-app`` 时,通过输入 **ifdef** 可快速生成条件编译的代码片段
-
- ![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni-022402.png)
-
-**语法高亮**
-
-在 HBuilderX 中对条件编译的代码注释部分提供了语法高亮,可分辨出写法是否正确,使得代码更加清晰(独立js文件需在编辑器右下角切换javascript es6+编辑器,独立css文件暂不支持高亮,但不高亮不影响使用)
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni-012403.png)
-
-
-**正确注释和快速选中**
-
-在 HBuilderX 中,ctrl+alt+/ 即可生成正确注释(js:``// 注释``、css:``/* 注释 */``、vue/nvue模板: ````)。
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni2019012801.png)
-
-点击 **ifdef** 或 **endif** 可快速选中条件编译部分;点击左侧的折叠图标,可折叠条件编译部分代码。
-
-![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni-012501.png)
-
-
-
-### 注意
-* Android 和 iOS 平台不支持通过条件编译来区分,如果需要区分 Android、iOS 平台,请通过调用 uni.getSystemInfo 来获取平台信息。在HBuilderX1.9.10起,支持`ifios`、`ifAndroid`代码块,可方便编写判断。
-* 有些跨端工具可以提供js的条件编译或多态,但这对于实际开发远远不够。uni-app不止是处理js,任何代码都可以多端条件编译,才能真正解决实际项目的跨端问题。另外所谓多态在实际开发中会造成大量冗余代码,很不利于复用和维护。举例,微信小程序主题色是绿色,而百度支付宝小程序是蓝色,你的应用想分平台适配颜色,只有条件编译是代码量最低、最容易维护的。
+
+![uniapp](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-1.1.png)
+
+### 样式的条件编译
+/* #ifdef %PLATFORM% */
+平台特有样式
+/* #endif */
+
+**注意:** 样式的条件编译,无论是 css 还是 sass/scss/less/stylus 等预编译语言中,必须使用 `/*注释*/` 的写法。
+
+正确写法
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-2.png)
+
+错误写法
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-3.png)
+
+### pages.json 的条件编译
+下面的页面,只有运行至 App 时才会编译进去。
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/img/platform-4.png)
+
+不同平台下的特有功能,以及小程序平台的分包,都可以通过 pages.json 的条件编译来更好地实现。这样,就不会在其它平台产生多余的资源,进而减小包体积。
+
+json的条件编译,如不同平台的key名称相同,cli项目下开发者自己安装的校验器会报错,需自行关闭这些校验器对json相同key的校验规则。如果使用HBuilderX的校验器,无需在意此问题,HBuilderX的语法校验器为此优化过。
+
+### static 目录的条件编译
+
+在不同平台,引用的静态资源可能也存在差异,通过 static 的的条件编译可以解决此问题,static 目录下新建不同平台的专有目录(目录名称同 `%PLATFORM%` 值域,但字母均为小写),专有目录下的静态资源只有在特定平台才会编译进去。
+
+如以下目录结构,``a.png`` 只有在微信小程序平台才会编译进去,``b.png`` 在所有平台都会被编译。
+
+
+
+┌─static
+│ ├─mp-weixin
+│ │ └─a.png
+│ └─b.png
+├─main.js
+├─App.vue
+├─manifest.json
+└─pages.json
+
+
+
+### 整体目录条件编译
+
+如果想把各平台的页面文件更彻底的分开,也可以在uni-app项目根目录创建`platforms`目录,然后在下面进一步创建APP-PLUS、MP-WEIXIN等子目录,存放不同平台的文件。
+
+### HBuilderX 支持
+
+HBuilderX 为 ``uni-app`` 的条件编译提供了丰富的支持:
+
+**代码块支持**
+
+在 HBuilderX 中开发 ``uni-app`` 时,通过输入 **ifdef** 可快速生成条件编译的代码片段
+
+ ![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni-022402.png)
+
+**语法高亮**
+
+在 HBuilderX 中对条件编译的代码注释部分提供了语法高亮,可分辨出写法是否正确,使得代码更加清晰(独立js文件需在编辑器右下角切换javascript es6+编辑器,独立css文件暂不支持高亮,但不高亮不影响使用)
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni-012403.png)
+
+
+**正确注释和快速选中**
+
+在 HBuilderX 中,ctrl+alt+/ 即可生成正确注释(js:``// 注释``、css:``/* 注释 */``、vue/nvue模板: ````)。
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni2019012801.png)
+
+点击 **ifdef** 或 **endif** 可快速选中条件编译部分;点击左侧的折叠图标,可折叠条件编译部分代码。
+
+![](https://img-cdn-qiniu.dcloud.net.cn/uniapp/doc/uni-012501.png)
+
+
+
+### 注意
+* Android 和 iOS 平台不支持通过条件编译来区分,如果需要区分 Android、iOS 平台,请通过调用 uni.getSystemInfo 来获取平台信息。在HBuilderX1.9.10起,支持`ifios`、`ifAndroid`代码块,可方便编写判断。
+* 有些跨端工具可以提供js的条件编译或多态,但这对于实际开发远远不够。uni-app不止是处理js,任何代码都可以多端条件编译,才能真正解决实际项目的跨端问题。另外所谓多态在实际开发中会造成大量冗余代码,很不利于复用和维护。举例,微信小程序主题色是绿色,而百度支付宝小程序是蓝色,你的应用想分平台适配颜色,只有条件编译是代码量最低、最容易维护的。
* 有些公司的产品运营总是给不同平台提不同需求,但这不是拒绝uni-app的理由。关键在于项目里,复用的代码多还是个性的代码多,正常都是复用的代码多,所以仍然应该多端。而个性的代码放到不同平台的目录下,差异化维护。
\ No newline at end of file
diff --git a/docs/select.md b/docs/select.md
index 8c7e2cb8e29eb3afde3d8a4c8f6b57273a9771fb..43102eeb34f05440983f9e7be2bc98cc70efce40 100644
--- a/docs/select.md
+++ b/docs/select.md
@@ -8,7 +8,7 @@
**uni-app收费吗?**
-```uni-app``` 是免费并且属于Apache2.0开源协议的产品。DCloud官方承诺永远不会变更开源协议。无论HBuilderX、uni-app、5+app,面向中国人永久免费。大家可以放心使用。
+```uni-app``` 是免费并且属于Apache2.0开源协议的产品。DCloud官方承诺永远不会变更开源协议。无论HBuilderX、uni-app、App,面向中国人永久免费。大家可以放心使用。
DCloud的盈利方式在帮助开发者进行推广和流量变现上,而不在开发工具收费上。
diff --git a/docs/snippet.md b/docs/snippet.md
index 84b4d243f17a178a6a01958a655fa38e73d067c0..cfe31219b4bfdeb1a862e72f036e571a444ef8f9 100644
--- a/docs/snippet.md
+++ b/docs/snippet.md
@@ -173,7 +173,7 @@ Tip
- 常用的开发模式就是`pc`上使用内置浏览器预览调dom,运行到真机上看`console.log`。如果是很复杂的问题才使用`debug`。
- vue页面也可以在微信开发者工具里调试,除了plus API,其他是一样的,微信开发者工具的查看`Dom`和网络和存储等调试工具相对而言更完善些。
注意:即使不发布微信小程序、只发布`App`,也需要安装微信开发者工具。
-- uni-app的App端没有5+App那种webkit remote debug,因为uni-app的js不是运行在webview里,而是独立的jscore里。
+- uni-app的App端没有App那种webkit remote debug,因为uni-app的js不是运行在webview里,而是独立的jscore里。
- 部分manifest配置,如三方sdk配置,需要打包后生效的,可以打包一个自定义运行基座。打包自定义基座后运行这个自定义基座,同样可以真机运行和debug。打包正式包将无法真机运行和debug。
diff --git a/examples/uniapp-one/manifest.json b/examples/uniapp-one/manifest.json
index 44bf2de946bded2b4432641c9222feac23a10086..623ecd0beb74bc2c19c906e54dee51a2a8925ce9 100644
--- a/examples/uniapp-one/manifest.json
+++ b/examples/uniapp-one/manifest.json
@@ -4,7 +4,7 @@
"description" : "A uni-app project",
"versionName" : "1.0.0",
"versionCode" : "100",
- "app-plus" : {/* 5+App特有相关 */
+ "app-plus" : {/* App特有相关 */
"modules" : {/* 模块配置 */
},
diff --git a/examples/wxcomponents-template/manifest.json b/examples/wxcomponents-template/manifest.json
index f098ca4fcba18ad213fbd319c428b86f5a3fc205..aaa7982d3372c98519235d28c9683547117ea411 100644
--- a/examples/wxcomponents-template/manifest.json
+++ b/examples/wxcomponents-template/manifest.json
@@ -5,7 +5,7 @@
"versionName": "1.0.0",
"versionCode": "100",
"transformPx":false,
- "app-plus": { /* 5+App特有相关 */
+ "app-plus": { /* App特有相关 */
"modules": { /* 模块配置 */
},
@@ -52,4 +52,4 @@
"urlCheck" : true
}
}
-}
+}