Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
d621a2c6
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3190
Star
106
Fork
810
代码
文件
提交
分支
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看板
提交
d621a2c6
编写于
8月 30, 2023
作者:
D
DCloud_LXH
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
feat: uni-app x navigator、web-view
上级
09280771
变更
4
隐藏空白更改
内联
并排
Showing
4 changed file
with
23 addition
and
163 deletion
+23
-163
docs/.vuepress/utils/utsComJson.json
docs/.vuepress/utils/utsComJson.json
+1
-163
docs/uni-app-x/_sidebar.md
docs/uni-app-x/_sidebar.md
+2
-0
docs/uni-app-x/component/navigator.md
docs/uni-app-x/component/navigator.md
+10
-0
docs/uni-app-x/component/web-view.md
docs/uni-app-x/component/web-view.md
+10
-0
未找到文件。
docs/.vuepress/utils/utsComJson.json
浏览文件 @
d621a2c6
{
"animation-view"
:
{
"name"
:
"## animation-view"
,
"description"
:
"Lottie 动画"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| path | String | - | 动画资源地址，目前只支持绝对路径 |
\n
| loop | Boolean | - | 动画是否循环播放 |
\n
| autoplay | Boolean | - | 动画是否自动播放 |
\n
| action | String | - | 动画操作，可取值 play、pause、stop [action](#action-values) |
\n
| hidden | Boolean | - | 是否隐藏动画 |
\n
| @ended | Any | - | - |
\n\n
#### action @action-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| play | 播放 |
\n
| pause | 暂停 |
\n
| stop | 停止 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/animation-view)
\n
"
},
"button"
:
{
"name"
:
"## button"
,
"description"
:
"按钮"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| hover-class | String | - | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | - | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | - | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | - | 手指松开后点击态保留时间，单位毫秒 |
\n
| size | String | - | 按钮的大小 [size](#size-values) |
\n
| type | String | - | 按钮的类型 [type](#type-values) |
\n
| plain | Boolean | - | 按钮是否镂空，背景色透明 |
\n
| loading | Boolean | - | 名称前是否带 loading 图标 |
\n
| form-type | String | - | 用于 form 组件，点击分别会触发 form 组件的 submit/reset 事件 [form-type](#form-type-values) |
\n
| open-type | String | - | 微信开放能力 [open-type](#open-type-values) |
\n
| lang | String | - | 指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。 |
\n
| session-from | String | - | 会话来源 |
\n
| send-message-title | String | - | 会话内消息卡片标题 |
\n
| send-message-path | String | - | 会话内消息卡片点击跳转应用路径 |
\n
| send-message-img | String | - | 会话内消息卡片图片 |
\n
| show-message-card | Boolean | - | 显示会话内消息卡片 |
\n
| app-parameter | String | - | 打开 APP 时，向 APP 传递的参数 |
\n
| group-id | String | - | 打开群资料卡时，传递的群号 |
\n
| guild-id | String | - | 打开频道页面时，传递的频道号 |
\n
| public-id | String | - | 打开公众号资料卡时，传递的号码 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @getuserinfo | (event: Event) => void | - | 用户点击该按钮时，会返回获取到的用户信息，回调的detail数据与wx.getUserInfo返回的一致 |
\n
| @contact | (event: Event) => void | - | 客服消息回调 |
\n
| @getphonenumber | (event: Event) => void | - | 获取用户手机号回调 |
\n
| @error | (event: Event) => void | - | 当使用开放能力时，发生错误的回调 |
\n
| @opensetting | (event: Event) => void | - | 在打开授权设置页后回调 |
\n
| @launchapp | (event: Event) => void | - | 打开 APP 成功的回调 |
\n
| @chooseavatar | (event: Event) => void | - | 获取用户头像回调 |
\n
| @chooseaddress | (event: Event) => void | - | 调起用户编辑并选择收货地址的回调 |
\n
| @chooseinvoicetitle | (event: Event) => void | - | 用户选择发票抬头的回调 |
\n
| @addgroupapp | (event: Event) => void | - | 添加群应用的回调 |
\n
| @subscribe | (event: Event) => void | - | 订阅消息授权回调 |
\n
| @login | (event: Event) => void | - | 登录回调 |
\n\n
#### size @size-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| default | - |
\n
| mini | - |
\n\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| default | - |
\n
| primary | - |
\n
| warn | - |
\n\n\n
#### form-type @form-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| submit | 提交表单 |
\n
| reset | 重置表单 |
\n\n\n
#### open-type @open-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| feedback | 打开“意见反馈”页面，用户可提交反馈内容并上传日志 |
\n
| share | 触发用户转发 |
\n
| getUserInfo | 获取用户信息，可以从@getuserinfo回调中获取到用户信息 |
\n
| contact | 打开客服会话，如果用户在会话中点击消息卡片后返回应用，可以从 @contact 回调中获得具体信息 |
\n
| getPhoneNumber | 获取用户手机号，可以从@getphonenumber回调中获取到用户信息 |
\n
| launchApp | 打开APP，可以通过app-parameter属性设定向APP传的参数 |
\n
| openSetting | 打开授权设置页 |
\n
| chooseAvatar | 获取用户头像，可以从@chooseavatar回调中获取到头像信息 |
\n
| getAuthorize | 支持小程序授权 |
\n
| lifestyle | 关注生活号 |
\n
| contactShare | 分享到通讯录好友 |
\n
| openGroupProfile | 呼起QQ群资料卡页面，可以通过group-id属性设定需要打开的群资料卡的群号，同时manifest.json中必须配置groupIdList |
\n
| openGuildProfile | 呼起频道页面，可以通过guild-id属性设定需要打开的频道ID |
\n
| openPublicProfile | 打开公众号资料卡，可以通过public-id属性设定需要打开的公众号资料卡的号码，同时manifest.json中必须配置publicIdList |
\n
| shareMessageToFriend | 在自定义开放数据域组件中,向指定好友发起分享据 |
\n
| addFriend | 添加好友，对方需要通过该小程序进行授权，允许被加好友后才能调用成功用户授权 |
\n
| addColorSign | 添加彩签，点击后添加状态有用户提示，无回调 |
\n
| addGroupApp | 添加群应用（只有管理员或群主有权操作），添加后给button绑定@addgroupapp事件接收回调数据 |
\n
| addToFavorites | 收藏当前页面，点击按钮后会触发Page.onAddToFavorites方法 |
\n
| chooseAddress | 选择用户收货地址，可以从@chooseaddress回调中获取到用户选择的地址信息 |
\n
| chooseInvoiceTitle | 选择用户发票抬头，可以从@chooseinvoicetitle回调中获取到用户选择发票抬头信息 |
\n
| login | 登录，可以从@login回调中确认是否登录成功 |
\n
| subscribe | 订阅类模板消息，需要用户授权才可发送 |
\n
| favorite | 触发用户收藏 |
\n
| watchLater | 触发用户稍后再看 |
\n
| openProfile | 触发打开用户主页 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/button)
\n
"
},
"checkbox"
:
{
"name"
:
"## checkbox"
,
"description"
:
"多选项目"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | String | - | checkbox 标识，选中时触发 checkbox-group 的 change 事件，并携带 checkbox 的 value |
\n
| checked | Boolean | - | 当前是否选中，可用来设置默认选中 |
\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属性 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
"
},
"checkbox-group"
:
{
"name"
:
"## checkbox-group"
,
"description"
:
"多项选择器，内部由多个checkbox组成"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: CheckboxGroupChangeEvent) => void | - | checkbox-group中选中项发生改变是触发 change 事件，detail = {value:
\\
[选中的checkbox的value的数组
\\
]} |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
"
},
"image"
:
{
"name"
:
"## image"
,
"description"
:
"图片"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| loop | Boolean | - | 是否循环播放 |
\n
| src | ImageURIString | - | 图片资源地址 |
\n
| mode | String | - | 图片裁剪、缩放的模式 [mode](#mode-values) |
\n
| lazy-load | Boolean | - | 图片懒加载。只针对page与scroll-view下的image有效 |
\n
| fade-show | Boolean | - | 图片显示动画效果 |
\n
| webp | Boolean | - | 默认不解析 webP 格式，只支持网络资源 |
\n
| show-menu-by-longpress | Boolean | - | 开启长按图片显示识别小程序码菜单 |
\n
| draggable | Boolean | - | 鼠标长按是否能拖动图片(仅H5平台) |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @error | (event: Event) => void | - | 当错误发生时，发布到 AppService 的事件名，事件对象event.detail = {errMsg: 'something wrong'} |
\n
| @load | (event: Event) => void | - | 当图片载入完毕时，发布到 AppService 的事件名，事件对象event.detail = {height:'图片高度px', width:'图片宽度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
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/image)
\n
"
},
"input"
:
{
"name"
:
"## input"
,
"description"
:
"输入框"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | String | - | 输入框的初始内容 |
\n
| type | String | - | input的类型 [type](#type-values) |
\n
| password | Boolean | - | 是否是密码类型 |
\n
| placeholder | String | - | 输入框为空时占位符 |
\n
| placeholder-style | String | - | 指定 placeholder 的样式 |
\n
| placeholder-class | String | - | 指定 placeholder 的样式类 |
\n
| maxlength | Number | - | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| cursor-spacing | Number | - | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| auto-focus | Boolean | - | 自动获取焦点 |
\n
| focus | Boolean | - | 获取焦点 |
\n
| confirm-type | String | - | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| always-embed | Boolean | - | 强制 input 处于同层状态，默认 focus 时 input 会切到非同层状态 (仅在 iOS 下生效) |
\n
| confirm-hold | Boolean | - | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| cursor | Number | - | 指定focus时的光标位置 |
\n
| selection-start | Number | - | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | - | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | - | 键盘弹起时，是否自动上推页面 |
\n
| text-content-type | String | - | 文本区域的语义，根据类型自动填充 [text-content-type](#text-content-type-values) |
\n
| hold-keyboard | Boolean | - | focus时，点击页面的时候不收起键盘 |
\n
| safe-password-cert-path | String | - | 安全键盘加密公钥的路径，只支持包内路径 |
\n
| safe-password-length | Number | - | 安全键盘输入密码长度 |
\n
| safe-password-time-stamp | Number | - | 安全键盘加密时间戳 |
\n
| safe-password-nonce | String | - | 安全键盘加密盐值 |
\n
| safe-password-salt | String | - | 安全键盘计算 hash 盐值，若指定custom-hash 则无效 |
\n
| safe-password-custom-hash | String | - | 安全键盘计算 hash 的算法表达式 |
\n
| random-number | Boolean | - | 当 type 为 number, digit, idcard 数字键盘是否随机排列 |
\n
| controlled | Boolean | - | 是否为受控组件。为 true 时，value 内容会完全受 setData 控制 |
\n
| always-system | Boolean | - | 是否强制使用系统键盘和 Web-view 创建的 input 元素。为 true 时，confirm-type、confirm-hold 可能失效 |
\n
| inputmode | String | - | 是一个枚举属性，它提供了用户在编辑元素或其内容时可能输入的数据类型的提示。在符合条件的高版本webview里，uni-app的 web 和 app-vue 平台中可使用本属性。 [inputmode](#inputmode-values) |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @input | (event: Event) => void | - | 当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |
\n
| @focus | (event: Event) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持 |
\n
| @blur | (event: Event) => void | - | 输入框失去焦点时触发，event.detail = {value: value} |
\n
| @keyboardheightchange | (event: Event) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @confirm | (event: Event) => void | - | 点击完成按钮时触发，event.detail = {value: value} |
\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| text | 文本输入键盘 |
\n
| number | 数字输入键盘 |
\n
| idcard | 身份证输入键盘 |
\n
| digit | 带小数点数字输入键盘 |
\n
| safe-password | 密码安全输入键盘 |
\n
| nickname | 昵称输入键盘 |
\n\n\n
#### confirm-type @confirm-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| send | 发送 |
\n
| search | 搜索 |
\n
| next | 下一个 |
\n
| go | 前往 |
\n
| done | 完成 |
\n\n\n
#### text-content-type @text-content-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| oneTimeCode | 一次性验证码 |
\n\n\n
#### inputmode @inputmode-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| none | 无虚拟键盘。在应用程序或者站点需要实现自己的键盘输入控件时很有用。 |
\n
| text | 使用用户本地区域设置的标准文本输入键盘。 |
\n
| decimal | 小数输入键盘，包含数字和分隔符（通常是“ . ”或者“ , ”），设备可能也可能不显示减号键。 |
\n
| numeric | 数字输入键盘，所需要的就是 0 到 9 的数字，设备可能也可能不显示减号键。 |
\n
| tel | 电话输入键盘，包含 0 到 9 的数字、星号（*）和井号（#）键。表单输入里面的电话输入通常应该使用
\\\\
<input type=
\"
tel
\"\\\\
> 。 |
\n
| search | 为搜索输入优化的虚拟键盘，比如，返回键可能被重新标记为“搜索”，也可能还有其他的优化。 |
\n
| email | 为邮件地址输入优化的虚拟键盘，通常包含
\"
@
\"
符号和其他优化。表单里面的邮件地址输入应该使用
\\\\
<input type=
\"
email
\"\\\\
> 。 |
\n
| url | 为网址输入优化的虚拟键盘，比如，“/”键会更加明显、历史记录访问等。表单里面的网址输入通常应该使用
\\\\
<input type=
\"
url
\"\\\\
> 。 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/input)
\n
"
},
"list-item"
:
{
"name"
:
"## list-item"
,
"description"
:
"列表组件"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| type | Number | - | 对应list-item的类型 List 将对同类型条目进行复用，所以合理的类型拆分，可以很好地提升 List 性能 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/list-view#list-item)
\n
"
},
"list-view"
:
{
"name"
:
"## list-view"
,
"description"
:
"列表组件"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| scroll-x | Boolean | false | 允许横向滚动 |
\n
| scroll-y | Boolean | false | 允许纵向滚动 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | - | 设置竖向滚动条位置 |
\n
| scroll-left | Number | - | 设置横向滚动条位置 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 在设置滚动条位置时使用动画过渡 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新 |
\n
| refresher-threshold | Number | false | 设置自定义下拉刷新阈值 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black，white，none，none 表示不使用默认样式。默认：black |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色。默认'#FFF' |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @refresherpulling | (event: RefresherEvent) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: RefresherEvent) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: RefresherEvent) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: RefresherEvent) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: ScrollToUpperEvent) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: ScrollToLowerEvent) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: ScrollEvent) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @refresherpulling | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrefresh | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrestore | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherabort | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltoupper | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltolower | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scroll | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
""
},
"picker-view-column"
:
{
"name"
:
"## picker-view-column"
,
"description"
:
"仅可放置于 picker-view 中，其孩子节点的高度会自动设置成与picker-view的选中框的高度一致"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/picker-view.html#picker-view-column)
\n
"
},
"picker-view"
:
{
"name"
:
"## picker-view"
,
"description"
:
"嵌入页面的滚动选择器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | Number | - | picker-view-column 选择的第几项 |
\n
| indicator-style | CSSString | - | 设置选择器中间选中框的样式 |
\n
| indicator-class | ClassString | - | 设置选择器中间选中框的类名 |
\n
| mask-style | CSSString | - | 设置蒙层的样式 |
\n
| mask-class | ClassString | - | 设置蒙层的类名 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: PickerViewChangeEvent) => void | - | 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0
\t\t
开始） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/picker-view)
\n
"
},
"progress"
:
{
"name"
:
"## progress"
,
"description"
:
"进度条"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| duration | Number | 30 | 进度增加1%所需毫秒数 |
\n
| percent | Number | 0 | 百分比0~100 |
\n
| show-info | Boolean | false | 在进度条右侧显示百分比 |
\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: 动画从头播；forwards：动画从上次结束点接着播 [active-mode](#active-mode-values) |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @activeend | (event: ProgressActiveendEvent) => void | - | 动画完成事件 |
\n\n
#### active-mode @active-mode-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| backwards | - |
\n
| forwards | - |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/progress)
\n
"
},
"radio"
:
{
"name"
:
"## radio"
,
"description"
:
"单选项目"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | String | - |
\\
<radio/
\\
> 标识。当该radio 选中时，radio-group的 change 事件会携带radio的value |
\n
| checked | Boolean | - |
\\
<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) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
"
},
"radio-group"
:
{
"name"
:
"## radio-group"
,
"description"
:
"单项选择器，内部由多个 radio 组成"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: RadioGroupChangeEvent) => void | - | radio-group 中的选中项发生变化时触发 change 事件，event.detail = {value: 选中项radio的value} |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
"
},
"rich-text"
:
{
"name"
:
"## rich-text"
,
"description"
:
"富文本"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| nodes | Array | - | 节点列表 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/rich-text)
\n
"
},
"scroll-view"
:
{
"name"
:
"## scroll-view"
,
"description"
:
"可滚动视图区域"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| scroll-x | Boolean | false | 允许横向滚动 |
\n
| scroll-y | Boolean | false | 允许纵向滚动 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | - | 设置竖向滚动条位置 |
\n
| scroll-left | Number | - | 设置横向滚动条位置 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 在设置滚动条位置时使用动画过渡 |
\n
| enable-back-to-top | Boolean | false | iOS点击顶部状态栏、安卓双击标题栏时，滚动条返回顶部，只支持竖向 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新 |
\n
| refresher-threshold | Number | 45 | 设置自定义下拉刷新阈值 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black | white | none， none 表示不使用默认样式 |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色。默认'#FFF' |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @refresherpulling | (event: RefresherEvent) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: RefresherEvent) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: RefresherEvent) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: RefresherEvent) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: ScrollToUpperEvent) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: ScrollToLowerEvent) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: ScrollEvent) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @refresherpulling | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrefresh | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrestore | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherabort | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltoupper | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltolower | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scroll | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/scroll-view)
\n
"
},
"slider"
:
{
"name"
:
"## slider"
,
"description"
:
"滑动选择器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\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
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: SliderChangeEvent) => void | - | 完成一次拖动后触发的事件，event.detail = {value: value} |
\n
| @changing | (event: SliderChangeEvent) => void | - | 拖动过程中触发的事件，event.detail = {value: value} |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @change | 4.4 | √ | 3.9+ | - | - | - |
\n
| @changing | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/slider)
\n
"
},
"swiper-item"
:
{
"name"
:
"## swiper-item"
,
"description"
:
"仅可放置在 swiper 组件中，宽高自动设置为100%"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| item-id | String | - | 该 swiper-item 的标识符 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/swiper.html#swiper-item)
\n
"
},
"swiper"
:
{
"name"
:
"## swiper"
,
"description"
:
"滑块视图容器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| indicator-dots | Boolean | - | 是否显示面板指示点 |
\n
| indicator-color | HexColor | - | 指示点颜色 |
\n
| indicator-active-color | HexColor | - | 当前选中的指示点颜色 |
\n
| active-class | String | - | swiper-item 可见时的 class |
\n
| changing-class | Boolean | - | acceleration 设置为 {{true}} 时且处于滑动过程中，中间若干屏处于可见时的class |
\n
| acceleration | Boolean | - | 当开启时，会根据滑动速度，连续滑动多屏 |
\n
| disable-programmatic-animation | Boolean | - | 是否禁用代码变动触发 swiper 切换时使用动画。 |
\n
| disable-touch | Boolean | - | 是否禁止用户 touch 操作 |
\n
| touchable | Boolean | - | 是否监听用户的触摸事件 |
\n
| easing-function | String | - | 指定 swiper 切换缓动动画类型，有效值：default、linear、easeInCubic、easeOutCubic、easeInOutCubic [easing-function](#easing-function-values) |
\n
| autoplay | Boolean | - | 是否自动切换 |
\n
| current | Number | - | 当前所在滑块的 index |
\n
| current-item-id | String | - | 当前所在滑块的 item-id ，不能与 current 被同时指定 |
\n
| interval | Number | - | 自动切换时间间隔 |
\n
| duration | Number | - | 滑动动画时长 |
\n
| circular | Boolean | - | 是否采用衔接滑动 |
\n
| vertical | Boolean | - | 滑动方向是否为纵向 |
\n
| previous-margin | String | - | 前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值 |
\n
| next-margin | String | - | 后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值 |
\n
| display-multiple-items | Number | - | 同时显示的滑块数量 |
\n
| skip-hidden-item-layout | Boolean | - | 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: Event) => void | - | current 改变时会触发 change 事件，event.detail = {current: current, source: source} |
\n
| @transition | (event: Event) => void | - | swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy} |
\n
| @animationfinish | (event: Event) => void | - | 动画结束时会触发 animationfinish 事件，event.detail = {current: current, source: source} |
\n\n
#### easing-function @easing-function-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| default | - |
\n
| linear | - |
\n
| easeInCubic | - |
\n
| easeOutCubic | - |
\n
| easeInOutCubic | - |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/swiper)
\n
"
},
"switch"
:
{
"name"
:
"## switch"
,
"description"
:
"开关选择器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| checked | Boolean | - | 是否选中 |
\n
| type | String | - | 样式，有效值：switch, checkbox [type](#type-values) |
\n
| color | ColorString | - | switch 的颜色，同 css 的 color |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: SwitchChangeEvent) => void | - | checked 改变时触发 change 事件，event.detail={ value:checked} |
\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| switch | - |
\n
| checkbox | - |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @change | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/switch)
\n
"
},
"text"
:
{
"name"
:
"## text"
,
"description"
:
"文本"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| selectable | Boolean | - | 文本是否可选 |
\n
| space | String | - | 显示连续空格 [space](#space-values) |
\n
| decode | Boolean | - | 是否解码 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n\n
#### space @space-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| ensp | 中文字符空格一半大小 |
\n
| emsp | 中文字符空格大小 |
\n
| nbsp | 根据字体设置的空格大小 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/text)
\n
"
},
"textarea"
:
{
"name"
:
"## textarea"
,
"description"
:
"多行输入框"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| display | Any | - | - |
\n
| value | String | - | 输入框的初始内容 |
\n
| placeholder | String | - | 输入框为空时占位符 |
\n
| placeholder-style | String | - | 指定 placeholder 的样式 |
\n
| placeholder-class | String | - | 指定 placeholder 的样式类 |
\n
| maxlength | Number | - | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| auto-focus | Boolean | - | 自动获取焦点 |
\n
| focus | Boolean | - | 获取焦点 |
\n
| cursor | Number | - | 指定focus时的光标位置 |
\n
| confirm-type | String | - | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| confirm-hold | Boolean | - | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| auto-height | Boolean | - | 是否自动增高，设置auto-height时，style.height不生效 |
\n
| fixed | Boolean | - | 如果 textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true |
\n
| cursor-spacing | Number | - | 指定光标与键盘的距离，单位 px 。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| show-confirm-bar | Boolean | - | 是否显示键盘上方带有”完成“按钮那一栏 |
\n
| selection-start | Number | - | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | - | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | - | 键盘弹起时，是否自动上推页面 |
\n
| inputmode | String | - | 是一个枚举属性，它提供了用户在编辑元素或其内容时可能输入的数据类型的提示。在符合条件的高版本webview里，uni-app的 web 和 app-vue 平台中可使用本属性。 [inputmode](#inputmode-values) |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @confirm | (event: Event) => void | - | 点击完成时， 触发 confirm 事件，event.detail = {value: value} |
\n
| @input | (event: Event) => void | - | 当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上 |
\n
| @linechange | (event: Event) => void | - | 输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0} |
\n
| @blur | (event: Event) => void | - | 输入框失去焦点时触发，event.detail = {value, cursor} |
\n
| @keyboardheightchange | (event: Event) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @focus | (event: Event) => 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\n
#### inputmode @inputmode-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| none | 无虚拟键盘。在应用程序或者站点需要实现自己的键盘输入控件时很有用。 |
\n
| text | 使用用户本地区域设置的标准文本输入键盘。 |
\n
| decimal | 小数输入键盘，包含数字和分隔符（通常是“ . ”或者“ , ”），设备可能也可能不显示减号键。 |
\n
| numeric | 数字输入键盘，所需要的就是 0 到 9 的数字，设备可能也可能不显示减号键。 |
\n
| tel | 电话输入键盘，包含 0 到 9 的数字、星号（*）和井号（#）键。表单输入里面的电话输入通常应该使用
\\\\
<input type=
\"
tel
\"\\\\
> 。 |
\n
| search | 为搜索输入优化的虚拟键盘，比如，返回键可能被重新标记为“搜索”，也可能还有其他的优化。 |
\n
| email | 为邮件地址输入优化的虚拟键盘，通常包含
\"
@
\"
符号和其他优化。表单里面的邮件地址输入应该使用
\\\\
<input type=
\"
email
\"\\\\
> 。 |
\n
| url | 为网址输入优化的虚拟键盘，比如，“/”键会更加明显、历史记录访问等。表单里面的网址输入通常应该使用
\\\\
<input type=
\"
url
\"\\\\
> 。 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @confirm | 4.4 | √ | 3.9+ | - | - | - |
\n
| @input | 4.4 | √ | 3.9+ | - | - | - |
\n
| @linechange | 4.4 | √ | 3.9+ | - | - | - |
\n
| @blur | 4.4 | √ | 3.9+ | - | - | - |
\n
| @keyboardheightchange | 4.4 | √ | 3.9+ | - | - | - |
\n
| @focus | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/textarea)
\n
"
},
"video"
:
{
"name"
:
"## video"
,
"description"
:
"视频"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| loop | Boolean | - | 是否循环播放 |
\n
| src | String
\\
|TagVideoURIString | - | 视频资源地址 |
\n
| initial-time | Number | - | 指定视频初始播放位置 |
\n
| duration | Number | - | 指定视频长度 |
\n
| controls | Boolean | - | 是否显示默认播放控件（播放/暂停按钮、播放进度、时间） |
\n
| danmu-list | Array | - | 弹幕列表 |
\n
| danmu-btn | Boolean | - | 是否显示弹幕按钮，只在初始化时有效，不能动态变更 |
\n
| enable-danmu | Boolean | - | 是否展示弹幕，只在初始化时有效，不能动态变更 |
\n
| autoplay | Boolean | - | 是否自动播放 |
\n
| muted | Boolean | - | 是否静音播放 |
\n
| page-gesture | Boolean | - | 在非全屏模式下，是否开启亮度与音量调节手势 |
\n
| direction | Number | - | 设置全屏时视频的方向，不指定则根据宽高比自动判断。有效值为 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度） |
\n
| show-progress | Boolean | - | 若不设置，宽度大于240时才会显示 |
\n
| show-fullscreen-btn | Boolean | - | 是否显示全屏按钮 |
\n
| show-play-btn | Boolean | - | 是否显示视频底部控制栏的播放按钮 |
\n
| show-center-play-btn | Boolean | - | 是否显示视频中间的播放按钮 |
\n
| enable-progress-gesture | Boolean | - | 是否开启控制进度的手势 |
\n
| objectFit | String | - | 当视频大小与 video 容器大小不一致时，视频的表现形式。 [objectFit](#objectFit-values) |
\n
| poster | String | - | 视频封面的图片网络资源地址，如果 controls 属性值为 false 则设置 poster 无效 |
\n
| show-mute-btn | Boolean | - | 是否显示静音按钮 |
\n
| title | String | - | 视频的标题，全屏时在顶部展示 |
\n
| play-btn-position | String | - | 播放按钮的位置 |
\n
| enable-play-gesture | Boolean | - | 是否开启播放手势，即双击切换播放、暂停 |
\n
| auto-pause-if-navigate | Boolean | - | 当跳转到其它小程序页面时，是否自动暂停本页面的视频 |
\n
| auto-pause-if-open-native | Boolean | - | 当跳转到其它微信原生页面时，是否自动暂停本页面的视频 |
\n
| vslide-gesture | Boolean | - | 在非全屏模式下，是否开启亮度与音量调节手势（同 page-gesture） |
\n
| vslide-gesture-in-fullscreen | Boolean | - | 在全屏模式下，是否开启亮度与音量调节手势 |
\n
| ad-unit-id | String | - | 视频前贴广告单元ID |
\n
| poster-for-crawler | String | - | 用于给搜索等场景作为视频封面展示，建议使用无播放 icon 的视频封面图，只支持网络地址 |
\n
| codec | String | - | 解码器选择 |
\n
| http-cache | Boolean | - | 是否对 http、https 视频源开启本地缓存 |
\n
| play-strategy | Number | - | 播放策略 |
\n
| is-live | Boolean | - | 是否为直播源 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @play | (event: Event) => void | - | 当开始/继续播放时触发play事件 |
\n
| @pause | (event: Event) => void | - | 当暂停播放时，触发pause事件 |
\n
| @ended | (event: Event) => void | - | 当播放到视频末尾时触发ended事件 |
\n
| @timeupdate | (event: Event) => void | - | 播放进度变化时触发，event.detail = {currentTime, duration} 。触发频率 250ms 一次 |
\n
| @fullscreenchange | (event: Event) => void | - | 当视频进入和退出全屏是触发，event.detail = {fullScreen, direction}，direction取为 vertical 或 horizontal |
\n
| @waiting | (event: Event) => void | - | 视频出现缓冲时触发 |
\n
| @error | (event: Event) => void | - | 播放出错试触发事件 |
\n
| @progress | (event: Event) => void | - | 加载进度变化时触发，只支持一段加载。event.detail = {buffered}，百分比 |
\n
| @loadedmetadata | (event: Event) => void | - | 视频元数据加载完成时触发。event.detail = {width, height, duration} |
\n\n
#### objectFit @objectFit-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| contain | 包含 |
\n
| fill | 填充 |
\n
| cover | 覆盖 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/video)
\n
"
},
"view"
:
{
"name"
:
"## view"
,
"description"
:
"基本视图容器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| hover-class | String | - | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | - | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | - | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | - | 手指松开后点击态保留时间，单位毫秒 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| view | 4.4 | √ | √ | - | - | - |
\n
| id | 4.4 | √ | √ | - | - | - |
\n
| style | 4.4 | √ | √ | - | - | - |
\n
| class | 4.4 | √ | √ | - | - | - |
\n
| hover-class | 4.4 | √ | √ | - | - | - |
\n
| hover-stop-propagation | 4.4 | √ | √ | - | - | - |
\n
| hover-start-time | 4.4 | √ | √ | - | - | - |
\n
| hover-stay-time | 4.4 | √ | √ | - | - | - |
\n
| @click | 4.4 | √ | √ | - | - | - |
\n
| @mousedown | 4.4 | √ | √ | - | - | - |
\n
| @mousemove | 4.4 | √ | √ | - | - | - |
\n
| @mouseup | 4.4 | √ | √ | - | - | - |
\n
| @touchstart | 4.4 | √ | √ | - | - | - |
\n
| @touchmove | 4.4 | √ | √ | - | - | - |
\n
| @touchcancel | 4.4 | √ | √ | - | - | - |
\n
| @touchend | 4.4 | √ | √ | - | - | - |
\n
| @tap | 4.4 | √ | √ | - | - | - |
\n
| @longpress | 4.4 | √ | √ | - | - | - |
\n
| @longtap | 4.4 | √ | x | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/view)
\n
"
}
}
\ No newline at end of file
{
"animation-view"
:{
"name"
:
"## animation-view"
,
"description"
:
"Lottie 动画"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| path | String | - | 动画资源地址，目前只支持绝对路径 |
\n
| loop | Boolean | - | 动画是否循环播放 |
\n
| autoplay | Boolean | - | 动画是否自动播放 |
\n
| action | String | - | 动画操作，可取值 play、pause、stop [action](#action-values) |
\n
| hidden | Boolean | - | 是否隐藏动画 |
\n
| @ended | Any | - | - |
\n\n
#### action @action-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| play | 播放 |
\n
| pause | 暂停 |
\n
| stop | 停止 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/animation-view)
\n
"
},
"button"
:{
"name"
:
"## button"
,
"description"
:
"按钮"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| hover-class | String | - | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | - | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | - | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | - | 手指松开后点击态保留时间，单位毫秒 |
\n
| size | String | - | 按钮的大小 [size](#size-values) |
\n
| type | String | - | 按钮的类型 [type](#type-values) |
\n
| plain | Boolean | - | 按钮是否镂空，背景色透明 |
\n
| loading | Boolean | - | 名称前是否带 loading 图标 |
\n
| form-type | String | - | 用于 form 组件，点击分别会触发 form 组件的 submit/reset 事件 [form-type](#form-type-values) |
\n
| open-type | String | - | 微信开放能力 [open-type](#open-type-values) |
\n
| lang | String | - | 指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。 |
\n
| session-from | String | - | 会话来源 |
\n
| send-message-title | String | - | 会话内消息卡片标题 |
\n
| send-message-path | String | - | 会话内消息卡片点击跳转应用路径 |
\n
| send-message-img | String | - | 会话内消息卡片图片 |
\n
| show-message-card | Boolean | - | 显示会话内消息卡片 |
\n
| app-parameter | String | - | 打开 APP 时，向 APP 传递的参数 |
\n
| group-id | String | - | 打开群资料卡时，传递的群号 |
\n
| guild-id | String | - | 打开频道页面时，传递的频道号 |
\n
| public-id | String | - | 打开公众号资料卡时，传递的号码 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @getuserinfo | (event: Event) => void | - | 用户点击该按钮时，会返回获取到的用户信息，回调的detail数据与wx.getUserInfo返回的一致 |
\n
| @contact | (event: Event) => void | - | 客服消息回调 |
\n
| @getphonenumber | (event: Event) => void | - | 获取用户手机号回调 |
\n
| @error | (event: Event) => void | - | 当使用开放能力时，发生错误的回调 |
\n
| @opensetting | (event: Event) => void | - | 在打开授权设置页后回调 |
\n
| @launchapp | (event: Event) => void | - | 打开 APP 成功的回调 |
\n
| @chooseavatar | (event: Event) => void | - | 获取用户头像回调 |
\n
| @chooseaddress | (event: Event) => void | - | 调起用户编辑并选择收货地址的回调 |
\n
| @chooseinvoicetitle | (event: Event) => void | - | 用户选择发票抬头的回调 |
\n
| @addgroupapp | (event: Event) => void | - | 添加群应用的回调 |
\n
| @subscribe | (event: Event) => void | - | 订阅消息授权回调 |
\n
| @login | (event: Event) => void | - | 登录回调 |
\n\n
#### size @size-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| default | - |
\n
| mini | - |
\n\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| default | - |
\n
| primary | - |
\n
| warn | - |
\n\n\n
#### form-type @form-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| submit | 提交表单 |
\n
| reset | 重置表单 |
\n\n\n
#### open-type @open-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| feedback | 打开“意见反馈”页面，用户可提交反馈内容并上传日志 |
\n
| share | 触发用户转发 |
\n
| getUserInfo | 获取用户信息，可以从@getuserinfo回调中获取到用户信息 |
\n
| contact | 打开客服会话，如果用户在会话中点击消息卡片后返回应用，可以从 @contact 回调中获得具体信息 |
\n
| getPhoneNumber | 获取用户手机号，可以从@getphonenumber回调中获取到用户信息 |
\n
| launchApp | 打开APP，可以通过app-parameter属性设定向APP传的参数 |
\n
| openSetting | 打开授权设置页 |
\n
| chooseAvatar | 获取用户头像，可以从@chooseavatar回调中获取到头像信息 |
\n
| getAuthorize | 支持小程序授权 |
\n
| lifestyle | 关注生活号 |
\n
| contactShare | 分享到通讯录好友 |
\n
| openGroupProfile | 呼起QQ群资料卡页面，可以通过group-id属性设定需要打开的群资料卡的群号，同时manifest.json中必须配置groupIdList |
\n
| openGuildProfile | 呼起频道页面，可以通过guild-id属性设定需要打开的频道ID |
\n
| openPublicProfile | 打开公众号资料卡，可以通过public-id属性设定需要打开的公众号资料卡的号码，同时manifest.json中必须配置publicIdList |
\n
| shareMessageToFriend | 在自定义开放数据域组件中,向指定好友发起分享据 |
\n
| addFriend | 添加好友，对方需要通过该小程序进行授权，允许被加好友后才能调用成功用户授权 |
\n
| addColorSign | 添加彩签，点击后添加状态有用户提示，无回调 |
\n
| addGroupApp | 添加群应用（只有管理员或群主有权操作），添加后给button绑定@addgroupapp事件接收回调数据 |
\n
| addToFavorites | 收藏当前页面，点击按钮后会触发Page.onAddToFavorites方法 |
\n
| chooseAddress | 选择用户收货地址，可以从@chooseaddress回调中获取到用户选择的地址信息 |
\n
| chooseInvoiceTitle | 选择用户发票抬头，可以从@chooseinvoicetitle回调中获取到用户选择发票抬头信息 |
\n
| login | 登录，可以从@login回调中确认是否登录成功 |
\n
| subscribe | 订阅类模板消息，需要用户授权才可发送 |
\n
| favorite | 触发用户收藏 |
\n
| watchLater | 触发用户稍后再看 |
\n
| openProfile | 触发打开用户主页 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/button)
\n
"
},
"checkbox"
:{
"name"
:
"## checkbox"
,
"description"
:
"多选项目"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | String | - | checkbox 标识，选中时触发 checkbox-group 的 change 事件，并携带 checkbox 的 value |
\n
| checked | Boolean | - | 当前是否选中，可用来设置默认选中 |
\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属性 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
"
},
"checkbox-group"
:{
"name"
:
"## checkbox-group"
,
"description"
:
"多项选择器，内部由多个checkbox组成"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: CheckboxGroupChangeEvent) => void | - | checkbox-group中选中项发生改变是触发 change 事件，detail = {value:
\\
[选中的checkbox的value的数组
\\
]} |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/checkbox)
\n
"
},
"image"
:{
"name"
:
"## image"
,
"description"
:
"图片"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| loop | Boolean | - | 是否循环播放 |
\n
| src | ImageURIString | - | 图片资源地址 |
\n
| mode | String | - | 图片裁剪、缩放的模式 [mode](#mode-values) |
\n
| lazy-load | Boolean | - | 图片懒加载。只针对page与scroll-view下的image有效 |
\n
| fade-show | Boolean | - | 图片显示动画效果 |
\n
| webp | Boolean | - | 默认不解析 webP 格式，只支持网络资源 |
\n
| show-menu-by-longpress | Boolean | - | 开启长按图片显示识别小程序码菜单 |
\n
| draggable | Boolean | - | 鼠标长按是否能拖动图片(仅H5平台) |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @error | (event: Event) => void | - | 当错误发生时，发布到 AppService 的事件名，事件对象event.detail = {errMsg: 'something wrong'} |
\n
| @load | (event: Event) => void | - | 当图片载入完毕时，发布到 AppService 的事件名，事件对象event.detail = {height:'图片高度px', width:'图片宽度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
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| image | 4.4 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/image)
\n
"
},
"input"
:{
"name"
:
"## input"
,
"description"
:
"输入框"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | String | - | 输入框的初始内容 |
\n
| type | String | - | input的类型 [type](#type-values) |
\n
| password | Boolean | - | 是否是密码类型 |
\n
| placeholder | String | - | 输入框为空时占位符 |
\n
| placeholder-style | String | - | 指定 placeholder 的样式 |
\n
| placeholder-class | String | - | 指定 placeholder 的样式类 |
\n
| maxlength | Number | - | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| cursor-spacing | Number | - | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| auto-focus | Boolean | - | 自动获取焦点 |
\n
| focus | Boolean | - | 获取焦点 |
\n
| confirm-type | String | - | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| always-embed | Boolean | - | 强制 input 处于同层状态，默认 focus 时 input 会切到非同层状态 (仅在 iOS 下生效) |
\n
| confirm-hold | Boolean | - | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| cursor | Number | - | 指定focus时的光标位置 |
\n
| selection-start | Number | - | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | - | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | - | 键盘弹起时，是否自动上推页面 |
\n
| text-content-type | String | - | 文本区域的语义，根据类型自动填充 [text-content-type](#text-content-type-values) |
\n
| hold-keyboard | Boolean | - | focus时，点击页面的时候不收起键盘 |
\n
| safe-password-cert-path | String | - | 安全键盘加密公钥的路径，只支持包内路径 |
\n
| safe-password-length | Number | - | 安全键盘输入密码长度 |
\n
| safe-password-time-stamp | Number | - | 安全键盘加密时间戳 |
\n
| safe-password-nonce | String | - | 安全键盘加密盐值 |
\n
| safe-password-salt | String | - | 安全键盘计算 hash 盐值，若指定custom-hash 则无效 |
\n
| safe-password-custom-hash | String | - | 安全键盘计算 hash 的算法表达式 |
\n
| random-number | Boolean | - | 当 type 为 number, digit, idcard 数字键盘是否随机排列 |
\n
| controlled | Boolean | - | 是否为受控组件。为 true 时，value 内容会完全受 setData 控制 |
\n
| always-system | Boolean | - | 是否强制使用系统键盘和 Web-view 创建的 input 元素。为 true 时，confirm-type、confirm-hold 可能失效 |
\n
| inputmode | String | - | 是一个枚举属性，它提供了用户在编辑元素或其内容时可能输入的数据类型的提示。在符合条件的高版本webview里，uni-app的 web 和 app-vue 平台中可使用本属性。 [inputmode](#inputmode-values) |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @input | (event: Event) => void | - | 当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |
\n
| @focus | (event: Event) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持 |
\n
| @blur | (event: Event) => void | - | 输入框失去焦点时触发，event.detail = {value: value} |
\n
| @keyboardheightchange | (event: Event) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @confirm | (event: Event) => void | - | 点击完成按钮时触发，event.detail = {value: value} |
\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| text | 文本输入键盘 |
\n
| number | 数字输入键盘 |
\n
| idcard | 身份证输入键盘 |
\n
| digit | 带小数点数字输入键盘 |
\n
| safe-password | 密码安全输入键盘 |
\n
| nickname | 昵称输入键盘 |
\n\n\n
#### confirm-type @confirm-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| send | 发送 |
\n
| search | 搜索 |
\n
| next | 下一个 |
\n
| go | 前往 |
\n
| done | 完成 |
\n\n\n
#### text-content-type @text-content-type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| oneTimeCode | 一次性验证码 |
\n\n\n
#### inputmode @inputmode-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| none | 无虚拟键盘。在应用程序或者站点需要实现自己的键盘输入控件时很有用。 |
\n
| text | 使用用户本地区域设置的标准文本输入键盘。 |
\n
| decimal | 小数输入键盘，包含数字和分隔符（通常是“ . ”或者“ , ”），设备可能也可能不显示减号键。 |
\n
| numeric | 数字输入键盘，所需要的就是 0 到 9 的数字，设备可能也可能不显示减号键。 |
\n
| tel | 电话输入键盘，包含 0 到 9 的数字、星号（*）和井号（#）键。表单输入里面的电话输入通常应该使用
\\\\
<input type=
\"
tel
\"\\\\
> 。 |
\n
| search | 为搜索输入优化的虚拟键盘，比如，返回键可能被重新标记为“搜索”，也可能还有其他的优化。 |
\n
| email | 为邮件地址输入优化的虚拟键盘，通常包含
\"
@
\"
符号和其他优化。表单里面的邮件地址输入应该使用
\\\\
<input type=
\"
email
\"\\\\
> 。 |
\n
| url | 为网址输入优化的虚拟键盘，比如，“/”键会更加明显、历史记录访问等。表单里面的网址输入通常应该使用
\\\\
<input type=
\"
url
\"\\\\
> 。 |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/input)
\n
"
},
"list-item"
:{
"name"
:
"## list-item"
,
"description"
:
"列表组件"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| type | Number | - | 对应list-item的类型 List 将对同类型条目进行复用，所以合理的类型拆分，可以很好地提升 List 性能 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/list-view#list-item)
\n
"
},
"list-view"
:{
"name"
:
"## list-view"
,
"description"
:
"列表组件"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| scroll-x | Boolean | false | 允许横向滚动 |
\n
| scroll-y | Boolean | false | 允许纵向滚动 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | - | 设置竖向滚动条位置 |
\n
| scroll-left | Number | - | 设置横向滚动条位置 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 在设置滚动条位置时使用动画过渡 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新 |
\n
| refresher-threshold | Number | false | 设置自定义下拉刷新阈值 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black，white，none，none 表示不使用默认样式。默认：black |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色。默认'#FFF' |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @refresherpulling | (event: RefresherEvent) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: RefresherEvent) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: RefresherEvent) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: RefresherEvent) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: ScrollToUpperEvent) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: ScrollToLowerEvent) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: ScrollEvent) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @refresherpulling | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrefresh | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrestore | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherabort | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltoupper | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltolower | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scroll | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
""
},
"navigator"
:{
"name"
:
"## navigator"
,
"description"
:
"页面链接"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\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
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\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
#### 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
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/navigator)
\n
"
},
"picker-view-column"
:{
"name"
:
"## picker-view-column"
,
"description"
:
"仅可放置于 picker-view 中，其孩子节点的高度会自动设置成与picker-view的选中框的高度一致"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/picker-view.html#picker-view-column)
\n
"
},
"picker-view"
:{
"name"
:
"## picker-view"
,
"description"
:
"嵌入页面的滚动选择器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | Number | - | picker-view-column 选择的第几项 |
\n
| indicator-style | CSSString | - | 设置选择器中间选中框的样式 |
\n
| indicator-class | ClassString | - | 设置选择器中间选中框的类名 |
\n
| mask-style | CSSString | - | 设置蒙层的样式 |
\n
| mask-class | ClassString | - | 设置蒙层的类名 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: PickerViewChangeEvent) => void | - | 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0
\t\t
开始） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/picker-view)
\n
"
},
"progress"
:{
"name"
:
"## progress"
,
"description"
:
"进度条"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| duration | Number | 30 | 进度增加1%所需毫秒数 |
\n
| percent | Number | 0 | 百分比0~100 |
\n
| show-info | Boolean | false | 在进度条右侧显示百分比 |
\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: 动画从头播；forwards：动画从上次结束点接着播 [active-mode](#active-mode-values) |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @activeend | (event: ProgressActiveendEvent) => void | - | 动画完成事件 |
\n\n
#### active-mode @active-mode-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| backwards | - |
\n
| forwards | - |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/progress)
\n
"
},
"radio"
:{
"name"
:
"## radio"
,
"description"
:
"单选项目"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| value | String | - |
\\
<radio/
\\
> 标识。当该radio 选中时，radio-group的 change 事件会携带radio的value |
\n
| checked | Boolean | - |
\\
<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) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
"
},
"radio-group"
:{
"name"
:
"## radio-group"
,
"description"
:
"单项选择器，内部由多个 radio 组成"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: RadioGroupChangeEvent) => void | - | radio-group 中的选中项发生变化时触发 change 事件，event.detail = {value: 选中项radio的value} |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/radio)
\n
"
},
"rich-text"
:{
"name"
:
"## rich-text"
,
"description"
:
"富文本"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| nodes | Array | - | 节点列表 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| rich-text | 4.4 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/rich-text)
\n
"
},
"scroll-view"
:{
"name"
:
"## scroll-view"
,
"description"
:
"可滚动视图区域"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| scroll-x | Boolean | false | 允许横向滚动 |
\n
| scroll-y | Boolean | false | 允许纵向滚动 |
\n
| rebound | Boolean | true | 控制是否回弹效果 |
\n
| upper-threshold | Number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |
\n
| lower-threshold | Number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |
\n
| scroll-top | Number | - | 设置竖向滚动条位置 |
\n
| scroll-left | Number | - | 设置横向滚动条位置 |
\n
| scroll-into-view | String | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素 |
\n
| scroll-with-animation | Boolean | false | 在设置滚动条位置时使用动画过渡 |
\n
| refresher-enabled | Boolean | false | 开启自定义下拉刷新 |
\n
| refresher-threshold | Number | 45 | 设置自定义下拉刷新阈值 |
\n
| refresher-default-style | String | black | 设置自定义下拉刷新默认样式，支持设置 black | white | none， none 表示不使用默认样式 |
\n
| refresher-background | String | #FFF | 设置自定义下拉刷新区域背景颜色。默认'#FFF' |
\n
| refresher-triggered | Boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |
\n
| show-scrollbar | Boolean | true | 控制是否出现滚动条 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @refresherpulling | (event: RefresherEvent) => void | - | 自定义下拉刷新控件被下拉 |
\n
| @refresherrefresh | (event: RefresherEvent) => void | - | 自定义下拉刷新被触发 |
\n
| @refresherrestore | (event: RefresherEvent) => void | - | 自定义下拉刷新被复位 |
\n
| @refresherabort | (event: RefresherEvent) => void | - | 自定义下拉刷新被中止 |
\n
| @scrolltoupper | (event: ScrollToUpperEvent) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |
\n
| @scrolltolower | (event: ScrollToLowerEvent) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |
\n
| @scroll | (event: ScrollEvent) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @refresherpulling | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrefresh | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherrestore | 4.4 | √ | 3.9+ | - | - | - |
\n
| @refresherabort | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltoupper | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scrolltolower | 4.4 | √ | 3.9+ | - | - | - |
\n
| @scroll | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/scroll-view)
\n
"
},
"slider"
:{
"name"
:
"## slider"
,
"description"
:
"滑动选择器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\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
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: SliderChangeEvent) => void | - | 完成一次拖动后触发的事件，event.detail = {value: value} |
\n
| @changing | (event: SliderChangeEvent) => void | - | 拖动过程中触发的事件，event.detail = {value: value} |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @change | 4.4 | √ | 3.9+ | - | - | - |
\n
| @changing | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/slider)
\n
"
},
"swiper-item"
:{
"name"
:
"## swiper-item"
,
"description"
:
"仅可放置在 swiper 组件中，宽高自动设置为100%"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| item-id | String | - | 该 swiper-item 的标识符 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.net.cn/component/swiper.html#swiper-item)
\n
"
},
"swiper"
:{
"name"
:
"## swiper"
,
"description"
:
"滑块视图容器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| indicator-dots | Boolean | - | 是否显示面板指示点 |
\n
| indicator-color | HexColor | - | 指示点颜色 |
\n
| indicator-active-color | HexColor | - | 当前选中的指示点颜色 |
\n
| active-class | String | - | swiper-item 可见时的 class |
\n
| changing-class | Boolean | - | acceleration 设置为 {{true}} 时且处于滑动过程中，中间若干屏处于可见时的class |
\n
| acceleration | Boolean | - | 当开启时，会根据滑动速度，连续滑动多屏 |
\n
| disable-programmatic-animation | Boolean | - | 是否禁用代码变动触发 swiper 切换时使用动画。 |
\n
| disable-touch | Boolean | - | 是否禁止用户 touch 操作 |
\n
| touchable | Boolean | - | 是否监听用户的触摸事件 |
\n
| easing-function | String | - | 指定 swiper 切换缓动动画类型，有效值：default、linear、easeInCubic、easeOutCubic、easeInOutCubic [easing-function](#easing-function-values) |
\n
| autoplay | Boolean | - | 是否自动切换 |
\n
| current | Number | - | 当前所在滑块的 index |
\n
| current-item-id | String | - | 当前所在滑块的 item-id ，不能与 current 被同时指定 |
\n
| interval | Number | - | 自动切换时间间隔 |
\n
| duration | Number | - | 滑动动画时长 |
\n
| circular | Boolean | - | 是否采用衔接滑动 |
\n
| vertical | Boolean | - | 滑动方向是否为纵向 |
\n
| previous-margin | String | - | 前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值 |
\n
| next-margin | String | - | 后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值 |
\n
| display-multiple-items | Number | - | 同时显示的滑块数量 |
\n
| skip-hidden-item-layout | Boolean | - | 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: Event) => void | - | current 改变时会触发 change 事件，event.detail = {current: current, source: source} |
\n
| @transition | (event: Event) => void | - | swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy} |
\n
| @animationfinish | (event: Event) => void | - | 动画结束时会触发 animationfinish 事件，event.detail = {current: current, source: source} |
\n\n
#### easing-function @easing-function-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| default | - |
\n
| linear | - |
\n
| easeInCubic | - |
\n
| easeOutCubic | - |
\n
| easeInOutCubic | - |
\n
"
,
"compatibility"
:
""
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/swiper)
\n
"
},
"switch"
:{
"name"
:
"## switch"
,
"description"
:
"开关选择器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| checked | Boolean | - | 是否选中 |
\n
| type | String | - | 样式，有效值：switch, checkbox [type](#type-values) |
\n
| color | ColorString | - | switch 的颜色，同 css 的 color |
\n
| disabled | Boolean | - | 是否禁用 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @change | (event: SwitchChangeEvent) => void | - | checked 改变时触发 change 事件，event.detail={ value:checked} |
\n\n
#### type @type-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| switch | - |
\n
| checkbox | - |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @change | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/switch)
\n
"
},
"text"
:{
"name"
:
"## text"
,
"description"
:
"文本"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| selectable | Boolean | - | 文本是否可选 |
\n
| space | String | - | 显示连续空格 [space](#space-values) |
\n
| decode | Boolean | - | 是否解码 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n\n
#### space @space-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| ensp | 中文字符空格一半大小 |
\n
| emsp | 中文字符空格大小 |
\n
| nbsp | 根据字体设置的空格大小 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| text | 4.4 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/text)
\n
"
},
"textarea"
:{
"name"
:
"## textarea"
,
"description"
:
"多行输入框"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| display | Any | - | - |
\n
| value | String | - | 输入框的初始内容 |
\n
| placeholder | String | - | 输入框为空时占位符 |
\n
| placeholder-style | String | - | 指定 placeholder 的样式 |
\n
| placeholder-class | String | - | 指定 placeholder 的样式类 |
\n
| maxlength | Number | - | 最大输入长度，设置为 -1 的时候不限制最大长度 |
\n
| auto-focus | Boolean | - | 自动获取焦点 |
\n
| focus | Boolean | - | 获取焦点 |
\n
| cursor | Number | - | 指定focus时的光标位置 |
\n
| confirm-type | String | - | 设置键盘右下角按钮的文字 [confirm-type](#confirm-type-values) |
\n
| confirm-hold | Boolean | - | 点击键盘右下角按钮时是否保持键盘不收起 |
\n
| auto-height | Boolean | - | 是否自动增高，设置auto-height时，style.height不生效 |
\n
| fixed | Boolean | - | 如果 textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true |
\n
| cursor-spacing | Number | - | 指定光标与键盘的距离，单位 px 。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
\n
| show-confirm-bar | Boolean | - | 是否显示键盘上方带有”完成“按钮那一栏 |
\n
| selection-start | Number | - | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
\n
| selection-end | Number | - | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |
\n
| adjust-position | Boolean | - | 键盘弹起时，是否自动上推页面 |
\n
| inputmode | String | - | 是一个枚举属性，它提供了用户在编辑元素或其内容时可能输入的数据类型的提示。在符合条件的高版本webview里，uni-app的 web 和 app-vue 平台中可使用本属性。 [inputmode](#inputmode-values) |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @confirm | (event: Event) => void | - | 点击完成时， 触发 confirm 事件，event.detail = {value: value} |
\n
| @input | (event: Event) => void | - | 当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上 |
\n
| @linechange | (event: Event) => void | - | 输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0} |
\n
| @blur | (event: Event) => void | - | 输入框失去焦点时触发，event.detail = {value, cursor} |
\n
| @keyboardheightchange | (event: Event) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
\n
| @focus | (event: Event) => 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\n
#### inputmode @inputmode-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| none | 无虚拟键盘。在应用程序或者站点需要实现自己的键盘输入控件时很有用。 |
\n
| text | 使用用户本地区域设置的标准文本输入键盘。 |
\n
| decimal | 小数输入键盘，包含数字和分隔符（通常是“ . ”或者“ , ”），设备可能也可能不显示减号键。 |
\n
| numeric | 数字输入键盘，所需要的就是 0 到 9 的数字，设备可能也可能不显示减号键。 |
\n
| tel | 电话输入键盘，包含 0 到 9 的数字、星号（*）和井号（#）键。表单输入里面的电话输入通常应该使用
\\\\
<input type=
\"
tel
\"\\\\
> 。 |
\n
| search | 为搜索输入优化的虚拟键盘，比如，返回键可能被重新标记为“搜索”，也可能还有其他的优化。 |
\n
| email | 为邮件地址输入优化的虚拟键盘，通常包含
\"
@
\"
符号和其他优化。表单里面的邮件地址输入应该使用
\\\\
<input type=
\"
email
\"\\\\
> 。 |
\n
| url | 为网址输入优化的虚拟键盘，比如，“/”键会更加明显、历史记录访问等。表单里面的网址输入通常应该使用
\\\\
<input type=
\"
url
\"\\\\
> 。 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| @confirm | 4.4 | √ | 3.9+ | - | - | - |
\n
| @input | 4.4 | √ | 3.9+ | - | - | - |
\n
| @linechange | 4.4 | √ | 3.9+ | - | - | - |
\n
| @blur | 4.4 | √ | 3.9+ | - | - | - |
\n
| @keyboardheightchange | 4.4 | √ | 3.9+ | - | - | - |
\n
| @focus | 4.4 | √ | 3.9+ | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/textarea)
\n
"
},
"video"
:{
"name"
:
"## video"
,
"description"
:
"视频"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| loop | Boolean | - | 是否循环播放 |
\n
| src | String
\\
|TagVideoURIString | - | 视频资源地址 |
\n
| initial-time | Number | - | 指定视频初始播放位置 |
\n
| duration | Number | - | 指定视频长度 |
\n
| controls | Boolean | - | 是否显示默认播放控件（播放/暂停按钮、播放进度、时间） |
\n
| danmu-list | Array | - | 弹幕列表 |
\n
| danmu-btn | Boolean | - | 是否显示弹幕按钮，只在初始化时有效，不能动态变更 |
\n
| enable-danmu | Boolean | - | 是否展示弹幕，只在初始化时有效，不能动态变更 |
\n
| autoplay | Boolean | - | 是否自动播放 |
\n
| muted | Boolean | - | 是否静音播放 |
\n
| page-gesture | Boolean | - | 在非全屏模式下，是否开启亮度与音量调节手势 |
\n
| direction | Number | - | 设置全屏时视频的方向，不指定则根据宽高比自动判断。有效值为 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度） |
\n
| show-progress | Boolean | - | 若不设置，宽度大于240时才会显示 |
\n
| show-fullscreen-btn | Boolean | - | 是否显示全屏按钮 |
\n
| show-play-btn | Boolean | - | 是否显示视频底部控制栏的播放按钮 |
\n
| show-center-play-btn | Boolean | - | 是否显示视频中间的播放按钮 |
\n
| enable-progress-gesture | Boolean | - | 是否开启控制进度的手势 |
\n
| objectFit | String | - | 当视频大小与 video 容器大小不一致时，视频的表现形式。 [objectFit](#objectFit-values) |
\n
| poster | String | - | 视频封面的图片网络资源地址，如果 controls 属性值为 false 则设置 poster 无效 |
\n
| show-mute-btn | Boolean | - | 是否显示静音按钮 |
\n
| title | String | - | 视频的标题，全屏时在顶部展示 |
\n
| play-btn-position | String | - | 播放按钮的位置 |
\n
| enable-play-gesture | Boolean | - | 是否开启播放手势，即双击切换播放、暂停 |
\n
| auto-pause-if-navigate | Boolean | - | 当跳转到其它小程序页面时，是否自动暂停本页面的视频 |
\n
| auto-pause-if-open-native | Boolean | - | 当跳转到其它微信原生页面时，是否自动暂停本页面的视频 |
\n
| vslide-gesture | Boolean | - | 在非全屏模式下，是否开启亮度与音量调节手势（同 page-gesture） |
\n
| vslide-gesture-in-fullscreen | Boolean | - | 在全屏模式下，是否开启亮度与音量调节手势 |
\n
| ad-unit-id | String | - | 视频前贴广告单元ID |
\n
| poster-for-crawler | String | - | 用于给搜索等场景作为视频封面展示，建议使用无播放 icon 的视频封面图，只支持网络地址 |
\n
| codec | String | - | 解码器选择 |
\n
| http-cache | Boolean | - | 是否对 http、https 视频源开启本地缓存 |
\n
| play-strategy | Number | - | 播放策略 |
\n
| is-live | Boolean | - | 是否为直播源 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @play | (event: Event) => void | - | 当开始/继续播放时触发play事件 |
\n
| @pause | (event: Event) => void | - | 当暂停播放时，触发pause事件 |
\n
| @ended | (event: Event) => void | - | 当播放到视频末尾时触发ended事件 |
\n
| @timeupdate | (event: Event) => void | - | 播放进度变化时触发，event.detail = {currentTime, duration} 。触发频率 250ms 一次 |
\n
| @fullscreenchange | (event: Event) => void | - | 当视频进入和退出全屏是触发，event.detail = {fullScreen, direction}，direction取为 vertical 或 horizontal |
\n
| @waiting | (event: Event) => void | - | 视频出现缓冲时触发 |
\n
| @error | (event: Event) => void | - | 播放出错试触发事件 |
\n
| @progress | (event: Event) => void | - | 加载进度变化时触发，只支持一段加载。event.detail = {buffered}，百分比 |
\n
| @loadedmetadata | (event: Event) => void | - | 视频元数据加载完成时触发。event.detail = {width, height, duration} |
\n\n
#### objectFit @objectFit-values
\n\n
| 值名称 | 描述 |
\n
| :-| :-|
\n
| contain | 包含 |
\n
| fill | 填充 |
\n
| cover | 覆盖 |
\n
"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| video | 4.4 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/video)
\n
"
},
"view"
:{
"name"
:
"## view"
,
"description"
:
"基本视图容器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| hover-class | String | - | 指定按下去的样式类。当 hover-class=
\"
none
\"
时，没有点击态效果 |
\n
| hover-stop-propagation | Boolean | - | 指定是否阻止本节点的祖先节点出现点击态 |
\n
| hover-start-time | Number | - | 按住后多久出现点击态，单位毫秒 |
\n
| hover-stay-time | Number | - | 手指松开后点击态保留时间，单位毫秒 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| view | 4.4 | √ | √ | - | - | - |
\n
| id | 4.4 | √ | √ | - | - | - |
\n
| style | 4.4 | √ | √ | - | - | - |
\n
| class | 4.4 | √ | √ | - | - | - |
\n
| hover-class | 4.4 | √ | √ | - | - | - |
\n
| hover-stop-propagation | 4.4 | √ | √ | - | - | - |
\n
| hover-start-time | 4.4 | √ | √ | - | - | - |
\n
| hover-stay-time | 4.4 | √ | √ | - | - | - |
\n
| @click | 4.4 | √ | √ | - | - | - |
\n
| @mousedown | 4.4 | √ | √ | - | - | - |
\n
| @mousemove | 4.4 | √ | √ | - | - | - |
\n
| @mouseup | 4.4 | √ | √ | - | - | - |
\n
| @touchstart | 4.4 | √ | √ | - | - | - |
\n
| @touchmove | 4.4 | √ | √ | - | - | - |
\n
| @touchcancel | 4.4 | √ | √ | - | - | - |
\n
| @touchend | 4.4 | √ | √ | - | - | - |
\n
| @tap | 4.4 | √ | √ | - | - | - |
\n
| @longpress | 4.4 | √ | √ | - | - | - |
\n
| @longtap | 4.4 | √ | x | - | - | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/view)
\n
"
},
"web-view"
:{
"name"
:
"## web-view"
,
"description"
:
"承载网页的容器"
,
"attrubute"
:
"### 参数
\n
| 属性名 | 类型 | 默认值 | 描述 |
\n
| :-| :-| :-| :-|
\n
| id | IDString | - | 唯一标识 |
\n
| style | String | - | 样式声明 |
\n
| class | ClassString | - | 引用样式表 |
\n
| src | String
\\
|URIString | - | webview 指向网页的链接 |
\n
| webview-styles | Object
\\
|Boolean | - | webview 的样式 |
\n
| @click | (event: MouseEvent) => void | - | 组件被点击时触发 |
\n
| @mousedown | (event: MouseEvent) => void | - | 鼠标在元素上点击后触发 |
\n
| @mousemove | (event: MouseEvent) => void | - | 鼠标在元素上移动时触发 |
\n
| @mouseup | (event: MouseEvent) => void | - | 鼠标主按钮在元素上松开时触发 |
\n
| @touchstart | (event: TouchEvent) => void | - | 手指触摸动作开始 |
\n
| @touchmove | (event: TouchEvent) => void | - | 手指触摸后移动 |
\n
| @touchcancel | (event: TouchEvent) => void | - | 手指触摸动作被打断，如来电提醒，弹窗 |
\n
| @touchend | (event: TouchEvent) => void | - | 手指触摸动作结束 |
\n
| @tap | (event: MouseEvent) => void | - | 手指触摸后马上离开 |
\n
| @longpress | (event: Event) => void | - | 如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。 |
\n
| @longtap | (event: Event) => void | - | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
\n
| @message | (event: Event) => void | - | 网页向应用 postMessage 时，会在特定时机（应用后退、组件销毁、分享）触发并收到消息。e.detail = { data } |"
,
"compatibility"
:
"
\n
### 兼容性
\n
| | 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
\n
| :-| :-| :-| :-| :-| :-| :-|
\n
| web-view | 4.4 | √ | 3.9.0 | 9.0 | √ | - |
\n
"
,
"reference"
:
"
\n
### 参见
\n
- [Reference](https://uniapp.dcloud.io/component/web-view)
\n
"
}}
\ No newline at end of file
docs/uni-app-x/_sidebar.md
浏览文件 @
d621a2c6
...
...
@@ -7,6 +7,7 @@
*
[
view
](
component/view.md
)
*
[
scroll-view
](
component/scroll-view.md
)
*
[
list-view
](
component/list-view.md
)
*
[
navigator
](
component/navigator.md
)
*
[
swiper
](
component/swiper.md
)
*
[
text
](
component/text.md
)
*
[
rich-text
](
component/rich-text.md
)
...
...
@@ -22,6 +23,7 @@
*
[
switch
](
component/switch.md
)
*
[
video
](
component/video.md
)
*
[
animation-view
](
component/animation-view.md
)
*
[
web-view
](
component/web-view.md
)
*
[
API
](
api.md
)
*
CSS
*
[
CSS概述
](
css/README.md
)
...
...
docs/uni-app-x/component/navigator.md
0 → 100644
浏览文件 @
d621a2c6
<!-- UTSCOMJSON.navigator.name -->
<!-- UTSCOMJSON.navigator.description -->
<!-- UTSCOMJSON.navigator.attrubute -->
<!-- UTSCOMJSON.navigator.compatibility -->
<!-- UTSCOMJSON.navigator.reference -->
docs/uni-app-x/component/web-view.md
0 → 100644
浏览文件 @
d621a2c6
<!-- UTSCOMJSON.web-view.name -->
<!-- UTSCOMJSON.web-view.description -->
<!-- UTSCOMJSON.web-view.attrubute -->
<!-- UTSCOMJSON.web-view.compatibility -->
<!-- UTSCOMJSON.web-view.reference -->
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑！
取消
想要评论请
注册
或
登录
