diff --git a/docs/component/ad-content-page.md b/docs/component/ad-content-page.md index fcd886823d6b05b9c30920f9a072cb9185805122..01d045037c84e48261b99f5d621229e92c6f48ff 100644 --- a/docs/component/ad-content-page.md +++ b/docs/component/ad-content-page.md @@ -8,9 +8,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√(3.1.17)|x|x|x|x|x|x|x|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√(3.1.17)|x|x|x|x|x|x|x|x|x| **仅Android nvue支持** diff --git a/docs/component/ad-draw.md b/docs/component/ad-draw.md index 1e5040d4c8d21224fe998d74ca8529cfcc7d2f33..127df22675713cdacd5811311fc02ec2274da23f 100644 --- a/docs/component/ad-draw.md +++ b/docs/component/ad-draw.md @@ -18,9 +18,9 @@ **平台差异说明** -|App-nvue|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√（3.0.0+）|x|x|x|x|x|x|x|x| +|App-nvue|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√（3.0.0+）|x|x|x|x|x|x|x|x|x| **开通配置广告** diff --git a/docs/component/ad-grid.md b/docs/component/ad-grid.md index 9d0957e771bd15127cdf67b9e857bd7e5d11a8e9..97d8f1cb216f5cb26a99fa8d6a306d448979a473 100644 --- a/docs/component/ad-grid.md +++ b/docs/component/ad-grid.md @@ -6,9 +6,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|x|x|√|x|x|x|x|x|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|x|x|√|x|x|x|x|x|x|x| **开通配置广告** diff --git a/docs/component/ad.md b/docs/component/ad.md index 9b02cddc788d91cd6e71dca77fea492312f44b5b..4b02db9c88e396f942b751eff705b3da12d22e70 100644 --- a/docs/component/ad.md +++ b/docs/component/ad.md @@ -17,9 +17,9 @@ banner或信息流广告展现场景非常灵活，常见的展现场景为： **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√（2.5.2+）|√（3.1.22+）|√|x|√|√|√|x|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√（2.5.2+）|√（3.1.22+）|√|x|√|√|√|x|x|√| **开通配置广告** @@ -42,7 +42,7 @@ banner或信息流广告展现场景非常灵活，常见的展现场景为： |adpid|String||uni-AD App广告位id，在[uni-AD官网](https://uniad.dcloud.net.cn/)申请广告位|App| |adpid-widescreen|String||同`adpid`, 一般用于大屏幕生效，当组件的宽度大于 750px 时生效，可以自定义生效的范围，参见 `widescreen-width`|H5| |widescreen-width|number|750|`widescreen` 自定义组件生效宽度|H5| -|unit-id|String||广告单元id，可在小程序管理后台的流量主模块新建|微信小程序、字节跳动小程序(最低版本1.19.0+)、QQ小程序| +|unit-id|String||广告单元id，可在小程序管理后台的流量主模块新建|微信小程序、字节跳动小程序(最低版本1.19.0+)、QQ小程序、快手小程序| |ad-intervals|number||广告自动刷新的间隔时间，单位为秒，参数值必须大于等于30（该参数不传入时 Banner 广告不会自动刷新）|微信小程序(基础库2.3.1+)| |appid|String||小程序应用 ID|百度小程序| |apid|String||小程序广告位 ID|百度小程序| @@ -50,7 +50,7 @@ banner或信息流广告展现场景非常灵活，常见的展现场景为： |ad-top|Number||type为feeds时广告上边距（px），必须大于0|QQ小程序| |ad-width|Number||type为feeds时广告宽度（px），默认100%，最大值为屏幕宽度，最小值为265|QQ小程序| |ad-height|Number||type为feeds时广告高度（px），最小85，最大160|QQ小程序| -|type|String|feed||QQ小程序、百度小程序、字节跳动小程序| +|type|String|feed||QQ小程序、百度小程序、字节跳动小程序、快手小程序| |@load|EventHandle||广告加载成功的回调|| |@error|EventHandle||广告加载失败的回调，event.detail = {errCode: }|| |@close|EventHandle||广告关闭的回调|| diff --git a/docs/component/audio.md b/docs/component/audio.md index 704e18941e9737a957c39d55fc8d94eb073f0bfd..3c2c43699a792d2541e13826275e1c5455cccfc7 100644 --- a/docs/component/audio.md +++ b/docs/component/audio.md @@ -3,9 +3,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|x|√|x|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|x|√|x|x|x| **注意：** 微信小程序平台自基础库 1.6.0 版本开始，不再维护 audio 组件，推荐使用API方式而不是组件方式来播放音频。API见 [uni.createInnerAudioContext](/api/media/audio-context?id=createinneraudiocontext) 替代。 diff --git a/docs/component/button.md b/docs/component/button.md index aaf4213ae5b763189fe628b67bd957fc7fed0114..3299b030ef955f53c1726f69a0ac71c440d1d05a 100644 --- a/docs/component/button.md +++ b/docs/component/button.md @@ -60,10 +60,10 @@ |值|说明|平台差异说明| |:-|:-|:-| |feedback|打开“意见反馈”页面，用户可提交反馈内容并上传日志|App、微信小程序、QQ小程序| -|share|触发用户转发|微信小程序、百度小程序、支付宝小程序、字节跳动小程序、QQ小程序| -|getUserInfo|获取用户信息，可以从@getuserinfo回调中获取到用户信息，包括头像、昵称等信息|微信小程序、百度小程序、QQ小程序| +|share|触发用户转发|微信小程序、百度小程序、支付宝小程序、字节跳动小程序、QQ小程序、快手小程序 | +|getUserInfo|获取用户信息，可以从@getuserinfo回调中获取到用户信息，包括头像、昵称等信息|微信小程序、百度小程序、QQ小程序、快手小程序 | |contact | 打开客服会话，如果用户在会话中点击消息卡片后返回应用，可以从 @contact 回调中获得具体信息 |微信小程序、百度小程序| -|getPhoneNumber | 获取用户手机号，可以从@getphonenumber回调中获取到用户信息|微信小程序、百度小程序、字节跳动小程序、支付宝小程序。App平台另见[一键登陆](https://uniapp.dcloud.net.cn/univerify) | +|getPhoneNumber | 获取用户手机号，可以从@getphonenumber回调中获取到用户信息|微信小程序、百度小程序、字节跳动小程序、支付宝小程序、快手小程序。App平台另见[一键登陆](https://uniapp.dcloud.net.cn/univerify) | |launchApp | 小程序中打开APP，可以通过app-parameter属性设定向APP传的参数|[微信小程序](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html)、[QQ小程序](https://q.qq.com/wiki/develop/miniprogram/frame/open_ability/open_app.html)| |openSetting | 打开授权设置页 |微信小程序、百度小程序| |getAuthorize | 支持小程序授权 | 支付宝小程序 | diff --git a/docs/component/camera.md b/docs/component/camera.md index e7bba265840c4b546204898cf9ef0a51110a423a..1ff462649c6b905e3e97993060255a4c6d7ebaa5 100644 --- a/docs/component/camera.md +++ b/docs/component/camera.md @@ -3,9 +3,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|x|x|√|x|√|x|√|√|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|x|x|√|x|√|x|√|√|x|√| * 在 App 和 H5 端，可以使用API方式来调用全屏摄像头，而不是组件内嵌方式，详见：[uni.chooseImage](/api/media/image?id=chooseimage) 和 [uni.chooseVideo](/api/media/video?id=choosevideo) * * 如开发身份证扫描、银行卡识别等ocr识别需求，在微信小程序和百度小程序中使用本camera组件，将图片发送给服务器识别，插件市场有封装好的[模板](https://ext.dcloud.net.cn/search?q=%E5%B0%8F%E7%A8%8B%E5%BA%8F%E7%9B%B8%E6%9C%BA)；在App端使用[原生插件](https://ext.dcloud.net.cn/search?q=ocr) @@ -21,8 +21,8 @@ |device-position|String |back |前置或后置摄像头，值为front, back| | |flash |String |auto |闪光灯，值为auto, on, off| | |frame-size|string|medium|指定期望的相机帧数据尺寸|微信小程序2.7.0、快应用| -|@stop |EventHandle | |摄像头在非正常终止时触发，如退出后台等情况| | -|@error |EventHandle | |用户不允许使用摄像头时触发| | +|@stop |EventHandle | |摄像头在非正常终止时触发，如退出后台等情况| 快手小程序不支持 | +|@error |EventHandle | |用户不允许使用摄像头时触发| 快手小程序不支持 | |@initdone|eventhandle||相机初始化完成时触发，e.detail = {maxZoom}|微信小程序2.7.0| |@scancode |EventHandle | |在扫码识别成功时触发，仅在 mode="scanCode" 时生效|微信小程序 | diff --git a/docs/component/cover-view.md b/docs/component/cover-view.md index 31d1e373f6c9b8ac8b8bf2a8fe80851d24055585..e05d4b4c78c6c8bee39b962744b521910ac70adc 100644 --- a/docs/component/cover-view.md +++ b/docs/component/cover-view.md @@ -6,9 +6,9 @@ app-vue和小程序框架，渲染引擎是webview的。但为了优化体验， **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|√|√|x|√|√|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|√|√|x|√|√|x|√| * app-nvue所有组件均为原生渲染，不存在前端组件无法覆盖原生组件的问题。但为了保持多端兼容，nvue里也实现了`cover-view`，作用于普通`view`一样。 * 微信小程序部分原生组件实现了同层渲染，在指定的基础库版本上，某些原生组件可无需使用`cover-view`覆盖，[详见](https://developers.weixin.qq.com/miniprogram/dev/component/native-component.html) @@ -27,15 +27,15 @@ app-vue和小程序框架，渲染引擎是webview的。但为了优化体验， **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|√|√|x|√|√|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|√|√|x|√|√|x|√| **属性说明** |属性名|类型|默认值|说明|平台差异说明| |:-|:-|:-|:-|:-| -|src|String||图标路径。支持本地路径、网络路径。不支持 base64 格式。| +|src|String||图标路径。支持本地路径、网络路径。不支持 base64 格式。|| |@load|eventhandle||图片加载成功时触发|微信小程序 2.1.0| |@error|eventhandle||图片加载失败时触发|微信小程序 2.1.0| diff --git a/docs/component/editor.md b/docs/component/editor.md index 57408eb5332d7facd59b77aee9de4a336eaa5bf4..0b4135193c7a67188da6c635f5e47b1471fb4d05 100644 --- a/docs/component/editor.md +++ b/docs/component/editor.md @@ -16,9 +16,9 @@ **平台差异说明** -|App |H5 |微信小程序 |支付宝小程序|百度小程序 |字节跳动小程序|QQ小程序 |快应用 |360小程序| -|:-: |:-: |:-: |:-: |:-: |:-: |:-: |:-: |:-: | -|2.0+，app-vue|2.4.5+ |基础库 2.7.0+|x |需引入动态库[引入方式](/api/media/editor-context) |x |x |x |x | +|App |H5 |微信小程序 |支付宝小程序|百度小程序 |字节跳动小程序|QQ小程序 |快应用 |360小程序|快手小程序 | +|:-: |:-: |:-: |:-: |:-: |:-: |:-: |:-: |:-: |:-: | +|2.0+，app-vue|2.4.5+ |基础库 2.7.0+|x |需引入动态库[引入方式](/api/media/editor-context) |x |x |x |x |x | editor组件目前只有H5、App的vue页面、微信小程序、百度小程序支持，其他端平台自身未提供editor组件，只能使用web-view加载web页面，也可搜索[插件市场](https://ext.dcloud.net.cn/search?q=%E5%AF%8C%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91) 获取简单的markdown富文本编辑器 diff --git a/docs/component/icon.md b/docs/component/icon.md index 0a0b37c77aecf4b0545436062136b352dea36fb2..2ebf8e4f8f9414f868e84cdcf5343c34a2ebd905 100644 --- a/docs/component/icon.md +++ b/docs/component/icon.md @@ -4,9 +4,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√(2.2.3+)|√|√|√|√|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√(2.2.3+)|√|√|√|√|√|√|√|√| **Tips** diff --git a/docs/component/input.md b/docs/component/input.md index 81c75073179b93f41ce87bf4476f611d91f102b8..c6e6d8c4ee738371e4006773d2e76f9089162b79 100644 --- a/docs/component/input.md +++ b/docs/component/input.md @@ -17,7 +17,7 @@ |maxlength|Number|140|最大输入长度，设置为 -1 的时候不限制最大长度|| |cursor-spacing|Number|0|指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离|App、微信小程序、百度小程序、QQ小程序| |focus|Boolean|false|获取焦点。|在 H5 平台能否聚焦以及软键盘是否跟随弹出，取决于当前浏览器本身的实现。nvue 页面不支持，需使用组件的 focus()、blur() 方法控制焦点| -|confirm-type|String|done|设置键盘右下角按钮的文字，仅在 type="text" 时生效。|微信小程序、App、H5| +|confirm-type|String|done|设置键盘右下角按钮的文字，仅在 type="text" 时生效。|微信小程序、App、H5、快手小程序| |confirm-hold|Boolean|false|点击键盘右下角按钮时是否保持键盘不收起|App、微信小程序、支付宝小程序、百度小程序、QQ小程序| |cursor|Number||指定focus时的光标位置|| |selection-start|Number|-1|光标起始位置，自动聚集时有效，需与selection-end搭配使用|| @@ -27,8 +27,8 @@ |auto-blur|boolean|false|键盘收起时，是否自动失去焦点|App 3.0.0+| |@input|EventHandle||当键盘输入时，触发input事件，event.detail = {value}|差异见下方 Tips| |@focus|EventHandle||输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度|仅微信小程序、App（2.2.3+） 、QQ小程序支持 height| -|@blur|EventHandle||输入框失去焦点时触发，event.detail = {value: value}|| -|@confirm|EventHandle||点击完成按钮时触发，event.detail = {value: value}| | +|@blur|EventHandle||输入框失去焦点时触发，event.detail = {value: value}|快手小程序不支持| +|@confirm|EventHandle||点击完成按钮时触发，event.detail = {value: value}| 快手小程序不支持| |@keyboardheightchange|eventhandle||键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration}|微信小程序基础库2.7.0+、App 3.1.0+| **Tips** @@ -55,7 +55,7 @@ |:-|:-|:-| |text|文本输入键盘|| |number|数字输入键盘|均支持，App平台、H5平台 3.1.22 以下版本 vue 页面在 iOS 平台显示的键盘包含负数和小数。| -|idcard|身份证输入键盘|微信、支付宝、百度、QQ小程序| +|idcard|身份证输入键盘|微信、支付宝、百度、QQ小程序、快手小程序| |digit|带小数点的数字键盘|均支持，App平台、H5平台 vue 页面在 iOS 平台显示的键盘包含负数。| |tel|电话输入键盘|仅App的nvue页面支持| @@ -77,11 +77,11 @@ |值|说明|平台差异说明| |:-|:-|:-| -|send|右下角按钮为“发送”|微信、支付宝、百度小程序、app-nvue、app-vue和h5(2.9.9+，且要求设备webview内核Chrome81+、Safari13.7+)| +|send|右下角按钮为“发送”|微信、支付宝、百度小程序、快手小程序、app-nvue、app-vue和h5(2.9.9+，且要求设备webview内核Chrome81+、Safari13.7+)| |search|右下角按钮为“搜索”|| -|next|右下角按钮为“下一个”|微信、支付宝、百度小程序、app-nvue、app-vue和h5(2.9.9+，且要求设备webview内核Chrome81+、Safari13.7+)| +|next|右下角按钮为“下一个”|微信、支付宝、百度小程序、快手小程序、app-nvue、app-vue和h5(2.9.9+，且要求设备webview内核Chrome81+、Safari13.7+)| |go|右下角按钮为“前往”|| -|done|右下角按钮为“完成”|微信、支付宝、百度小程序、app-nvue、app-vue和h5(2.9.9+，且要求设备webview内核Chrome81+、Safari13.7+)| +|done|右下角按钮为“完成”|微信、支付宝、百度小程序、快手小程序、app-nvue、app-vue和h5(2.9.9+，且要求设备webview内核Chrome81+、Safari13.7+)| - App平台的nvue页面，如果是weex编译模式，需通过weex的api设置（weex模式已被淘汰） - App平台的vue页面及 H5平台 的弹出键盘使用的是浏览器控制的键盘，在Chrome81+、Safari13.7+之前，键盘右下角文字只能设置完成和搜索，从Chrome81+、Safari13.7+起支持设置发送、下一个。 diff --git a/docs/component/live-pusher.md b/docs/component/live-pusher.md index 02274f223a0c88d83271ef32de0a818ddd03df8a..ef4d2304dbdef4993f9160d9e5a1df866a337e22 100644 --- a/docs/component/live-pusher.md +++ b/docs/component/live-pusher.md @@ -4,9 +4,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√(仅nvue)|x|√|x|x|x|x|x|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√(仅nvue)|x|√|x|x|x|x|x|x|x|x| 如app平台的vue页面需要支持直播推流，需编写条件编译代码，使用 `plus.video.LivePusher`，[业务指南](https://ask.dcloud.net.cn/article/13416)、[规范文档](http://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusher)。还是推荐直接使用nvue里的`live-pusher`组件。 diff --git a/docs/component/map.md b/docs/component/map.md index 572eda3ad7283fe65516338ae4955dea3aae91b4..3699297e9e9b159aac2f108e28c023f28525697d 100644 --- a/docs/component/map.md +++ b/docs/component/map.md @@ -6,9 +6,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|√|√|1.63+|1.9.0+|√|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|√|√|1.63+|1.9.0+|√|x|x| **属性说明** diff --git a/docs/component/movable-view.md b/docs/component/movable-view.md index 18f56f1dd4b4a2933f708f3a581577a8e2817dd9..8037e6e46c8395a32a70589ed266f31b5abb3745 100644 --- a/docs/component/movable-view.md +++ b/docs/component/movable-view.md @@ -14,9 +14,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|√|√|x|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|√|√|x|√|√|√|√| **属性说明** @@ -36,9 +36,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|√|√|x|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|√|√|x|√|√|√|√| **属性说明** @@ -46,19 +46,19 @@ |:-|:-|:-|:-|:-| |direction|String|none|movable-view的移动方向，属性值有all、vertical、horizontal、none|| |inertia|Boolean|false|movable-view是否带有惯性|微信小程序、支付宝小程序、App、H5、百度小程序| -|out-of-bounds|Boolean|false|超过可移动区域后，movable-view是否还可以移动|微信小程序、支付宝小程序、App、H5、百度小程序| +|out-of-bounds|Boolean|false|超过可移动区域后，movable-view是否还可以移动|微信小程序、支付宝小程序、App、H5、百度小程序、快手小程序| |x|Number / String||定义x轴方向的偏移，如果x的值不在可移动范围内，会自动移动到可移动范围；改变x的值会触发动画|| |y|Number / String||定义y轴方向的偏移，如果y的值不在可移动范围内，会自动移动到可移动范围；改变y的值会触发动画|| |damping|Number|20|阻尼系数，用于控制x或y改变时的动画和过界回弹的动画，值越大移动越快|微信小程序、支付宝小程序、App、H5、百度小程序| |friction|Number|2|摩擦系数，用于控制惯性滑动的动画，值越大摩擦力越大，滑动越快停止；必须大于0，否则会被设置成默认值|微信小程序、支付宝小程序、App、H5、百度小程序| |disabled|Boolean|false|是否禁用|| -|scale|Boolean|false|是否支持双指缩放，默认缩放手势生效区域是在movable-view内|微信小程序、支付宝小程序、App、H5| -|scale-min|Number|0.5|定义缩放倍数最小值|微信小程序、支付宝小程序、App、H5| -|scale-max|Number|10|定义缩放倍数最大值|微信小程序、支付宝小程序、App、H5| -|scale-value|Number|1|定义缩放倍数，取值范围为 0.5 - 10|微信小程序、支付宝小程序、App、H5| -|animation|Boolean|true|是否使用动画|微信小程序、支付宝小程序、App、H5、百度小程序| +|scale|Boolean|false|是否支持双指缩放，默认缩放手势生效区域是在movable-view内|微信小程序、支付宝小程序、App、H5、快手小程序| +|scale-min|Number|0.5|定义缩放倍数最小值|微信小程序、支付宝小程序、App、H5、快手小程序| +|scale-max|Number|10|定义缩放倍数最大值|微信小程序、支付宝小程序、App、H5、快手小程序| +|scale-value|Number|1|定义缩放倍数，取值范围为 0.5 - 10|微信小程序、支付宝小程序、App、H5、快手小程序| +|animation|Boolean|true|是否使用动画|微信小程序、支付宝小程序、App、H5、百度小程序、快手小程序| |@change|EventHandle||拖动过程中触发的事件，event.detail = {x: x, y: y, source: source}，其中source表示产生移动的原因，值可为touch（拖动）、touch-out-of-bounds（超出移动范围）、out-of-bounds（超出移动范围后的回弹）、friction（惯性）和空字符串（setData）|| -|@scale|EventHandle||缩放过程中触发的事件，event.detail = {x: x, y: y, scale: scale}，|微信小程序、App、H5、百度小程序| +|@scale|EventHandle||缩放过程中触发的事件，event.detail = {x: x, y: y, scale: scale}，|微信小程序、App、H5、百度小程序、快手小程序| 除了基本事件外，movable-view提供了两个特殊事件 diff --git a/docs/component/navigation-bar.md b/docs/component/navigation-bar.md index 62e67e19b176cd1c5bc3aeff56c2d129822b1de4..ca08eb93ca6a8781d7c2d3ef4c7bfa1a5e2b0c69 100644 --- a/docs/component/navigation-bar.md +++ b/docs/component/navigation-bar.md @@ -4,9 +4,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√ 2.6.3+|2.6.3+|√ 2.9.0+|√|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√ 2.6.3+|2.6.3+|√ 2.9.0+|√|√|√|√|x| 从HBuilderX 2.9.3起，编译到所有平台均支持`navigation-bar`，但编译到微信时，受微信基础库版本限制；编译到其他平台不受平台版本限制。 diff --git a/docs/component/open-data.md b/docs/component/open-data.md index 0372cd49fc7b09c0832486ff5075661ba5521caa..fc5ed7abefd1d84236ff9cb7e352ced303feca62 100644 --- a/docs/component/open-data.md +++ b/docs/component/open-data.md @@ -4,9 +4,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|x|x|√|x|√|x|√|x|x| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快应用|360小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|x|x|√|x|√|x|√|x|x|x| **Tips** diff --git a/docs/component/page-meta.md b/docs/component/page-meta.md index a79cf523c76e474f4e220bbd945624d6d10e1f70..10cbb871615a067d04dcb08020878a6c82ccb760 100644 --- a/docs/component/page-meta.md +++ b/docs/component/page-meta.md @@ -10,9 +10,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√ 2.6.3+|2.6.3+|√ 2.9.0+|√|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√ 2.6.3+|2.6.3+|√ 2.9.0+|√|√|√|√|x| 从HBuilderX 2.6.3起，编译到所有平台均支持`page-meta`，但编译到微信时，受微信基础库版本限制；编译到其他平台不受平台版本限制。 diff --git a/docs/component/picker-view.md b/docs/component/picker-view.md index e1a0b18425221ea0aa4b21b8a0fcf37c4058917a..18775e43ecc7c6a877236e987728a250851271de 100644 --- a/docs/component/picker-view.md +++ b/docs/component/picker-view.md @@ -14,8 +14,8 @@ |mask-style|String|设置蒙层的样式|| |mask-class|String|设置蒙层的类名|app-nvue和字节跳动小程序不支持| |@change|EventHandle|当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 开始）| | -|@pickstart|eventhandle||当滚动选择开始时候触发事件|微信小程序2.3.1| -|@pickend|eventhandle||当滚动选择结束时候触发事件|微信小程序2.3.1| +|@pickstart|eventhandle||当滚动选择开始时候触发事件|微信小程序2.3.1、快手小程序| +|@pickend|eventhandle||当滚动选择结束时候触发事件|微信小程序2.3.1、快手小程序| **注意：**其中只可放置 `` 组件，其他节点不会显示。 diff --git a/docs/component/picker.md b/docs/component/picker.md index a77b6acdd5543aa795b9fe9cbb23e5ca6fa376d3..3894792bc24c354d9280e121a06f4b61d9e15b89 100644 --- a/docs/component/picker.md +++ b/docs/component/picker.md @@ -15,8 +15,8 @@ |value|Number|0|value 的值表示选择了 range 中的第几个（下标从 0 开始）|| |selector-type|String|auto|大屏时UI类型，支持 picker、select、auto，默认在 iPad 以 picker 样式展示而在 PC 以 select 样式展示|H5 2.9.9+| |@change|EventHandle||value 改变时触发 change 事件，event.detail = {value: value}|| -|disabled|Boolean|false|是否禁用|| -|@cancel|EventHandle||取消选择或点遮罩层收起 picker 时触发|| +|disabled|Boolean|false|是否禁用|快手小程序不支持| +|@cancel|EventHandle||取消选择或点遮罩层收起 picker 时触发|快手小程序不支持| - picker在各平台的实现是有UI差异的，有的平台如百度、支付宝小程序的Android端是从中间弹出的；有的平台支持循环滚动如百度小程序；有的平台没有取消按钮如App-iOS端。但均不影响功能使用。 @@ -26,9 +26,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序 -|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|vue支持，nvue自2.4起支持|√|√|x|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|vue支持，nvue自2.4起支持|√|√|x|√|√|√|√| 支付宝小程序 picker 组件不支持多列选择，可以使用 picker-view 组件替代。 @@ -41,8 +41,8 @@ |value|Array|[]|value 每一项的值表示选择了 range 对应项中的第几个（下标从 0 开始）| |@change|EventHandle||value 改变时触发 change 事件，event.detail = {value: value}| |@columnchange|EventHandle||某一列的值改变时触发 columnchange 事件，event.detail = {column: column, value: value}，column 的值表示改变了第几列（下标从0开始），value 的值表示变更值的下标| -|@cancel|EventHandle||取消选择时触发| -|disabled|Boolean|false|是否禁用| +|@cancel|EventHandle||取消选择时触发（快手小程序不支持）| +|disabled|Boolean|false|是否禁用（快手小程序不支持）| **bug & tips** - 由于 JavaScript 的限制 vue 不能观测如下方式设置 value：``this.value[0] = 0`` （[vue 注意事项](https://cn.vuejs.org/v2/guide/list.html#注意事项)），解决方式参考：[hello-uniapp 示例](https://github.com/dcloudio/hello-uniapp/commit/59264474172a591c865431d02a2a1e3583978827) @@ -54,9 +54,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|√|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|√|√|√|√|x| - 时间选择在App端调用的是os的原生时间选择控件，在不同平台有不同的ui表现 @@ -77,9 +77,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|√|√|√|√|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|√|√|√|√|√|√|√|x| 日期选择默认在App端和H5端（PC版Chrome以及PC版FireFox）调用的是os的原生日期选择控件，在不同平台有不同的ui表现，当配置fields参数后使用统一的展示方式。 @@ -109,9 +109,9 @@ **平台差异说明** -|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序| -|:-:|:-:|:-:|:-:|:-:|:-:|:-:| -|x|x|√|x|√|√|√| +|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序| +|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| +|x|x|√|x|√|√|√|x| - 小程序平台在引擎层面内置了省市区数据。但省市区包含大量数据，占用体积，并非所有应用都需要，且很多城市数据有自维护需求，所以在App和H5平台没有在前端内置这些数据。可以基于多列picker或picker-view，自行填充城市数据。插件市场有较多类似插件，[详见](https://ext.dcloud.net.cn/search?q=%E5%9F%8E%E5%B8%82%E9%80%89%E6%8B%A9)。注意基于多列picker方式的地区选择不能运行在支付宝小程序上，只有基于picker-view的可以全端运行。尤其推荐插件[uni-data-picker](https://ext.dcloud.net.cn/plugin?id=3796)，自带省市区的联网数据，自带懒加载。 @@ -120,8 +120,8 @@ |value|Array|[]|表示选中的省市区，默认选中每一列的第一个值| |custom-item|String||可为每一列的顶部添加一个自定义的项| |@change|EventHandle||value 改变时触发 change 事件，event.detail = {value: value}| -|@cancel|EventHandle||取消选择时触发| -|disabled|Boolean|false|是否禁用| +|@cancel|EventHandle||取消选择时触发（快手小程序不支持）| +|disabled|Boolean|false|是否禁用（快手小程序不支持）| **示例** [查看演示](https://hellouniapp.dcloud.net.cn/pages/component/picker/picker) diff --git a/docs/component/progress.md b/docs/component/progress.md index 09cd4ae23f750a27764806f04595476cb1daa86f..a58bfdbdbb5709417506f9e3cb7f193e6eedd431 100644 --- a/docs/component/progress.md +++ b/docs/component/progress.md @@ -7,14 +7,14 @@ |:- |:- |:- |:- |:- | |percent |Float |无 |百分比0~100 | | |show-info |Boolean |false |在进度条右侧显示百分比 | | -|border-radius|number/string|0|圆角大小|app-nvue、微信基础库2.3.1+、QQ小程序| +|border-radius|number/string|0|圆角大小|app-nvue、微信基础库2.3.1+、QQ小程序、快手小程序| |font-size|number/string|16|右侧百分比字体大小|app-nvue、微信基础库2.3.1+、QQ小程序| |stroke-width |Number |6 |进度条线的宽度，单位px | | |activeColor |Color |#09BB07（百度为#E6E6E6） |已选择的进度条的颜色 | | |backgroundColor|Color |#EBEBEB |未选择的进度条的颜色 | | |active |Boolean |false |进度条从左往右的动画 | | -|active-mode |String |backwards |backwards: 动画从头播；forwards：动画从上次结束点接着播|App、H5、微信小程序、QQ小程序 | -|duration|number|30|进度增加1%所需毫秒数|App-nvue2.6.1+、微信基础库2.8.2+、H5 3.1.11+| +|active-mode |String |backwards |backwards: 动画从头播；forwards：动画从上次结束点接着播|App、H5、微信小程序、QQ小程序、快手小程序 | +|duration|number|30|进度增加1%所需毫秒数|App-nvue2.6.1+、微信基础库2.8.2+、H5 3.1.11+、快手小程序| |@activeend |EventHandle| |动画完成事件 |微信小程序 | **示例** [查看演示](https://hellouniapp.dcloud.net.cn/pages/component/progress/progress) diff --git a/docs/component/rich-text.md b/docs/component/rich-text.md index a1c1e4360193bea330d9882b56be8aebfac2d474..f0272ce107d84ce5d5cc447e1335fb499f6d60ad 100644 --- a/docs/component/rich-text.md +++ b/docs/component/rich-text.md @@ -6,7 +6,7 @@ |属性名|类型|默认值|说明|平台兼容| |:-|:-|:-|:-|:-| |nodes|Array / String|[]|节点列表 / HTML String|| -|[space](https://developers.weixin.qq.com/miniprogram/dev/component/rich-text.html)|string||显示连续空格|微信基础库2.4.1+、QQ小程序| +|space|string||显示连续空格|微信基础库2.4.1+[详见](https://developers.weixin.qq.com/miniprogram/dev/component/rich-text.html)、QQ小程序、快手小程序[详见](https://mp.kuaishou.com/docs/develop/components/basicComponents/richText.html)| |selectable|Boolean|false|富文本是否可以长按选中，可用于复制，粘贴等场景|百度小程序（真机）| **注意** diff --git a/docs/component/swiper.md b/docs/component/swiper.md index 07588af81f040024c915e52750f59c71a839090c..8a894d699c9f2ef281a33b2347b2c530588747db 100644 --- a/docs/component/swiper.md +++ b/docs/component/swiper.md @@ -30,9 +30,9 @@ |skip-hidden-item-layout|Boolean|false|是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息|App、微信小程序| |disable-touch|Boolean|false|是否禁止用户 touch 操作|App 2.5.5+、H5 2.5.5+、支付宝小程序、字节跳动小程序（只在初始化时有效，不能动态变更）| |touchable|Boolean|true|是否监听用户的触摸事件，只在初始化时有效，不能动态变更|字节跳动小程序（uni-app 2.5.5+ 推荐统一使用 disable-touch）| -|easing-function|String|default|指定 swiper 切换缓动动画类型，有效值：default、linear、easeInCubic、easeOutCubic、easeInOutCubic|微信小程序| +|easing-function|String|default|指定 swiper 切换缓动动画类型，有效值：default、linear、easeInCubic、easeOutCubic、easeInOutCubic|微信小程序、快手小程序| |@change|EventHandle||current 改变时会触发 change 事件，event.detail = {current: current, source: source}|| -|@transition|EventHandle||swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy}，支付宝小程序暂不支持dx, dy|App、H5、微信小程序、支付宝小程序、字节跳动小程序、QQ小程序| +|@transition|EventHandle||swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy}，支付宝小程序暂不支持dx, dy|App、H5、微信小程序、支付宝小程序、字节跳动小程序、QQ小程序、快手小程序| |@animationfinish|EventHandle||动画结束时会触发 animationfinish 事件，event.detail = {current: current, source: source}|字节跳动小程序不支持| change 事件返回 detail 中包含一个 source 字段，表示导致变更的原因，可能值如下： diff --git a/docs/component/text.md b/docs/component/text.md index d80b1af2e9bf3a7547724335debfd4676fcd33eb..a7fc03ff035fdd0ce1b0d606a15e86d3b6c3b9f6 100644 --- a/docs/component/text.md +++ b/docs/component/text.md @@ -7,7 +7,7 @@ |属性名 |类型 |默认值 |说明 |平台差异说明 | |:-|:- |:- |:- |:- |:- | -|selectable |Boolean|false |文本是否可选 | App、H5 | +|selectable |Boolean|false |文本是否可选 | App、H5、快手小程序 | |user-select |Boolean|false |文本是否可选 | 微信小程序 | |space |String | |显示连续空格 |App、H5、微信小程序 | |decode |Boolean|false |是否解码 |App、H5、微信小程序 | diff --git a/docs/component/textarea.md b/docs/component/textarea.md index f4265c61d03024a72f3824b04ae30f64ee93b843..5b69760785f9fb53f8c27aeda6031aa8dec6cdf5 100644 --- a/docs/component/textarea.md +++ b/docs/component/textarea.md @@ -9,12 +9,12 @@ |value|String||输入框的内容|| |placeholder|String||输入框为空时占位符|| |placeholder-style|String||指定 placeholder 的样式|| -|placeholder-class|String|textarea-placeholder|指定 placeholder 的样式类，注意页面或组件的style中写了scoped时，需要在类名前写/deep/|字节跳动小程序不支持| +|placeholder-class|String|textarea-placeholder|指定 placeholder 的样式类，注意页面或组件的style中写了scoped时，需要在类名前写/deep/|字节跳动小程序、快手小程序不支持| |disabled|Boolean|false|是否禁用|| |maxlength|Number|140|最大输入长度，设置为 -1 的时候不限制最大长度|| |focus|Boolean|false|获取焦点|在 H5 平台能否聚焦以及软键盘是否跟随弹出，取决于当前浏览器本身的实现。nvue 页面不支持，需使用组件的 focus()、blur() 方法控制焦点| |auto-height|Boolean|false|是否自动增高，设置auto-height时，style.height不生效|| -|fixed|Boolean|false|如果 textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true|微信小程序、百度小程序、字节跳动小程序、QQ小程序| +|fixed|Boolean|false|如果 textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true|微信小程序、百度小程序、字节跳动小程序、QQ小程序、快手小程序| |cursor-spacing|Number|0|指定光标与键盘的距离，单位 px 。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离|App、微信小程序、百度小程序、字节跳动小程序、QQ小程序| |cursor|Number||指定focus时的光标位置|微信小程序、App、H5、百度小程序、字节跳动小程序、QQ小程序| |confirm-type|String|done|设置键盘右下角按钮的文字|微信小程序基础库2.13.0+、App-vue和H5(2.9.9+，且要求设备webview内核Chrome81+、Safari13.7+)| @@ -26,9 +26,9 @@ |hold-keyboard|boolean|false|focus时，点击页面的时候不收起键盘|微信小程序2.8.2| |auto-blur|boolean|false|键盘收起时，是否自动失去焦点|App-vue 3.0.0+ ，App-nvue不支持| |@focus|EventHandle||输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度|仅微信小程序、App（HBuilderX 2.0+ [nvue uni-app模式](http://ask.dcloud.net.cn/article/36074)） 、QQ小程序支持 height| -|@blur|EventHandle||输入框失去焦点时触发，event.detail = {value, cursor}|| -|@linechange|EventHandle||输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0}|字节跳动小程序不支持,nvue ios暂不支持| -|@input|EventHandle||当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上|| +|@blur|EventHandle||输入框失去焦点时触发，event.detail = {value, cursor}|快手小程序不支持| +|@linechange|EventHandle||输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0}|字节跳动小程序、快手小程序不支持,nvue ios暂不支持| +|@input|EventHandle||当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上|快手小程序不支持| |@confirm|EventHandle||点击完成时， 触发 confirm 事件，event.detail = {value: value}|微信小程序、百度小程序、QQ小程序| |@keyboardheightchange|Eventhandle||键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration}|微信小程序基础库2.7.0+、App 3.1.0+| diff --git a/docs/component/video.md b/docs/component/video.md index 3703174a49ec86c1fee28d9de004f4e6078fdb92..70d699628f60899b2404e7561612f923e629822d 100644 --- a/docs/component/video.md +++ b/docs/component/video.md @@ -10,14 +10,14 @@ |loop|Boolean|false|是否循环播放|| |muted|Boolean|false|是否静音播放|字节跳动小程序不支持| |initial-time|Number||指定视频初始播放位置，单位为秒（s）。|字节跳动小程序不支持| -|duration|Number||指定视频时长，单位为秒（s）。|字节跳动小程序不支持| -|controls|Boolean|true|是否显示默认播放控件（播放/暂停按钮、播放进度、时间）|| -|danmu-list|Object Array||弹幕列表|字节跳动小程序不支持| -|danmu-btn|Boolean|false|是否显示弹幕按钮，只在初始化时有效，不能动态变更|字节跳动小程序不支持| -|enable-danmu|Boolean|false|是否展示弹幕，只在初始化时有效，不能动态变更|字节跳动小程序不支持| +|duration|Number||指定视频时长，单位为秒（s）。|字节跳动小程序、快手小程序不支持| +|controls|Boolean|true|是否显示默认播放控件（播放/暂停按钮、播放进度、时间）|快手小程序不支持| +|danmu-list|Object Array||弹幕列表|字节跳动小程序、快手小程序不支持| +|danmu-btn|Boolean|false|是否显示弹幕按钮，只在初始化时有效，不能动态变更|字节跳动小程序、快手小程序不支持| +|enable-danmu|Boolean|false|是否展示弹幕，只在初始化时有效，不能动态变更|字节跳动小程序、快手小程序不支持| |page-gesture|Boolean|false|在非全屏模式下，是否开启亮度与音量调节手势|微信小程序、H5| -|direction|Number||设置全屏时视频的方向，不指定则根据宽高比自动判断。有效值为 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度）|H5和字节跳动小程序不支持| -|show-progress|Boolean|true|若不设置，宽度大于240时才会显示|字节跳动小程序不支持| +|direction|Number||设置全屏时视频的方向，不指定则根据宽高比自动判断。有效值为 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度）|H5和字节跳动小程序、快手小程序不支持| +|show-progress|Boolean|true|若不设置，宽度大于240时才会显示|字节跳动小程序、快手小程序不支持| |show-fullscreen-btn|Boolean|true|是否显示全屏按钮|| |show-play-btn|Boolean|true|是否显示视频底部控制栏的播放按钮|| |show-center-play-btn|Boolean|true|是否显示视频中间的播放按钮|字节跳动小程序不支持| @@ -28,11 +28,11 @@ |show-mute-btn|Boolean|false|是否显示静音按钮|微信小程序| |title|String||视频的标题，全屏时在顶部展示|微信小程序| |play-btn-position|String|bottom|播放按钮的位置|微信小程序、字节跳动小程序| -|enable-play-gesture|Boolean|false|是否开启播放手势，即双击切换播放/暂停|微信小程序| +|enable-play-gesture|Boolean|false|是否开启播放手势，即双击切换播放/暂停|微信小程序、快手小程序| |auto-pause-if-navigate|Boolean|true|当跳转到其它小程序页面时，是否自动暂停本页面的视频|微信小程序| |auto-pause-if-open-native|Boolean|true|当跳转到其它微信原生页面时，是否自动暂停本页面的视频|微信小程序| -|vslide-gesture|Boolean|false|在非全屏模式下，是否开启亮度与音量调节手势（同 page-gesture）|微信小程序| -|vslide-gesture-in-fullscreen|Boolean|true|在全屏模式下，是否开启亮度与音量调节手势|微信小程序| +|vslide-gesture|Boolean|false|在非全屏模式下，是否开启亮度与音量调节手势（同 page-gesture）|微信小程序、快手小程序| +|vslide-gesture-in-fullscreen|Boolean|true|在全屏模式下，是否开启亮度与音量调节手势|微信小程序、快手小程序| |ad-unit-id|String||视频前贴广告单元ID，更多详情可参考开放能力[视频前贴广告](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/ad/video-patch-ad.html)|微信小程序| |poster-for-crawler|String||用于给搜索等场景作为视频封面展示，建议使用无播放 icon 的视频封面图，只支持网络地址|微信小程序| |codec|String|hardware|解码器选择，hardware：硬解码（硬解码可以增加解码算力，提高视频清晰度。少部分老旧硬件可能存在兼容性问题）；software：ffmpeg 软解码；|App-Android 3.1.0+| @@ -44,7 +44,7 @@ |@ended|EventHandle||当播放到末尾时触发 ended 事件|字节跳动小程序不支持| |@timeupdate|EventHandle||播放进度变化时触发，event.detail = {currentTime, duration} 。触发频率 250ms 一次|字节跳动小程序不支持| |@fullscreenchange|EventHandle||当视频进入和退出全屏时触发，event.detail = {fullScreen, direction}，direction取为 vertical 或 horizontal|字节跳动小程序不支持| -|@waiting|EventHandle||视频出现缓冲时触发|字节跳动小程序不支持| +|@waiting|EventHandle||视频出现缓冲时触发|字节跳动小程序、快手小程序不支持| |@error|EventHandle||视频播放出错时触发|字节跳动小程序不支持| |@progress|EventHandle||加载进度变化时触发，只支持一段加载。event.detail = {buffered}，百分比|微信小程序、H5| |@loadedmetadata|EventHandle||视频元数据加载完成时触发。event.detail = {width, height, duration}|微信小程序、H5|