Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
2b0207aa
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3183
Star
105
Fork
807
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
69
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
69
合并请求
69
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
2b0207aa
编写于
9月 26, 2023
作者:
G
git_robot
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新 utsComJson.json
上级
7c1d8d8f
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
1 addition
and
1 deletion
+1
-1
docs/.vuepress/utils/utsComJson.json
docs/.vuepress/utils/utsComJson.json
+1
-1
未找到文件。
docs/.vuepress/utils/utsComJson.json
浏览文件 @
2b0207aa
{
"animation-view"
:{
"name"
:
"## animation-view"
,
"description"
:
"Lottie 动画"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| path | String | | 动画资源地址，目前只支持绝对路径 |
\n
| loop | Boolean | false | 动画是否循环播放 |
\n
| autoplay | Boolean | false | 动画是否自动播放 |
\n
| action | String | stop | 动画操作，可取值 play、pause、stop [action](#action-values) |
\n
| hidden | Boolean | false | 是否隐藏动画 |
\n
| @ended | Any | - | - |
\n\n
#### action @action-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| play | 播放 |
\n
| pause | 暂停 |
\n
| stop | 停止 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/animation-view)
\n
- [插件市场](https://ext.dcloud.net.cn/plugin?id=10674)
\n
"
},
"button"
:{
"name"
:
"## button"
,
"description"
:
"按钮"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| hover-class | ClassString | button-hover | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-start-time | Number | 20 | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | 70 | 手指松开后点击态保留时间，单位毫秒 |
\n
| size | String | default | 按钮的大小 [size](#size-values) |
\n
| type | String | default | 按钮的样式类型 [type](#type-values) |
\n
| plain | Boolean | false | 按钮是否镂空，背景色透明 |
\n\n
#### size @size-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| default | 默认大小 |
\n
| mini | 小尺寸 |
\n\n\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| default | 白色 |
\n
| primary | 蓝色 |
\n
| warn | 红色 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/button)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/button/button.uvue)
\n
"
},
"checkbox"
:{
"name"
:
"## checkbox"
,
"description"
:
"多选项。在1组check-group中可选择多个"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| value | String | - | checkbox 标识，选中时触发 checkbox-group 的 change 事件，并携带 checkbox 的 value |
\n
| checked | Boolean | false | 当前是否选中，可用来设置默认选中 |
\n
| color | ColorString | #007aff | checkbox的颜色 |
\n
| backgroundColor | ColorString | #ffffff | checkbox默认的背景颜色 |
\n
| borderColor | ColorString | #d1d1d1 | checkbox默认的边框颜色 |
\n
| activeBackgroundColor | ColorString | #ffffff | checkbox选中时的背景颜色 |
\n
| activeBorderColor | ColorString | #d1d1d1 | checkbox选中时的边框颜色 |
\n
| iconColor | ColorString | #007aff | checkbox的图标颜色，优先级大于color属性 |"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/checkbox/checkbox.uvue)
\n
"
},
"checkbox-group"
:{
"name"
:
"## checkbox-group"
,
"description"
:
"多项组，内部由多个checkbox组成"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| @change | (event: [CheckboxGroupChangeEvent](#checkboxgroupchangeevent)) => void | - | checkbox-group中选中项发生改变是触发 change 事件，detail = {value:[选中的checkbox的value的数组
\\
]} |"
,
"event"
:
"
\n
### 事件
\n
#### CheckboxGroupChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<string
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### CheckboxGroupChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<string
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<string
\\
> | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/checkbox-group/checkbox-group.uvue)
\n
"
},
"image"
:{
"name"
:
"## image"
,
"description"
:
"图片"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| src | ImageURIString | - | 图片资源地址 |
\n
| mode | String | scaleToFill | 图片裁剪、缩放的模式 [mode](#mode-values) |
\n
| fade-show | Boolean | false | 图片显示动画效果 |
\n
| @error | (event: [ImageErrorEvent](#imageerrorevent)) => void | - | 图片加载错误时触发，event.detail = { errMsg } |
\n
| @load | (event: [ImageLoadEvent](#imageloadevent)) => void | - | 图片加载完成时触发，event.detail = { width: '图片宽度px', height: '图片高度px' } |
\n\n
#### mode @mode-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| scaleToFill | 不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素 |
\n
| aspectFit | 保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。 |
\n
| aspectFill | 保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取 |
\n
| widthFix | 宽度不变，高度自动变化，保持原图宽高比不变 |
\n
| heightFix | 高度不变，宽度自动变化，保持原图宽高比不变 |
\n
| top | 不缩放图片，只显示图片的顶部区域 |
\n
| bottom | 不缩放图片，只显示图片的底部区域 |
\n
| center | 不缩放图片，只显示图片的中间区域 |
\n
| left | 不缩放图片，只显示图片的左边区域 |
\n
| right | 不缩放图片，只显示图片的右边区域 |
\n
| top left | 不缩放图片，只显示图片的左上边区域 |
\n
| top rigth | 不缩放图片，只显示图片的右上边区域 |
\n
| bottom left | 不缩放图片，只显示图片的左下边区域 |
\n
| bottom right | 不缩放图片，只显示图片的右下边区域 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### ImageErrorEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ImageErrorEventdetail](#imageerroreventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ImageErrorEventdetail 属性值 @imageerroreventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| errMsg | string | 是 | - | 错误信息 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ImageLoadEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ImageLoadEventdetail](#imageloadeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ImageLoadEventdetail 属性值 @imageloadeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| width | number | 是 | - | 图片宽度 |
\n
| height | number | 是 | - | 图片高度 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| image | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
| src | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| mode | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| fade-show | 5.0 | √ | 3.9.0 | 9.0 | x | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/image)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/image/image.uvue)
\n
"
},
"input"
:{
"name"
:
"## input"
,
"description"
:
"输入框"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| value | String | | 输入框的初始内容 |
\n
| type | String | text | input的类型 [type](#type-values) |
\n
| password | Boolean | false | 是否是密码类型 |
\n
| placeholder | String | | 输入框为空时占位符 |
\n
| placeholder-style | String | | 指定 placeholder 的样式 |
\n
| placeholder-class | String | | 指定 placeholder 的样式类 |
\n
| maxlength | Number | 140 | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| cursor-spacing | Number | 0 | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| auto-focus | Boolean | false | 自动获取焦点 |
\n
| focus | Boolean | false | 获取焦点 |
\n
| confirm-type | String | done | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| confirm-hold | Boolean | false | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| cursor | Number | 0 | 指定focus时的光标位置 |
\n
| selection-start | Number | -1 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | -1 | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | true | 键盘弹起时，是否自动上推页面 |
\n
| @input | (event: [InputEvent](#inputevent)) => void | - | 当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |
\n
| @focus | (event: [InputFocusEvent](#inputfocusevent)) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持 |
\n
| @blur | (event: [InputBlurEvent](#inputblurevent)) => void | - | 输入框失去焦点时触发，event.detail = {value: value} |
\n
| @keyboardheightchange | (event: [InputKeyboardHeightChangeEvent](#inputkeyboardheightchangeevent)) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @confirm | (event: [InputConfirmEvent](#inputconfirmevent)) => void | - | 点击完成按钮时触发，event.detail = {value: value} |
\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| text | 文本输入键盘 |
\n
| number | 数字输入键盘 |
\n
| digit | 带小数点数字输入键盘 |
\n
| tel | 电话输入键盘 |
\n\n\n\n
#### confirm-type @confirm-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| send | 发送 |
\n
| search | 搜索 |
\n
| next | 下一个 |
\n
| go | 前往 |
\n
| done | 完成 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### InputEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputEventdetail](#inputeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputEventdetail 属性值 @inputeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n
| cursor | number | 是 | - | 光标的位置 |
\n
| keyCode | number | 是 | - | 输入字符的Unicode值 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputFocusEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputFocusEventdetail](#inputfocuseventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputFocusEventdetail 属性值 @inputfocuseventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputBlurEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputBlurEventdetail](#inputblureventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputBlurEventdetail 属性值 @inputblureventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputKeyboardHeightChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputKeyboardHeightChangeEventdetail](#inputkeyboardheightchangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputKeyboardHeightChangeEventdetail 属性值 @inputkeyboardheightchangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| duration | number | 是 | - | 持续时间 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputConfirmEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputConfirmEventdetail](#inputconfirmeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputConfirmEventdetail 属性值 @inputconfirmeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/input)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/input/input.uvue)
\n
"
},
"list-item"
:{
"name"
:
"## list-item"
,
"description"
:
"list-view组件的唯一合法子组件。每个item是一行"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| type | Number | 0 | 对应list-item的类型 List 将对同类型条目进行复用，所以合理的类型拆分，可以很好地提升 List 性能 |"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/uni-app-x/component/list-view#list-item)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/list-item/list-item.uvue)
\n
"
},
"list-view"
:{
"name"
:
"## list-view"
,
"description"
:
"列表组件"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| scroll-x | Boolean | false | 允许横向滚动，不支持同时设置scroll-y属性 |
\n
| scroll-y | Boolean | true | 允许纵向滚动，不支持同时设置scroll-x属性 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | 0 | 设置竖向滚动条位置 |
\n
| scroll-left | Number | 0 | 设置横向滚动条位置 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 是否在设置滚动条位置时使用滚动动画，设置false没有滚动动画 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新，暂时不支持scroll-x = true横向刷新 |
\n
| refresher-threshold | Number | 45 | 设置自定义下拉刷新阈值 |
\n
| refresher-max-drag-distance | Number | - | 设置下拉最大拖拽距离（单位px），默认是下拉刷新控件高度的2.5倍 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black，white，none，none 表示不使用默认样式 |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色 |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| @refresherpulling | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: [ScrollToUpperEvent](#scrolltoupperevent)) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: [ScrollToLowerEvent](#scrolltolowerevent)) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: [ScrollEvent](#scrollevent)) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"event"
:
"
\n
### 事件
\n
#### RefresherEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [RefresherEventdetail](#refreshereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### RefresherEventdetail 属性值 @refreshereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| dy | number | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToUpperEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToUpperEventdetail](#scrolltouppereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToUpperEventdetail 属性值 @scrolltouppereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 top 或 left |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToLowerEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToLowerEventdetail](#scrolltolowereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToLowerEventdetail 属性值 @scrolltolowereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 bottom 或 right |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollEventdetail](#scrolleventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollEventdetail 属性值 @scrolleventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| scrollTop | number | 是 | - | 竖向滚动的距离 |
\n
| scrollLeft | number | 是 | - | 横向滚动的距离 |
\n
| scrollHeight | number | 是 | - | 滚动区域的高度 |
\n
| scrollWidth | number | 是 | - | 滚动区域的宽度 |
\n
| deltaY | number | 是 | - | 当次滚动事件竖向滚动量 |
\n
| deltaX | number | 是 | - | 当次滚动事件横向滚动量 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| @refresherpulling | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherrefresh | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherrestore | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherabort | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scrolltoupper | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scrolltolower | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scroll | 5.0 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/list-view/list-view.uvue)
\n
"
},
"navigator"
:{
"name"
:
"## navigator"
,
"description"
:
"页面链接"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| target | String | - | 在哪个目标上发生跳转，默认当前应用 |
\n
| url | String
\\
|PageURIString | - | 当前应用内的跳转链接 |
\n
| open-type | String | - | 跳转方式 [open-type](#open-type-values) |
\n
| delta | Number | - | 当 open-type 为 navigateBack 时有效，表示回退的层数 |
\n
| app-id | String | - | 当target=
\"
miniProgram
\"
时有效，要打开的小程序 appId |
\n
| path | String | - | 当target=
\"
miniProgram
\"
时有效，打开的页面路径，如果为空则打开首页 |
\n
| extra-data | Object | - | 当target=
\"
miniProgram
\"
时有效，需要传递给目标应用的数据，目标应用可在 App.onLaunch()，App.onShow() 中获取到这份数据 |
\n
| version | String | - | 当target=
\"
miniProgram
\"
时有效，要打开的小程序版本，有效值 develop（开发版），trial（体验版），release（正式版），仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是体验版或正式版，则打开的小程序必定是正式版 |
\n
| animation-type | String | - | 当 open-type=
\"
navigateTo
\"
或 open-type=
\"
navigateBack
\"
时有效，窗口的显示/关闭的动画类型。 [animation-type](#animation-type-values) |
\n
| animation-duration | Number | - | 当 open-type=
\"
navigateTo
\"
或 open-type=
\"
navigateBack
\"
时有效，窗口的显示/关闭动画的持续时间。 |
\n
| hover-class | String | - | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | - | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | - | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | - | 手指松开后点击态保留时间，单位毫秒 |
\n\n
#### open-type @open-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| navigate | 对应 wx.navigateTo 或 wx.navigateToMiniProgram 的功能 |
\n
| redirect | 对应 wx.redirectTo 的功能 |
\n
| switchTab | 对应 wx.switchTab 的功能 |
\n
| reLaunch | 对应 wx.reLaunch 的功能 |
\n
| navigateBack | 对应 wx.navigateBack 的功能 |
\n\n\n\n
#### animation-type @animation-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| auto | 自动选择动画效果 |
\n
| none | 无动画效果 |
\n
| slide-in-right | 从右侧横向滑动效果 |
\n
| slide-in-left | 左侧横向滑动效果 |
\n
| slide-in-top | 从上侧竖向滑动效果 |
\n
| slide-in-bottom | 从下侧竖向滑动效果 |
\n
| fade-in | 从透明到不透明逐渐显示效果 |
\n
| zoom-out | 从小到大逐渐放大显示效果 |
\n
| zoom-fade-out | 从小到大逐渐放大并且从透明到不透明逐渐显示效果 |
\n
| pop-in | 从右侧平移入栈动画效果 |
\n
| slide-out-right | 横向向右侧滑出屏幕动画 |
\n
| slide-out-left | 横向向左侧滑出屏幕动画 |
\n
| slide-out-top | 竖向向上侧滑出屏幕动画 |
\n
| slide-out-bottom | 竖向向下侧滑出屏幕动画 |
\n
| fade-out | 从不透明到透明逐渐隐藏动画 |
\n
| zoom-in | 从大逐渐缩小关闭动画 |
\n
| zoom-fade-in | 从大逐渐缩小并且从不透明到透明逐渐隐藏关闭动画 |
\n
| pop-out | 从右侧平移出栈动画效果 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/navigator)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/navigator/navigator.uvue)
\n
"
},
"picker-view-column"
:{
"name"
:
"## picker-view-column"
,
"description"
:
"仅可放置于 picker-view 中，其子节点未继承 picker-view 的选中框的高度，需要自己设置高度并居中"
,
"attrubute"
:
""
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/picker-view.html#picker-view-column)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/picker-view-column/picker-view-column.uvue)
\n
"
},
"picker-view"
:{
"name"
:
"## picker-view"
,
"description"
:
"嵌入页面的滚动选择器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| value | Array
\\
<Number> | - | picker-view-column 选择的第几项 |
\n
| indicator-style | CSSString | - | 设置选择器中间选中框的样式 |
\n
| mask-top-style | CSSString | - | 设置蒙层上半部分的样式 |
\n
| mask-bottom-style | CSSString | - | 设置蒙层下半部分的样式 |
\n
| @change | (event: [PickerViewChangeEvent](#pickerviewchangeevent)) => void | - | 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0
\t\t
开始） |"
,
"event"
:
"
\n
### 事件
\n
#### PickerViewChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<number
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### PickerViewChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<number
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<number
\\
> | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/picker-view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/picker-view/picker-view.uvue)
\n
"
},
"progress"
:{
"name"
:
"## progress"
,
"description"
:
"进度条"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| duration | Number | 30 | 进度增加1%所需毫秒数 |
\n
| percent | Number | 0 | 百分比0~100 |
\n
| show-info | Boolean | false | 在进度条右侧显示百分比 |
\n
| border-radius | Number | 0 | 圆角大小 |
\n
| font-size | Number | 16 | 右侧百分比字体大小 |
\n
| stroke-width | Number | 6 | 进度条线的宽度，单位px |
\n
| color | ColorString | - | 进度条颜色 （请使用 activeColor） |
\n
| activeColor | ColorString | #09BB07 | 已选择的进度条的颜色 |
\n
| backgroundColor | ColorString | #EBEBEB | 未选择的进度条的颜色 |
\n
| active | Boolean | false | 进度条从左往右的动画 |
\n
| active-mode | String | backwards | backwards: 动画从头播；forwards：动画从上次结束点接着播 [active-mode](#active-mode-values) |
\n
| @activeend | (event: [ProgressActiveendEvent](#progressactiveendevent)) => void | - | 动画完成事件 |
\n\n
#### active-mode @active-mode-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| backwards | 动画从头播 |
\n
| forwards | 动画从上次结束点接着播 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### ProgressActiveendEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ProgressActiveendEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| curPercent | number | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/progress)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/progress/progress.uvue)
\n
"
},
"radio"
:{
"name"
:
"## radio"
,
"description"
:
"单选项。在1组radio-group中只能选中1个"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| value | String | - |
\\
<radio/> 标识。当该radio 选中时，radio-group的 change 事件会携带radio的value |
\n
| checked | Boolean | false |
\\
<radio/> 当前是否选中 |
\n
| color | ColorString | #007AFF | radio的颜色 |
\n
| backgroundColor | ColorString | #ffffff | radio默认的背景颜色 |
\n
| borderColor | ColorString | #d1d1d1 | radio默认的边框颜色 |
\n
| activeBackgroundColor | ColorString | #007AFF | radio选中时的背景颜色，优先级大于color属性 |
\n
| activeBorderColor | ColorString | | radio选中时的边框颜色 |
\n
| iconColor | ColorString | #ffffff | radio的图标颜色 |
\n
| @click | (event: [MouseEvent](/uni-app-x/component/common#mouseevent)) => void | - | 组件被点击时触发 |"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/radio/radio.uvue)
\n
"
},
"radio-group"
:{
"name"
:
"## radio-group"
,
"description"
:
"单选组，内部由多个 radio 组成"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| @change | (event: [RadioGroupChangeEvent](#radiogroupchangeevent)) => void | - | radio-group 中的选中项发生变化时触发 change 事件，event.detail = {value: 选中项radio的value} |"
,
"event"
:
"
\n
### 事件
\n
#### RadioGroupChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### RadioGroupChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/radio-group/radio-group.uvue)
\n
"
},
"rich-text"
:{
"name"
:
"## rich-text"
,
"description"
:
"富文本。可渲染文字样式、图片、超链接。支持部分HTML标签"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| nodes | Array
\\
| String | - | 节点列表
\\
| HTML String |
\n
| selectable | Boolean | false | 文本是否可选 |
\n
| @itemclick | (event: [RichTextItemClickEvent](#richtextitemclickevent)) => void | - | 拦截点击事件（只支持 a、img标签），返回用户自定义数据或img标签的src属性或a标签的href属性。event.detail={ ref
\\
| src
\\
| href } |"
,
"event"
:
"
\n
### 事件
\n
#### RichTextItemClickEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [RichTextItemClickEventdetail](#richtextitemclickeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### RichTextItemClickEventdetail 属性值 @richtextitemclickeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| ref | string | 否 | - | 自定义数据 |
\n
| src | string | 否 | - |
\\
<img/>图片链接 |
\n
| href | string | 否 | - |
\\
<a/>超链接 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| rich-text | 5.0 | √ | 3.9 | 9.0 | √ | - |
\n
| selectable | 5.0 | x | 3.91 | 9.0 | x | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/rich-text)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/rich-text/rich-text.uvue)
\n
"
},
"scroll-view"
:{
"name"
:
"## scroll-view"
,
"description"
:
"可滚动视图容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| scroll-x | Boolean | false | 允许横向滚动，不支持同时设置scroll-y属性 |
\n
| scroll-y | Boolean | true | 允许纵向滚动，不支持同时设置scroll-x属性 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | 0 | 设置竖向滚动条位置 |
\n
| scroll-left | Number | 0 | 设置横向滚动条位置 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 是否在设置滚动条位置时使用滚动动画，设置false没有滚动动画 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新，暂时不支持scroll-x = true横向刷新 |
\n
| refresher-threshold | Number | 45 | 设置自定义下拉刷新阈值 |
\n
| refresher-max-drag-distance | Number | - | 设置下拉最大拖拽距离（单位px），默认是下拉刷新控件高度的2.5倍 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black
\\
| white
\\
| none， none 表示不使用默认样式 |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色 |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| @refresherpulling | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: [ScrollToUpperEvent](#scrolltoupperevent)) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: [ScrollToLowerEvent](#scrolltolowerevent)) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: [ScrollEvent](#scrollevent)) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"event"
:
"
\n
### 事件
\n
#### RefresherEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [RefresherEventdetail](#refreshereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### RefresherEventdetail 属性值 @refreshereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| dy | number | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToUpperEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToUpperEventdetail](#scrolltouppereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToUpperEventdetail 属性值 @scrolltouppereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 top 或 left |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToLowerEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToLowerEventdetail](#scrolltolowereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToLowerEventdetail 属性值 @scrolltolowereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 bottom 或 right |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollEventdetail](#scrolleventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollEventdetail 属性值 @scrolleventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| scrollTop | number | 是 | - | 竖向滚动的距离 |
\n
| scrollLeft | number | 是 | - | 横向滚动的距离 |
\n
| scrollHeight | number | 是 | - | 滚动区域的高度 |
\n
| scrollWidth | number | 是 | - | 滚动区域的宽度 |
\n
| deltaY | number | 是 | - | 当次滚动事件竖向滚动量 |
\n
| deltaX | number | 是 | - | 当次滚动事件横向滚动量 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| @refresherpulling | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherrefresh | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherrestore | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherabort | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scrolltoupper | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scrolltolower | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scroll | 5.0 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/scroll-view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/scroll-view/scroll-view.uvue)
\n
"
},
"slider"
:{
"name"
:
"## slider"
,
"description"
:
"滑动选择器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| min | Number | 0 | slider 最小值 |
\n
| max | Number | 100 | slider 最大值 |
\n
| step | Number | 1 | slider 步长，取值必须大于 0，并且可被(max - min)整除 |
\n
| value | Number | 0 | radio当前取值 |
\n
| color | ColorString | - | slider 背景条的颜色（请使用 backgroundColor） |
\n
| activeColor | ColorString | #007aff | slider 滑块左侧已选择部分的线条颜色 |
\n
| backgroundColor | ColorString | #e9e9e9 | radio背景条的颜色 |
\n
| block-size | Number | 28 | radio滑块的大小，取值范围为 12 - 28 |
\n
| block-color | ColorString | #ffffff | 滑块颜色 |
\n
| show-value | Boolean | false | 是否显示当前 value |
\n
| @change | (event: [SliderChangeEvent](#sliderchangeevent)) => void | - | 完成一次拖动后触发的事件，event.detail = {value: value} |
\n
| @changing | (event: [SliderChangeEvent](#sliderchangeevent)) => void | - | 拖动过程中触发的事件，event.detail = {value: value} |"
,
"event"
:
"
\n
### 事件
\n
#### SliderChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SliderChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| disabled | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| min | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| max | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| step | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| value | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| color | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| activeColor | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| backgroundColor | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| block-size | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| block-color | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| show-value | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| @change | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| @changing | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/slider)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/slider/slider.uvue)
\n
"
},
"swiper-item"
:{
"name"
:
"## swiper-item"
,
"description"
:
"swiper的唯一合法子组件。每个swiper-item代表一个滑块。宽高自动设置为100%"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| item-id | String | - | 该 swiper-item 的标识符 |"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| item-id | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/swiper.html#swiper-item)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/swiper-item/swiper-item.uvue)
\n
"
},
"swiper"
:{
"name"
:
"## swiper"
,
"description"
:
"滑块视图容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| indicator-dots | Boolean | false | 是否显示面板指示点 |
\n
| indicator-color | ColorString | rgba(0, 0, 0, .3) | 指示点颜色 |
\n
| indicator-active-color | ColorString | #000000 | 当前选中的指示点颜色 |
\n
| disable-touch | Boolean | false | 是否禁止用户 touch 操作 |
\n
| autoplay | Boolean | false | 是否自动切换 |
\n
| current | Number | 0 | 当前所在滑块的 index |
\n
| current-item-id | String | - | 当前所在滑块的 item-id ，不能与 current 被同时指定 |
\n
| interval | Number | 3000 | 自动切换时间间隔 |
\n
| circular | Boolean | false | 是否采用衔接滑动 |
\n
| vertical | Boolean | false | 滑动方向是否为纵向 |
\n
| @change | (event: [SwiperChangeEvent](#swiperchangeevent)) => void | - | current 改变时会触发 change 事件，event.detail = {current: current, source: source} |
\n
| @transition | (event: [SwiperTransitionEvent](#swipertransitionevent)) => void | - | swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy} |
\n
| @animationfinish | (event: [SwiperAnimationFinishEvent](#swiperanimationfinishevent)) => void | - | 动画结束时会触发 animationfinish 事件，event.detail = {current: current, source: source} |"
,
"event"
:
"
\n
### 事件
\n
#### SwiperChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [SwiperChangeEventdetail](#swiperchangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### SwiperChangeEventdetail 属性值 @swiperchangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| current | number | 是 | - | - |
\n
| source | string | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SwiperTransitionEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [SwiperTransitionEventdetail](#swipertransitioneventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### SwiperTransitionEventdetail 属性值 @swipertransitioneventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| dx | number | 是 | - | - |
\n
| dy | number | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SwiperAnimationFinishEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [SwiperAnimationFinishEventdetail](#swiperanimationfinisheventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### SwiperAnimationFinishEventdetail 属性值 @swiperanimationfinisheventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| current | number | 是 | - | - |
\n
| source | string | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| indicator-dots | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| indicator-color | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| indicator-active-color | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| disable-touch | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| autoplay | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| current | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| current-item-id | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| interval | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| circular | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| vertical | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| @change | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| @transition | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| @animationfinish | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/swiper)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/swiper/swiper.uvue)
\n
"
},
"switch"
:{
"name"
:
"## switch"
,
"description"
:
"开关选择器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| checked | Boolean | - | 是否选中 |
\n
| color | ColorString | - | switch 的颜色，同 css 的 color |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @change | (event: [SwitchChangeEvent](#switchchangeevent)) => void | - | checked 改变时触发 change 事件，event.detail={ value:checked} |"
,
"event"
:
"
\n
### 事件
\n
#### SwitchChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | boolean | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SwitchChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | boolean | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | boolean | 是 | - | - |
\n\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| checked | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| color | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| disabled | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| @change | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/switch)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/switch/switch.uvue)
\n
"
},
"text"
:{
"name"
:
"## text"
,
"description"
:
"文本"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| selectable | Boolean | false | 文本是否可选 |
\n
| space | String | - | 显示连续空格 [space](#space-values) |
\n
| decode | Boolean | false | 是否解码 |
\n\n
#### space @space-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| ensp | 中文字符空格一半大小 |
\n
| emsp | 中文字符空格大小 |
\n
| nbsp | 根据字体设置的空格大小 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| text | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/text)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/text/text.uvue)
\n
"
},
"textarea"
:{
"name"
:
"## textarea"
,
"description"
:
"多行输入框"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| value | String | | 输入框的初始内容 |
\n
| placeholder | String | | 输入框为空时占位符 |
\n
| placeholder-style | String | | 指定 placeholder 的样式 |
\n
| placeholder-class | String | | 指定 placeholder 的样式类 |
\n
| maxlength | Number | 140 | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| auto-focus | Boolean | false | 自动获取焦点 |
\n
| focus | Boolean | false | 获取焦点 |
\n
| cursor | Number | 0 | 指定focus时的光标位置 |
\n
| confirm-type | String | done | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| confirm-hold | Boolean | false | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| auto-height | Boolean | false | 是否自动增高，设置auto-height时，style.height不生效 |
\n
| cursor-spacing | Number | 0 | 指定光标与键盘的距离，单位 px 。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| selection-start | Number | -1 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | -1 | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | true | 键盘弹起时，是否自动上推页面 |
\n
| @confirm | (event: [InputConfirmEvent](#inputconfirmevent)) => void | - | 点击完成时， 触发 confirm 事件，event.detail = {value: value} |
\n
| @input | (event: [InputEvent](#inputevent)) => void | - | 当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上 |
\n
| @linechange | (event: [TextareaLineChangeEvent](#textarealinechangeevent)) => void | - | 输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0} |
\n
| @blur | (event: [TextareaBlurEvent](#textareablurevent)) => void | - | 输入框失去焦点时触发，event.detail = {value, cursor} |
\n
| @keyboardheightchange | (event: [InputKeyboardHeightChangeEvent](#inputkeyboardheightchangeevent)) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @focus | (event: [TextareaFocusEvent](#textareafocusevent)) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持 |
\n\n
#### confirm-type @confirm-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| send | 发送 |
\n
| search | 搜索 |
\n
| next | 下一个 |
\n
| go | 前往 |
\n
| done | 完成 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### InputConfirmEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputConfirmEventdetail](#inputconfirmeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputConfirmEventdetail 属性值 @inputconfirmeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputEventdetail](#inputeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputEventdetail 属性值 @inputeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n
| cursor | number | 是 | - | 光标的位置 |
\n
| keyCode | number | 是 | - | 输入字符的Unicode值 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### TextareaLineChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [TextareaLineChangeEventdetail](#textarealinechangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### TextareaLineChangeEventdetail 属性值 @textarealinechangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| lineCount | number | 是 | - | 行数 |
\n
| heightRpx | number | 是 | - | textarea的高度 |
\n
| height | number | 是 | - | textarea的高度 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### TextareaBlurEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [TextareaBlurEventdetail](#textareablureventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### TextareaBlurEventdetail 属性值 @textareablureventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n
| cursor | number | 是 | - | 选择区域的起始位置 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputKeyboardHeightChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputKeyboardHeightChangeEventdetail](#inputkeyboardheightchangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputKeyboardHeightChangeEventdetail 属性值 @inputkeyboardheightchangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| duration | number | 是 | - | 持续时间 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### TextareaFocusEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [TextareaFocusEventdetail](#textareafocuseventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### TextareaFocusEventdetail 属性值 @textareafocuseventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| @confirm | 5.0 | √ | 3.9+ | - | - | - |
\n
| @input | 5.0 | √ | 3.9+ | - | - | - |
\n
| @linechange | 5.0 | √ | 3.9+ | - | - | - |
\n
| @blur | 5.0 | √ | 3.9+ | - | - | - |
\n
| @keyboardheightchange | 5.0 | √ | 3.9+ | - | - | - |
\n
| @focus | 5.0 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/textarea)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/textarea/textarea.uvue)
\n
"
},
"video"
:{
"name"
:
"## video"
,
"description"
:
"视频"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| loop | Boolean | false | 是否循环播放 |
\n
| src | String
\\
|TagVideoURIString | - | 视频资源地址 |
\n
| initial-time | Number | - | 指定视频初始播放位置 |
\n
| duration | Number | - | 指定视频长度 |
\n
| controls | Boolean | true | 是否显示默认播放控件（播放/暂停按钮、播放进度、时间） |
\n
| danmu-list | Array | - | 弹幕列表 |
\n
| danmu-btn | Boolean | false | 是否显示弹幕按钮，只在初始化时有效，不能动态变更 |
\n
| enable-danmu | Boolean | false | 是否展示弹幕，只在初始化时有效，不能动态变更 |
\n
| autoplay | Boolean | false | 是否自动播放 |
\n
| muted | Boolean | false | 是否静音播放 |
\n
| page-gesture | Boolean | false | 在非全屏模式下，是否开启亮度与音量调节手势 |
\n
| direction | Number | -90 | 设置全屏时视频的方向，不指定则根据宽高比自动判断。有效值为 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度） |
\n
| show-progress | Boolean | true | 若不设置，宽度大于240时才会显示 |
\n
| show-fullscreen-btn | Boolean | true | 是否显示全屏按钮 |
\n
| show-play-btn | Boolean | true | 是否显示视频底部控制栏的播放按钮 |
\n
| show-center-play-btn | Boolean | true | 是否显示视频中间的播放按钮 |
\n
| show-loading | Boolean | true | 是否显示loading控件 |
\n
| enable-progress-gesture | Boolean | true | 是否开启控制进度的手势 |
\n
| objectFit | String | contain | 当视频大小与 video 容器大小不一致时，视频的表现形式。 [objectFit](#objectFit-values) |
\n
| poster | String | - | 视频封面的图片网络资源地址，如果 controls 属性值为 false 则设置 poster 无效 |
\n
| show-mute-btn | Boolean | false | 是否显示静音按钮 |
\n
| title | String | - | 视频的标题，全屏时在顶部展示 |
\n
| play-btn-position | String | - | 播放按钮的位置 |
\n
| enable-play-gesture | Boolean | false | 是否开启播放手势，即双击切换播放、暂停 |
\n
| auto-pause-if-navigate | Boolean | - | 当跳转到其它小程序页面时，是否自动暂停本页面的视频 |
\n
| auto-pause-if-open-native | Boolean | - | 当跳转到其它微信原生页面时，是否自动暂停本页面的视频 |
\n
| vslide-gesture | Boolean | false | 在非全屏模式下，是否开启亮度与音量调节手势（同 page-gesture） |
\n
| vslide-gesture-in-fullscreen | Boolean | true | 在全屏模式下，是否开启亮度与音量调节手势 |
\n
| ad-unit-id | String | - | 视频前贴广告单元ID |
\n
| poster-for-crawler | String | - | 用于给搜索等场景作为视频封面展示，建议使用无播放 icon 的视频封面图，只支持网络地址 |
\n
| codec | String | hardware | 解码器选择 |
\n
| http-cache | Boolean | false | 是否对 http、https 视频源开启本地缓存 |
\n
| play-strategy | Number | 0 | 播放策略 |
\n
| is-live | Boolean | - | 是否为直播源 |
\n
| @play | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当开始/继续播放时触发play事件 |
\n
| @pause | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当暂停播放时，触发pause事件 |
\n
| @ended | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当播放到视频末尾时触发ended事件 |
\n
| @timeupdate | (event: [Event](/uni-app-x/component/common#event)) => void | - | 播放进度变化时触发，event.detail = {currentTime, duration} 。触发频率 250ms 一次 |
\n
| @fullscreenchange | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当视频进入和退出全屏是触发，event.detail = {fullScreen, direction}，direction取为 vertical 或 horizontal |
\n
| @waiting | (event: [Event](/uni-app-x/component/common#event)) => void | - | 视频出现缓冲时触发 |
\n
| @error | (event: [Event](/uni-app-x/component/common#event)) => void | - | 播放出错试触发事件 |
\n
| @progress | (event: [Event](/uni-app-x/component/common#event)) => void | - | 加载进度变化时触发，只支持一段加载。event.detail = {buffered}，百分比 |
\n
| @loadedmetadata | (event: [Event](/uni-app-x/component/common#event)) => void | - | 视频元数据加载完成时触发。event.detail = {width, height, duration} |
\n\n
#### objectFit @objectFit-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| contain | 包含 |
\n
| fill | 填充 |
\n
| cover | 覆盖 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| video | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
| play-btn-position | 5.0 | x | x | 9.0 | x | - |
\n
| auto-pause-if-navigate | 5.0 | x | x | 9.0 | x | - |
\n
| auto-pause-if-open-native | 5.0 | x | x | 9.0 | x | - |
\n
| ad-unit-id | 5.0 | x | x | 9.0 | x | - |
\n
| poster-for-crawler | 5.0 | x | x | 9.0 | x | - |
\n
| is-live | 5.0 | x | x | 9.0 | x | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/video)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/video/video.uvue)
\n
"
},
"view"
:{
"name"
:
"## view"
,
"description"
:
"基本视图容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| hover-class | String | none | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | false | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | 50 | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | 400 | 手指松开后点击态保留时间，单位毫秒 |"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| view | 5.0 | √ | √ | - | - | - |
\n
| hover-class | 5.0 | √ | √ | - | - | - |
\n
| hover-stop-propagation | 5.0 | √ | √ | - | - | - |
\n
| hover-start-time | 5.0 | √ | √ | - | - | - |
\n
| hover-stay-time | 5.0 | √ | √ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/view/view.uvue)
\n
"
},
"web-view"
:{
"name"
:
"## web-view"
,
"description"
:
"承载网页的容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| src | String
\\
|URIString | - | webview 指向网页的链接 |
\n
| webview-styles | Object
\\
|Boolean | {
\"
progress
\"
:{
\"
color
\"
:
\"
#00FF00
\"
}} | webview 的样式 |
\n
| @message | (event: [WebViewMessageEvent](#webviewmessageevent)) => void | - | 网页向应用 postMessage 时触发。e.detail = { data } |
\n
| @error | (event: [WebViewErrorEvent](#webviewerrorevent)) => void | - | 网页加载错误时触发。e.detail = { errMsg } |
\n
| @loaded | (event: [WebViewLoadedEvent](#webviewloadedevent)) => void | - | 网页加载完成后触发。 |
\n
| @loading | (event: [WebViewLoadingEvent](#webviewloadingevent)) => void | - | 网页加载中触发。 |"
,
"event"
:
"
\n
### 事件
\n
#### WebViewMessageEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [WebViewMessageEventdetail](#webviewmessageeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### WebViewMessageEventdetail 属性值 @webviewmessageeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| data | Map
\\
<string, any> | 否 | - | 消息包含的数据 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### WebViewErrorEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [WebViewErrorEventdetail](#webviewerroreventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### WebViewErrorEventdetail 属性值 @webviewerroreventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| errMsg | string | 是 | - | 错误信息 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### WebViewLoadedEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### WebViewLoadingEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| web-view | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/web-view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/web-view/web-view.uvue)
\n
"
}}
{
"animation-view"
:{
"name"
:
"## animation-view"
,
"description"
:
"Lottie 动画"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| path | String | | 动画资源地址，目前只支持绝对路径 |
\n
| loop | Boolean | false | 动画是否循环播放 |
\n
| autoplay | Boolean | false | 动画是否自动播放 |
\n
| action | String | stop | 动画操作，可取值 play、pause、stop [action](#action-values) |
\n
| hidden | Boolean | false | 是否隐藏动画 |
\n
| @ended | Any | - | - |
\n\n
#### action @action-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| play | 播放 |
\n
| pause | 暂停 |
\n
| stop | 停止 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/animation-view)
\n
- [插件市场](https://ext.dcloud.net.cn/plugin?id=10674)
\n
"
},
"button"
:{
"name"
:
"## button"
,
"description"
:
"按钮"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| hover-class | ClassString | button-hover | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-start-time | Number | 20 | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | 70 | 手指松开后点击态保留时间，单位毫秒 |
\n
| size | String | default | 按钮的大小 [size](#size-values) |
\n
| type | String | default | 按钮的样式类型 [type](#type-values) |
\n
| plain | Boolean | false | 按钮是否镂空，背景色透明 |
\n\n
#### size @size-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| default | 默认大小 |
\n
| mini | 小尺寸 |
\n\n\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| default | 白色 |
\n
| primary | 蓝色 |
\n
| warn | 红色 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/button)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/button/button.uvue)
\n
"
},
"checkbox"
:{
"name"
:
"## checkbox"
,
"description"
:
"多选项。在1组check-group中可选择多个"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| value | String | - | checkbox 标识，选中时触发 checkbox-group 的 change 事件，并携带 checkbox 的 value |
\n
| checked | Boolean | false | 当前是否选中，可用来设置默认选中 |
\n
| color | ColorString | #007aff | checkbox的颜色 |
\n
| backgroundColor | ColorString | #ffffff | checkbox默认的背景颜色 |
\n
| borderColor | ColorString | #d1d1d1 | checkbox默认的边框颜色 |
\n
| activeBackgroundColor | ColorString | #ffffff | checkbox选中时的背景颜色 |
\n
| activeBorderColor | ColorString | #d1d1d1 | checkbox选中时的边框颜色 |
\n
| iconColor | ColorString | #007aff | checkbox的图标颜色，优先级大于color属性 |"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/checkbox/checkbox.uvue)
\n
"
},
"checkbox-group"
:{
"name"
:
"## checkbox-group"
,
"description"
:
"多项组，内部由多个checkbox组成"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| @change | (event: [CheckboxGroupChangeEvent](#checkboxgroupchangeevent)) => void | - | checkbox-group中选中项发生改变是触发 change 事件，detail = {value:[选中的checkbox的value的数组
\\
]} |"
,
"event"
:
"
\n
### 事件
\n
#### CheckboxGroupChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<string
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### CheckboxGroupChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<string
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<string
\\
> | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/checkbox-group/checkbox-group.uvue)
\n
"
},
"image"
:{
"name"
:
"## image"
,
"description"
:
"图片"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| src | ImageURIString | - | 图片资源地址 |
\n
| mode | String | scaleToFill | 图片裁剪、缩放的模式 [mode](#mode-values) |
\n
| fade-show | Boolean | false | 图片显示动画效果 |
\n
| @error | (event: [ImageErrorEvent](#imageerrorevent)) => void | - | 图片加载错误时触发，event.detail = { errMsg } |
\n
| @load | (event: [ImageLoadEvent](#imageloadevent)) => void | - | 图片加载完成时触发，event.detail = { width: '图片宽度px', height: '图片高度px' } |
\n\n
#### mode @mode-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| scaleToFill | 不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素 |
\n
| aspectFit | 保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。 |
\n
| aspectFill | 保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取 |
\n
| widthFix | 宽度不变，高度自动变化，保持原图宽高比不变 |
\n
| heightFix | 高度不变，宽度自动变化，保持原图宽高比不变 |
\n
| top | 不缩放图片，只显示图片的顶部区域 |
\n
| bottom | 不缩放图片，只显示图片的底部区域 |
\n
| center | 不缩放图片，只显示图片的中间区域 |
\n
| left | 不缩放图片，只显示图片的左边区域 |
\n
| right | 不缩放图片，只显示图片的右边区域 |
\n
| top left | 不缩放图片，只显示图片的左上边区域 |
\n
| top rigth | 不缩放图片，只显示图片的右上边区域 |
\n
| bottom left | 不缩放图片，只显示图片的左下边区域 |
\n
| bottom right | 不缩放图片，只显示图片的右下边区域 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### ImageErrorEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ImageErrorEventdetail](#imageerroreventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ImageErrorEventdetail 属性值 @imageerroreventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| errMsg | string | 是 | - | 错误信息 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ImageLoadEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ImageLoadEventdetail](#imageloadeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ImageLoadEventdetail 属性值 @imageloadeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| width | number | 是 | - | 图片宽度 |
\n
| height | number | 是 | - | 图片高度 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| image | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
| src | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| mode | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| fade-show | 5.0 | √ | 3.9.0 | 9.0 | x | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/image)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/image/image.uvue)
\n
"
},
"input"
:{
"name"
:
"## input"
,
"description"
:
"输入框"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| value | String | | 输入框的初始内容 |
\n
| type | String | text | input的类型 [type](#type-values) |
\n
| password | Boolean | false | 是否是密码类型 |
\n
| placeholder | String | | 输入框为空时占位符 |
\n
| placeholder-style | String | | 指定 placeholder 的样式 |
\n
| placeholder-class | String | | 指定 placeholder 的样式类 |
\n
| maxlength | Number | 140 | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| cursor-spacing | Number | 0 | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| auto-focus | Boolean | false | 自动获取焦点 |
\n
| focus | Boolean | false | 获取焦点 |
\n
| confirm-type | String | done | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| confirm-hold | Boolean | false | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| cursor | Number | 0 | 指定focus时的光标位置 |
\n
| selection-start | Number | -1 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | -1 | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | true | 键盘弹起时，是否自动上推页面 |
\n
| @input | (event: [InputEvent](#inputevent)) => void | - | 当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |
\n
| @focus | (event: [InputFocusEvent](#inputfocusevent)) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持 |
\n
| @blur | (event: [InputBlurEvent](#inputblurevent)) => void | - | 输入框失去焦点时触发，event.detail = {value: value} |
\n
| @keyboardheightchange | (event: [InputKeyboardHeightChangeEvent](#inputkeyboardheightchangeevent)) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @confirm | (event: [InputConfirmEvent](#inputconfirmevent)) => void | - | 点击完成按钮时触发，event.detail = {value: value} |
\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| text | 文本输入键盘 |
\n
| number | 数字输入键盘 |
\n
| digit | 带小数点数字输入键盘 |
\n
| tel | 电话输入键盘 |
\n\n\n\n
#### confirm-type @confirm-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| send | 发送 |
\n
| search | 搜索 |
\n
| next | 下一个 |
\n
| go | 前往 |
\n
| done | 完成 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### InputEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputEventdetail](#inputeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputEventdetail 属性值 @inputeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n
| cursor | number | 是 | - | 光标的位置 |
\n
| keyCode | number | 是 | - | 输入字符的Unicode值 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputFocusEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputFocusEventdetail](#inputfocuseventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputFocusEventdetail 属性值 @inputfocuseventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputBlurEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputBlurEventdetail](#inputblureventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputBlurEventdetail 属性值 @inputblureventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputKeyboardHeightChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputKeyboardHeightChangeEventdetail](#inputkeyboardheightchangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputKeyboardHeightChangeEventdetail 属性值 @inputkeyboardheightchangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| duration | number | 是 | - | 持续时间 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputConfirmEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputConfirmEventdetail](#inputconfirmeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputConfirmEventdetail 属性值 @inputconfirmeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/input)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/input/input.uvue)
\n
"
},
"list-item"
:{
"name"
:
"## list-item"
,
"description"
:
"list-view组件的唯一合法子组件。每个item是一行"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| type | Number | 0 | 对应list-item的类型 List 将对同类型条目进行复用，所以合理的类型拆分，可以很好地提升 List 性能 |"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/uni-app-x/component/list-view#list-item)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/list-item/list-item.uvue)
\n
"
},
"list-view"
:{
"name"
:
"## list-view"
,
"description"
:
"列表组件"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| scroll-x | Boolean | false | 允许横向滚动，不支持同时设置scroll-y属性 |
\n
| scroll-y | Boolean | true | 允许纵向滚动，不支持同时设置scroll-x属性 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | 0 | 设置竖向滚动条位置 |
\n
| scroll-left | Number | 0 | 设置横向滚动条位置 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 是否在设置滚动条位置时使用滚动动画，设置false没有滚动动画 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新，暂时不支持scroll-x = true横向刷新 |
\n
| refresher-threshold | Number | 45 | 设置自定义下拉刷新阈值 |
\n
| refresher-max-drag-distance | Number | - | 设置下拉最大拖拽距离（单位px），默认是下拉刷新控件高度的2.5倍 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black，white，none，none 表示不使用默认样式 |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色 |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| @refresherpulling | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: [ScrollToUpperEvent](#scrolltoupperevent)) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: [ScrollToLowerEvent](#scrolltolowerevent)) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: [ScrollEvent](#scrollevent)) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"event"
:
"
\n
### 事件
\n
#### RefresherEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [RefresherEventdetail](#refreshereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### RefresherEventdetail 属性值 @refreshereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| dy | number | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToUpperEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToUpperEventdetail](#scrolltouppereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToUpperEventdetail 属性值 @scrolltouppereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 top 或 left |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToLowerEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToLowerEventdetail](#scrolltolowereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToLowerEventdetail 属性值 @scrolltolowereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 bottom 或 right |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollEventdetail](#scrolleventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollEventdetail 属性值 @scrolleventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| scrollTop | number | 是 | - | 竖向滚动的距离 |
\n
| scrollLeft | number | 是 | - | 横向滚动的距离 |
\n
| scrollHeight | number | 是 | - | 滚动区域的高度 |
\n
| scrollWidth | number | 是 | - | 滚动区域的宽度 |
\n
| deltaY | number | 是 | - | 当次滚动事件竖向滚动量 |
\n
| deltaX | number | 是 | - | 当次滚动事件横向滚动量 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| @refresherpulling | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherrefresh | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherrestore | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherabort | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scrolltoupper | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scrolltolower | 5.0 | √ | 3.9+ | - | - | - |
\n
| @scroll | 5.0 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/list-view/list-view.uvue)
\n
"
},
"navigator"
:{
"name"
:
"## navigator"
,
"description"
:
"页面链接"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| target | String | - | 在哪个目标上发生跳转，默认当前应用 |
\n
| url | String
\\
|PageURIString | - | 当前应用内的跳转链接 |
\n
| open-type | String | - | 跳转方式 [open-type](#open-type-values) |
\n
| delta | Number | - | 当 open-type 为 navigateBack 时有效，表示回退的层数 |
\n
| app-id | String | - | 当target=
\"
miniProgram
\"
时有效，要打开的小程序 appId |
\n
| path | String | - | 当target=
\"
miniProgram
\"
时有效，打开的页面路径，如果为空则打开首页 |
\n
| extra-data | Object | - | 当target=
\"
miniProgram
\"
时有效，需要传递给目标应用的数据，目标应用可在 App.onLaunch()，App.onShow() 中获取到这份数据 |
\n
| version | String | - | 当target=
\"
miniProgram
\"
时有效，要打开的小程序版本，有效值 develop（开发版），trial（体验版），release（正式版），仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是体验版或正式版，则打开的小程序必定是正式版 |
\n
| animation-type | String | - | 当 open-type=
\"
navigateTo
\"
或 open-type=
\"
navigateBack
\"
时有效，窗口的显示/关闭的动画类型。 [animation-type](#animation-type-values) |
\n
| animation-duration | Number | - | 当 open-type=
\"
navigateTo
\"
或 open-type=
\"
navigateBack
\"
时有效，窗口的显示/关闭动画的持续时间。 |
\n
| hover-class | String | - | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | - | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | - | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | - | 手指松开后点击态保留时间，单位毫秒 |
\n\n
#### open-type @open-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| navigate | 对应 wx.navigateTo 或 wx.navigateToMiniProgram 的功能 |
\n
| redirect | 对应 wx.redirectTo 的功能 |
\n
| switchTab | 对应 wx.switchTab 的功能 |
\n
| reLaunch | 对应 wx.reLaunch 的功能 |
\n
| navigateBack | 对应 wx.navigateBack 的功能 |
\n\n\n\n
#### animation-type @animation-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| auto | 自动选择动画效果 |
\n
| none | 无动画效果 |
\n
| slide-in-right | 从右侧横向滑动效果 |
\n
| slide-in-left | 左侧横向滑动效果 |
\n
| slide-in-top | 从上侧竖向滑动效果 |
\n
| slide-in-bottom | 从下侧竖向滑动效果 |
\n
| fade-in | 从透明到不透明逐渐显示效果 |
\n
| zoom-out | 从小到大逐渐放大显示效果 |
\n
| zoom-fade-out | 从小到大逐渐放大并且从透明到不透明逐渐显示效果 |
\n
| pop-in | 从右侧平移入栈动画效果 |
\n
| slide-out-right | 横向向右侧滑出屏幕动画 |
\n
| slide-out-left | 横向向左侧滑出屏幕动画 |
\n
| slide-out-top | 竖向向上侧滑出屏幕动画 |
\n
| slide-out-bottom | 竖向向下侧滑出屏幕动画 |
\n
| fade-out | 从不透明到透明逐渐隐藏动画 |
\n
| zoom-in | 从大逐渐缩小关闭动画 |
\n
| zoom-fade-in | 从大逐渐缩小并且从不透明到透明逐渐隐藏关闭动画 |
\n
| pop-out | 从右侧平移出栈动画效果 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/navigator)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/navigator/navigator.uvue)
\n
"
},
"picker-view-column"
:{
"name"
:
"## picker-view-column"
,
"description"
:
"仅可放置于 picker-view 中，其子节点未继承 picker-view 的选中框的高度，需要自己设置高度并居中"
,
"attrubute"
:
""
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/picker-view.html#picker-view-column)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/picker-view-column/picker-view-column.uvue)
\n
"
},
"picker-view"
:{
"name"
:
"## picker-view"
,
"description"
:
"嵌入页面的滚动选择器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| value | Array
\\
<Number> | - | picker-view-column 选择的第几项 |
\n
| indicator-style | CSSString | - | 设置选择器中间选中框的样式 |
\n
| mask-top-style | CSSString | - | 设置蒙层上半部分的样式 |
\n
| mask-bottom-style | CSSString | - | 设置蒙层下半部分的样式 |
\n
| @change | (event: [PickerViewChangeEvent](#pickerviewchangeevent)) => void | - | 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0
\t\t
开始） |"
,
"event"
:
"
\n
### 事件
\n
#### PickerViewChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<number
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### PickerViewChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<number
\\
> | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | Array
\\
<number
\\
> | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/picker-view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/picker-view/picker-view.uvue)
\n
"
},
"progress"
:{
"name"
:
"## progress"
,
"description"
:
"进度条"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| duration | Number | 30 | 进度增加1%所需毫秒数 |
\n
| percent | Number | 0 | 百分比0~100 |
\n
| show-info | Boolean | false | 在进度条右侧显示百分比 |
\n
| border-radius | Number | 0 | 圆角大小 |
\n
| font-size | Number | 16 | 右侧百分比字体大小 |
\n
| stroke-width | Number | 6 | 进度条线的宽度，单位px |
\n
| color | ColorString | - | 进度条颜色 （请使用 activeColor） |
\n
| activeColor | ColorString | #09BB07 | 已选择的进度条的颜色 |
\n
| backgroundColor | ColorString | #EBEBEB | 未选择的进度条的颜色 |
\n
| active | Boolean | false | 进度条从左往右的动画 |
\n
| active-mode | String | backwards | backwards: 动画从头播；forwards：动画从上次结束点接着播 [active-mode](#active-mode-values) |
\n
| @activeend | (event: [ProgressActiveendEvent](#progressactiveendevent)) => void | - | 动画完成事件 |
\n\n
#### active-mode @active-mode-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| backwards | 动画从头播 |
\n
| forwards | 动画从上次结束点接着播 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### ProgressActiveendEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ProgressActiveendEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| curPercent | number | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/progress)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/progress/progress.uvue)
\n
"
},
"radio"
:{
"name"
:
"## radio"
,
"description"
:
"单选项。在1组radio-group中只能选中1个"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | false | 是否禁用 |
\n
| value | String | - |
\\
<radio/> 标识。当该radio 选中时，radio-group的 change 事件会携带radio的value |
\n
| checked | Boolean | false |
\\
<radio/> 当前是否选中 |
\n
| color | ColorString | #007AFF | radio的颜色 |
\n
| backgroundColor | ColorString | #ffffff | radio默认的背景颜色 |
\n
| borderColor | ColorString | #d1d1d1 | radio默认的边框颜色 |
\n
| activeBackgroundColor | ColorString | #007AFF | radio选中时的背景颜色，优先级大于color属性 |
\n
| activeBorderColor | ColorString | | radio选中时的边框颜色 |
\n
| iconColor | ColorString | #ffffff | radio的图标颜色 |
\n
| @click | (event: [MouseEvent](/uni-app-x/component/common#mouseevent)) => void | - | 组件被点击时触发 |"
,
"event"
:
""
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/radio/radio.uvue)
\n
"
},
"radio-group"
:{
"name"
:
"## radio-group"
,
"description"
:
"单选组，内部由多个 radio 组成"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| @change | (event: [RadioGroupChangeEvent](#radiogroupchangeevent)) => void | - | radio-group 中的选中项发生变化时触发 change 事件，event.detail = {value: 选中项radio的value} |"
,
"event"
:
"
\n
### 事件
\n
#### RadioGroupChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### RadioGroupChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | - |
\n\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/radio-group/radio-group.uvue)
\n
"
},
"rich-text"
:{
"name"
:
"## rich-text"
,
"description"
:
"富文本。可渲染文字样式、图片、超链接。支持部分HTML标签"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| nodes | Array
\\
| String | - | 节点列表
\\
| HTML String |
\n
| selectable | Boolean | false | 文本是否可选 |
\n
| @itemclick | (event: [RichTextItemClickEvent](#richtextitemclickevent)) => void | - | 拦截点击事件（只支持 a、img标签），返回用户自定义数据或img标签的src属性或a标签的href属性。event.detail={ ref
\\
| src
\\
| href } |"
,
"event"
:
"
\n
### 事件
\n
#### RichTextItemClickEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [RichTextItemClickEventdetail](#richtextitemclickeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### RichTextItemClickEventdetail 属性值 @richtextitemclickeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| ref | string | 否 | - | 自定义数据 |
\n
| src | string | 否 | - |
\\
<img/>图片链接 |
\n
| href | string | 否 | - |
\\
<a/>超链接 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| rich-text | 5.0 | √ | 3.9 | 9.0 | √ | - |
\n
| selectable | 5.0 | x | 3.91 | 9.0 | x | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/rich-text)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/rich-text/rich-text.uvue)
\n
"
},
"scroll-view"
:{
"name"
:
"## scroll-view"
,
"description"
:
"可滚动视图容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| scroll-x | Boolean | false | 允许横向滚动，不支持同时设置scroll-y属性为true，同时设置true时scroll-x生效 |
\n
| scroll-y | Boolean | true | 允许纵向滚动，不支持同时设置scroll-x属性为true，同时设置true时scroll-x生效 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | 0 | 设置竖向滚动条位置 |
\n
| scroll-left | Number | 0 | 设置横向滚动条位置 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 是否在设置滚动条位置时使用滚动动画，设置false没有滚动动画 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新，暂时不支持scroll-x = true横向刷新 |
\n
| refresher-threshold | Number | 45 | 设置自定义下拉刷新阈值 |
\n
| refresher-max-drag-distance | Number | - | 设置下拉最大拖拽距离（单位px），默认是下拉刷新控件高度的2.5倍 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black
\\
| white
\\
| none， none 表示不使用默认样式 |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色 |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| @refresherpulling | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: [RefresherEvent](#refresherevent)) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: [ScrollToUpperEvent](#scrolltoupperevent)) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: [ScrollToLowerEvent](#scrolltolowerevent)) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: [ScrollEvent](#scrollevent)) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"event"
:
"
\n
### 事件
\n
#### RefresherEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [RefresherEventdetail](#refreshereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### RefresherEventdetail 属性值 @refreshereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| dy | number | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToUpperEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToUpperEventdetail](#scrolltouppereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToUpperEventdetail 属性值 @scrolltouppereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 top 或 left |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollToLowerEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollToLowerEventdetail](#scrolltolowereventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollToLowerEventdetail 属性值 @scrolltolowereventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| direction | string | 是 | - | 滚动方向 bottom 或 right |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### ScrollEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [ScrollEventdetail](#scrolleventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### ScrollEventdetail 属性值 @scrolleventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| scrollTop | number | 是 | - | 竖向滚动的距离 |
\n
| scrollLeft | number | 是 | - | 横向滚动的距离 |
\n
| scrollHeight | number | 是 | - | 滚动区域的高度 |
\n
| scrollWidth | number | 是 | - | 滚动区域的宽度 |
\n
| deltaY | number | 是 | - | 当次滚动事件竖向滚动量 |
\n
| deltaX | number | 是 | - | 当次滚动事件横向滚动量 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| scroll-view | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
| scroll-x | 5.0 | √ | 3.9+ | - | - | - |
\n
| scroll-y | 5.0 | √ | 3.9+ | - | - | - |
\n
| rebound | 5.0 | x | 3.9+ | - | - | - |
\n
| upper-threshold | 5.0 | √ | 3.9+ | - | - | - |
\n
| lower-threshold | 5.0 | √ | 3.9+ | - | - | - |
\n
| scroll-top | 5.0 | √ | 3.9+ | - | - | - |
\n
| scroll-left | 5.0 | √ | 3.9+ | - | - | - |
\n
| scroll-into-view | 5.0 | √ | 3.9+ | - | - | - |
\n
| scroll-with-animation | 5.0 | √ | 3.9+ | - | - | - |
\n
| refresher-enabled | 5.0 | √ | 3.9+ | - | - | - |
\n
| refresher-threshold | 5.0 | √ | 3.9+ | - | - | - |
\n
| refresher-max-drag-distance | 5.0 | x | 3.9+ | - | - | - |
\n
| refresher-default-style | 5.0 | √ | 3.9+ | - | - | - |
\n
| refresher-background | 5.0 | √ | 3.9+ | - | - | - |
\n
| refresher-triggered | 5.0 | √ | 3.9+ | - | - | - |
\n
| show-scrollbar | 5.0 | √ | 3.9+ | - | - | - |
\n
| @refresherpulling | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
| @refresherrefresh | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
| @refresherrestore | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
| @refresherabort | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
| @scrolltoupper | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
| @scrolltolower | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
| @scroll | 5.0 | √ | 3.9+ | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/scroll-view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/scroll-view/scroll-view.uvue)
\n
"
},
"slider"
:{
"name"
:
"## slider"
,
"description"
:
"滑动选择器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| min | Number | 0 | slider 最小值 |
\n
| max | Number | 100 | slider 最大值 |
\n
| step | Number | 1 | slider 步长，取值必须大于 0，并且可被(max - min)整除 |
\n
| value | Number | 0 | radio当前取值 |
\n
| color | ColorString | - | slider 背景条的颜色（请使用 backgroundColor） |
\n
| activeColor | ColorString | #007aff | slider 滑块左侧已选择部分的线条颜色 |
\n
| backgroundColor | ColorString | #e9e9e9 | radio背景条的颜色 |
\n
| block-size | Number | 28 | radio滑块的大小，取值范围为 12 - 28 |
\n
| block-color | ColorString | #ffffff | 滑块颜色 |
\n
| show-value | Boolean | false | 是否显示当前 value |
\n
| @change | (event: [SliderChangeEvent](#sliderchangeevent)) => void | - | 完成一次拖动后触发的事件，event.detail = {value: value} |
\n
| @changing | (event: [SliderChangeEvent](#sliderchangeevent)) => void | - | 拖动过程中触发的事件，event.detail = {value: value} |"
,
"event"
:
"
\n
### 事件
\n
#### SliderChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SliderChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | number | 是 | - | - |
\n\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| disabled | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| min | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| max | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| step | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| value | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| color | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| activeColor | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| backgroundColor | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| block-size | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| block-color | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| show-value | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| @change | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| @changing | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/slider)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/slider/slider.uvue)
\n
"
},
"swiper-item"
:{
"name"
:
"## swiper-item"
,
"description"
:
"swiper的唯一合法子组件。每个swiper-item代表一个滑块。宽高自动设置为100%"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| item-id | String | - | 该 swiper-item 的标识符 |"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| item-id | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/swiper.html#swiper-item)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/swiper-item/swiper-item.uvue)
\n
"
},
"swiper"
:{
"name"
:
"## swiper"
,
"description"
:
"滑块视图容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| indicator-dots | Boolean | false | 是否显示面板指示点 |
\n
| indicator-color | ColorString | rgba(0, 0, 0, .3) | 指示点颜色 |
\n
| indicator-active-color | ColorString | #000000 | 当前选中的指示点颜色 |
\n
| disable-touch | Boolean | false | 是否禁止用户 touch 操作 |
\n
| autoplay | Boolean | false | 是否自动切换 |
\n
| current | Number | 0 | 当前所在滑块的 index |
\n
| current-item-id | String | - | 当前所在滑块的 item-id ，不能与 current 被同时指定 |
\n
| interval | Number | 3000 | 自动切换时间间隔 |
\n
| circular | Boolean | false | 是否采用衔接滑动 |
\n
| vertical | Boolean | false | 滑动方向是否为纵向 |
\n
| @change | (event: [SwiperChangeEvent](#swiperchangeevent)) => void | - | current 改变时会触发 change 事件，event.detail = {current: current, source: source} |
\n
| @transition | (event: [SwiperTransitionEvent](#swipertransitionevent)) => void | - | swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy} |
\n
| @animationfinish | (event: [SwiperAnimationFinishEvent](#swiperanimationfinishevent)) => void | - | 动画结束时会触发 animationfinish 事件，event.detail = {current: current, source: source} |"
,
"event"
:
"
\n
### 事件
\n
#### SwiperChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [SwiperChangeEventdetail](#swiperchangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### SwiperChangeEventdetail 属性值 @swiperchangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| current | number | 是 | - | - |
\n
| source | string | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SwiperTransitionEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [SwiperTransitionEventdetail](#swipertransitioneventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### SwiperTransitionEventdetail 属性值 @swipertransitioneventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| dx | number | 是 | - | - |
\n
| dy | number | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SwiperAnimationFinishEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [SwiperAnimationFinishEventdetail](#swiperanimationfinisheventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### SwiperAnimationFinishEventdetail 属性值 @swiperanimationfinisheventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| current | number | 是 | - | - |
\n
| source | string | 是 | - | - |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| indicator-dots | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| indicator-color | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| indicator-active-color | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| disable-touch | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| autoplay | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| current | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| current-item-id | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| interval | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| circular | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| vertical | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| @change | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| @transition | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
| @animationfinish | 5.0 | √ | 3.9.0 | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/swiper)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/swiper/swiper.uvue)
\n
"
},
"switch"
:{
"name"
:
"## switch"
,
"description"
:
"开关选择器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| checked | Boolean | - | 是否选中 |
\n
| color | ColorString | - | switch 的颜色，同 css 的 color |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @change | (event: [SwitchChangeEvent](#switchchangeevent)) => void | - | checked 改变时触发 change 事件，event.detail={ value:checked} |"
,
"event"
:
"
\n
### 事件
\n
#### SwitchChangeEvent
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | boolean | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | T | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### SwitchChangeEventDetail
\n\n
##### 构造函数
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | boolean | 是 | - | - |
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | boolean | 是 | - | - |
\n\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| checked | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| color | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| disabled | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
| @change | 5.0 | √ | 3.9+ | 9.0 | √ | x |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/switch)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/switch/switch.uvue)
\n
"
},
"text"
:{
"name"
:
"## text"
,
"description"
:
"文本"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| selectable | Boolean | false | 文本是否可选 |
\n
| space | String | - | 显示连续空格 [space](#space-values) |
\n
| decode | Boolean | false | 是否解码 |
\n\n
#### space @space-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| ensp | 中文字符空格一半大小 |
\n
| emsp | 中文字符空格大小 |
\n
| nbsp | 根据字体设置的空格大小 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| text | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/text)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/text/text.uvue)
\n
"
},
"textarea"
:{
"name"
:
"## textarea"
,
"description"
:
"多行输入框"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| value | String | | 输入框的初始内容 |
\n
| placeholder | String | | 输入框为空时占位符 |
\n
| placeholder-style | String | | 指定 placeholder 的样式 |
\n
| placeholder-class | String | | 指定 placeholder 的样式类 |
\n
| maxlength | Number | 140 | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| auto-focus | Boolean | false | 自动获取焦点 |
\n
| focus | Boolean | false | 获取焦点 |
\n
| cursor | Number | 0 | 指定focus时的光标位置 |
\n
| confirm-type | String | done | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| confirm-hold | Boolean | false | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| auto-height | Boolean | false | 是否自动增高，设置auto-height时，style.height不生效 |
\n
| cursor-spacing | Number | 0 | 指定光标与键盘的距离，单位 px 。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| selection-start | Number | -1 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | -1 | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | true | 键盘弹起时，是否自动上推页面 |
\n
| @confirm | (event: [InputConfirmEvent](#inputconfirmevent)) => void | - | 点击完成时， 触发 confirm 事件，event.detail = {value: value} |
\n
| @input | (event: [InputEvent](#inputevent)) => void | - | 当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上 |
\n
| @linechange | (event: [TextareaLineChangeEvent](#textarealinechangeevent)) => void | - | 输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0} |
\n
| @blur | (event: [TextareaBlurEvent](#textareablurevent)) => void | - | 输入框失去焦点时触发，event.detail = {value, cursor} |
\n
| @keyboardheightchange | (event: [InputKeyboardHeightChangeEvent](#inputkeyboardheightchangeevent)) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @focus | (event: [TextareaFocusEvent](#textareafocusevent)) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持 |
\n\n
#### confirm-type @confirm-type-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| send | 发送 |
\n
| search | 搜索 |
\n
| next | 下一个 |
\n
| go | 前往 |
\n
| done | 完成 |
\n\n
"
,
"event"
:
"
\n
### 事件
\n
#### InputConfirmEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputConfirmEventdetail](#inputconfirmeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputConfirmEventdetail 属性值 @inputconfirmeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputEventdetail](#inputeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputEventdetail 属性值 @inputeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n
| cursor | number | 是 | - | 光标的位置 |
\n
| keyCode | number | 是 | - | 输入字符的Unicode值 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### TextareaLineChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [TextareaLineChangeEventdetail](#textarealinechangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### TextareaLineChangeEventdetail 属性值 @textarealinechangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| lineCount | number | 是 | - | 行数 |
\n
| heightRpx | number | 是 | - | textarea的高度 |
\n
| height | number | 是 | - | textarea的高度 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### TextareaBlurEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [TextareaBlurEventdetail](#textareablureventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### TextareaBlurEventdetail 属性值 @textareablureventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| value | string | 是 | - | 输入框内容 |
\n
| cursor | number | 是 | - | 选择区域的起始位置 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### InputKeyboardHeightChangeEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [InputKeyboardHeightChangeEventdetail](#inputkeyboardheightchangeeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### InputKeyboardHeightChangeEventdetail 属性值 @inputkeyboardheightchangeeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| duration | number | 是 | - | 持续时间 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### TextareaFocusEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [TextareaFocusEventdetail](#textareafocuseventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### TextareaFocusEventdetail 属性值 @textareafocuseventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| height | number | 是 | - | 键盘高度 |
\n
| value | string | 是 | - | 输入框内容 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| @confirm | 5.0 | √ | 3.9+ | - | - | - |
\n
| @input | 5.0 | √ | 3.9+ | - | - | - |
\n
| @linechange | 5.0 | √ | 3.9+ | - | - | - |
\n
| @blur | 5.0 | √ | 3.9+ | - | - | - |
\n
| @keyboardheightchange | 5.0 | √ | 3.9+ | - | - | - |
\n
| @focus | 5.0 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/textarea)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/textarea/textarea.uvue)
\n
"
},
"video"
:{
"name"
:
"## video"
,
"description"
:
"视频"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| loop | Boolean | false | 是否循环播放 |
\n
| src | String
\\
|TagVideoURIString | - | 视频资源地址 |
\n
| initial-time | Number | - | 指定视频初始播放位置 |
\n
| duration | Number | - | 指定视频长度 |
\n
| controls | Boolean | true | 是否显示默认播放控件（播放/暂停按钮、播放进度、时间） |
\n
| danmu-list | Array | - | 弹幕列表 |
\n
| danmu-btn | Boolean | false | 是否显示弹幕按钮，只在初始化时有效，不能动态变更 |
\n
| enable-danmu | Boolean | false | 是否展示弹幕，只在初始化时有效，不能动态变更 |
\n
| autoplay | Boolean | false | 是否自动播放 |
\n
| muted | Boolean | false | 是否静音播放 |
\n
| page-gesture | Boolean | false | 在非全屏模式下，是否开启亮度与音量调节手势 |
\n
| direction | Number | -90 | 设置全屏时视频的方向，不指定则根据宽高比自动判断。有效值为 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度） |
\n
| show-progress | Boolean | true | 若不设置，宽度大于240时才会显示 |
\n
| show-fullscreen-btn | Boolean | true | 是否显示全屏按钮 |
\n
| show-play-btn | Boolean | true | 是否显示视频底部控制栏的播放按钮 |
\n
| show-center-play-btn | Boolean | true | 是否显示视频中间的播放按钮 |
\n
| show-loading | Boolean | true | 是否显示loading控件 |
\n
| enable-progress-gesture | Boolean | true | 是否开启控制进度的手势 |
\n
| objectFit | String | contain | 当视频大小与 video 容器大小不一致时，视频的表现形式。 [objectFit](#objectFit-values) |
\n
| poster | String | - | 视频封面的图片网络资源地址，如果 controls 属性值为 false 则设置 poster 无效 |
\n
| show-mute-btn | Boolean | false | 是否显示静音按钮 |
\n
| title | String | - | 视频的标题，全屏时在顶部展示 |
\n
| play-btn-position | String | - | 播放按钮的位置 |
\n
| enable-play-gesture | Boolean | false | 是否开启播放手势，即双击切换播放、暂停 |
\n
| auto-pause-if-navigate | Boolean | - | 当跳转到其它小程序页面时，是否自动暂停本页面的视频 |
\n
| auto-pause-if-open-native | Boolean | - | 当跳转到其它微信原生页面时，是否自动暂停本页面的视频 |
\n
| vslide-gesture | Boolean | false | 在非全屏模式下，是否开启亮度与音量调节手势（同 page-gesture） |
\n
| vslide-gesture-in-fullscreen | Boolean | true | 在全屏模式下，是否开启亮度与音量调节手势 |
\n
| ad-unit-id | String | - | 视频前贴广告单元ID |
\n
| poster-for-crawler | String | - | 用于给搜索等场景作为视频封面展示，建议使用无播放 icon 的视频封面图，只支持网络地址 |
\n
| codec | String | hardware | 解码器选择 |
\n
| http-cache | Boolean | false | 是否对 http、https 视频源开启本地缓存 |
\n
| play-strategy | Number | 0 | 播放策略 |
\n
| is-live | Boolean | - | 是否为直播源 |
\n
| @play | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当开始/继续播放时触发play事件 |
\n
| @pause | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当暂停播放时，触发pause事件 |
\n
| @ended | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当播放到视频末尾时触发ended事件 |
\n
| @timeupdate | (event: [Event](/uni-app-x/component/common#event)) => void | - | 播放进度变化时触发，event.detail = {currentTime, duration} 。触发频率 250ms 一次 |
\n
| @fullscreenchange | (event: [Event](/uni-app-x/component/common#event)) => void | - | 当视频进入和退出全屏是触发，event.detail = {fullScreen, direction}，direction取为 vertical 或 horizontal |
\n
| @waiting | (event: [Event](/uni-app-x/component/common#event)) => void | - | 视频出现缓冲时触发 |
\n
| @error | (event: [Event](/uni-app-x/component/common#event)) => void | - | 播放出错试触发事件 |
\n
| @progress | (event: [Event](/uni-app-x/component/common#event)) => void | - | 加载进度变化时触发，只支持一段加载。event.detail = {buffered}，百分比 |
\n
| @loadedmetadata | (event: [Event](/uni-app-x/component/common#event)) => void | - | 视频元数据加载完成时触发。event.detail = {width, height, duration} |
\n\n
#### objectFit @objectFit-values
\n\n
| 值名称 | 描述 |
\n
| :- | :- |
\n
| contain | 包含 |
\n
| fill | 填充 |
\n
| cover | 覆盖 |
\n\n
"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| video | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
| play-btn-position | 5.0 | x | x | 9.0 | x | - |
\n
| auto-pause-if-navigate | 5.0 | x | x | 9.0 | x | - |
\n
| auto-pause-if-open-native | 5.0 | x | x | 9.0 | x | - |
\n
| ad-unit-id | 5.0 | x | x | 9.0 | x | - |
\n
| poster-for-crawler | 5.0 | x | x | 9.0 | x | - |
\n
| is-live | 5.0 | x | x | 9.0 | x | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/video)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/video/video.uvue)
\n
"
},
"view"
:{
"name"
:
"## view"
,
"description"
:
"基本视图容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| hover-class | String | none | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | false | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | 50 | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | 400 | 手指松开后点击态保留时间，单位毫秒 |"
,
"event"
:
""
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| view | 5.0 | √ | √ | - | - | - |
\n
| hover-class | 5.0 | √ | √ | - | - | - |
\n
| hover-stop-propagation | 5.0 | √ | √ | - | - | - |
\n
| hover-start-time | 5.0 | √ | √ | - | - | - |
\n
| hover-stay-time | 5.0 | √ | √ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/view/view.uvue)
\n
"
},
"web-view"
:{
"name"
:
"## web-view"
,
"description"
:
"承载网页的容器"
,
"attrubute"
:
"### 参数
\n
| 名称 | 类型 | 默认值 | 描述 |
\n
| :- | :- | :- | :- |
\n
| src | String
\\
|URIString | - | webview 指向网页的链接 |
\n
| webview-styles | Object
\\
|Boolean | {
\"
progress
\"
:{
\"
color
\"
:
\"
#00FF00
\"
}} | webview 的样式 |
\n
| @message | (event: [WebViewMessageEvent](#webviewmessageevent)) => void | - | 网页向应用 postMessage 时触发。e.detail = { data } |
\n
| @error | (event: [WebViewErrorEvent](#webviewerrorevent)) => void | - | 网页加载错误时触发。e.detail = { errMsg } |
\n
| @loaded | (event: [WebViewLoadedEvent](#webviewloadedevent)) => void | - | 网页加载完成后触发。 |
\n
| @loading | (event: [WebViewLoadingEvent](#webviewloadingevent)) => void | - | 网页加载中触发。 |"
,
"event"
:
"
\n
### 事件
\n
#### WebViewMessageEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [WebViewMessageEventdetail](#webviewmessageeventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### WebViewMessageEventdetail 属性值 @webviewmessageeventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| data | Map
\\
<string, any> | 否 | - | 消息包含的数据 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### WebViewErrorEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| detail | [WebViewErrorEventdetail](#webviewerroreventdetail) | 是 | - | - |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n
###### WebViewErrorEventdetail 属性值 @webviewerroreventdetail
\n\n
| 名称 | 类型 | 必备 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| errMsg | string | 是 | - | 错误信息 |
\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### WebViewLoadedEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n\n
#### WebViewLoadingEvent
\n\n
##### 属性值
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| type | string | 是 | - | 事件类型 |
\n
| target | [Element](/uni-app-x/dom/element.md) | 是 | - | 触发事件的组件 |
\n
| currentTarget | [Element](/uni-app-x/dom/element.md) | 是 | - | 当前组件 |
\n
| timeStamp | number | 是 | - | 事件发生时的时间戳 |
\n\n\n
##### 方法
\n
| 名称 | 类型 | 必填 | 默认值 | 描述 |
\n
| :- | :- | :- | :- | :- |
\n
| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
\n
| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :- | :- | :- | :- | :- | :- | :- |
\n
| web-view | 5.0 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/web-view)
\n
- [示例](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/master/pages/component/web-view/web-view.uvue)
\n
"
}}
\ No newline at end of file
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑！
取消
想要评论请
注册
或
登录
