{"animation-view":{"name":"## animation-view","description":"Lottie 动画\n\n### animation-view 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | - |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| path | string | \"\" | 动画资源地址，目前只支持绝对路径 |\n| loop | boolean | false | 动画是否循环播放 |\n| autoplay | boolean | false | 动画是否自动播放 |\n| action | string | \"stop\" | 动画操作，可取值 play、pause、stop |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| play | 播放 |\n@| pause | 暂停 |\n@| stop | 停止 |\n| hidden | boolean | false | 是否隐藏动画 |\n| @ended | (event: [UniEvent](/component/common#unievent)) => void | - | - |\n\n#### action 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| play | 3.9 | 4.11 | - |\n| pause | 3.9 | 4.11 | - |\n| stop | 3.9 | 4.11 | - |\n","event":"","example":"","compatibility":"### animation-view 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| path | 3.9 | 4.11 | - |\n| loop | 3.9 | 4.11 | - |\n| autoplay | 3.9 | 4.11 | - |\n| action | 3.9 | 4.11 | - |\n| hidden | 3.9 | 4.11 | - |\n| @ended | 3.9 | 4.11 | - |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/animation-view)\n- [插件市场](https://ext.dcloud.net.cn/plugin?id=10674)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/animation-view.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.animation-view)\n"},"button":{"name":"## button","description":"> 组件类型：UniButtonElement \n\n 按钮\n\n### button 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| disabled | boolean | false | 是否禁用 |\n| hover-class | string([string.ClassString](/uts/data-type.md#ide-string)) | \"button-hover\" | 指定按下去的样式类。当 hover-class=\"none\" 时，没有点击态效果 |\n| hover-stop-propagation | boolean | - | 指定是否阻止本节点的祖先节点出现点击态 |\n| hover-start-time | number | 20 | 按住后多久出现点击态，单位毫秒 |\n| hover-stay-time | number | 70 | 手指松开后点击态保留时间，单位毫秒 |\n| size | string | \"default\" | 按钮的大小 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| default | 默认大小 |\n@| mini | 小尺寸 |\n| type | string | \"default\" | 按钮的样式类型 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| default | 白色 |\n@| primary | 蓝色 |\n@| warn | 红色 |\n| plain | boolean | false | 按钮是否镂空，背景色透明 |\n| loading | boolean | - | 名称前是否带 loading 图标 |\n| form-type | string | - | 用于 form 组件，点击分别会触发 form 组件的 submit/reset 事件 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| submit | 提交表单 |\n@| reset | 重置表单 |\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| @getuserinfo | (event: [UniEvent](/component/common#unievent)) => void | - | 用户点击该按钮时，会返回获取到的用户信息，回调的detail数据与wx.getUserInfo返回的一致 |\n| @contact | (event: [UniEvent](/component/common#unievent)) => void | - | 客服消息回调 |\n| @getphonenumber | (event: [UniEvent](/component/common#unievent)) => void | - | 获取用户手机号回调 |\n| @opensetting | (event: [UniEvent](/component/common#unievent)) => void | - | 在打开授权设置页后回调 |\n| @launchapp | (event: [UniEvent](/component/common#unievent)) => void | - | 打开 APP 成功的回调 |\n| @chooseavatar | (event: [UniEvent](/component/common#unievent)) => void | - | 获取用户头像回调 |\n| @chooseaddress | (event: [UniEvent](/component/common#unievent)) => void | - | 调起用户编辑并选择收货地址的回调 |\n| @addgroupapp | (event: [UniEvent](/component/common#unievent)) => void | - | 添加群应用的回调 |\n\n#### size 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| default | √ | 4.11 | 4.0 |\n| mini | √ | x | 4.0 |\n\n\n#### type 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| default | √ | 4.11 | 4.0 |\n| primary | √ | x | 4.0 |\n| warn | √ | x | 4.0 |\n\n\n#### form-type 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| submit | √ | 4.11 | 4.0 |\n| reset | √ | x | 4.0 |\n","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/button/button.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/button/button\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n import { ItemType } from '@/components/enum-data/enum-data'\r\n export default {\r\n data() {\r\n return {\r\n plain_boolean: false,\r\n disabled_boolean: false,\r\n default_style: false,\r\n size_enum: [{ \"value\": 0, \"name\": \"default\" }, { \"value\": 1, \"name\": \"mini\" }] as ItemType[],\r\n size_enum_current: 0,\r\n type_enum: [{ \"value\": 0, \"name\": \"default\" }, { \"value\": 1, \"name\": \"primary\" }, { \"value\": 2, \"name\": \"warn\" }] as ItemType[],\r\n type_enum_current: 0,\r\n count: 0,\r\n text: 'uni-app-x'\r\n }\r\n },\r\n methods: {\r\n button_click() {\r\n console.log(\"组件被点击时触发\")\r\n this.count++\r\n },\r\n button_touchstart() { console.log(\"手指触摸动作开始\") },\r\n button_touchmove() { console.log(\"手指触摸后移动\") },\r\n button_touchcancel() { console.log(\"手指触摸动作被打断，如来电提醒，弹窗\") },\r\n button_touchend() { console.log(\"手指触摸动作结束\") },\r\n button_tap() { console.log(\"手指触摸后马上离开\") },\r\n button_longpress() { console.log(\"如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。\") },\r\n change_plain_boolean(checked : boolean) { this.plain_boolean = checked },\r\n change_disabled_boolean(checked : boolean) { this.disabled_boolean = checked },\r\n change_default_style(checked : boolean) { this.default_style = checked },\r\n radio_change_size_enum(checked : number) { this.size_enum_current = checked },\r\n radio_change_type_enum(checked : number) { this.type_enum_current = checked },\r\n confirm_text_input(value : string) { this.text = value },\r\n navigateToChild() {\r\n uni.navigateTo({\r\n url: 'buttonstatus',\r\n })\r\n },\r\n //用于自动化测试\r\n checkUniButtonElement() : boolean {\r\n const button = uni.getElementById(\"testButton\")\r\n if (button != null && button instanceof UniButtonElement) {\r\n return true\r\n }\r\n return false\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### button 属性兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| disabled | 5.0 | √ | 4.11 | 4.0 |\n| hover-class | 5.0 | √ | 4.11 | 4.0 |\n| hover-stop-propagation | x | x | x | 4.0 |\n| hover-start-time | 5.0 | √ | 4.11 | 4.0 |\n| hover-stay-time | 5.0 | √ | 4.11 | 4.0 |\n| size | 5.0 | √ | x | 4.0 |\n| type | 5.0 | √ | x | 4.0 |\n| plain | 5.0 | √ | 4.11 | 4.0 |\n| loading | 5.0 | x | x | 4.0 |\n| form-type | 5.0 | √ | x | 4.0 |\n| lang | x | x | x | x |\n| session-from | x | x | x | x |\n| send-message-title | x | x | x | x |\n| send-message-path | x | x | x | x |\n| send-message-img | x | x | x | x |\n| show-message-card | x | x | x | x |\n| app-parameter | x | x | x | x |\n| group-id | x | x | x | x |\n| guild-id | x | x | x | x |\n| public-id | x | x | x | x |\n| @getuserinfo | x | x | x | x |\n| @contact | x | x | x | x |\n| @getphonenumber | x | x | x | x |\n| @opensetting | x | x | x | x |\n| @launchapp | x | x | x | x |\n| @chooseavatar | x | x | x | x |\n| @chooseaddress | x | x | x | x |\n| @addgroupapp | x | x | x | x |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/button)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/button.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.button)\n"},"checkbox":{"name":"## checkbox","description":"> 组件类型：UniCheckboxElement \n\n 多选项。在1组check-group中可选择多个\n\n### checkbox 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| disabled | boolean | false | 是否禁用 |\n| value | string | - | checkbox 标识，选中时触发 checkbox-group 的 change 事件，并携带 checkbox 的 value |\n| checked | boolean | false | 当前是否选中，可用来设置默认选中 |\n| color | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#007aff\" | checkbox的颜色 |\n| backgroundColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#ffffff\" | checkbox默认的背景颜色 |\n| borderColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#d1d1d1\" | checkbox默认的边框颜色 |\n| activeBackgroundColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#ffffff\" | checkbox选中时的背景颜色 |\n| activeBorderColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#d1d1d1\" | checkbox选中时的边框颜色 |\n| iconColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#007aff\" | checkbox的图标颜色，优先级大于color属性 |","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/checkbox/checkbox.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/checkbox/checkbox\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n type ItemType = {\r\n value : string\r\n name : string\r\n checked : boolean\r\n }\r\n export default {\r\n data() {\r\n return {\r\n items: [\r\n {\r\n value: 'CHN',\r\n name: '中国',\r\n checked: true,\r\n },\r\n {\r\n value: 'USA',\r\n name: '美国',\r\n checked: false,\r\n },\r\n {\r\n value: 'BRA',\r\n name: '巴西',\r\n checked: false,\r\n },\r\n {\r\n value: 'JPN',\r\n name: '日本',\r\n checked: false,\r\n },\r\n {\r\n value: 'ENG',\r\n name: '英国',\r\n checked: false,\r\n },\r\n {\r\n value: 'FRA',\r\n name: '法国',\r\n checked: false,\r\n },\r\n ] as ItemType[],\r\n\r\n text: '未选中',\r\n wrapText: 'uni-app x，终极跨平台方案\\nuts，大一统语言',\r\n value: [] as string[],\r\n disabled: true,\r\n checked: true,\r\n color: '#007aff',\r\n // 组件属性 autotest\r\n checked_boolean: false,\r\n disabled_boolean: false,\r\n color_input: \"#007aff\",\r\n backgroundColor_input: \"#ffffff\",\r\n borderColor_input: \"#d1d1d1\",\r\n activeBackgroundColor_input: \"#ffffff\",\r\n activeBorderColor_input: \"#d1d1d1\",\r\n iconColor_input: \"#007aff\"\r\n }\r\n },\r\n methods: {\r\n checkboxChange: function (e : UniCheckboxGroupChangeEvent) {\r\n const selectedNames : string[] = []\r\n this.items.forEach((item) => {\r\n if (e.detail.value.includes(item.value)) {\r\n selectedNames.push(item.name)\r\n }\r\n })\r\n uni.showToast({\r\n icon: 'none',\r\n title: '当前选中:' + selectedNames.join(','),\r\n })\r\n },\r\n testChange: function (e : UniCheckboxGroupChangeEvent) {\r\n this.value = e.detail.value\r\n },\r\n checkbox_click() { console.log(\"组件被点击时触发\") },\r\n checkbox_touchstart() { console.log(\"手指触摸动作开始\") },\r\n checkbox_touchmove() { console.log(\"手指触摸后移动\") },\r\n checkbox_touchcancel() { console.log(\"手指触摸动作被打断，如来电提醒，弹窗\") },\r\n checkbox_touchend() { console.log(\"手指触摸动作结束\") },\r\n checkbox_tap() { console.log(\"手指触摸后马上离开\") },\r\n checkbox_longpress() { console.log(\"如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。\") },\r\n change_checked_boolean(checked : boolean) { this.checked_boolean = checked },\r\n change_disabled_boolean(checked : boolean) { this.disabled_boolean = checked },\r\n confirm_color_input(value : string) { this.color_input = value },\r\n confirm_backgroundColor_input(value : string) { this.backgroundColor_input = value },\r\n confirm_borderColor_input(value : string) { this.borderColor_input = value },\r\n confirm_activeBackgroundColor_input(value : string) { this.activeBackgroundColor_input = value },\r\n confirm_activeBorderColor_input(value : string) { this.activeBorderColor_input = value },\r\n confirm_iconColor_input(value : string) { this.iconColor_input = value }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### checkbox 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| disabled | √ | 4.11 | 4.0 |\n| value | √ | 4.11 | 4.0 |\n| checked | √ | 4.11 | 4.0 |\n| color | √ | 4.11 | 4.0 |\n| backgroundColor | √ | 4.11 | 4.0 |\n| borderColor | √ | 4.11 | 4.0 |\n| activeBackgroundColor | √ | 4.11 | 4.0 |\n| activeBorderColor | √ | 4.11 | 4.0 |\n| iconColor | √ | 4.11 | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/checkbox)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/checkbox-group.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.checkbox)\n"},"checkbox-group":{"name":"## checkbox-group","description":"> 组件类型：UniCheckboxGroupElement \n\n 多项组，内部由多个checkbox组成\n\n### checkbox-group 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| name | string | - | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |\n| @change | (event: [UniCheckboxGroupChangeEvent](#unicheckboxgroupchangeevent)) => void | - | checkbox-group中选中项发生改变是触发 change 事件，detail = {value:[选中的checkbox的value的数组\\]} |","event":"\n### 事件\n#### UniCheckboxGroupChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | Array\\ | 是 | - | - |\n\n##### UniCheckboxGroupChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniCheckboxGroupChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | Array\\ | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniCheckboxGroupChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"","compatibility":"### checkbox-group 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| name | 3.9 | 4.11 | 4.0 |\n| @change | √ | 4.11 | 4.0 |\n","children":"### 子组件 @children-tags \n - [checkbox](#checkbox)","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/checkbox)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/checkbox-group.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.checkbox-group)\n"},"image":{"name":"## image","description":"> 组件类型：UniImageElement \n\n 图片\n\n### image 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| src | string([string.ImageURIString](/uts/data-type.md#ide-string)) | - | 图片资源地址 |\n| mode | string | \"scaleToFill\" | 图片裁剪、缩放的模式 |\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 right | 不缩放图片，只显示图片的右上边区域 |\n@| bottom left | 不缩放图片，只显示图片的左下边区域 |\n@| bottom right | 不缩放图片，只显示图片的右下边区域 |\n| lazy-load | boolean | false | 图片懒加载。只针对page与scroll-view下的image有效 |\n| fade-show | boolean | false | 图片显示动画效果 |\n| webp | boolean | true | 是否支持 webP 格式 |\n| show-menu-by-longpress | boolean | false | 开启长按图片显示识别小程序码菜单 |\n| draggable | boolean | false | 鼠标长按是否能拖动图片(仅H5平台) |\n| @error | (event: [UniImageErrorEvent](#uniimageerrorevent)) => void | - | 图片加载错误时触发，event.detail = { errMsg } |\n| @load | (event: [UniImageLoadEvent](#uniimageloadevent)) => void | - | 图片加载完成时触发，event.detail = { width: '图片宽度px', height: '图片高度px' } |\n\n#### mode 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| scaleToFill | 3.9 | 4.11 | 4.0 |\n| aspectFit | 3.9 | 4.11 | 4.0 |\n| aspectFill | 3.9 | 4.11 | 4.0 |\n| widthFix | 3.9 | 4.11 | 4.0 |\n| heightFix | 3.9 | 4.11 | 4.0 |\n| top | 3.9 | 4.11 | 4.0 |\n| bottom | 3.9 | 4.11 | 4.0 |\n| center | 3.9 | 4.11 | 4.0 |\n| left | 3.9 | 4.11 | 4.0 |\n| right | 3.9 | 4.11 | 4.0 |\n| top left | 3.9 | 4.11 | 4.0 |\n| top right | 3.9 | 4.11 | 4.0 |\n| bottom left | 3.9 | 4.11 | 4.0 |\n| bottom right | 3.9 | 4.11 | 4.0 |\n","event":"\n### 事件\n#### UniImageErrorEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniImageErrorEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniImageErrorEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| errMsg | string | 是 | - | 错误信息 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniImageErrorEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniImageLoadEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniImageLoadEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniImageLoadEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| width | number | 是 | - | 图片宽度 |\n@| height | number | 是 | - | 图片高度 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniImageLoadEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/image/image.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/image/image\n>Template\n```vue\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n title: 'image',\r\n imageSrc: \"/static/test-image/logo.png\" as string.ImageURIString,\r\n loadError: false,\n // 自动化测试\n autoTest: false,\n setCookieImage: \"\",\n verifyCookieImage: \"\"\r\n }\r\n },\r\n methods: {\r\n error(event : ImageErrorEvent) {\r\n this.loadError = true\r\n console.log(event.type, event.detail);\r\n },\r\n load(event : ImageLoadEvent) {\r\n console.log(event.type, event.detail);\r\n },\r\n imageFormat() {\r\n uni.navigateTo({\r\n url: '/pages/component/image/image-format'\r\n });\r\n },\r\n imageMode() {\r\n uni.navigateTo({\r\n url: '/pages/component/image/image-mode'\r\n });\r\n },\r\n imagePath() {\r\n uni.navigateTo({\r\n url: '/pages/component/image/image-path'\r\n });\r\n },\r\n imageLarge() {\r\n uni.navigateTo({\r\n url: '/pages/component/image/image-large'\r\n });\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### image 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| src | 3.9 | 4.11 | 4.0 |\n| mode | 3.9 | 4.11 | 4.0 |\n| lazy-load | x | 4.11 | 4.0 |\n| fade-show | 3.9 | x | 4.0 |\n| webp | x | x | 4.0 |\n| show-menu-by-longpress | x | x | 4.0 |\n| draggable | x | x | 4.0 |\n| @error | 3.9 | 4.11 | 4.0 |\n| @load | 3.9 | 4.11 | 4.0 |\n","children":"### 子组件 @children-tags \n 不可以嵌套组件","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/image)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/image.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.image)\n"},"input":{"name":"## input","description":"> 组件类型：[UniInputElement](#uniinputelement) \n\n 输入框\n\n### input 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | - | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| name | string | - | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |\n| disabled | boolean | false | 是否禁用 |\n| value | string | \"\" | 输入框的初始内容 |\n| type | text \\| number \\| digit \\| tel \\| safe-password \\| nickname | \"text\" | input的类型 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| text | 文本输入键盘 |\n@| number | 数字输入键盘 |\n@| digit | 带小数点数字输入键盘 |\n@| tel | 电话输入键盘 |\n@| safe-password | 密码安全输入键盘 |\n@| nickname | 昵称输入键盘 |\n| password | boolean | false | 是否是密码类型 |\n| placeholder | string | \"\" | 输入框为空时占位符 |\n| placeholder-style | string | \"\" | 指定 placeholder 的样式 |\n| placeholder-class | string([string.ClassString](/uts/data-type.md#ide-string)) | \"\" | 指定 placeholder 的样式类，目前仅支持color,font-size和font-weight |\n| maxlength | number | \"不限制长度\" | 最大输入长度，0和正数为合法值，非法值的时候不限制最大长度 |\n| cursor-spacing | number | 0 | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |\n| cursor-color | string([string.ColorString](/uts/data-type.md#ide-string)) | \"\" | 指定光标颜色 |\n| auto-focus | boolean | false | 自动获取焦点 |\n| focus | boolean | false | 获取焦点 |\n| confirm-type | send \\| search \\| next \\| go \\| done | \"done\" | 设置键盘右下角按钮的文字 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| send | 发送 |\n@| search | 搜索 |\n@| next | 下一个 |\n@| go | 前往 |\n@| done | 完成 |\n| always-embed | boolean | - | 强制 input 处于同层状态，默认 focus 时 input 会切到非同层状态 (仅在 iOS 下生效) |\n| confirm-hold | boolean | false | 点击键盘右下角按钮时是否保持键盘不收起 |\n| cursor | number | 0 | 指定focus时的光标位置 |\n| selection-start | number | -1 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |\n| selection-end | number | -1 | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |\n| adjust-position | boolean | true | 键盘弹起时，是否自动上推页面 |\n| text-content-type | string | - | 文本区域的语义，根据类型自动填充 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| oneTimeCode | 一次性验证码 |\n| hold-keyboard | boolean | false | focus时，点击页面的时候不收起键盘 |\n| controlled | boolean | - | 是否为受控组件。为 true 时，value 内容会完全受 setData 控制 |\n| always-system | boolean | - | 是否强制使用系统键盘和 Web-view 创建的 input 元素。为 true 时，confirm-type、confirm-hold 可能失效 |\n| @input | (event: [UniInputEvent](#uniinputevent)) => void | - | 当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |\n| @focus | (event: [UniInputFocusEvent](#uniinputfocusevent)) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度 |\n| @blur | (event: [UniInputBlurEvent](#uniinputblurevent)) => void | - | 输入框失去焦点时触发，event.detail = {value: value} |\n| @keyboardheightchange | (event: [UniInputKeyboardHeightChangeEvent](#uniinputkeyboardheightchangeevent)) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |\n| @confirm | (event: [UniInputConfirmEvent](#uniinputconfirmevent)) => void | - | 点击完成按钮时触发，event.detail = {value: value} |\n\n#### type 兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| text | 5.0 | 3.9 | x | - |\n| number | 5.0 | 3.9 | x | - |\n| digit | 5.0 | 3.9 | x | - |\n| tel | 5.0 | 3.9 | x | - |\n| safe-password | x | x | x | 4.0 |\n| nickname | x | x | x | 4.0 |\n\n\n#### confirm-type 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| send | 3.9 | x | - |\n| search | 3.9 | x | - |\n| next | 3.9 | x | - |\n| go | 3.9 | x | - |\n| done | 3.9 | x | - |\n\n\n#### text-content-type 兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| oneTimeCode | x | x | x | 4.0 |\n","event":"\n### 事件\n#### UniInputEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | string | 是 | - | 输入框内容 |\n@| cursor | number | 是 | - | 光标的位置 |\n@| keyCode | number | 是 | - | 输入字符的Unicode值 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniInputEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniInputFocusEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputFocusEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputFocusEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| height | number | 是 | - | 键盘高度 |\n@| value | string | 是 | - | 输入框内容 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n###### UniInputFocusEventDetail 兼容性 \n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| height | √ | - | 4.0 |\n\n##### UniInputFocusEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniInputBlurEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputBlurEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputBlurEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | string | 是 | - | 输入框内容 |\n@| cursor | number | 是 | - | 选择区域的起始位置 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniInputBlurEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniInputKeyboardHeightChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputKeyboardHeightChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputKeyboardHeightChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| height | number | 是 | - | 键盘高度 |\n@| duration | number | 是 | - | 持续时间 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniInputKeyboardHeightChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniInputConfirmEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputConfirmEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputConfirmEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | string | 是 | - | 输入框内容 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniInputConfirmEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/input/input.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/input/input\n>Template\n```vue\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n title: 'input',\r\n showClearIcon: false,\r\n inputClearValue: '',\r\n showPassword: true,\r\n cursor: -1,\r\n cursor_color: \"#3393E2\",\r\n selectionStart: -1,\r\n selectionEnd: -1,\r\n inputEventDetail: '',\r\n focusAndBlurEventDetail: '',\r\n confirmEventDetail: '',\r\n keyboardHeightChangeEventDetail: '',\r\n focus: true,\r\n inputPassword: true,\r\n inputTypeTel: \"tel\",\r\n inputPlaceHolderStyle: \"color:red\",\r\n inputPlaceHolderClass: \"uni-input-placeholder-class\" as string.ClassString ,\r\n inputMaxLengthValue: \"\",\r\n onMaxLengthInputValue: \"\",\r\n inputMaxLengthFocus: false,\r\n inputPasswordValue: \"\",\r\n inputFocusKeyBoardChangeValue: true,\r\n holdKeyboard: false\r\n }\r\n },\r\n methods: {\r\n inputFocusKeyBoardChange(e : UniInputKeyboardHeightChangeEvent) {\r\n this.inputFocusKeyBoardChangeValue = e.detail.height > 50\r\n },\r\n onMaxLengthInput(event : UniInputEvent) {\r\n this.onMaxLengthInputValue = event.detail.value\r\n },\r\n setCursor: function (cursor : number) {\r\n (this.$refs['input'] as UniInputElement).focus();\r\n this.cursor = cursor;\n },\n onCursorBlurChange(){\n this.cursor = 0\n },\r\n setSelection: function (selectionStart : number, selectionEnd : number) {\r\n (this.$refs['input2'] as UniInputElement).focus();\r\n this.selectionStart = selectionStart;\r\n this.selectionEnd = selectionEnd;\n },\n onSelectionBlurChange(){\n this.selectionEnd = 0;\n },\r\n clearInput: function (event : UniInputEvent) {\r\n this.inputClearValue = event.detail.value\r\n if (event.detail.value.length > 0) {\r\n this.showClearIcon = true\r\n } else {\r\n this.showClearIcon = false\r\n }\r\n },\r\n clearIcon: function () {\r\n this.inputClearValue = ''\r\n this.showClearIcon = false\r\n },\r\n changePassword: function () {\r\n this.showPassword = !this.showPassword\r\n },\r\n onInput: function (event : UniInputEvent) {\r\n console.log(\"键盘输入\", JSON.stringify(event.detail));\r\n this.inputEventDetail = JSON.stringify(event.detail)\r\n },\r\n onFocus: function (event : UniInputFocusEvent) {\r\n console.log(\"输入框聚焦\", JSON.stringify(event.detail));\r\n this.focusAndBlurEventDetail = JSON.stringify(event.detail);\r\n },\r\n onBlur: function (event : UniInputBlurEvent) {\r\n console.log(\"输入框失去焦点\", JSON.stringify(event.detail));\r\n this.focusAndBlurEventDetail = JSON.stringify(event.detail);\r\n },\r\n onConfirm: function (event : UniInputConfirmEvent) {\r\n console.log(\"点击完成按钮\", JSON.stringify(event.detail));\r\n this.confirmEventDetail = JSON.stringify(event.detail);\r\n },\r\n onKeyborardHeightChange: function (event : UniInputKeyboardHeightChangeEvent) {\r\n console.log(\"键盘高度发生变化\", JSON.stringify(event.detail));\r\n this.keyboardHeightChangeEventDetail = JSON.stringify(event.detail);\r\n },\r\n test_check_input_value() : number {\r\n return this.onMaxLengthInputValue.length\r\n },\r\n changeCursorColor(event : UniSwitchChangeEvent) {\r\n const checked = event.detail.value;\r\n if (checked) {\r\n this.cursor_color = \"red\"\r\n } else {\r\n this.cursor_color = \"#3393E2\"\r\n }\r\n const input = uni.getElementById(\"uni-input-cursor-color\")\r\n input?.focus()\r\n },\r\n changeHoldKeyboard(event : UniSwitchChangeEvent) {\r\n const checked = event.detail.value;\r\n this.holdKeyboard = checked\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### input 属性兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| name | 5.0 | 3.9 | x | 4.0 |\n| disabled | 5.0 | 3.9 | x | 4.0 |\n| value | 5.0 | 3.9 | x | 4.0 |\n| type | 5.0 | 3.9 | x | - |\n| password | 5.0 | 3.9 | x | 4.0 |\n| placeholder | 5.0 | 3.9 | x | 4.0 |\n| placeholder-style | 5.0 | 3.9 | x | 4.0 |\n| placeholder-class | 5.0 | 3.9 | x | 4.0 |\n| maxlength | 5.0 | 3.9 | x | 4.0 |\n| cursor-spacing | 5.0 | 3.9 | x | 4.0 |\n| cursor-color | 5.0 | 3.99 | x | - |\n| auto-focus | 5.0 | 3.9 | x | 4.0 |\n| focus | 5.0 | 3.9 | x | 4.0 |\n| confirm-type | 5.0 | 3.9 | x | - |\n| always-embed | x | x | x | 4.0 |\n| confirm-hold | 5.0 | 3.9 | x | 4.0 |\n| cursor | 5.0 | 3.9 | x | 4.0 |\n| selection-start | 5.0 | 3.9 | x | 4.0 |\n| selection-end | 5.0 | 3.9 | x | 4.0 |\n| adjust-position | 5.0 | 3.9 | x | 4.0 |\n| text-content-type | x | x | x | 4.0 |\n| hold-keyboard | 5.0 | 4.0 | x | 4.0 |\n| controlled | x | x | x | 4.0 |\n| always-system | x | x | x | 4.0 |\n| @input | 5.0 | 3.9 | x | 4.0 |\n| @focus | 5.0 | 3.9 | x | 4.0 |\n| @blur | 5.0 | 3.9 | x | 4.0 |\n| @keyboardheightchange | 5.0 | 3.9 | x | 4.0 |\n| @confirm | 5.0 | 3.9 | x | 4.0 |\n","children":"### 子组件 @children-tags \n 不可以嵌套组件","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/input)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/input.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.input)\n","component_type":"### UniInputElement\n\ninput元素对象\n#### UniInputElement 的属性值\n| 名称 | 类型 | 必填 | 描述 |\n| :- | :- | :- | :- |\n| name | string | 是 | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交\n |\n| type | string | 是 | input的类型\n |\n| disabled | boolean | 是 | 是否禁用\n |\n| autofocus | boolean | 是 | 自动获取焦点\n |\n| value | string | 是 | 输入框的初始内容\n |"},"list-item":{"name":"## list-item","description":"> 组件类型：UniListItemElement \n\n list-view组件的唯一合法子组件。每个item是一行\n\n### list-item 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.02 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| type | number | 0 | 对应list-item的类型 list-view 将对同类型条目进行复用，所以合理的类型拆分，可以很好地提升 list-view 性能 |","event":"","example":"","compatibility":"### list-item 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| type | 3.9 | x | 4.0 |\n","children":"","reference":"\n### 参见\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.list-item)\n"},"sticky-header":{"name":"## sticky-header","description":"> 组件类型：UniStickyHeaderElement \n\n 吸顶布局容器 \n\n 注意：暂时仅支持作为list-view、sticky-section的子节点, sticky-header不支持css样式！当一个容器视图设置多个sticky-header时，后一个sticky-header会停靠在前一个sticky-header的末尾处。\n\n### sticky-header 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.93 | 4.11 | 4.02 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| padding | array\\ | [0,0,0,0\\] | 长度为 4 的数组，按 top、right、bottom、left 顺序指定内边距 |","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/sticky-header/sticky-header.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/sticky-header/sticky-header\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n sift_item: [\"排序\", \"筛选\"],\r\n list_item: [] as Array,\r\n refresher_enabled_boolean: true,\r\n refresher_triggered_boolean: false,\r\n scroll_top_input: 0\r\n }\r\n },\r\n onLoad() {\r\n let lists : Array = []\r\n for (let i = 0; i < 40; i++) {\r\n lists.push(\"item---\" + i)\r\n }\r\n this.list_item = lists\r\n },\r\n methods: {\r\n list_view_refresherrefresh() {\r\n console.log(\"下拉刷新被触发 \")\r\n this.refresher_triggered_boolean = true\r\n setTimeout(() => {\r\n this.refresher_triggered_boolean = false\r\n }, 1500)\r\n },\r\n confirm_scroll_top_input(value : number) {\r\n this.scroll_top_input = value\r\n },\r\n clickTH(index : number) {\r\n console.log(\"点击表头：\" + index);\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### sticky-header 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| padding | 3.98 | 4.11 | 4.02 |\n","children":"","reference":"\n### 参见\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.sticky-header)\n"},"sticky-section":{"name":"## sticky-section","description":"> 组件类型：UniStickySectionElement \n\n 吸顶布局容器 \n\n 注意：暂时仅支持作为list-view的子节点, sticky-section不支持css样式！\n\n### sticky-section 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.98 | 4.11 | 4.02 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| push-pinned-header | boolean | true | sticky-section元素重叠时是否继续上推 |\n| padding | array\\ | [0,0,0,0\\] | 长度为 4 的数组，按 top、right、bottom、left 顺序指定内边距 |","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/sticky-section/sticky-section.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/sticky-section/sticky-section\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n data: ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N'],\r\n sectionPadding: [0, 10, 0, 10] as Array,\r\n scrollIntoView: \"\",\r\n scrolling: false\r\n }\r\n },\r\n methods: {\r\n toTop(){\r\n this.scrollIntoView = \"\"\r\n uni.getElementById(\"list-view\")!.scrollTop = 0\r\n },\r\n //用于自动化测试\r\n listViewScrollByY(y : number) {\r\n const listview = this.$refs[\"list-view\"] as UniElement\r\n listview.scrollBy(0, y)\r\n },\r\n gotoStickyHeader(id : string) {\r\n this.scrollIntoView = id\r\n },\r\n onScroll() {\r\n this.scrolling = true\r\n },\r\n onScrollEnd() {\r\n this.scrolling = false\r\n //滚动后重置scrollIntoView = \"\"\r\n if(this.scrollIntoView != \"\") {\r\n this.scrollIntoView = \"\"\r\n }\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### sticky-section 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| push-pinned-header | 3.98 | 4.11 | x |\n| padding | 3.98 | 4.11 | 4.02 |\n","children":"","reference":"\n### 参见\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.sticky-section)\n"},"list-view":{"name":"## list-view","description":"> 组件类型：UniListViewElement \n\n 列表组件\n\n### list-view 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.02 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| direction | string | \"vertical\" | 滚动方向，可取值 none、horizontal、vertical，默认值vertical。注：iOS 平台仅支持vertical |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| none | 禁止滚动 |\n@| horizontal | 横向滚动 |\n@| vertical | 竖向滚动 |\n| ~~scroll-x~~ | boolean | false | 允许横向滚动，不支持同时设置scroll-y属性为true，同时设置true时scroll-y生效。已废弃，请改用direction |\n| ~~scroll-y~~ | boolean | true | 允许纵向滚动，不支持同时设置scroll-x属性为true，同时设置true时scroll-y生效。已废弃，请改用direction |\n| ~~rebound~~ | boolean | true | 控制是否回弹效果。已废弃，请改用bounces |\n| associative-container | string | \"\" | 关联的滚动容器 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| nested-scroll-view | 嵌套滚动 |\n| bounces | boolean | true | 控制是否回弹效果 优先级高于rebound |\n| upper-threshold | number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |\n| lower-threshold | number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |\n| scroll-top | number | 0 | 设置竖向滚动条位置 |\n| scroll-left | number | 0 | 设置横向滚动条位置 |\n| show-scrollbar | boolean | true | 控制是否出现滚动条 |\n| scroll-into-view | string([string.IDString](/uts/data-type.md#ide-string)) | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素起始位置 |\n| scroll-with-animation | boolean | false | 是否在设置滚动条位置时使用滚动动画，设置false没有滚动动画 |\n| refresher-enabled | boolean | false | 开启下拉刷新，暂时不支持scroll-x = true横向刷新 |\n| refresher-threshold | number | 45 | 设置下拉刷新阈值, 仅 refresher-default-style = 'none' 自定义样式下生效 |\n| refresher-max-drag-distance | number | - | 设置下拉最大拖拽距离（单位px），默认是下拉刷新控件高度的2.5倍 |\n| refresher-default-style | string | \"black\" | 设置下拉刷新默认样式，支持设置 black \\| white \\| none， none 表示不使用默认样式 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| black | 深颜色雪花样式 |\n@| white | 浅白色雪花样式 |\n@| none | 不使用默认样式 |\n| refresher-background | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#FFF\" | 设置下拉刷新区域背景颜色 |\n| refresher-triggered | boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |\n| custom-nested-scroll | boolean | false | 子元素是否开启嵌套滚动 将滚动事件与父元素协商处理 |\n| @refresherpulling | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新控件被下拉 |\n| @refresherrefresh | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新被触发 |\n| @refresherrestore | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新被复位 |\n| @refresherabort | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新被中止 |\n| @scrolltoupper | (event: [UniScrollToUpperEvent](#uniscrolltoupperevent)) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |\n| @scrolltolower | (event: [UniScrollToLowerEvent](#uniscrolltolowerevent)) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |\n| @scroll | (event: [UniScrollEvent](#uniscrollevent)) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |\n| @scrollend | (event: [UniScrollEvent](#uniscrollevent)) => void | - | 滚动结束时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |\n\n#### direction 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| none | 4.0 | 4.11 | 4.02 |\n| horizontal | 4.0 | x | x |\n| vertical | 4.0 | 4.11 | 4.02 |\n\n\n#### associative-container 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| nested-scroll-view | 4.11 | 4.11 | x |\n\n\n#### refresher-default-style 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| black | 3.9 | 4.11 | - |\n| white | 3.9 | 4.11 | - |\n| none | 3.93 | 4.11 | - |\n","event":"\n### 事件\n#### UniRefresherEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniRefresherEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniRefresherEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| dy | number | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniRefresherEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniScrollToUpperEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniScrollToUpperEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniScrollToUpperEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| direction | string | 是 | - | 滚动方向 top 或 left |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniScrollToUpperEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniScrollToLowerEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniScrollToLowerEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniScrollToLowerEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| direction | string | 是 | - | 滚动方向 bottom 或 right |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniScrollToLowerEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniScrollEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| String | **String** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| toString | any | 是 | - | 返回一个字符串，表示指定的字符串。 |\n@| length | number | 是 | - | 返回字符串的 UTF-16 码元长度。 |\n@| valueOf | any | 是 | - | 返回 String 对象的原始值 |\n| detail | any | 是 | - | - |\n\n##### UniScrollEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniScrollEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| scrollTop | number | 是 | - | 竖向滚动的距离 |\n@| scrollLeft | number | 是 | - | 横向滚动的距离 |\n@| scrollHeight | number | 是 | - | 滚动区域的高度 |\n@| scrollWidth | number | 是 | - | 滚动区域的宽度 |\n@| deltaY | number | 是 | - | 当次滚动事件竖向滚动量 |\n@| deltaX | number | 是 | - | 当次滚动事件横向滚动量 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n#### String 的方法 @string-values \n\n#### charAt(pos) @charat\n\n返回一个由给定索引处的单个 UTF-16 码元构成的新字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| pos | number | 是 | - | 要返回的字符的索引，从零开始。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### charAt 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[charAt](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#charAt)\n\n#### toCharArray() @tochararray\n\n返回包含此字符串的字符的[kotlin.CharArray\\]。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| CharArray |\n \n\n##### toCharArray 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | x |\n\n\n##### 参见\n[toCharArray](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toCharArray)\n\n#### charCodeAt(index) @charcodeat\n\n返回 0 到 65535 之间的整数，表示给定索引处的 UTF-16 代码单元\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | 一个大于等于 0，小于字符串长度的整数。如果不是一个数值，则默认为 0。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### charCodeAt 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[charCodeAt](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#charCodeAt)\n\n#### concat(strings) @concat\n\n将字符串参数连接到调用的字符串，并返回一个新的字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| strings | Array\\ | 是 | - | T要连接到 str 的一个或多个字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### concat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[concat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#concat)\n\n#### indexOf(searchString, position) @indexof\n\n在字符串中搜索指定子字符串，并返回其第一次出现的位置索引。它可以接受一个可选的参数指定搜索的起始位置，如果找到了指定的子字符串，则返回的位置索引大于或等于指定的数字。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的子字符串。 |\n| position | number | 是 | - | 该方法返回指定子字符串在大于或等于 position 位置的第一次出现的索引，默认为 0。如果 position 大于调用字符串的长度，则该方法根本不搜索调用字符串。如果 position 小于零，该方法的行为就像 position 为 0 时一样。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### indexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[indexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#indexOf)\n\n#### lastIndexOf(searchString, position) @lastindexof\n\n搜索该字符串并返回指定子字符串最后一次出现的索引。它可以接受一个可选的起始位置参数，并返回指定子字符串在小于或等于指定数字的索引中的最后一次出现的位置。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的子字符串。 |\n| position | number | 是 | - | 该方法返回指定子字符串在小于或等于 position 的位置中的最后一次出现的索引，默认为 +Infinity。如果 position 大于调用字符串的长度，则该方法将搜索整个字符串。如果 position 小于 0，则行为与 0 相同，即该方法只在索引 0 处查找指定的子字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### lastIndexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[lastIndexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#lastIndexOf)\n\n#### localeCompare(that) @localecompare\n\n返回一个数字，表示参考字符串在排序顺序中是在给定字符串之前、之后还是与之相同。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| that | string | 是 | - | 与 referenceStr 进行比较的字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### localeCompare 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[localeCompare](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#localeCompare)\n\n#### match(regexp) @match\n\nmatch() 方法检索字符串与正则表达式进行匹配的结果。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| regexp | string \\| [RegExp](#regexp-values) | 是 | - | 一个正则表达式对象或者任何具有 Symbol.match 方法的对象。 | \n\n##### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| [RegExpMatchArray](#regexpmatcharray-values) \\| null | 否 |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| 0 | string | 是 | - | The first match. This will always be present because `null` will be returned if there are no matches. |\n@| index | number | 否 | - | The index of the search at which the result was found. |\n@| input | string | 否 | - | A copy of the search string. |\n@| length | number | 是 | - | length 是 Array 的实例属性，表示该数组中元素的个数。该值是一个无符号 32 位整数，并且其数值总是大于数组最大索引。 |\n@| toString | any | 是 | - | toString() 方法返回一个字符串，表示指定的数组及其元素。 |\n@| toLocaleString | any | 是 | - | toLocaleString() 方法返回一个字符串，表示数组中的所有元素。每个元素通过调用它们自己的 toLocaleString 方法转换为字符串，并且使用特定于语言环境的字符串（例如逗号“,”）分隔开。 |\n##### RegExpMatchArray 的方法 @regexpmatcharray-values \n\n##### toKotlinList() @tokotlinlist\n\ntoKotlinList() 将当前的Array对象转换为 kotlin 中对应的List对象\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| kotlin.collections.List\\ |\n \n\n###### toKotlinList 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | x | - |\n\n\n###### 参见\n[toKotlinList](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#toKotlinList)\n\n##### add(item) @add\n\n将指定的元素追加到此列表的末尾\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| item | T | 是 | - | 添加到数组的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### add 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[add](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#add)\n\n##### joinToString(separator) @jointostring\n\n从所有元素中使用[separator\\]创建字符串\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 分隔符 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### joinToString 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[joinToString](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#joinToString)\n\n##### pop() @pop\n\npop() 方法从数组中删除最后一个元素，并返回该元素的值。此方法会更改数组的长度。\n\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n###### pop 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[pop](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#pop)\n\n##### push(items) @push\n\npush() 方法将指定的元素添加到数组的末尾，并返回新的数组长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到数组末尾的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### push 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[push](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#push)\n\n##### concat(items) @concat\n\nconcat() 方法用于合并两个或多个数组。此方法不会更改现有数组，而是返回一个新数组。\n\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\\\> | 是 | - | 数组和/或值，将被合并到一个新的数组中。如果省略了所有 valueN 参数，则 concat 会返回调用此方法的现存数组的一个浅拷贝。详情请参阅下文描述。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### concat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[concat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#concat)\n\n##### join(separator) @join\n\njoin() 方法将一个数组（或一个类数组对象）的所有元素连接成一个字符串并返回这个字符串，用逗号或指定的分隔符字符串分隔。如果数组只有一个元素，那么将返回该元素而不使用分隔符。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 指定一个字符串来分隔数组的每个元素。如果需要，将分隔符转换为字符串。如果省略，数组元素用逗号（,）分隔。如果 separator 是空字符串（\"\"），则所有元素之间都没有任何字符。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### join 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | - |\n\n\n###### 参见\n[join](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#join)\n\n##### reverse() @reverse\n\nreverse() 方法就地反转数组中的元素，并返回同一数组的引用。数组的第一个元素会变成最后一个，数组的最后一个元素变成第一个。换句话说，数组中的元素顺序将被翻转，变为与之前相反的方向。\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### reverse 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reverse](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reverse)\n\n##### shift() @shift\n\nshift() 方法从数组中删除第一个元素，并返回该元素的值。此方法更改数组的长度。\n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| T \\| null | 否 |\n \n\n###### shift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[shift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#shift)\n\n##### slice(start, end) @slice\n\nslice() 方法返回一个新的数组对象，这一对象是一个由 start 和 end 决定的原数组的浅拷贝（包括 start，不包括 end），其中 start 和 end 代表了数组元素的索引。原始数组不会被改变。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 提取起始处的索引（从 0 开始），会转换为整数。 |\n| end | number | 是 | - | 提取终止处的索引（从 0 开始），会转换为整数。slice() 会提取到但不包括 end 的位置。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### slice 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[slice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#slice)\n\n##### sort(compareFn) @sort\n\nsort() 方法就地对数组的元素进行排序，并返回对相同数组的引用。默认排序是将元素转换为字符串，然后按照它们的 UTF-16 码元值升序排序。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| compareFn | (a: T, b: T) => number | 是 | - | 定义排序顺序的函数。返回值应该是一个数字，其正负性表示两个元素的相对顺序。该函数使用以下参数调用： a:第一个用于比较的元素。不会是 null。 b:第二个用于比较的元素。不会是 null。 如果省略该函数，数组元素会被转换为字符串，然后根据每个字符的 Unicode 码位值进行排序。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### sort 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[sort](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#sort)\n\n##### splice(start, deleteCount) @splice\n\nsplice() 方法通过移除或者替换已存在的元素和/或添加新元素就地改变一个数组的内容。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 从 0 开始计算的索引，表示要开始改变数组的位置，它会被转换成整数。 |\n| deleteCount | number | 是 | - | 一个整数，表示数组中要从 start 开始删除的元素数量。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### splice 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[splice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#splice)\n\n##### unshift(items) @unshift\n\nunshift() 方法将指定元素添加到数组的开头，并返回数组的新长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到 arr 开头的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### unshift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[unshift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#unshift)\n\n##### indexOf(searchElement, fromIndex) @indexof\n\nindexOf() 方法返回数组中第一次出现给定元素的下标，如果不存在则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 数组中要查找的元素。 |\n| fromIndex | number | 是 | - | 开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### indexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[indexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#indexOf)\n\n##### lastIndexOf(searchElement, fromIndex) @lastindexof\n\nlastIndexOf() 方法返回数组中给定元素最后一次出现的索引，如果不存在则返回 -1。该方法从 fromIndex 开始向前搜索数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 被查找的元素。 |\n| fromIndex | number | 是 | - | 以 0 起始的索引，表明反向搜索的起始位置，会被转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### lastIndexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[lastIndexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#lastIndexOf)\n\n##### every(predicate, thisArg) @every\n\nevery() 方法测试一个数组内的所有元素是否都能通过指定函数的测试。它返回一个布尔值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 every() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### every 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[every](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#every)\n\n##### some(predicate, thisArg) @some\n\nsome() 方法测试数组中是否至少有一个元素通过了由提供的函数实现的测试。如果在数组中找到一个元素使得提供的函数返回 true，则返回 true；否则返回 false。它不会修改数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 some() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### some 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[some](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#some)\n\n##### forEach(callbackfn, thisArg) @foreach\n\nforEach() 方法对数组的每个元素执行一次给定的函数。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => void | 是 | - | 为数组中每个元素执行的函数。并会丢弃它的返回值。该函数被调用时将传入以下参数： value:数组中正在处理的当前元素。 index:数组中正在处理的当前元素的索引。 array:调用了 forEach() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n\n###### forEach 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[forEach](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#forEach)\n\n##### map(callbackfn, thisArg) @map\n\nmap() 方法创建一个新数组，这个新数组由原数组中的每个元素都调用一次提供的函数后的返回值组成。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => U | 是 | - | 为数组中的每个元素执行的函数。它的返回值作为一个元素被添加为新数组中。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 map() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### map 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[map](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#map)\n\n##### filter(predicate, thisArg) @filter\n\nfilter() 方法创建给定数组一部分的浅拷贝，其包含通过所提供函数实现的测试的所有元素。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以将元素保留在结果数组中，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 filter() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### filter 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[filter](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#filter)\n\n##### reduce(callbackfn) @reduce\n\nreduce() 方法对数组中的每个元素按序执行一个提供的 reducer 函数，每一次运行 reducer 会将先前元素的计算结果作为参数传入，最后将其结果汇总为单个返回值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将作为 reduce() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为 array[0\\] 的值。 currentValue:当前元素的值。在第一次调用时，如果指定了 initialValue，则为 array[0\\] 的值，否则为 array[1\\]。 currentIndex:currentValue 在数组中的索引位置。在第一次调用时，如果指定了 initialValue 则为 0，否则为 1 array:调用了 reduce() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduce 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduce](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduce)\n\n##### reduceRight(callbackfn) @reduceright\n\nreduceRight() 方法对累加器（accumulator）和数组的每个值（按从右到左的顺序）应用一个函数，并使其成为单个值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中的每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将成为 reduceRight() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为数组最后一个元素的值。 currentValue:数组中当前正在处理的元素。 currentIndex:正在处理的元素在数组中的索引。 array:调用了 reduceRight() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduceRight 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduceRight](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduceRight)\n\n##### find(predicate, thisArg) @find\n\nfind() 方法返回数组中满足提供的测试函数的第一个元素的值。否则返回 null。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值来表示已经找到了匹配的元素。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| S \\| null | 否 |\n \n\n###### find 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[find](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#find)\n\n##### findIndex(predicate, thisArg) @findindex\n\nfindIndex() 方法返回数组中满足提供的测试函数的第一个元素的索引。若没有找到对应元素则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示已找到匹配元素，否则返回一个假值。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### findIndex 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[findIndex](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#findIndex)\n\n##### fill(value, start, end) @fill\n\nfill() 方法用一个固定值填充一个数组中从起始索引（默认为 0）到终止索引（默认为 array.length）内的全部元素。它返回修改后的数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | T | 是 | - | 用来填充数组元素的值。注意所有数组中的元素都将是这个确定的值：如果 value 是个对象，那么数组的每一项都会引用这个元素。 |\n| start | number | 是 | - | 基于零的索引，从此开始填充，转换为整数。 |\n| end | number | 是 | - | 基于零的索引，在此结束填充，转换为整数。fill() 填充到但不包含 end 索引。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### fill 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[fill](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#fill)\n\n##### copyWithin(target, start, end) @copywithin\n\ncopyWithin() 方法浅复制数组的一部分到同一数组中的另一个位置，并返回它，不会改变原数组的长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| target | number | 是 | - | 序列开始替换的目标位置，以 0 为起始的下标表示，且将被转换为整数 |\n| start | number | 是 | - | 要复制的元素序列的起始位置，以 0 为起始的下标表示，且将被转换为整数 |\n| end | number | 是 | - | 要复制的元素序列的结束位置，以 0 为起始的下标表示，且将被转换为整数。copyWithin 将会拷贝到该位置，但不包括 end 这个位置的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### copyWithin 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[copyWithin](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#copyWithin)\n\n##### includes(searchElement, fromIndex) @includes\n\nincludes() 方法用来判断一个数组是否包含一个指定的值，根据情况，如果包含则返回 true，否则返回 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | any | 是 | - | 需要查找的值。 |\n| fromIndex | number | 是 | - | 可选。开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### includes 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[includes](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#includes)\n\n##### at(index) @at\n\nTakes an integer value and returns the item at that index,\nallowing for positive and negative integers.\nNegative integers count back from the last item in the array.\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | - | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n\n\n###### RegExpMatchArray 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| length | 5.0 | 3.9 | 4.11 | 4.0 |\n| toString | x | x | x | 4.0 |\n| toLocaleString | x | x | x | 4.0 |\n \n\n##### match 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| √ | √ | x | 4.0 |\n\n\n##### 参见\n[match](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#match)\n\n#### replace(searchValue, replaceValue) @replace\n\n返回一个由替换值（replacement）替换部分或所有的模式（pattern）匹配项后的新字符串。模式可以是一个字符串或者一个正则表达式。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchValue | string \\| [RegExp](#regexp-values) | 是 | - | RegExp: 一个RegExp 对象或者其字面量。该正则所匹配的内容会被第二个参数的返回值替换掉。string: 一个将被 newSubStr 替换的 字符串。其被视为一整个字符串，而不是一个正则表达式。仅第一个匹配项会被替换。 |\n| replaceValue | string | 是 | - | 用于替换掉第一个参数在原字符串中的匹配部分的字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### replace 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[replace](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#replace)\n\n#### search(regexp) @search\n\nsearch() 方法执行正则表达式和 String 对象之间的一个搜索匹配。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| regexp | string \\| [RegExp](#regexp-values) | 是 | - | 一个正则表达式（regular expression）对象。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### search 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[search](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#search)\n\n#### slice(start, end) @slice\n\nslice() 方法提取某个字符串的一部分，并返回一个新的字符串，且不会改动原字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 可选。从该索引（以 0 为基数）处开始提取原字符串中的字符。如果值为负数，会被当做 strLength + beginIndex 看待，这里的strLength 是字符串的长度（例如，如果 beginIndex 是 -3 则看作是：strLength - 3） |\n| end | number | 是 | - | 可选。在该索引（以 0 为基数）处结束提取字符串。如果省略该参数，slice() 会一直提取到字符串末尾。如果该参数为负数，则被看作是 strLength + endIndex，这里的 strLength 就是字符串的长度 (例如，如果 endIndex 是 -3，则是，strLength - 3)。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### slice 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[slice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#slice)\n\n#### split(separator, limit) @split\n\nsplit() 方法接受一个模式，通过搜索模式将字符串分割成一个有序的子串列表，将这些子串放入一个数组，并返回该数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string \\| [RegExp](#regexp-values) | 是 | - | 描述每个分割应该发生在哪里的模式。 |\n| limit | number | 是 | - | 一个非负整数，指定数组中包含的子字符串的数量限制。当提供此参数时，split 方法会在指定 separator 每次出现时分割该字符串，但在已经有 limit 个元素时停止分割。任何剩余的文本都不会包含在数组中。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n##### split 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[split](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#split)\n\n#### substring(start, end) @substring\n\n返回一个字符串在开始索引到结束索引之间的一个子集，或从开始索引直到字符串的末尾的一个子集。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 要截取的第一个字符的索引，该索引位置的字符作为返回的字符串的首字母。 |\n| end | number | 是 | - | 可选。一个 0 到字符串长度之间的整数，以该数字为索引的字符不包含在截取的字符串内。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### substring 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[substring](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#substring)\n\n#### toLowerCase() @tolowercase\ntoLowerCase() 会将调用该方法的字符串值转为小写形式，并返回。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toLowerCase 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[toLowerCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toLowerCase)\n\n#### toLocaleLowerCase(locales) @tolocalelowercase\n\n根据任何指定区域语言环境设置的大小写映射，返回调用字符串被转换为小写的格式。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| locales | string \\| Array\\ | 是 | - | 可选。指明要转换成小写格式的特定语言区域。如果以一个数组 Array 形式给出多个 locales, 最合适的地区将被选出来应用。默认的 locale 是主机环境的当前区域 (locale) 设置。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toLocaleLowerCase 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[toLocaleLowerCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toLocaleLowerCase)\n\n#### toUpperCase() @touppercase\n\n将调用该方法的字符串转为大写形式并返回（如果调用该方法的值不是字符串类型会被强制转换）。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toUpperCase 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[toUpperCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toUpperCase)\n\n#### toLocaleUpperCase(locales) @tolocaleuppercase\n\n根据本地主机语言环境把字符串转换为大写格式，并返回转换后的字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| locales | string \\| Array\\ | 是 | - | locales参数指示要用于根据任何特定于语言环境的大小写映射转换为大写的语言环境。如果Array中给出了多个区域设置，则使用最佳可用区域设置。默认语言环境是主机环境的当前语言环境。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toLocaleUpperCase 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[toLocaleUpperCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toLocaleUpperCase)\n\n#### trim() @trim\n\n从字符串的两端清除空格，返回一个新的字符串，而不修改原始字符串。此上下文中的空格是指所有的空白字符（空格、tab、不换行空格等）以及所有行终止符字符（如 LF、CR 等）。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### trim 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[trim](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#trim)\n\n#### ~~substr~~(from, length) @substr\n\n返回一个字符串中从指定位置开始到指定字符数的字符。 **已废弃。警告： 尽管 String.prototype.substr(…) 没有严格被废弃 (as in \"removed from the Web standards\"), 但它被认作是遗留的函数并且可以的话应该避免使用。它并非 JavaScript 核心语言的一部分，未来将可能会被移除掉。如果可以的话，使用 substring() 替代它。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| from | number | 是 | - | 开始提取字符的位置。如果为负值，则被看作 strLength + start，其中 strLength 为字符串的长度（例如，如果 start 为 -3，则被看作 strLength + (-3)）。 |\n| length | number | 是 | - | 可选。提取的字符数。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### substr 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[substr](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#substr)\n\n#### padStart(targetLength, padString) @padstart\n\n用另一个字符串填充当前字符串（如果需要会重复填充），直到达到给定的长度。填充是从当前字符串的开头开始的。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| targetLength | number | 是 | - | 当前 str 填充后的长度。如果该值小于或等于 str.length，则会直接返回当前 str。 |\n| padString | string | 是 | - | 可选。用于填充当前 str 的字符串。如果 padString 太长，无法适应 targetLength，则会从末尾被截断。默认值为“ ”字符（U+0020）。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### padStart 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[padStart](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#padStart)\n\n#### padEnd(targetLength, padString) @padend\n\n将当前字符串从末尾开始填充给定的字符串（如果需要会重复填充），直到达到给定的长度。填充是从当前字符串的末尾开始的。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| targetLength | number | 是 | - | 当前 str 填充后的长度。如果该值小于或等于 str.length，则会直接返回当前 str。 |\n| padString | string | 是 | - | 可选。用于填充当前 str 的字符串。如果 padString 太长，无法适应 targetLength，则会被截断。默认值为“ ”字符（U+0020）。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### padEnd 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[padEnd](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#padEnd)\n\n#### codePointAt(pos) @codepointat\n\n返回一个小于 1114112 (0x110000) 的非负整数 Number，它是 UTF-16 编码的代码点的代码点值，该代码点始于将此对象转换为字符串而产生的字符串中位置 pos 处的字符串元素。\n如果该位置没有元素，则结果未定义。\n如果有效的 UTF-16 代理项对不是从 pos 开始，则结果是 pos 处的代码单元。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| pos | number | 是 | - | 这个字符串中需要转码的元素的位置。 | \n\n##### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| number \\| null | 否 |\n \n\n##### codePointAt 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[codePointAt](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#codePointAt)\n\n#### includes(searchString, position) @includes\n\n如果 searchString 作为此对象转换为 String 的结果的子字符串出现在大于或等于position的一个或多个位置，则返回 true；否则，返回 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要在 str 中搜索的字符串。不能是正则表达式。 |\n| position | number | 是 | - | 在字符串中开始搜索 searchString 的位置。（默认为 0。） | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n##### includes 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[includes](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#includes)\n\n#### endsWith(searchString, endPosition) @endswith\n\nendsWith() 方法用于判断一个字符串是否以指定字符串结尾，如果是则返回 true，否则返回 false。该方法区分大小写。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的作为结尾的字符串，不能是正则表达式。所有非正则表达式的值都会被强制转换为字符串。 |\n| endPosition | number | 是 | - | 可选，预期找到 searchString 的末尾位置（即 searchString 最后一个字符的索引加 1）。默认为 str.length。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n##### endsWith 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[endsWith](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#endsWith)\n\n#### normalize(form) @normalize\n\nnormalize() 方法会按照指定的一种 Unicode 正规形式将当前字符串规范化。（如果该值不是字符串，则首先将其转换为一个字符串）。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| form | \"NFC\" \\| \"NFD\" \\| \"NFKC\" \\| \"NFKD\" | 是 | - | 四种 Unicode 正规形式（Unicode Normalization Form）\"NFC\"、\"NFD\"、\"NFKC\"，或 \"NFKD\" 其中的一个，默认值为 \"NFC\"。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### normalize 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[normalize](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#normalize)\n\n#### repeat(count) @repeat\n\nrepeat() 构造并返回一个新字符串，该字符串包含被连接在一起的指定数量的字符串的副本。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| count | number | 是 | - | 介于 0 和 +Infinity 之间的整数。表示在新构造的字符串中重复了多少遍原字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### repeat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[repeat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#repeat)\n\n#### startsWith(searchString, position) @startswith\n\nstartsWith() 方法用来判断当前字符串是否以另外一个给定的子字符串开头，并根据判断结果返回 true 或 false。这个方法区分大小写。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的子字符串。 |\n| position | number | 是 | - | 在 str 中搜索 searchString 的开始位置，默认值为 0。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n##### startsWith 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[startsWith](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#startsWith)\n\n#### ~~anchor~~(name) @anchor\n\nanchor() 方法创建一个 \\ HTML 锚元素，被用作超文本靶标（hypertext target）。 **浏览器兼容性的遗留特性。警告： 该特性已经从 Web 标准中删除，虽然一些浏览器目前仍然支持它，但也许会在未来的某个时间停止支持，请尽量不要使用该特性。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| name | string | 是 | - | 一个字符串，表示被创建的标签的 name 属性。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### anchor 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[anchor](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#anchor)\n\n#### ~~big~~() @big\n\n创建一个使字符串显示大号字体的\\标签。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### big 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[big](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#big)\n\n#### ~~blink~~() @blink\n\nblink() 方法创建一个字符串，其在 \\str\\ 中嵌入字符串，这使得字符串在旧版浏览器中闪烁。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。\r\n#**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### blink 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[blink](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#blink)\n\n#### ~~bold~~() @bold\n\nbold() 方法会创建 HTML 元素“b”，并将字符串加粗展示。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### bold 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[bold](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#bold)\n\n#### ~~fixed~~() @fixed\n\nfixed() 方法创建了一个 \\ 标签元素将字符串包裹起来，从而让这个字符串里面的内容具有固定间距。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### fixed 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[fixed](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#fixed)\n\n#### ~~fontcolor~~(color) @fontcolor\n\n创建一个\\的 HTML 元素让字符串被显示成指定的字体颜色。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。\r\n备注： 元素已经在在HTML5 中 (en-US)被移除并且不应该在使用。替代的是，Web 开发者应该使用CSS属性。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| color | string | 是 | - | 代表颜色的一个字符串，可以是三个一组的十六进制的 RGB 值，也可以是一个颜色名称的字符串字面量. | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### fontcolor 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[fontcolor](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#fontcolor)\n\n#### ~~fontsize~~(size) @fontsize\n\n返回一个' \\ ' HTML元素并设置size属性值 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| size | number | 是 | - | 1到7之间的整数。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### fontsize 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[fontsize](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#fontsize)\n\n#### italics() @italics\n\nitalics()方法创建一个\\ HTML元素，使字符串变为斜体。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### italics 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[italics](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#italics)\n\n#### ~~link~~(url) @link\n\nlink() 方法创建一个 HTML 元素 \\ ，用该字符串作为超链接的显示文本，参数作为指向另一个 URL 的超链接。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| url | string | 是 | - | 任何能够指定 a 标签的 href 属性的字符串；它应当是有效的 URL（相对或绝对），任何 & 字符将会被转义为 &，任何 \" 字符将会被转义为 "。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### link 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[link](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#link)\n\n#### ~~small~~() @small\n\nsmall() 方法的作用是创建一个使字符串显示小号字体的 \\ 标签。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### small 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[small](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#small)\n\n#### ~~strike~~() @strike\n\nstrike()方法创建\\ HTML 元素，使字符串展示为被删除的文本。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### strike 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[strike](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#strike)\n\n#### ~~sub~~() @sub\n\nsub()方法创建一个 \\ HTML 元素，使字符串展示为下标。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### sub 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[sub](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#sub)\n\n#### ~~sup~~() @sup\n\nsup()方法创建 一个\\HTML 元素，使字符串显示为上标。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### sup 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[sup](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#sup)\n\n#### at(index) @at\n\n方法接受一个整数值，并返回一个新的 String，该字符串由位于指定偏移量处的单个 UTF-16 码元组成\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | 字符指定偏移量处，允许正整数和负整数，负整数从字符串中的最后一个字符开始倒数。 | \n\n##### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| string \\| null | 否 |\n \n\n##### at 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[at](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#at)\n\n##### RegExp 的属性值 @regexp-values \n\n| 名称 | 类型 | 必备 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| flags | string | 是 | - | 返回一个字符串，由当前正则表达式对象的标志组成。此属性是一个只读属性 此字符串中的字符按以下顺序排序和连接: - \"g\" for global - \"i\" for ignoreCase - \"m\" for multiline - \"u\" for unicode - \"y\" for sticky 如果没有设置标志，则该值为空字符串。 |\n| dotAll | boolean | 是 | - | 表明是否在正则表达式中一起使用\"s\"修饰符（引入/s 修饰符，使得。可以匹配任意单个字符）。dotAll 是一个只读的属性，属于单个正则表达式实例。 |\n| hasIndices | boolean | 是 | - | 指示 d 标志是否与正则表达式一起使用。只读的。 |\n| sticky | boolean | 是 | - | 搜索是否具有粘性（仅从正则表达式的 lastIndex 属性表示的索引处搜索）。sticky 是正则表达式对象的只读属性。默认为false。只读的。 |\n| unicode | boolean | 是 | - | 表明正则表达式带有\"u\" 标志。 unicode 是正则表达式独立实例的只读属性。unicode 的值是 Boolean，并且如果使用了 \"u\" 标志则为 true；否则为 false。\"u\" 标志开启了多种 Unicode 相关的特性。使用 \"u\" 标志，任何 Unicode 代码点的转义都会被解释。 |\n| source | string | 是 | - | 返回一个值为当前正则表达式对象的模式文本的字符串，该字符串不会包含正则字面量两边的斜杠以及任何的标志字符。 |\n| global | boolean | 是 | - | 表明正则表达式是否使用了 \"g\" 标志。global 是一个正则表达式实例的只读属性。 |\n| ignoreCase | boolean | 是 | - | 表明正则表达式是否使用了 \"i\" 标志。ignoreCase 是正则表达式实例的只读属性。 |\n| multiline | boolean | 是 | - | 表明正则表达式是否使用了 \"m\" 标志。multiline 是正则表达式实例的一个只读属性。 |\n| lastIndex | number | 是 | - | 正则表达式的一个可读可写的整型属性，用来指定下一次匹配的起始索引。 |\n\n##### RegExp 的方法 @regexp-values \n\n##### exec(string) @exec\n\n在一个指定字符串中执行一个搜索匹配。返回一个结果数组或 null。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| string | string | 是 | - | 要匹配正则表达式的字符串。 | \n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| [RegExpExecArray](#regexpexecarray-values) \\| null | 否 |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| 0 | string | 是 | - | The first match. This will always be present because `null` will be returned if there are no matches. |\n@| index | number | 是 | - | The index of the search at which the result was found. |\n@| input | string | 是 | - | A copy of the search string. |\n@| length | number | 是 | - | length 是 Array 的实例属性，表示该数组中元素的个数。该值是一个无符号 32 位整数，并且其数值总是大于数组最大索引。 |\n@| toString | any | 是 | - | toString() 方法返回一个字符串，表示指定的数组及其元素。 |\n@| toLocaleString | any | 是 | - | toLocaleString() 方法返回一个字符串，表示数组中的所有元素。每个元素通过调用它们自己的 toLocaleString 方法转换为字符串，并且使用特定于语言环境的字符串（例如逗号“,”）分隔开。 |\n##### RegExpExecArray 的方法 @regexpexecarray-values \n\n##### toKotlinList() @tokotlinlist\n\ntoKotlinList() 将当前的Array对象转换为 kotlin 中对应的List对象\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| kotlin.collections.List\\ |\n \n\n###### toKotlinList 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | x | - |\n\n\n###### 参见\n[toKotlinList](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#toKotlinList)\n\n##### add(item) @add\n\n将指定的元素追加到此列表的末尾\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| item | T | 是 | - | 添加到数组的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### add 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[add](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#add)\n\n##### joinToString(separator) @jointostring\n\n从所有元素中使用[separator\\]创建字符串\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 分隔符 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### joinToString 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[joinToString](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#joinToString)\n\n##### pop() @pop\n\npop() 方法从数组中删除最后一个元素，并返回该元素的值。此方法会更改数组的长度。\n\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n###### pop 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[pop](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#pop)\n\n##### push(items) @push\n\npush() 方法将指定的元素添加到数组的末尾，并返回新的数组长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到数组末尾的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### push 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[push](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#push)\n\n##### concat(items) @concat\n\nconcat() 方法用于合并两个或多个数组。此方法不会更改现有数组，而是返回一个新数组。\n\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\\\> | 是 | - | 数组和/或值，将被合并到一个新的数组中。如果省略了所有 valueN 参数，则 concat 会返回调用此方法的现存数组的一个浅拷贝。详情请参阅下文描述。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### concat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[concat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#concat)\n\n##### join(separator) @join\n\njoin() 方法将一个数组（或一个类数组对象）的所有元素连接成一个字符串并返回这个字符串，用逗号或指定的分隔符字符串分隔。如果数组只有一个元素，那么将返回该元素而不使用分隔符。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 指定一个字符串来分隔数组的每个元素。如果需要，将分隔符转换为字符串。如果省略，数组元素用逗号（,）分隔。如果 separator 是空字符串（\"\"），则所有元素之间都没有任何字符。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### join 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | - |\n\n\n###### 参见\n[join](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#join)\n\n##### reverse() @reverse\n\nreverse() 方法就地反转数组中的元素，并返回同一数组的引用。数组的第一个元素会变成最后一个，数组的最后一个元素变成第一个。换句话说，数组中的元素顺序将被翻转，变为与之前相反的方向。\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### reverse 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reverse](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reverse)\n\n##### shift() @shift\n\nshift() 方法从数组中删除第一个元素，并返回该元素的值。此方法更改数组的长度。\n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| T \\| null | 否 |\n \n\n###### shift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[shift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#shift)\n\n##### slice(start, end) @slice\n\nslice() 方法返回一个新的数组对象，这一对象是一个由 start 和 end 决定的原数组的浅拷贝（包括 start，不包括 end），其中 start 和 end 代表了数组元素的索引。原始数组不会被改变。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 提取起始处的索引（从 0 开始），会转换为整数。 |\n| end | number | 是 | - | 提取终止处的索引（从 0 开始），会转换为整数。slice() 会提取到但不包括 end 的位置。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### slice 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[slice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#slice)\n\n##### sort(compareFn) @sort\n\nsort() 方法就地对数组的元素进行排序，并返回对相同数组的引用。默认排序是将元素转换为字符串，然后按照它们的 UTF-16 码元值升序排序。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| compareFn | (a: T, b: T) => number | 是 | - | 定义排序顺序的函数。返回值应该是一个数字，其正负性表示两个元素的相对顺序。该函数使用以下参数调用： a:第一个用于比较的元素。不会是 null。 b:第二个用于比较的元素。不会是 null。 如果省略该函数，数组元素会被转换为字符串，然后根据每个字符的 Unicode 码位值进行排序。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### sort 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[sort](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#sort)\n\n##### splice(start, deleteCount) @splice\n\nsplice() 方法通过移除或者替换已存在的元素和/或添加新元素就地改变一个数组的内容。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 从 0 开始计算的索引，表示要开始改变数组的位置，它会被转换成整数。 |\n| deleteCount | number | 是 | - | 一个整数，表示数组中要从 start 开始删除的元素数量。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### splice 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[splice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#splice)\n\n##### unshift(items) @unshift\n\nunshift() 方法将指定元素添加到数组的开头，并返回数组的新长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到 arr 开头的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### unshift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[unshift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#unshift)\n\n##### indexOf(searchElement, fromIndex) @indexof\n\nindexOf() 方法返回数组中第一次出现给定元素的下标，如果不存在则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 数组中要查找的元素。 |\n| fromIndex | number | 是 | - | 开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### indexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[indexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#indexOf)\n\n##### lastIndexOf(searchElement, fromIndex) @lastindexof\n\nlastIndexOf() 方法返回数组中给定元素最后一次出现的索引，如果不存在则返回 -1。该方法从 fromIndex 开始向前搜索数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 被查找的元素。 |\n| fromIndex | number | 是 | - | 以 0 起始的索引，表明反向搜索的起始位置，会被转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### lastIndexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[lastIndexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#lastIndexOf)\n\n##### every(predicate, thisArg) @every\n\nevery() 方法测试一个数组内的所有元素是否都能通过指定函数的测试。它返回一个布尔值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 every() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### every 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[every](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#every)\n\n##### some(predicate, thisArg) @some\n\nsome() 方法测试数组中是否至少有一个元素通过了由提供的函数实现的测试。如果在数组中找到一个元素使得提供的函数返回 true，则返回 true；否则返回 false。它不会修改数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 some() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### some 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[some](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#some)\n\n##### forEach(callbackfn, thisArg) @foreach\n\nforEach() 方法对数组的每个元素执行一次给定的函数。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => void | 是 | - | 为数组中每个元素执行的函数。并会丢弃它的返回值。该函数被调用时将传入以下参数： value:数组中正在处理的当前元素。 index:数组中正在处理的当前元素的索引。 array:调用了 forEach() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n\n###### forEach 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[forEach](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#forEach)\n\n##### map(callbackfn, thisArg) @map\n\nmap() 方法创建一个新数组，这个新数组由原数组中的每个元素都调用一次提供的函数后的返回值组成。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => U | 是 | - | 为数组中的每个元素执行的函数。它的返回值作为一个元素被添加为新数组中。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 map() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### map 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[map](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#map)\n\n##### filter(predicate, thisArg) @filter\n\nfilter() 方法创建给定数组一部分的浅拷贝，其包含通过所提供函数实现的测试的所有元素。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以将元素保留在结果数组中，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 filter() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### filter 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[filter](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#filter)\n\n##### reduce(callbackfn) @reduce\n\nreduce() 方法对数组中的每个元素按序执行一个提供的 reducer 函数，每一次运行 reducer 会将先前元素的计算结果作为参数传入，最后将其结果汇总为单个返回值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将作为 reduce() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为 array[0\\] 的值。 currentValue:当前元素的值。在第一次调用时，如果指定了 initialValue，则为 array[0\\] 的值，否则为 array[1\\]。 currentIndex:currentValue 在数组中的索引位置。在第一次调用时，如果指定了 initialValue 则为 0，否则为 1 array:调用了 reduce() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduce 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduce](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduce)\n\n##### reduceRight(callbackfn) @reduceright\n\nreduceRight() 方法对累加器（accumulator）和数组的每个值（按从右到左的顺序）应用一个函数，并使其成为单个值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中的每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将成为 reduceRight() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为数组最后一个元素的值。 currentValue:数组中当前正在处理的元素。 currentIndex:正在处理的元素在数组中的索引。 array:调用了 reduceRight() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduceRight 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduceRight](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduceRight)\n\n##### find(predicate, thisArg) @find\n\nfind() 方法返回数组中满足提供的测试函数的第一个元素的值。否则返回 null。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值来表示已经找到了匹配的元素。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| S \\| null | 否 |\n \n\n###### find 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[find](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#find)\n\n##### findIndex(predicate, thisArg) @findindex\n\nfindIndex() 方法返回数组中满足提供的测试函数的第一个元素的索引。若没有找到对应元素则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示已找到匹配元素，否则返回一个假值。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### findIndex 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[findIndex](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#findIndex)\n\n##### fill(value, start, end) @fill\n\nfill() 方法用一个固定值填充一个数组中从起始索引（默认为 0）到终止索引（默认为 array.length）内的全部元素。它返回修改后的数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | T | 是 | - | 用来填充数组元素的值。注意所有数组中的元素都将是这个确定的值：如果 value 是个对象，那么数组的每一项都会引用这个元素。 |\n| start | number | 是 | - | 基于零的索引，从此开始填充，转换为整数。 |\n| end | number | 是 | - | 基于零的索引，在此结束填充，转换为整数。fill() 填充到但不包含 end 索引。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### fill 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[fill](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#fill)\n\n##### copyWithin(target, start, end) @copywithin\n\ncopyWithin() 方法浅复制数组的一部分到同一数组中的另一个位置，并返回它，不会改变原数组的长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| target | number | 是 | - | 序列开始替换的目标位置，以 0 为起始的下标表示，且将被转换为整数 |\n| start | number | 是 | - | 要复制的元素序列的起始位置，以 0 为起始的下标表示，且将被转换为整数 |\n| end | number | 是 | - | 要复制的元素序列的结束位置，以 0 为起始的下标表示，且将被转换为整数。copyWithin 将会拷贝到该位置，但不包括 end 这个位置的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### copyWithin 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[copyWithin](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#copyWithin)\n\n##### includes(searchElement, fromIndex) @includes\n\nincludes() 方法用来判断一个数组是否包含一个指定的值，根据情况，如果包含则返回 true，否则返回 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | any | 是 | - | 需要查找的值。 |\n| fromIndex | number | 是 | - | 可选。开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### includes 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[includes](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#includes)\n\n##### at(index) @at\n\nTakes an integer value and returns the item at that index,\nallowing for positive and negative integers.\nNegative integers count back from the last item in the array.\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | - | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n\n\n###### RegExpExecArray 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| length | 5.0 | 3.9 | 4.11 | 4.0 |\n| toString | x | x | x | 4.0 |\n| toLocaleString | x | x | x | 4.0 |\n \n\n###### exec 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[exec](https://uniapp.dcloud.net.cn/uts/buildin-object-api/RegExp.html#exec)\n\n##### test(string) @test\n\n执行一个检索，用来查看正则表达式与指定的字符串是否匹配。返回 true 或 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| string | string | 是 | - | 用来与正则表达式匹配的字符串。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### test 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[test](https://uniapp.dcloud.net.cn/uts/buildin-object-api/RegExp.html#test)\n\n###### RegExp 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| flags | 5.0 | 3.9 | 4.11 | 4.0 |\n| dotAll | x | x | x | 4.0 |\n| hasIndices | x | x | x | 4.0 |\n| sticky | x | x | x | 4.0 |\n| unicode | x | x | x | 4.0 |\n| source | 5.0 | 3.9 | 4.11 | 4.0 |\n| global | 5.0 | 3.9 | 4.11 | 4.0 |\n| ignoreCase | 5.0 | 3.9 | 4.11 | 4.0 |\n| multiline | 5.0 | 3.9 | 4.11 | 4.0 |\n| lastIndex | 5.0 | 3.9 | 4.11 | 4.0 |\n\n##### String 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| toString | x | x | x | 4.0 |\n| length | 5.0 | 3.9 | 4.11 | 4.0 |\n| valueOf | x | x | x | 4.0 |\n\n##### UniScrollEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/list-view/list-view.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/list-view/list-view\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n import { ItemType } from '@/components/enum-data/enum-data'\r\n export default {\r\n data() {\r\n return {\r\n refresher_triggered_boolean: false,\r\n refresher_enabled_boolean: false,\r\n scroll_with_animation_boolean: false,\r\n show_scrollbar_boolean: false,\r\n bounces_boolean: true,\r\n scroll_y_boolean: true,\r\n scroll_x_boolean: false,\r\n scroll_direction: \"vertical\",\r\n upper_threshold_input: 50,\r\n lower_threshold_input: 50,\r\n scroll_top_input: 0,\r\n scroll_left_input: 0,\r\n refresher_background_input: \"#FFF\",\r\n scrollData: [] as Array,\r\n size_enum: [{ \"value\": 0, \"name\": \"item---0\" }, { \"value\": 3, \"name\": \"item---3\" }] as ItemType[],\r\n scrollIntoView: \"\",\r\n refresherrefresh: false,\r\n refresher_default_style_input: \"black\",\r\n text: ['继续下拉执行刷新', '释放立即刷新', '刷新中', \"\"],\r\n state: 3,\r\n reset: true\r\n }\r\n },\r\n onLoad() {\r\n let lists : Array = []\r\n for (let i = 0; i < 10; i++) {\r\n lists.push(\"item---\" + i)\r\n }\r\n this.scrollData = lists\r\n },\r\n methods: {\r\n list_view_click() { console.log(\"组件被点击时触发\") },\r\n list_view_touchstart() { console.log(\"手指触摸动作开始\") },\r\n list_view_touchmove() { console.log(\"手指触摸后移动\") },\r\n list_view_touchcancel() { console.log(\"手指触摸动作被打断，如来电提醒，弹窗\") },\r\n list_view_touchend() { console.log(\"手指触摸动作结束\") },\r\n list_view_tap() { console.log(\"手指触摸后马上离开\") },\r\n list_view_longpress() { console.log(\"如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。\") },\r\n list_view_refresherpulling(e : RefresherEvent) {\r\n console.log(\"下拉刷新控件被下拉\")\r\n if (this.reset) {\r\n if (e.detail.dy > 45) {\r\n this.state = 1\r\n } else {\r\n this.state = 0\r\n }\r\n }\r\n },\r\n list_view_refresherrefresh() {\r\n console.log(\"下拉刷新被触发 \")\r\n this.refresherrefresh = true\r\n this.refresher_triggered_boolean = true\r\n this.state = 2\r\n this.reset = false;\r\n setTimeout(() => {\r\n this.refresher_triggered_boolean = false\r\n }, 1500)\r\n },\r\n list_view_refresherrestore() {\r\n this.refresherrefresh = false\r\n this.state = 3\r\n this.reset = true\r\n console.log(\"下拉刷新被复位\")\r\n },\r\n list_view_refresherabort() { console.log(\"下拉刷新被中止\") },\r\n list_view_scrolltoupper(e : ScrollToUpperEvent) { console.log(\"滚动到顶部/左边，会触发 scrolltoupper 事件 direction=\" + e.detail.direction) },\r\n list_view_scrolltolower(e : ScrollToLowerEvent) { console.log(\"滚动到底部/右边，会触发 scrolltolower 事件 direction=\" + e.detail.direction) },\r\n list_view_scroll() { console.log(\"滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY}\") },\r\n list_item_click() { console.log(\"list-item组件被点击时触发\") },\r\n list_item_touchstart() { console.log(\"手指触摸list-item组件动作开始\") },\r\n list_item_touchmove() { console.log(\"手指触摸list-item组件后移动\") },\r\n list_item_touchcancel() { console.log(\"手指触摸list-item组件动作被打断，如来电提醒，弹窗\") },\r\n list_item_touchend() { console.log(\"手指触摸list-item组件动作结束\") },\r\n list_item_tap() { console.log(\"手指触摸list-item组件后马上离开\") },\r\n list_item_longpress() { console.log(\"list-item组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。\") },\r\n change_refresher_triggered_boolean(checked : boolean) { this.refresher_triggered_boolean = checked },\r\n change_refresher_enabled_boolean(checked : boolean) { this.refresher_enabled_boolean = checked },\r\n change_scroll_with_animation_boolean(checked : boolean) { this.scroll_with_animation_boolean = checked },\r\n change_show_scrollbar_boolean(checked : boolean) { this.show_scrollbar_boolean = checked },\r\n change_bounces_boolean(checked : boolean) { this.bounces_boolean = checked },\r\n change_scroll_y_boolean(checked : boolean) {\r\n this.scroll_y_boolean = checked\r\n this.change_scroll_direction()\r\n },\r\n change_scroll_x_boolean(checked : boolean) {\r\n this.scroll_x_boolean = checked\r\n this.change_scroll_direction()\r\n },\r\n change_scroll_direction() {\r\n if (this.scroll_y_boolean && this.scroll_x_boolean || this.scroll_y_boolean) {\r\n this.scroll_direction = \"vertical\"\r\n } else if (!this.scroll_y_boolean && !this.scroll_x_boolean) {\r\n this.scroll_direction = \"none\"\r\n } else if (!this.scroll_y_boolean && this.scroll_x_boolean) {\r\n this.scroll_direction = \"horizontal\"\r\n }\r\n },\r\n confirm_upper_threshold_input(value : number) { this.upper_threshold_input = value },\r\n confirm_lower_threshold_input(value : number) { this.lower_threshold_input = value },\r\n confirm_scroll_top_input(value : number) { this.scroll_top_input = value },\r\n confirm_scroll_left_input(value : number) { this.scroll_left_input = value },\r\n confirm_refresher_background_input(value : string) { this.refresher_background_input = value },\r\n item_change_size_enum(index : number) { this.scrollIntoView = \"item---\" + index },\r\n //自动化测试例专用\r\n check_scroll_height() : Boolean {\r\n var listElement = this.$refs[\"listview\"] as UniElement\r\n console.log(\"check_scroll_height--\" + listElement.scrollHeight)\r\n if (listElement.scrollHeight > 2000) {\r\n return true\r\n }\r\n return false\r\n },\r\n //自动化测试例专用\r\n check_scroll_width() : Boolean {\r\n var listElement = this.$refs[\"listview\"] as UniElement\r\n console.log(\"check_scroll_width\" + listElement.scrollWidth)\r\n if (listElement.scrollWidth > 2000) {\r\n return true\r\n }\r\n return false\r\n },\r\n change_refresher_style_boolean(checked : boolean) {\r\n if (checked) {\r\n this.refresher_default_style_input = \"none\"\r\n } else {\r\n this.refresher_default_style_input = \"black\"\r\n }\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### list-view 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| direction | 4.0 | 4.11 | x |\n| ~~scroll-x~~ | 3.9 | x | x |\n| ~~scroll-y~~ | 3.9 | 4.11 | x |\n| ~~rebound~~ | 3.9 | 4.11 | x |\n| associative-container | 4.11 | 4.11 | x |\n| bounces | 4.0 | 4.11 | x |\n| upper-threshold | 3.9 | 4.11 | 4.02 |\n| lower-threshold | 3.9 | 4.11 | 4.02 |\n| scroll-top | 3.9 | 4.11 | 4.02 |\n| scroll-left | 3.9 | 4.11 | x |\n| show-scrollbar | 3.9 | 4.11 | 4.02 |\n| scroll-into-view | 3.9 | 4.11 | x |\n| scroll-with-animation | 3.9 | 4.11 | 4.02 |\n| refresher-enabled | 3.9 | 4.11 | x |\n| refresher-threshold | 3.9 | 4.11 | x |\n| refresher-max-drag-distance | 3.9 | 4.11 | x |\n| refresher-default-style | 3.9 | 4.11 | x |\n| refresher-background | 3.9 | 4.11 | x |\n| refresher-triggered | 3.9 | 4.11 | x |\n| custom-nested-scroll | 3.9 | 4.11 | x |\n| @refresherpulling | 3.9 | 4.11 | x |\n| @refresherrefresh | 3.9 | 4.11 | x |\n| @refresherrestore | 3.9 | 4.11 | x |\n| @refresherabort | 3.9 | 4.11 | x |\n| @scrolltoupper | 3.9 | 4.11 | 4.02 |\n| @scrolltolower | 3.9 | 4.11 | 4.02 |\n| @scroll | 3.9 | 4.11 | 4.02 |\n| @scrollend | 3.9 | 4.11 | x |\n","children":"### 子组件 @children-tags \n - [list-item](#list-item)\n- [sticky-header](https://uniapp.dcloud.net.cn/uni-app-x/component/sticky.html#sticky-header)\n- [sticky-section](https://uniapp.dcloud.net.cn/uni-app-x/component/sticky.html#sticky-section)","reference":"\n### 参见\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.list-view)\n"},"navigator":{"name":"## navigator","description":"> 组件类型：UniNavigatorElement \n\n 页面链接\n\n### navigator 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| target | string | - | 在哪个目标上发生跳转，默认当前应用 |\n| url | string([string.PageURIString](/uts/data-type.md#ide-string)) | - | 当前应用内的跳转链接 |\n| open-type | string | \"navigate\" | 跳转方式 |\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| 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 | \"pop-in/out\" | 当 open-type=\"navigateTo\" 或 open-type=\"navigateBack\" 时有效，窗口的显示/关闭的动画类型。 |\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| animation-duration | number | 300 | 当 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| render-link | boolean | true | 是否给 navigator 组件加一层 a 标签控制 ssr 渲染 |\n\n","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/navigator/navigator.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/navigator/navigator\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n title: 'navigator'\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### navigator 属性兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| target | 5.0 | 3.9 | 4.11 | 4.0 |\n| url | 5.0 | 3.9 | 4.11 | 4.0 |\n| open-type | 5.0 | 3.9 | 4.11 | 4.0 |\n| delta | 5.0 | 3.9 | 4.11 | 4.0 |\n| path | 5.0 | 3.9 | x | 4.0 |\n| animation-type | 5.0 | 3.9 | 4.11 | 4.0 |\n| animation-duration | 5.0 | 3.9 | 4.11 | 4.0 |\n| render-link | x | x | x | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/navigator)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/navigator.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.navigator)\n"},"picker-view-column":{"name":"## picker-view-column","description":"仅可放置于 picker-view 中，其子节点未继承 picker-view 的选中框的高度，需要自己设置高度并居中\n\n### picker-view-column 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"","event":"","example":"","compatibility":"","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.net.cn/component/picker-view.html#picker-view-column)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/picker-view.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.picker-view-column)\n"},"picker-view":{"name":"## picker-view","description":"> 组件类型：UniPickerViewElement \n\n 嵌入页面的滚动选择器\n\n### picker-view 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| value | array\\ | - | picker-view-column 选择的第几项 |\n| indicator-style | string([string.CSSString](/uts/data-type.md#ide-string)) | - | 设置选择器中间选中框的样式 |\n| indicator-class | string([string.ClassString](/uts/data-type.md#ide-string)) | - | 设置选择器中间选中框的类名 |\n| mask-style | string([string.CSSString](/uts/data-type.md#ide-string)) | - | 设置蒙层的样式 |\n| mask-top-style | string([string.CSSString](/uts/data-type.md#ide-string)) | - | 设置蒙层上半部分的样式 |\n| mask-bottom-style | string([string.CSSString](/uts/data-type.md#ide-string)) | - | 设置蒙层下半部分的样式 |\n| mask-class | string([string.ClassString](/uts/data-type.md#ide-string)) | - | 设置蒙层的类名 |\n| @change | (event: [UniPickerViewChangeEvent](#unipickerviewchangeevent)) => void | - | 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 \t\t开始） |","event":"\n### 事件\n#### UniPickerViewChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | Array\\ | 是 | - | - |\n\n##### UniPickerViewChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniPickerViewChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | Array\\ | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniPickerViewChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/picker-view/picker-view.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/picker-view/picker-view\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n const date = new Date()\r\n const _years : number[] = []\r\n const _year = date.getFullYear()\r\n const _months : number[] = []\r\n const _month : number = date.getMonth() + 1\r\n const _days : number[] = []\r\n const _day = date.getDate()\r\n for (let i = 2000; i <= _year; i++) {\r\n _years.push(i)\r\n }\r\n for (let i = 1; i <= 12; i++) {\r\n _months.push(i)\r\n }\r\n for (let i = 1; i <= 31; i++) {\r\n _days.push(i)\r\n }\r\n return {\r\n title: 'picker-view',\r\n years: _years as number[],\r\n year: _year as number,\r\n months: _months as number[],\r\n month: _month as number,\r\n days: _days as number[],\r\n day: _day as number,\r\n value: [_year - 2000, _month - 1, _day - 1] as number[],\r\n result: [] as number[],\r\n indicatorStyle: 'height: 50px;',\r\n maskTopStyle: '',\r\n maskBottomStyle: ''\r\n }\r\n },\r\n methods: {\r\n bindChange(e : UniPickerViewChangeEvent) {\r\n const val = e.detail.value\r\n this.result = val\r\n this.year = this.years[val[0]]\r\n this.month = this.months[val[1]]\r\n this.day = this.days[val[2]]\r\n },\r\n setValue() {\r\n this.value = [0, 0, 0] as number[]\r\n },\r\n setValue1() {\r\n this.value = [10, 10, 10] as number[]\r\n },\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### picker-view 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| value | √ | 4.11 | 4.0 |\n| indicator-style | √ | 4.11 | 4.0 |\n| indicator-class | x | x | 4.0 |\n| mask-style | x | x | 4.0 |\n| mask-top-style | √ | 4.11 | x |\n| mask-bottom-style | √ | 4.11 | x |\n| mask-class | x | x | 4.0 |\n| @change | √ | 4.11 | 4.0 |\n","children":"### 子组件 @children-tags \n - [picker-view-column](#picker-view-column)","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/picker-view)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/picker-view.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.picker-view)\n"},"progress":{"name":"## progress","description":"> 组件类型：UniProgressElement \n\n 进度条\n\n### progress 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| duration | number | 30 | 进度增加1%所需毫秒数 |\n| percent | number | 0 | 百分比0~100 |\n| show-info | boolean | false | 在进度条右侧显示百分比 |\n| border-radius | number | 0 | 圆角大小 |\n| font-size | number | 16 | 右侧百分比字体大小 |\n| stroke-width | number | 6 | 进度条线的宽度，单位px |\n| activeColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#09BB07\" | 已选择的进度条的颜色 |\n| backgroundColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#EBEBEB\" | 未选择的进度条的颜色 |\n| active | boolean | false | 进度条从左往右的动画 |\n| active-mode | string | \"backwards\" | backwards: 动画从头播；forwards：动画从上次结束点接着播 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| backwards | 动画从头播 |\n@| forwards | 动画从上次结束点接着播 |\n| @activeend | (event: [UniProgressActiveendEvent](#uniprogressactiveendevent)) => void | - | 动画完成事件 |\n\n#### active-mode 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| backwards | √ | 4.11 | 4.0 |\n| forwards | √ | x | 4.0 |\n","event":"\n### 事件\n#### UniProgressActiveendEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | number | 是 | - | - |\n\n##### UniProgressActiveendEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniProgressActiveendEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| curPercent | number | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniProgressActiveendEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/progress/progress.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/progress/progress\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n import { ItemType } from '@/components/enum-data/enum-data'\r\n export default {\r\n data() {\r\n return {\r\n title: 'progress',\r\n pgList: [0, 0, 0, 0] as number[],\r\n curPercent: 0,\r\n showInfo: true,\r\n borderRadius: 0,\r\n fontSize: 16,\r\n strokeWidth: 3,\r\n backgroundColor: '#EBEBEB',\r\n\r\n // 组件属性 autotest\r\n active_boolean: false,\r\n show_info_boolean: false,\r\n duration_input: 30,\r\n percent_input: 0,\r\n stroke_width_input: 6,\r\n activeColor_input: \"#09BB07\",\r\n backgroundColor_input: \"#EBEBEB\",\r\n active_mode_enum: [{ \"value\": 0, \"name\": \"backwards\" }, { \"value\": 1, \"name\": \"forwards\" }] as ItemType[],\r\n active_mode_enum_current: 0\r\n }\r\n },\r\n methods: {\r\n setProgress() {\r\n this.pgList = [20, 40, 60, 80] as number[]\r\n },\r\n clearProgress() {\r\n this.pgList = [0, 0, 0, 0] as number[]\r\n },\r\n activeend(e : UniProgressActiveendEvent) {\r\n this.curPercent = e.detail.curPercent\r\n },\r\n progress_touchstart() { console.log(\"手指触摸动作开始\") },\r\n progress_touchmove() { console.log(\"手指触摸后移动\") },\r\n progress_touchcancel() { console.log(\"手指触摸动作被打断，如来电提醒，弹窗\") },\r\n progress_touchend() { console.log(\"手指触摸动作结束\") },\r\n progress_tap() { console.log(\"手指触摸后马上离开\") },\r\n change_active_boolean(checked : boolean) { this.active_boolean = checked },\r\n change_show_info_boolean(checked : boolean) { this.show_info_boolean = checked },\r\n confirm_duration_input(value : number) { this.duration_input = value },\r\n confirm_percent_input(value : number) { this.percent_input = value },\r\n confirm_stroke_width_input(value : number) { this.stroke_width_input = value },\r\n confirm_activeColor_input(value : string) { this.activeColor_input = value },\r\n confirm_backgroundColor_input(value : string) { this.backgroundColor_input = value },\r\n radio_change_active_mode_enum(checked : number) { this.active_mode_enum_current = checked }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### progress 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| duration | √ | 4.11 | 4.0 |\n| percent | √ | 4.11 | 4.0 |\n| show-info | √ | 4.11 | 4.0 |\n| border-radius | √ | 4.11 | x |\n| font-size | √ | 4.11 | x |\n| stroke-width | √ | 4.11 | 4.0 |\n| activeColor | √ | 4.11 | 4.0 |\n| backgroundColor | √ | 4.11 | 4.0 |\n| active | √ | 4.11 | 4.0 |\n| active-mode | √ | x | 4.0 |\n| @activeend | √ | 4.11 | x |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/progress)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/progress.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.progress)\n"},"radio":{"name":"## radio","description":"> 组件类型：UniRadioElement \n\n 单选项。在1组radio-group中只能选中1个\n\n### radio 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| disabled | boolean | false | 是否禁用 |\n| value | string | - | \\ 标识。当该radio 选中时，radio-group的 change 事件会携带radio的value |\n| checked | boolean | false | \\ 当前是否选中 |\n| color | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#007AFF\" | radio的颜色 |\n| backgroundColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#ffffff\" | radio默认的背景颜色 |\n| borderColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#d1d1d1\" | radio默认的边框颜色 |\n| activeBackgroundColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#007AFF\" | radio选中时的背景颜色，优先级大于color属性 |\n| activeBorderColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"\" | radio选中时的边框颜色 |\n| iconColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#ffffff\" | radio的图标颜色 |","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/radio/radio.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/radio/radio\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n type ItemType = {\r\n value : string\r\n name : string\r\n }\r\n export default {\r\n data() {\r\n return {\r\n items: [\r\n {\r\n value: 'CHN',\r\n name: '中国',\r\n },\r\n {\r\n value: 'USA',\r\n name: '美国',\r\n },\r\n\r\n {\r\n value: 'BRA',\r\n name: '巴西',\r\n },\r\n {\r\n value: 'JPN',\r\n name: '日本',\r\n },\r\n {\r\n value: 'ENG',\r\n name: '英国',\r\n },\r\n {\r\n value: 'FRA',\r\n name: '法国',\r\n },\r\n ] as ItemType[],\r\n current: 0,\r\n\r\n value: '',\r\n text: '未选中',\r\n wrapText: 'uni-app x，终极跨平台方案\\nuts，大一统语言',\r\n disabled: true,\r\n checked: true,\r\n color: '#007aff',\r\n // 组件属性 autotest\r\n checked_boolean: false,\r\n disabled_boolean: false,\r\n color_input: \"#007AFF\",\r\n backgroundColor_input: \"#ffffff\",\r\n borderColor_input: \"#d1d1d1\",\r\n activeBackgroundColor_input: \"#007AFF\",\r\n activeBorderColor_input: \"\",\r\n iconColor_input: \"#ffffff\"\r\n }\r\n },\r\n methods: {\r\n radioChange(e : UniRadioGroupChangeEvent) {\r\n const selected = this.items.find((item) : boolean => {\r\n return item.value == e.detail.value\r\n })\r\n uni.showToast({\r\n icon: 'none',\r\n title: '当前选中:' + selected?.name,\r\n })\r\n },\r\n testChange(e : UniRadioGroupChangeEvent) {\r\n this.value = e.detail.value\r\n },\r\n radio_click() { console.log(\"组件被点击时触发\") },\r\n radio_touchstart() { console.log(\"手指触摸动作开始\") },\r\n radio_touchmove() { console.log(\"手指触摸后移动\") },\r\n radio_touchcancel() { console.log(\"手指触摸动作被打断，如来电提醒，弹窗\") },\r\n radio_touchend() { console.log(\"手指触摸动作结束\") },\r\n radio_tap() { console.log(\"手指触摸后马上离开\") },\r\n radio_longpress() { console.log(\"如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。\") },\r\n change_checked_boolean(checked : boolean) { this.checked_boolean = checked },\r\n change_disabled_boolean(checked : boolean) { this.disabled_boolean = checked },\r\n confirm_color_input(value : string) { this.color_input = value },\r\n confirm_backgroundColor_input(value : string) { this.backgroundColor_input = value },\r\n confirm_borderColor_input(value : string) { this.borderColor_input = value },\r\n confirm_activeBackgroundColor_input(value : string) { this.activeBackgroundColor_input = value },\r\n confirm_activeBorderColor_input(value : string) { this.activeBorderColor_input = value },\r\n confirm_iconColor_input(value : string) { this.iconColor_input = value }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### radio 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| disabled | √ | 4.11 | 4.0 |\n| value | √ | 4.11 | 4.0 |\n| checked | √ | 4.11 | 4.0 |\n| color | √ | 4.11 | 4.0 |\n| backgroundColor | √ | 4.11 | 4.0 |\n| borderColor | √ | 4.11 | 4.0 |\n| activeBackgroundColor | √ | 4.11 | 4.0 |\n| activeBorderColor | √ | 4.11 | 4.0 |\n| iconColor | √ | 4.11 | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/radio)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/radio-group.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.radio)\n"},"radio-group":{"name":"## radio-group","description":"> 组件类型：UniRadioGroupElement \n\n 单选组，内部由多个 radio 组成\n\n### radio-group 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| √ | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| name | string | - | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |\n| @change | (event: [UniRadioGroupChangeEvent](#uniradiogroupchangeevent)) => void | - | radio-group 中的选中项发生变化时触发 change 事件，event.detail = {value: 选中项radio的value} |","event":"\n### 事件\n#### UniRadioGroupChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | string | 是 | - | - |\n\n##### UniRadioGroupChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniRadioGroupChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | string | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniRadioGroupChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"","compatibility":"### radio-group 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| name | 3.9 | 4.11 | 4.0 |\n| @change | √ | 4.11 | 4.0 |\n","children":"### 子组件 @children-tags \n - [radio](#radio)","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/radio)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/radio-group.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.radio-group)\n"},"form":{"name":"## form","description":"> 组件类型：UniFormElement \n\n 表单\n\n### form 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.97 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| disabled | boolean | - | 是否禁用 |\n| report-submit | boolean | - | 是否返回 formId 用于发送模板消息 |\n| @submit | (event: [UniFormSubmitEvent](#uniformsubmitevent)) => void | - | 携带 form 中的数据触发 submit 事件，event.detail = {value : {'name': 'value'}} |\n| @reset | (event: [UniFormResetEvent](#uniformresetevent)) => void | - | 表单重置时会触发 reset 事件 |","event":"\n### 事件\n#### UniFormSubmitEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | [UTSJSONObject](/uts/buildin-object-api/utsjsonobject.md) | 是 | - | - |\n\n##### UniFormSubmitEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniFormSubmitEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | [UTSJSONObject](/uts/buildin-object-api/utsjsonobject.md) | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniFormSubmitEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniFormResetEvent\n\n##### 构造函数\n##### UniFormResetEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniFormResetEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniFormResetEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/form/form.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/form/form\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n nickname: '',\r\n gender: '0',\r\n age: 18,\r\n loves: ['0'],\r\n switch: true,\r\n formData: {} as UTSJSONObject\r\n }\r\n },\r\n computed: {\r\n formDataText() : string {\r\n return JSON.stringify(this.formData)\r\n }\r\n },\r\n methods: {\r\n onFormSubmit: function (e : UniFormSubmitEvent) {\r\n this.formData = e.detail.value\r\n },\r\n onFormReset: function (_ : UniFormResetEvent) {\r\n this.formData = {}\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### form 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| disabled | 3.97 | 4.11 | 4.0 |\n| report-submit | x | x | 4.0 |\n| @submit | 3.97 | 4.11 | 4.0 |\n| @reset | 3.97 | 4.11 | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/form)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/form.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.form)\n"},"rich-text":{"name":"## rich-text","description":"> 组件类型：UniRichTextElement \n\n 富文本。可渲染文字样式、图片、超链接。支持部分HTML标签\n\n### rich-text 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| nodes | array \\| string | - | 节点列表 \\| HTML String |\n| selectable | boolean | false | 文本是否可选 |\n| @itemclick | (event: [UniRichTextItemClickEvent](#unirichtextitemclickevent)) => void | - | 拦截点击事件（只支持 a、img标签），返回用户自定义数据或img标签的src属性或a标签的href属性。event.detail={ ref \\| src \\| href } |","event":"\n### 事件\n#### UniRichTextItemClickEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniRichTextItemClickEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniRichTextItemClickEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| ref | string \\| null | 否 | - | 自定义数据 |\n@| src | string \\| null | 否 | - | \\图片链接 |\n@| href | string \\| null | 否 | - | \\超链接 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniRichTextItemClickEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/rich-text/rich-text.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/rich-text/rich-text\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n\r\n\n```\n\n:::","compatibility":"### rich-text 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| nodes | 3.9 | 4.11 | 4.0 |\n| selectable | 3.9 | 4.11 | 4.0 |\n| @itemclick | 3.9 | 4.11 | - |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/rich-text)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/rich-text.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.rich-text)\n"},"nested-scroll-body":{"name":"## nested-scroll-body","description":"> 组件类型：UniNestedScrollHeaderElement \n\n 嵌套 scroll-view 场景中属于里层 scroll-view 的节点，仅支持作为 \\ 模式的直接子节点\n\n### nested-scroll-body 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 4.11 | 4.11 | x |\n","attribute":"","event":"","example":"","compatibility":"","children":"","reference":"\n### 参见\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.nested-scroll-body)\n"},"nested-scroll-header":{"name":"## nested-scroll-header","description":"> 组件类型：UniNestedScrollHeaderElement \n\n 嵌套 scroll-view 场景中属于外层 scroll-view 的节点，仅支持作为 \\ 模式的直接子节点\n\n### nested-scroll-header 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 4.11 | 4.11 | x |\n","attribute":"","event":"","example":"","compatibility":"","children":"","reference":"\n### 参见\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.nested-scroll-header)\n"},"scroll-view":{"name":"## scroll-view","description":"> 组件类型：UniScrollViewElement \n\n 可滚动视图容器\n\n### scroll-view 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| type | string | - | 渲染模式，可取值 nested |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| nested | 嵌套模式。用于处理父子 scroll-view 间的嵌套滚动，子节点只能是 nested-scroll-header nested-scroll-body 组件或自定义 refresher |\n| direction | string | \"vertical\" | 滚动方向，可取值 none、all、horizontal、vertical，默认值vertical |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| none | 禁止滚动 |\n@| all | 横向竖向都可滚动 app端不支持 |\n@| horizontal | 横向滚动 |\n@| vertical | 竖向滚动 |\n| ~~scroll-x~~ | boolean | false | 允许横向滚动，不支持同时设置scroll-y属性为true，同时设置true时scroll-y生效。已废弃，请改用direction |\n| ~~scroll-y~~ | boolean | true | 允许纵向滚动，不支持同时设置scroll-x属性为true，同时设置true时scroll-y生效。已废弃，请改用direction |\n| ~~rebound~~ | boolean | true | 控制是否回弹效果。已废弃，请改用bounces |\n| associative-container | string | \"\" | 关联的滚动容器 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| nested-scroll-view | 嵌套滚动 |\n| bounces | boolean | true | 控制是否回弹效果 优先级高于rebound |\n| upper-threshold | number | 50 | 距顶部/左边多远时（单位px），触发 scrolltoupper 事件 |\n| lower-threshold | number | 50 | 距底部/右边多远时（单位px），触发 scrolltolower 事件 |\n| scroll-top | number | 0 | 设置竖向滚动条位置 |\n| scroll-left | number | 0 | 设置横向滚动条位置 |\n| scroll-into-view | string([string.IDString](/uts/data-type.md#ide-string)) | - | 值应为某子元素id（id不能以数字开头）。设置哪个方向可滚动，则在哪个方向滚动到该元素起始位置 |\n| scroll-with-animation | boolean | false | 是否在设置滚动条位置时使用滚动动画，设置false没有滚动动画 |\n| refresher-enabled | boolean | false | 开启下拉刷新，暂时不支持scroll-x = true横向刷新 |\n| refresher-threshold | number | 45 | 设置下拉刷新阈值 |\n| refresher-max-drag-distance | number | - | 设置下拉最大拖拽距离（单位px），默认是下拉刷新控件高度的2.5倍 |\n| refresher-default-style | string | \"black\" | 设置下拉刷新默认样式，支持设置 black \\| white \\| none， none 表示不使用默认样式 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| black | 深颜色雪花样式 |\n@| white | 浅白色雪花样式 |\n@| none | 不使用默认样式 |\n| refresher-background | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#FFF\" | 设置下拉刷新区域背景颜色 |\n| refresher-triggered | boolean | false | 设置当前下拉刷新状态，true 表示下拉刷新已经被触发，false 表示下拉刷新未被触发 |\n| show-scrollbar | boolean | true | 控制是否出现滚动条 |\n| custom-nested-scroll | boolean | false | 子元素是否开启嵌套滚动 将滚动事件与父元素协商处理 |\n| nested-scroll-child | string([string.IDString](/uts/data-type.md#ide-string)) | \"\" | 嵌套滚动子元素的id属性，不支持ref，scroll-view惯性滚动时会让对应id元素视图进行滚动，子元素滚动时会触发scroll-view的nestedprescroll事件，嵌套子元素需要设置custom-nested-scroll = true |\n| @refresherpulling | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新控件被下拉 |\n| @refresherrefresh | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新被触发 |\n| @refresherrestore | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新被复位 |\n| @refresherabort | (event: [UniRefresherEvent](#unirefresherevent)) => void | - | 下拉刷新被中止 |\n| @scrolltoupper | (event: [UniScrollToUpperEvent](#uniscrolltoupperevent)) => void | - | 滚动到顶部/左边，会触发 scrolltoupper 事件 |\n| @scrolltolower | (event: [UniScrollToLowerEvent](#uniscrolltolowerevent)) => void | - | 滚动到底部/右边，会触发 scrolltolower 事件 |\n| @scroll | (event: [UniScrollEvent](#uniscrollevent)) => void | - | 滚动时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |\n| @scrollend | (event: [UniScrollEvent](#uniscrollevent)) => void | - | 滚动结束时触发，event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY} |\n| @startnestedscroll | (event: [UniStartNestedScrollEvent](#unistartnestedscrollevent)) => Boolean | - | 子元素开始滚动时触发, return ture表示与子元素开启滚动协商 默认return false! event = {node} |\n| @nestedprescroll | (event: [UniNestedPreScrollEvent](#uninestedprescrollevent)) => void | - | 子元素滚动时触发，可执行event.consumed(x,y)告知子元素deltaX、deltaY各消耗多少。子元素将执行差值后的deltaX、deltaY滚动距离。不执行consumed(x,y)则表示父元素不消耗deltaX、deltaY。event = {deltaX, deltaY} |\n| @stopnestedscroll | (event: [UniStopNestedScrollEvent](#unistopnestedscrollevent)) => void | - | 子元素滚动结束或意外终止时触发 |\n\n#### type 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| nested | 4.11 | 4.11 | x |\n\n\n#### direction 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| none | 4.0 | 4.11 | 4.0 |\n| all | 4.0 | x | 4.0 |\n| horizontal | 4.0 | 4.11 | 4.0 |\n| vertical | 4.0 | 4.11 | 4.0 |\n\n\n#### associative-container 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| nested-scroll-view | 4.11 | 4.11 | x |\n\n\n#### refresher-default-style 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| black | 3.9 | 4.11 | - |\n| white | 3.9 | 4.11 | - |\n| none | 3.9 | 4.11 | - |\n","event":"\n### 事件\n#### UniRefresherEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniRefresherEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniRefresherEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| dy | number | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniRefresherEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniScrollToUpperEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniScrollToUpperEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniScrollToUpperEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| direction | string | 是 | - | 滚动方向 top 或 left |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniScrollToUpperEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniScrollToLowerEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniScrollToLowerEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniScrollToLowerEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| direction | string | 是 | - | 滚动方向 bottom 或 right |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniScrollToLowerEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniScrollEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| String | **String** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| toString | any | 是 | - | 返回一个字符串，表示指定的字符串。 |\n@| length | number | 是 | - | 返回字符串的 UTF-16 码元长度。 |\n@| valueOf | any | 是 | - | 返回 String 对象的原始值 |\n| detail | any | 是 | - | - |\n\n##### UniScrollEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniScrollEventDetail** | 是 | - | |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| scrollTop | number | 是 | - | 竖向滚动的距离 |\n@| scrollLeft | number | 是 | - | 横向滚动的距离 |\n@| scrollHeight | number | 是 | - | 滚动区域的高度 |\n@| scrollWidth | number | 是 | - | 滚动区域的宽度 |\n@| deltaY | number | 是 | - | 当次滚动事件竖向滚动量 |\n@| deltaX | number | 是 | - | 当次滚动事件横向滚动量 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n#### String 的方法 @string-values \n\n#### charAt(pos) @charat\n\n返回一个由给定索引处的单个 UTF-16 码元构成的新字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| pos | number | 是 | - | 要返回的字符的索引，从零开始。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### charAt 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[charAt](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#charAt)\n\n#### toCharArray() @tochararray\n\n返回包含此字符串的字符的[kotlin.CharArray\\]。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| CharArray |\n \n\n##### toCharArray 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | x |\n\n\n##### 参见\n[toCharArray](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toCharArray)\n\n#### charCodeAt(index) @charcodeat\n\n返回 0 到 65535 之间的整数，表示给定索引处的 UTF-16 代码单元\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | 一个大于等于 0，小于字符串长度的整数。如果不是一个数值，则默认为 0。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### charCodeAt 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[charCodeAt](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#charCodeAt)\n\n#### concat(strings) @concat\n\n将字符串参数连接到调用的字符串，并返回一个新的字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| strings | Array\\ | 是 | - | T要连接到 str 的一个或多个字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### concat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[concat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#concat)\n\n#### indexOf(searchString, position) @indexof\n\n在字符串中搜索指定子字符串，并返回其第一次出现的位置索引。它可以接受一个可选的参数指定搜索的起始位置，如果找到了指定的子字符串，则返回的位置索引大于或等于指定的数字。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的子字符串。 |\n| position | number | 是 | - | 该方法返回指定子字符串在大于或等于 position 位置的第一次出现的索引，默认为 0。如果 position 大于调用字符串的长度，则该方法根本不搜索调用字符串。如果 position 小于零，该方法的行为就像 position 为 0 时一样。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### indexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[indexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#indexOf)\n\n#### lastIndexOf(searchString, position) @lastindexof\n\n搜索该字符串并返回指定子字符串最后一次出现的索引。它可以接受一个可选的起始位置参数，并返回指定子字符串在小于或等于指定数字的索引中的最后一次出现的位置。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的子字符串。 |\n| position | number | 是 | - | 该方法返回指定子字符串在小于或等于 position 的位置中的最后一次出现的索引，默认为 +Infinity。如果 position 大于调用字符串的长度，则该方法将搜索整个字符串。如果 position 小于 0，则行为与 0 相同，即该方法只在索引 0 处查找指定的子字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### lastIndexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[lastIndexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#lastIndexOf)\n\n#### localeCompare(that) @localecompare\n\n返回一个数字，表示参考字符串在排序顺序中是在给定字符串之前、之后还是与之相同。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| that | string | 是 | - | 与 referenceStr 进行比较的字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### localeCompare 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[localeCompare](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#localeCompare)\n\n#### match(regexp) @match\n\nmatch() 方法检索字符串与正则表达式进行匹配的结果。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| regexp | string \\| [RegExp](#regexp-values) | 是 | - | 一个正则表达式对象或者任何具有 Symbol.match 方法的对象。 | \n\n##### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| [RegExpMatchArray](#regexpmatcharray-values) \\| null | 否 |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| 0 | string | 是 | - | The first match. This will always be present because `null` will be returned if there are no matches. |\n@| index | number | 否 | - | The index of the search at which the result was found. |\n@| input | string | 否 | - | A copy of the search string. |\n@| length | number | 是 | - | length 是 Array 的实例属性，表示该数组中元素的个数。该值是一个无符号 32 位整数，并且其数值总是大于数组最大索引。 |\n@| toString | any | 是 | - | toString() 方法返回一个字符串，表示指定的数组及其元素。 |\n@| toLocaleString | any | 是 | - | toLocaleString() 方法返回一个字符串，表示数组中的所有元素。每个元素通过调用它们自己的 toLocaleString 方法转换为字符串，并且使用特定于语言环境的字符串（例如逗号“,”）分隔开。 |\n##### RegExpMatchArray 的方法 @regexpmatcharray-values \n\n##### toKotlinList() @tokotlinlist\n\ntoKotlinList() 将当前的Array对象转换为 kotlin 中对应的List对象\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| kotlin.collections.List\\ |\n \n\n###### toKotlinList 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | x | - |\n\n\n###### 参见\n[toKotlinList](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#toKotlinList)\n\n##### add(item) @add\n\n将指定的元素追加到此列表的末尾\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| item | T | 是 | - | 添加到数组的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### add 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[add](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#add)\n\n##### joinToString(separator) @jointostring\n\n从所有元素中使用[separator\\]创建字符串\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 分隔符 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### joinToString 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[joinToString](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#joinToString)\n\n##### pop() @pop\n\npop() 方法从数组中删除最后一个元素，并返回该元素的值。此方法会更改数组的长度。\n\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n###### pop 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[pop](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#pop)\n\n##### push(items) @push\n\npush() 方法将指定的元素添加到数组的末尾，并返回新的数组长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到数组末尾的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### push 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[push](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#push)\n\n##### concat(items) @concat\n\nconcat() 方法用于合并两个或多个数组。此方法不会更改现有数组，而是返回一个新数组。\n\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\\\> | 是 | - | 数组和/或值，将被合并到一个新的数组中。如果省略了所有 valueN 参数，则 concat 会返回调用此方法的现存数组的一个浅拷贝。详情请参阅下文描述。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### concat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[concat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#concat)\n\n##### join(separator) @join\n\njoin() 方法将一个数组（或一个类数组对象）的所有元素连接成一个字符串并返回这个字符串，用逗号或指定的分隔符字符串分隔。如果数组只有一个元素，那么将返回该元素而不使用分隔符。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 指定一个字符串来分隔数组的每个元素。如果需要，将分隔符转换为字符串。如果省略，数组元素用逗号（,）分隔。如果 separator 是空字符串（\"\"），则所有元素之间都没有任何字符。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### join 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | - |\n\n\n###### 参见\n[join](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#join)\n\n##### reverse() @reverse\n\nreverse() 方法就地反转数组中的元素，并返回同一数组的引用。数组的第一个元素会变成最后一个，数组的最后一个元素变成第一个。换句话说，数组中的元素顺序将被翻转，变为与之前相反的方向。\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### reverse 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reverse](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reverse)\n\n##### shift() @shift\n\nshift() 方法从数组中删除第一个元素，并返回该元素的值。此方法更改数组的长度。\n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| T \\| null | 否 |\n \n\n###### shift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[shift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#shift)\n\n##### slice(start, end) @slice\n\nslice() 方法返回一个新的数组对象，这一对象是一个由 start 和 end 决定的原数组的浅拷贝（包括 start，不包括 end），其中 start 和 end 代表了数组元素的索引。原始数组不会被改变。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 提取起始处的索引（从 0 开始），会转换为整数。 |\n| end | number | 是 | - | 提取终止处的索引（从 0 开始），会转换为整数。slice() 会提取到但不包括 end 的位置。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### slice 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[slice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#slice)\n\n##### sort(compareFn) @sort\n\nsort() 方法就地对数组的元素进行排序，并返回对相同数组的引用。默认排序是将元素转换为字符串，然后按照它们的 UTF-16 码元值升序排序。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| compareFn | (a: T, b: T) => number | 是 | - | 定义排序顺序的函数。返回值应该是一个数字，其正负性表示两个元素的相对顺序。该函数使用以下参数调用： a:第一个用于比较的元素。不会是 null。 b:第二个用于比较的元素。不会是 null。 如果省略该函数，数组元素会被转换为字符串，然后根据每个字符的 Unicode 码位值进行排序。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### sort 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[sort](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#sort)\n\n##### splice(start, deleteCount) @splice\n\nsplice() 方法通过移除或者替换已存在的元素和/或添加新元素就地改变一个数组的内容。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 从 0 开始计算的索引，表示要开始改变数组的位置，它会被转换成整数。 |\n| deleteCount | number | 是 | - | 一个整数，表示数组中要从 start 开始删除的元素数量。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### splice 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[splice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#splice)\n\n##### unshift(items) @unshift\n\nunshift() 方法将指定元素添加到数组的开头，并返回数组的新长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到 arr 开头的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### unshift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[unshift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#unshift)\n\n##### indexOf(searchElement, fromIndex) @indexof\n\nindexOf() 方法返回数组中第一次出现给定元素的下标，如果不存在则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 数组中要查找的元素。 |\n| fromIndex | number | 是 | - | 开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### indexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[indexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#indexOf)\n\n##### lastIndexOf(searchElement, fromIndex) @lastindexof\n\nlastIndexOf() 方法返回数组中给定元素最后一次出现的索引，如果不存在则返回 -1。该方法从 fromIndex 开始向前搜索数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 被查找的元素。 |\n| fromIndex | number | 是 | - | 以 0 起始的索引，表明反向搜索的起始位置，会被转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### lastIndexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[lastIndexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#lastIndexOf)\n\n##### every(predicate, thisArg) @every\n\nevery() 方法测试一个数组内的所有元素是否都能通过指定函数的测试。它返回一个布尔值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 every() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### every 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[every](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#every)\n\n##### some(predicate, thisArg) @some\n\nsome() 方法测试数组中是否至少有一个元素通过了由提供的函数实现的测试。如果在数组中找到一个元素使得提供的函数返回 true，则返回 true；否则返回 false。它不会修改数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 some() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### some 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[some](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#some)\n\n##### forEach(callbackfn, thisArg) @foreach\n\nforEach() 方法对数组的每个元素执行一次给定的函数。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => void | 是 | - | 为数组中每个元素执行的函数。并会丢弃它的返回值。该函数被调用时将传入以下参数： value:数组中正在处理的当前元素。 index:数组中正在处理的当前元素的索引。 array:调用了 forEach() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n\n###### forEach 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[forEach](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#forEach)\n\n##### map(callbackfn, thisArg) @map\n\nmap() 方法创建一个新数组，这个新数组由原数组中的每个元素都调用一次提供的函数后的返回值组成。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => U | 是 | - | 为数组中的每个元素执行的函数。它的返回值作为一个元素被添加为新数组中。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 map() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### map 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[map](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#map)\n\n##### filter(predicate, thisArg) @filter\n\nfilter() 方法创建给定数组一部分的浅拷贝，其包含通过所提供函数实现的测试的所有元素。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以将元素保留在结果数组中，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 filter() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### filter 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[filter](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#filter)\n\n##### reduce(callbackfn) @reduce\n\nreduce() 方法对数组中的每个元素按序执行一个提供的 reducer 函数，每一次运行 reducer 会将先前元素的计算结果作为参数传入，最后将其结果汇总为单个返回值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将作为 reduce() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为 array[0\\] 的值。 currentValue:当前元素的值。在第一次调用时，如果指定了 initialValue，则为 array[0\\] 的值，否则为 array[1\\]。 currentIndex:currentValue 在数组中的索引位置。在第一次调用时，如果指定了 initialValue 则为 0，否则为 1 array:调用了 reduce() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduce 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduce](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduce)\n\n##### reduceRight(callbackfn) @reduceright\n\nreduceRight() 方法对累加器（accumulator）和数组的每个值（按从右到左的顺序）应用一个函数，并使其成为单个值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中的每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将成为 reduceRight() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为数组最后一个元素的值。 currentValue:数组中当前正在处理的元素。 currentIndex:正在处理的元素在数组中的索引。 array:调用了 reduceRight() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduceRight 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduceRight](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduceRight)\n\n##### find(predicate, thisArg) @find\n\nfind() 方法返回数组中满足提供的测试函数的第一个元素的值。否则返回 null。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值来表示已经找到了匹配的元素。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| S \\| null | 否 |\n \n\n###### find 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[find](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#find)\n\n##### findIndex(predicate, thisArg) @findindex\n\nfindIndex() 方法返回数组中满足提供的测试函数的第一个元素的索引。若没有找到对应元素则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示已找到匹配元素，否则返回一个假值。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### findIndex 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[findIndex](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#findIndex)\n\n##### fill(value, start, end) @fill\n\nfill() 方法用一个固定值填充一个数组中从起始索引（默认为 0）到终止索引（默认为 array.length）内的全部元素。它返回修改后的数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | T | 是 | - | 用来填充数组元素的值。注意所有数组中的元素都将是这个确定的值：如果 value 是个对象，那么数组的每一项都会引用这个元素。 |\n| start | number | 是 | - | 基于零的索引，从此开始填充，转换为整数。 |\n| end | number | 是 | - | 基于零的索引，在此结束填充，转换为整数。fill() 填充到但不包含 end 索引。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### fill 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[fill](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#fill)\n\n##### copyWithin(target, start, end) @copywithin\n\ncopyWithin() 方法浅复制数组的一部分到同一数组中的另一个位置，并返回它，不会改变原数组的长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| target | number | 是 | - | 序列开始替换的目标位置，以 0 为起始的下标表示，且将被转换为整数 |\n| start | number | 是 | - | 要复制的元素序列的起始位置，以 0 为起始的下标表示，且将被转换为整数 |\n| end | number | 是 | - | 要复制的元素序列的结束位置，以 0 为起始的下标表示，且将被转换为整数。copyWithin 将会拷贝到该位置，但不包括 end 这个位置的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### copyWithin 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[copyWithin](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#copyWithin)\n\n##### includes(searchElement, fromIndex) @includes\n\nincludes() 方法用来判断一个数组是否包含一个指定的值，根据情况，如果包含则返回 true，否则返回 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | any | 是 | - | 需要查找的值。 |\n| fromIndex | number | 是 | - | 可选。开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### includes 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[includes](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#includes)\n\n##### at(index) @at\n\nTakes an integer value and returns the item at that index,\nallowing for positive and negative integers.\nNegative integers count back from the last item in the array.\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | - | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n\n\n###### RegExpMatchArray 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| length | 5.0 | 3.9 | 4.11 | 4.0 |\n| toString | x | x | x | 4.0 |\n| toLocaleString | x | x | x | 4.0 |\n \n\n##### match 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| √ | √ | x | 4.0 |\n\n\n##### 参见\n[match](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#match)\n\n#### replace(searchValue, replaceValue) @replace\n\n返回一个由替换值（replacement）替换部分或所有的模式（pattern）匹配项后的新字符串。模式可以是一个字符串或者一个正则表达式。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchValue | string \\| [RegExp](#regexp-values) | 是 | - | RegExp: 一个RegExp 对象或者其字面量。该正则所匹配的内容会被第二个参数的返回值替换掉。string: 一个将被 newSubStr 替换的 字符串。其被视为一整个字符串，而不是一个正则表达式。仅第一个匹配项会被替换。 |\n| replaceValue | string | 是 | - | 用于替换掉第一个参数在原字符串中的匹配部分的字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### replace 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[replace](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#replace)\n\n#### search(regexp) @search\n\nsearch() 方法执行正则表达式和 String 对象之间的一个搜索匹配。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| regexp | string \\| [RegExp](#regexp-values) | 是 | - | 一个正则表达式（regular expression）对象。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n##### search 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[search](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#search)\n\n#### slice(start, end) @slice\n\nslice() 方法提取某个字符串的一部分，并返回一个新的字符串，且不会改动原字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 可选。从该索引（以 0 为基数）处开始提取原字符串中的字符。如果值为负数，会被当做 strLength + beginIndex 看待，这里的strLength 是字符串的长度（例如，如果 beginIndex 是 -3 则看作是：strLength - 3） |\n| end | number | 是 | - | 可选。在该索引（以 0 为基数）处结束提取字符串。如果省略该参数，slice() 会一直提取到字符串末尾。如果该参数为负数，则被看作是 strLength + endIndex，这里的 strLength 就是字符串的长度 (例如，如果 endIndex 是 -3，则是，strLength - 3)。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### slice 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[slice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#slice)\n\n#### split(separator, limit) @split\n\nsplit() 方法接受一个模式，通过搜索模式将字符串分割成一个有序的子串列表，将这些子串放入一个数组，并返回该数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string \\| [RegExp](#regexp-values) | 是 | - | 描述每个分割应该发生在哪里的模式。 |\n| limit | number | 是 | - | 一个非负整数，指定数组中包含的子字符串的数量限制。当提供此参数时，split 方法会在指定 separator 每次出现时分割该字符串，但在已经有 limit 个元素时停止分割。任何剩余的文本都不会包含在数组中。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n##### split 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[split](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#split)\n\n#### substring(start, end) @substring\n\n返回一个字符串在开始索引到结束索引之间的一个子集，或从开始索引直到字符串的末尾的一个子集。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 要截取的第一个字符的索引，该索引位置的字符作为返回的字符串的首字母。 |\n| end | number | 是 | - | 可选。一个 0 到字符串长度之间的整数，以该数字为索引的字符不包含在截取的字符串内。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### substring 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[substring](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#substring)\n\n#### toLowerCase() @tolowercase\ntoLowerCase() 会将调用该方法的字符串值转为小写形式，并返回。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toLowerCase 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[toLowerCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toLowerCase)\n\n#### toLocaleLowerCase(locales) @tolocalelowercase\n\n根据任何指定区域语言环境设置的大小写映射，返回调用字符串被转换为小写的格式。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| locales | string \\| Array\\ | 是 | - | 可选。指明要转换成小写格式的特定语言区域。如果以一个数组 Array 形式给出多个 locales, 最合适的地区将被选出来应用。默认的 locale 是主机环境的当前区域 (locale) 设置。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toLocaleLowerCase 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[toLocaleLowerCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toLocaleLowerCase)\n\n#### toUpperCase() @touppercase\n\n将调用该方法的字符串转为大写形式并返回（如果调用该方法的值不是字符串类型会被强制转换）。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toUpperCase 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[toUpperCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toUpperCase)\n\n#### toLocaleUpperCase(locales) @tolocaleuppercase\n\n根据本地主机语言环境把字符串转换为大写格式，并返回转换后的字符串。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| locales | string \\| Array\\ | 是 | - | locales参数指示要用于根据任何特定于语言环境的大小写映射转换为大写的语言环境。如果Array中给出了多个区域设置，则使用最佳可用区域设置。默认语言环境是主机环境的当前语言环境。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### toLocaleUpperCase 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[toLocaleUpperCase](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#toLocaleUpperCase)\n\n#### trim() @trim\n\n从字符串的两端清除空格，返回一个新的字符串，而不修改原始字符串。此上下文中的空格是指所有的空白字符（空格、tab、不换行空格等）以及所有行终止符字符（如 LF、CR 等）。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### trim 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[trim](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#trim)\n\n#### ~~substr~~(from, length) @substr\n\n返回一个字符串中从指定位置开始到指定字符数的字符。 **已废弃。警告： 尽管 String.prototype.substr(…) 没有严格被废弃 (as in \"removed from the Web standards\"), 但它被认作是遗留的函数并且可以的话应该避免使用。它并非 JavaScript 核心语言的一部分，未来将可能会被移除掉。如果可以的话，使用 substring() 替代它。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| from | number | 是 | - | 开始提取字符的位置。如果为负值，则被看作 strLength + start，其中 strLength 为字符串的长度（例如，如果 start 为 -3，则被看作 strLength + (-3)）。 |\n| length | number | 是 | - | 可选。提取的字符数。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### substr 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[substr](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#substr)\n\n#### padStart(targetLength, padString) @padstart\n\n用另一个字符串填充当前字符串（如果需要会重复填充），直到达到给定的长度。填充是从当前字符串的开头开始的。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| targetLength | number | 是 | - | 当前 str 填充后的长度。如果该值小于或等于 str.length，则会直接返回当前 str。 |\n| padString | string | 是 | - | 可选。用于填充当前 str 的字符串。如果 padString 太长，无法适应 targetLength，则会从末尾被截断。默认值为“ ”字符（U+0020）。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### padStart 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[padStart](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#padStart)\n\n#### padEnd(targetLength, padString) @padend\n\n将当前字符串从末尾开始填充给定的字符串（如果需要会重复填充），直到达到给定的长度。填充是从当前字符串的末尾开始的。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| targetLength | number | 是 | - | 当前 str 填充后的长度。如果该值小于或等于 str.length，则会直接返回当前 str。 |\n| padString | string | 是 | - | 可选。用于填充当前 str 的字符串。如果 padString 太长，无法适应 targetLength，则会被截断。默认值为“ ”字符（U+0020）。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### padEnd 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[padEnd](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#padEnd)\n\n#### codePointAt(pos) @codepointat\n\n返回一个小于 1114112 (0x110000) 的非负整数 Number，它是 UTF-16 编码的代码点的代码点值，该代码点始于将此对象转换为字符串而产生的字符串中位置 pos 处的字符串元素。\n如果该位置没有元素，则结果未定义。\n如果有效的 UTF-16 代理项对不是从 pos 开始，则结果是 pos 处的代码单元。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| pos | number | 是 | - | 这个字符串中需要转码的元素的位置。 | \n\n##### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| number \\| null | 否 |\n \n\n##### codePointAt 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[codePointAt](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#codePointAt)\n\n#### includes(searchString, position) @includes\n\n如果 searchString 作为此对象转换为 String 的结果的子字符串出现在大于或等于position的一个或多个位置，则返回 true；否则，返回 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要在 str 中搜索的字符串。不能是正则表达式。 |\n| position | number | 是 | - | 在字符串中开始搜索 searchString 的位置。（默认为 0。） | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n##### includes 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[includes](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#includes)\n\n#### endsWith(searchString, endPosition) @endswith\n\nendsWith() 方法用于判断一个字符串是否以指定字符串结尾，如果是则返回 true，否则返回 false。该方法区分大小写。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的作为结尾的字符串，不能是正则表达式。所有非正则表达式的值都会被强制转换为字符串。 |\n| endPosition | number | 是 | - | 可选，预期找到 searchString 的末尾位置（即 searchString 最后一个字符的索引加 1）。默认为 str.length。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n##### endsWith 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[endsWith](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#endsWith)\n\n#### normalize(form) @normalize\n\nnormalize() 方法会按照指定的一种 Unicode 正规形式将当前字符串规范化。（如果该值不是字符串，则首先将其转换为一个字符串）。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| form | \"NFC\" \\| \"NFD\" \\| \"NFKC\" \\| \"NFKD\" | 是 | - | 四种 Unicode 正规形式（Unicode Normalization Form）\"NFC\"、\"NFD\"、\"NFKC\"，或 \"NFKD\" 其中的一个，默认值为 \"NFC\"。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### normalize 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[normalize](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#normalize)\n\n#### repeat(count) @repeat\n\nrepeat() 构造并返回一个新字符串，该字符串包含被连接在一起的指定数量的字符串的副本。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| count | number | 是 | - | 介于 0 和 +Infinity 之间的整数。表示在新构造的字符串中重复了多少遍原字符串。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### repeat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[repeat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#repeat)\n\n#### startsWith(searchString, position) @startswith\n\nstartsWith() 方法用来判断当前字符串是否以另外一个给定的子字符串开头，并根据判断结果返回 true 或 false。这个方法区分大小写。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchString | string | 是 | - | 要搜索的子字符串。 |\n| position | number | 是 | - | 在 str 中搜索 searchString 的开始位置，默认值为 0。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n##### startsWith 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[startsWith](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#startsWith)\n\n#### ~~anchor~~(name) @anchor\n\nanchor() 方法创建一个 \\ HTML 锚元素，被用作超文本靶标（hypertext target）。 **浏览器兼容性的遗留特性。警告： 该特性已经从 Web 标准中删除，虽然一些浏览器目前仍然支持它，但也许会在未来的某个时间停止支持，请尽量不要使用该特性。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| name | string | 是 | - | 一个字符串，表示被创建的标签的 name 属性。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### anchor 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[anchor](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#anchor)\n\n#### ~~big~~() @big\n\n创建一个使字符串显示大号字体的\\标签。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### big 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[big](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#big)\n\n#### ~~blink~~() @blink\n\nblink() 方法创建一个字符串，其在 \\str\\ 中嵌入字符串，这使得字符串在旧版浏览器中闪烁。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。\r\n#**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### blink 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[blink](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#blink)\n\n#### ~~bold~~() @bold\n\nbold() 方法会创建 HTML 元素“b”，并将字符串加粗展示。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### bold 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[bold](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#bold)\n\n#### ~~fixed~~() @fixed\n\nfixed() 方法创建了一个 \\ 标签元素将字符串包裹起来，从而让这个字符串里面的内容具有固定间距。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### fixed 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[fixed](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#fixed)\n\n#### ~~fontcolor~~(color) @fontcolor\n\n创建一个\\的 HTML 元素让字符串被显示成指定的字体颜色。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。\r\n备注： 元素已经在在HTML5 中 (en-US)被移除并且不应该在使用。替代的是，Web 开发者应该使用CSS属性。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| color | string | 是 | - | 代表颜色的一个字符串，可以是三个一组的十六进制的 RGB 值，也可以是一个颜色名称的字符串字面量. | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### fontcolor 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[fontcolor](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#fontcolor)\n\n#### ~~fontsize~~(size) @fontsize\n\n返回一个' \\ ' HTML元素并设置size属性值 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| size | number | 是 | - | 1到7之间的整数。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### fontsize 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[fontsize](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#fontsize)\n\n#### italics() @italics\n\nitalics()方法创建一个\\ HTML元素，使字符串变为斜体。\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### italics 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[italics](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#italics)\n\n#### ~~link~~(url) @link\n\nlink() 方法创建一个 HTML 元素 \\ ，用该字符串作为超链接的显示文本，参数作为指向另一个 URL 的超链接。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| url | string | 是 | - | 任何能够指定 a 标签的 href 属性的字符串；它应当是有效的 URL（相对或绝对），任何 & 字符将会被转义为 &，任何 \" 字符将会被转义为 "。 | \n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### link 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[link](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#link)\n\n#### ~~small~~() @small\n\nsmall() 方法的作用是创建一个使字符串显示小号字体的 \\ 标签。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### small 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[small](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#small)\n\n#### ~~strike~~() @strike\n\nstrike()方法创建\\ HTML 元素，使字符串展示为被删除的文本。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### strike 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[strike](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#strike)\n\n#### ~~sub~~() @sub\n\nsub()方法创建一个 \\ HTML 元素，使字符串展示为下标。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### sub 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[sub](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#sub)\n\n#### ~~sup~~() @sup\n\nsup()方法创建 一个\\HTML 元素，使字符串显示为上标。 **已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它，但也许已从相关的 web 标准中移除，也许正准备移除或出于兼容性而保留。请尽量不要使用该特性，并更新现有的代码；请注意，该特性随时可能无法正常工作。**\n\n##### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n##### sup 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n##### 参见\n[sup](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#sup)\n\n#### at(index) @at\n\n方法接受一个整数值，并返回一个新的 String，该字符串由位于指定偏移量处的单个 UTF-16 码元组成\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | 字符指定偏移量处，允许正整数和负整数，负整数从字符串中的最后一个字符开始倒数。 | \n\n##### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| string \\| null | 否 |\n \n\n##### at 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n##### 参见\n[at](https://uniapp.dcloud.net.cn/uts/buildin-object-api/buildin-object-api/string.html#at)\n\n##### RegExp 的属性值 @regexp-values \n\n| 名称 | 类型 | 必备 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| flags | string | 是 | - | 返回一个字符串，由当前正则表达式对象的标志组成。此属性是一个只读属性 此字符串中的字符按以下顺序排序和连接: - \"g\" for global - \"i\" for ignoreCase - \"m\" for multiline - \"u\" for unicode - \"y\" for sticky 如果没有设置标志，则该值为空字符串。 |\n| dotAll | boolean | 是 | - | 表明是否在正则表达式中一起使用\"s\"修饰符（引入/s 修饰符，使得。可以匹配任意单个字符）。dotAll 是一个只读的属性，属于单个正则表达式实例。 |\n| hasIndices | boolean | 是 | - | 指示 d 标志是否与正则表达式一起使用。只读的。 |\n| sticky | boolean | 是 | - | 搜索是否具有粘性（仅从正则表达式的 lastIndex 属性表示的索引处搜索）。sticky 是正则表达式对象的只读属性。默认为false。只读的。 |\n| unicode | boolean | 是 | - | 表明正则表达式带有\"u\" 标志。 unicode 是正则表达式独立实例的只读属性。unicode 的值是 Boolean，并且如果使用了 \"u\" 标志则为 true；否则为 false。\"u\" 标志开启了多种 Unicode 相关的特性。使用 \"u\" 标志，任何 Unicode 代码点的转义都会被解释。 |\n| source | string | 是 | - | 返回一个值为当前正则表达式对象的模式文本的字符串，该字符串不会包含正则字面量两边的斜杠以及任何的标志字符。 |\n| global | boolean | 是 | - | 表明正则表达式是否使用了 \"g\" 标志。global 是一个正则表达式实例的只读属性。 |\n| ignoreCase | boolean | 是 | - | 表明正则表达式是否使用了 \"i\" 标志。ignoreCase 是正则表达式实例的只读属性。 |\n| multiline | boolean | 是 | - | 表明正则表达式是否使用了 \"m\" 标志。multiline 是正则表达式实例的一个只读属性。 |\n| lastIndex | number | 是 | - | 正则表达式的一个可读可写的整型属性，用来指定下一次匹配的起始索引。 |\n\n##### RegExp 的方法 @regexp-values \n\n##### exec(string) @exec\n\n在一个指定字符串中执行一个搜索匹配。返回一个结果数组或 null。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| string | string | 是 | - | 要匹配正则表达式的字符串。 | \n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| [RegExpExecArray](#regexpexecarray-values) \\| null | 否 |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| 0 | string | 是 | - | The first match. This will always be present because `null` will be returned if there are no matches. |\n@| index | number | 是 | - | The index of the search at which the result was found. |\n@| input | string | 是 | - | A copy of the search string. |\n@| length | number | 是 | - | length 是 Array 的实例属性，表示该数组中元素的个数。该值是一个无符号 32 位整数，并且其数值总是大于数组最大索引。 |\n@| toString | any | 是 | - | toString() 方法返回一个字符串，表示指定的数组及其元素。 |\n@| toLocaleString | any | 是 | - | toLocaleString() 方法返回一个字符串，表示数组中的所有元素。每个元素通过调用它们自己的 toLocaleString 方法转换为字符串，并且使用特定于语言环境的字符串（例如逗号“,”）分隔开。 |\n##### RegExpExecArray 的方法 @regexpexecarray-values \n\n##### toKotlinList() @tokotlinlist\n\ntoKotlinList() 将当前的Array对象转换为 kotlin 中对应的List对象\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| kotlin.collections.List\\ |\n \n\n###### toKotlinList 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | x | - |\n\n\n###### 参见\n[toKotlinList](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#toKotlinList)\n\n##### add(item) @add\n\n将指定的元素追加到此列表的末尾\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| item | T | 是 | - | 添加到数组的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### add 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[add](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#add)\n\n##### joinToString(separator) @jointostring\n\n从所有元素中使用[separator\\]创建字符串\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 分隔符 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### joinToString 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| √ | x | - |\n\n\n###### 参见\n[joinToString](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#joinToString)\n\n##### pop() @pop\n\npop() 方法从数组中删除最后一个元素，并返回该元素的值。此方法会更改数组的长度。\n\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n###### pop 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[pop](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#pop)\n\n##### push(items) @push\n\npush() 方法将指定的元素添加到数组的末尾，并返回新的数组长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到数组末尾的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### push 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[push](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#push)\n\n##### concat(items) @concat\n\nconcat() 方法用于合并两个或多个数组。此方法不会更改现有数组，而是返回一个新数组。\n\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\\\> | 是 | - | 数组和/或值，将被合并到一个新的数组中。如果省略了所有 valueN 参数，则 concat 会返回调用此方法的现存数组的一个浅拷贝。详情请参阅下文描述。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### concat 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[concat](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#concat)\n\n##### join(separator) @join\n\njoin() 方法将一个数组（或一个类数组对象）的所有元素连接成一个字符串并返回这个字符串，用逗号或指定的分隔符字符串分隔。如果数组只有一个元素，那么将返回该元素而不使用分隔符。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| separator | string | 是 | - | 指定一个字符串来分隔数组的每个元素。如果需要，将分隔符转换为字符串。如果省略，数组元素用逗号（,）分隔。如果 separator 是空字符串（\"\"），则所有元素之间都没有任何字符。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| string |\n \n\n###### join 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | - |\n\n\n###### 参见\n[join](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#join)\n\n##### reverse() @reverse\n\nreverse() 方法就地反转数组中的元素，并返回同一数组的引用。数组的第一个元素会变成最后一个，数组的最后一个元素变成第一个。换句话说，数组中的元素顺序将被翻转，变为与之前相反的方向。\n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### reverse 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reverse](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reverse)\n\n##### shift() @shift\n\nshift() 方法从数组中删除第一个元素，并返回该元素的值。此方法更改数组的长度。\n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| T \\| null | 否 |\n \n\n###### shift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[shift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#shift)\n\n##### slice(start, end) @slice\n\nslice() 方法返回一个新的数组对象，这一对象是一个由 start 和 end 决定的原数组的浅拷贝（包括 start，不包括 end），其中 start 和 end 代表了数组元素的索引。原始数组不会被改变。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 提取起始处的索引（从 0 开始），会转换为整数。 |\n| end | number | 是 | - | 提取终止处的索引（从 0 开始），会转换为整数。slice() 会提取到但不包括 end 的位置。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### slice 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[slice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#slice)\n\n##### sort(compareFn) @sort\n\nsort() 方法就地对数组的元素进行排序，并返回对相同数组的引用。默认排序是将元素转换为字符串，然后按照它们的 UTF-16 码元值升序排序。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| compareFn | (a: T, b: T) => number | 是 | - | 定义排序顺序的函数。返回值应该是一个数字，其正负性表示两个元素的相对顺序。该函数使用以下参数调用： a:第一个用于比较的元素。不会是 null。 b:第二个用于比较的元素。不会是 null。 如果省略该函数，数组元素会被转换为字符串，然后根据每个字符的 Unicode 码位值进行排序。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### sort 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[sort](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#sort)\n\n##### splice(start, deleteCount) @splice\n\nsplice() 方法通过移除或者替换已存在的元素和/或添加新元素就地改变一个数组的内容。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| start | number | 是 | - | 从 0 开始计算的索引，表示要开始改变数组的位置，它会被转换成整数。 |\n| deleteCount | number | 是 | - | 一个整数，表示数组中要从 start 开始删除的元素数量。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### splice 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[splice](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#splice)\n\n##### unshift(items) @unshift\n\nunshift() 方法将指定元素添加到数组的开头，并返回数组的新长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| items | Array\\ | 是 | - | 添加到 arr 开头的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### unshift 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[unshift](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#unshift)\n\n##### indexOf(searchElement, fromIndex) @indexof\n\nindexOf() 方法返回数组中第一次出现给定元素的下标，如果不存在则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 数组中要查找的元素。 |\n| fromIndex | number | 是 | - | 开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### indexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[indexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#indexOf)\n\n##### lastIndexOf(searchElement, fromIndex) @lastindexof\n\nlastIndexOf() 方法返回数组中给定元素最后一次出现的索引，如果不存在则返回 -1。该方法从 fromIndex 开始向前搜索数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | T | 是 | - | 被查找的元素。 |\n| fromIndex | number | 是 | - | 以 0 起始的索引，表明反向搜索的起始位置，会被转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### lastIndexOf 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[lastIndexOf](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#lastIndexOf)\n\n##### every(predicate, thisArg) @every\n\nevery() 方法测试一个数组内的所有元素是否都能通过指定函数的测试。它返回一个布尔值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 every() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### every 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[every](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#every)\n\n##### some(predicate, thisArg) @some\n\nsome() 方法测试数组中是否至少有一个元素通过了由提供的函数实现的测试。如果在数组中找到一个元素使得提供的函数返回 true，则返回 true；否则返回 false。它不会修改数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示元素通过测试，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 some() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### some 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[some](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#some)\n\n##### forEach(callbackfn, thisArg) @foreach\n\nforEach() 方法对数组的每个元素执行一次给定的函数。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => void | 是 | - | 为数组中每个元素执行的函数。并会丢弃它的返回值。该函数被调用时将传入以下参数： value:数组中正在处理的当前元素。 index:数组中正在处理的当前元素的索引。 array:调用了 forEach() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n\n###### forEach 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[forEach](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#forEach)\n\n##### map(callbackfn, thisArg) @map\n\nmap() 方法创建一个新数组，这个新数组由原数组中的每个元素都调用一次提供的函数后的返回值组成。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (value: T, index: number, array: Array\\) => U | 是 | - | 为数组中的每个元素执行的函数。它的返回值作为一个元素被添加为新数组中。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 map() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### map 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[map](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#map)\n\n##### filter(predicate, thisArg) @filter\n\nfilter() 方法创建给定数组一部分的浅拷贝，其包含通过所提供函数实现的测试的所有元素。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, array: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以将元素保留在结果数组中，否则返回一个假值。该函数被调用时将传入以下参数： value:数组中当前正在处理的元素。 index:正在处理的元素在数组中的索引。 array:调用了 filter() 的数组本身。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| Array\\ |\n \n\n###### filter 兼容性 \n| Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- |\n| x | x | x | 4.0 |\n\n\n###### 参见\n[filter](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#filter)\n\n##### reduce(callbackfn) @reduce\n\nreduce() 方法对数组中的每个元素按序执行一个提供的 reducer 函数，每一次运行 reducer 会将先前元素的计算结果作为参数传入，最后将其结果汇总为单个返回值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将作为 reduce() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为 array[0\\] 的值。 currentValue:当前元素的值。在第一次调用时，如果指定了 initialValue，则为 array[0\\] 的值，否则为 array[1\\]。 currentIndex:currentValue 在数组中的索引位置。在第一次调用时，如果指定了 initialValue 则为 0，否则为 1 array:调用了 reduce() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduce 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduce](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduce)\n\n##### reduceRight(callbackfn) @reduceright\n\nreduceRight() 方法对累加器（accumulator）和数组的每个值（按从右到左的顺序）应用一个函数，并使其成为单个值。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| callbackfn | (previousValue: T, currentValue: T, currentIndex: number, array: Array\\) => T | 是 | - | 为数组中的每个元素执行的函数。其返回值将作为下一次调用 callbackFn 时的 accumulator 参数。对于最后一次调用，返回值将成为 reduceRight() 的返回值。该函数被调用时将传入以下参数： previousValue:上一次调用 callbackFn 的结果。在第一次调用时，如果指定了 initialValue 则为指定的值，否则为数组最后一个元素的值。 currentValue:数组中当前正在处理的元素。 currentIndex:正在处理的元素在数组中的索引。 array:调用了 reduceRight() 的数组本身。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T |\n \n\n###### reduceRight 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[reduceRight](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#reduceRight)\n\n##### find(predicate, thisArg) @find\n\nfind() 方法返回数组中满足提供的测试函数的第一个元素的值。否则返回 null。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => boolean | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值来表示已经找到了匹配的元素。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| S \\| null | 否 |\n \n\n###### find 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[find](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#find)\n\n##### findIndex(predicate, thisArg) @findindex\n\nfindIndex() 方法返回数组中满足提供的测试函数的第一个元素的索引。若没有找到对应元素则返回 -1。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| predicate | (value: T, index: number, obj: Array\\) => unknown | 是 | - | 为数组中的每个元素执行的函数。它应该返回一个真值以指示已找到匹配元素，否则返回一个假值。 |\n| thisArg | any | 是 | - | 执行 callbackFn 时用作 this 的值。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| number |\n \n\n###### findIndex 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[findIndex](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#findIndex)\n\n##### fill(value, start, end) @fill\n\nfill() 方法用一个固定值填充一个数组中从起始索引（默认为 0）到终止索引（默认为 array.length）内的全部元素。它返回修改后的数组。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | T | 是 | - | 用来填充数组元素的值。注意所有数组中的元素都将是这个确定的值：如果 value 是个对象，那么数组的每一项都会引用这个元素。 |\n| start | number | 是 | - | 基于零的索引，从此开始填充，转换为整数。 |\n| end | number | 是 | - | 基于零的索引，在此结束填充，转换为整数。fill() 填充到但不包含 end 索引。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### fill 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[fill](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#fill)\n\n##### copyWithin(target, start, end) @copywithin\n\ncopyWithin() 方法浅复制数组的一部分到同一数组中的另一个位置，并返回它，不会改变原数组的长度。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| target | number | 是 | - | 序列开始替换的目标位置，以 0 为起始的下标表示，且将被转换为整数 |\n| start | number | 是 | - | 要复制的元素序列的起始位置，以 0 为起始的下标表示，且将被转换为整数 |\n| end | number | 是 | - | 要复制的元素序列的结束位置，以 0 为起始的下标表示，且将被转换为整数。copyWithin 将会拷贝到该位置，但不包括 end 这个位置的元素。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| this |\n \n\n###### copyWithin 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[copyWithin](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#copyWithin)\n\n##### includes(searchElement, fromIndex) @includes\n\nincludes() 方法用来判断一个数组是否包含一个指定的值，根据情况，如果包含则返回 true，否则返回 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| searchElement | any | 是 | - | 需要查找的值。 |\n| fromIndex | number | 是 | - | 可选。开始搜索的索引（从零开始），会转换为整数。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### includes 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[includes](https://uniapp.dcloud.net.cn/uts/buildin-object-api/Array.html#includes)\n\n##### at(index) @at\n\nTakes an integer value and returns the item at that index,\nallowing for positive and negative integers.\nNegative integers count back from the last item in the array.\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| index | number | 是 | - | - | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| T \\| null |\n \n\n\n\n###### RegExpExecArray 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| length | 5.0 | 3.9 | 4.11 | 4.0 |\n| toString | x | x | x | 4.0 |\n| toLocaleString | x | x | x | 4.0 |\n \n\n###### exec 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[exec](https://uniapp.dcloud.net.cn/uts/buildin-object-api/RegExp.html#exec)\n\n##### test(string) @test\n\n执行一个检索，用来查看正则表达式与指定的字符串是否匹配。返回 true 或 false。\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| string | string | 是 | - | 用来与正则表达式匹配的字符串。 | \n\n###### 返回值 \n\n| 类型 |\n| :- |\n| boolean |\n \n\n###### test 兼容性 \n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n\n\n###### 参见\n[test](https://uniapp.dcloud.net.cn/uts/buildin-object-api/RegExp.html#test)\n\n###### RegExp 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| flags | 5.0 | 3.9 | 4.11 | 4.0 |\n| dotAll | x | x | x | 4.0 |\n| hasIndices | x | x | x | 4.0 |\n| sticky | x | x | x | 4.0 |\n| unicode | x | x | x | 4.0 |\n| source | 5.0 | 3.9 | 4.11 | 4.0 |\n| global | 5.0 | 3.9 | 4.11 | 4.0 |\n| ignoreCase | 5.0 | 3.9 | 4.11 | 4.0 |\n| multiline | 5.0 | 3.9 | 4.11 | 4.0 |\n| lastIndex | 5.0 | 3.9 | 4.11 | 4.0 |\n\n##### String 兼容性 \n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| toString | x | x | x | 4.0 |\n| length | 5.0 | 3.9 | 4.11 | 4.0 |\n| valueOf | x | x | x | 4.0 |\n\n##### UniScrollEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniStartNestedScrollEvent\n\n##### UniStartNestedScrollEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| node | [UniElement](/dom/unielement.md) | 是 | - | 开始滚动子节点对象 |\n| isTouch | boolean | 是 | - | 是否由触摸行为发生的Event |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniStartNestedScrollEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniNestedPreScrollEvent\n\n##### UniNestedPreScrollEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| deltaX | number | 是 | - | x轴滚动距离 |\n| deltaY | number | 是 | - | y轴滚动距离 |\n| isTouch | boolean | 是 | - | 是否由触摸行为发生的Event |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniNestedPreScrollEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| consumed | (consumedX: number, consumedY: number) => void | 是 | - | 通知到子节点x,y轴滚动距离的消耗 |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniStopNestedScrollEvent\n\n##### UniStopNestedScrollEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| isTouch | boolean | 是 | - | 是否由触摸行为发生的Event |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniStopNestedScrollEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/scroll-view/scroll-view.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/scroll-view/scroll-view\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n scrollTop: 0,\r\n oldScrollTop: 0,\r\n showScrollbar: true\r\n }\r\n },\r\n methods: {\r\n upper: function (e : ScrollToUpperEvent) {\r\n console.log(e)\r\n },\r\n lower: function (e : ScrollToLowerEvent) {\r\n console.log(e)\r\n },\r\n scroll: function (e : ScrollEvent) {\r\n this.oldScrollTop = e.detail.scrollTop\r\n },\r\n goTop: function () {\r\n // 解决view层不同步的问题\r\n this.scrollTop = this.oldScrollTop\r\n this.$nextTick(function () {\r\n this.scrollTop = 0\r\n })\r\n uni.showToast({\r\n icon: 'none',\r\n title: '纵向滚动 scrollTop 值已被修改为 0',\r\n })\r\n }\r\n },\r\n }\r\n\n```\n\n:::","compatibility":"### scroll-view 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| type | 4.11 | 4.11 | x |\n| direction | 4.0 | 4.11 | 4.0 |\n| ~~scroll-x~~ | 3.9 | x | 4.0 |\n| ~~scroll-y~~ | 3.9 | x | 4.0 |\n| ~~rebound~~ | 3.9 | x | - |\n| associative-container | 4.11 | 4.11 | x |\n| bounces | 4.0 | 4.11 | x |\n| upper-threshold | 3.9 | 4.11 | 4.0 |\n| lower-threshold | 3.9 | 4.11 | 4.0 |\n| scroll-top | 3.9 | 4.11 | 4.0 |\n| scroll-left | 3.9 | 4.11 | 4.0 |\n| scroll-into-view | 3.9 | 4.11 | 4.0 |\n| scroll-with-animation | 3.9 | 4.11 | 4.0 |\n| refresher-enabled | 3.9 | 4.11 | x |\n| refresher-threshold | 3.9 | 4.11 | x |\n| refresher-max-drag-distance | 3.9 | 4.11 | x |\n| refresher-default-style | 3.9 | 4.11 | x |\n| refresher-background | 3.9 | 4.11 | x |\n| refresher-triggered | 3.9 | 4.11 | x |\n| show-scrollbar | 3.9 | 4.11 | 4.0 |\n| custom-nested-scroll | 3.9 | x | x |\n| nested-scroll-child | 3.97 | x | x |\n| @refresherpulling | 3.9 | 4.11 | x |\n| @refresherrefresh | 3.9 | 4.11 | x |\n| @refresherrestore | 3.9 | 4.11 | x |\n| @refresherabort | 3.9 | 4.11 | x |\n| @scrolltoupper | 3.9 | 4.11 | 4.0 |\n| @scrolltolower | 3.9 | 4.11 | 4.0 |\n| @scroll | 3.9 | 4.11 | 4.0 |\n| @scrollend | 3.9 | 4.11 | 4.0 |\n| @startnestedscroll | 3.9 | x | x |\n| @nestedprescroll | 3.9 | x | x |\n| @stopnestedscroll | 3.9 | x | x |\n","children":"### 子组件 @children-tags \n - [nested-scroll-body](https://doc.dcloud.net.cn/uni-app-x/component/nested-scroll-body.html)\n- [nested-scroll-header](https://doc.dcloud.net.cn/uni-app-x/component/nested-scroll-header.html)","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/scroll-view)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/scroll-view.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.scroll-view)\n"},"slider":{"name":"## slider","description":"> 组件类型：UniSliderElement \n\n 滑动选择器\n\n### slider 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| name | string | - | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |\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| activeColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#007aff\" | slider 滑块左侧已选择部分的线条颜色 |\n| backgroundColor | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#e9e9e9\" | radio背景条的颜色 |\n| block-size | number | 28 | radio滑块的大小，取值范围为 12 - 28 |\n| block-color | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#ffffff\" | 滑块颜色 |\n| show-value | boolean | false | 是否显示当前 value |\n| @change | (event: [UniSliderChangeEvent](#unisliderchangeevent)) => void | - | 完成一次拖动后触发的事件，event.detail = {value: value} |\n| @changing | (event: [UniSliderChangeEvent](#unisliderchangeevent)) => void | - | 拖动过程中触发的事件，event.detail = {value: value} |","event":"\n### 事件\n#### UniSliderChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | number | 是 | - | - |\n\n##### UniSliderChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniSliderChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | number | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniSliderChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/slider/slider.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/slider/slider\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n sliderValue: 50,\r\n sliderBlockSize: 20,\r\n sliderBackgroundColor: \"#000000\",\r\n sliderActiveColor: \"#FFCC33\",\r\n sliderBlockColor: \"#8A6DE9\",\r\n // 组件属性 autotest\r\n show_value_boolean: false,\r\n disabled_boolean: false,\r\n min_input: 0,\r\n max_input: 100,\r\n step_input: 1,\r\n value_input: 0,\r\n activeColor_input: \"#007aff\",\r\n backgroundColor_input: \"#e9e9e9\",\r\n block_size_input: 28,\r\n block_color_input: \"#ffffff\",\r\n };\r\n },\r\n methods: {\r\n sliderChange(e : UniSliderChangeEvent) {\r\n console.log(\"value 发生变化：\" + e.detail.value);\r\n },\r\n slider_click() {\r\n console.log(\"组件被点击时触发\");\r\n },\r\n slider_touchstart() {\r\n console.log(\"手指触摸动作开始\");\r\n },\r\n slider_touchmove() {\r\n console.log(\"手指触摸后移动\");\r\n },\r\n slider_touchcancel() {\r\n console.log(\"手指触摸动作被打断，如来电提醒，弹窗\");\r\n },\r\n slider_touchend() {\r\n console.log(\"手指触摸动作结束\");\r\n },\r\n slider_tap() {\r\n console.log(\"手指触摸后马上离开\");\r\n },\r\n slider_longpress() {\r\n console.log(\r\n \"如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。\"\r\n );\r\n },\r\n slider_change() {\r\n console.log(\"完成一次拖动后触发的事件，event.detail = {value: value}\");\r\n },\r\n slider_changing() {\r\n console.log(\"拖动过程中触发的事件，event.detail = {value: value}\");\r\n },\r\n change_show_value_boolean(checked : boolean) {\r\n this.show_value_boolean = checked;\r\n },\r\n change_disabled_boolean(checked : boolean) {\r\n this.disabled_boolean = checked;\r\n },\r\n confirm_min_input(value : number) {\r\n this.min_input = value;\r\n },\r\n confirm_max_input(value : number) {\r\n this.max_input = value;\r\n },\r\n confirm_step_input(value : number) {\r\n this.step_input = value;\r\n },\r\n confirm_value_input(value : number) {\r\n this.value_input = value;\r\n },\r\n confirm_activeColor_input(value : string) {\r\n this.activeColor_input = value;\r\n },\r\n confirm_backgroundColor_input(value : string) {\r\n this.backgroundColor_input = value;\r\n },\r\n confirm_block_size_input(value : number) {\r\n this.block_size_input = value;\r\n },\r\n confirm_block_color_input(value : string) {\r\n this.block_color_input = value;\r\n },\r\n },\r\n };\r\n\n```\n\n:::","compatibility":"### slider 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| name | 3.9 | 4.11 | 4.0 |\n| disabled | 3.9 | 4.11 | 4.0 |\n| min | 3.9 | 4.11 | 4.0 |\n| max | 3.9 | 4.11 | 4.0 |\n| step | 3.9 | 4.11 | 4.0 |\n| value | 3.9 | 4.11 | 4.0 |\n| activeColor | 3.9 | 4.11 | 4.0 |\n| backgroundColor | 3.9 | 4.11 | 4.0 |\n| block-size | 3.9 | 4.11 | 4.0 |\n| block-color | 3.9 | 4.11 | 4.0 |\n| show-value | 3.9 | 4.11 | 4.0 |\n| @change | 3.9 | 4.11 | 4.0 |\n| @changing | 3.9 | 4.11 | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/slider)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/slider.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.slider)\n"},"swiper-item":{"name":"## swiper-item","description":"> 组件类型：UniSwiperItemElement \n\n swiper的唯一合法子组件。每个swiper-item代表一个滑块。宽高自动设置为100%\n\n### swiper-item 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | x | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| item-id | string | - | 该 swiper-item 的标识符 |","event":"","example":"","compatibility":"### swiper-item 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| item-id | 3.9 | x | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.net.cn/component/swiper.html#swiper-item)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/swiper.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.swiper-item)\n"},"swiper":{"name":"## swiper","description":"> 组件类型：UniSwiperElement \n\n 滑块视图容器\n\n### swiper 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | x | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| indicator-dots | boolean | false | 是否显示面板指示点 |\n| indicator-color | string([string.ColorString](/uts/data-type.md#ide-string)) | \"rgba(0, 0, 0, .3)\" | 指示点颜色 |\n| indicator-active-color | string([string.ColorString](/uts/data-type.md#ide-string)) | \"#000000\" | 当前选中的指示点颜色 |\n| disable-touch | boolean | false | 是否禁止用户 touch 操作 |\n| autoplay | boolean | false | 是否自动切换 |\n| current | number | 0 | 当前所在滑块的 index |\n| current-item-id | string | - | 当前所在滑块的 item-id ，不能与 current 被同时指定 |\n| interval | number | 3000 | 自动切换时间间隔 |\n| duration | number | - | 滑动动画时长 |\n| circular | boolean | false | 是否采用衔接滑动 |\n| vertical | boolean | false | 滑动方向是否为纵向 |\n| rebound | boolean | true | 控制是否回弹效果 |\n| @change | (event: [UniSwiperChangeEvent](#uniswiperchangeevent)) => void | - | current 改变时会触发 change 事件，event.detail = {current: current, source: source} |\n| @transition | (event: [UniSwiperTransitionEvent](#uniswipertransitionevent)) => void | - | swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy} |\n| @animationfinish | (event: [UniSwiperAnimationFinishEvent](#uniswiperanimationfinishevent)) => void | - | 动画结束时会触发 animationfinish 事件，event.detail = {current: current, source: source} |","event":"\n### 事件\n#### UniSwiperChangeEvent\n\n##### UniSwiperChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniSwiperChangeDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| current | number | 是 | - | 发生change事件的滑块下标 |\n@| source | string | 是 | - | autoplay 自动播放导致swiper变化；touch 用户划动引起swiper变化 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniSwiperChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniSwiperTransitionEvent\n\n##### UniSwiperTransitionEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniSwiperTransitionDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| dx | number | 是 | - | 横向偏移量，单位是逻辑像素px |\n@| dy | number | 是 | - | 纵向偏移量，单位是逻辑像素px |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniSwiperTransitionEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniSwiperAnimationFinishEvent\n\n##### UniSwiperAnimationFinishEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniSwiperAnimationFinishDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| current | number | 是 | - | 发生动画结束事件的滑块下标 |\n@| source | string | 是 | - | autoplay 自动播放导致swiper变化；touch 用户划动引起swiper变化 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniSwiperAnimationFinishEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/swiper/swiper.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/swiper/swiper\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n background: ['color1', 'color2', 'color3'],\r\n dotsSelect: false,\r\n reboundSelect: false,\r\n autoplaySelect: false,\r\n circularSelect: false,\r\n indicatorColorSelect: false,\r\n verticalSelect: false,\r\n currentSelect: false,\r\n currentItemIdSelect: false,\r\n intervalSelect: 2000,\r\n indicatorColor: \"\",\r\n indicatorColorActive: \"\",\r\n currentVal: 0,\r\n currentItemIdVal: \"\",\r\n disableTouchSelect: false,\r\n swiperTransitionSelect: false,\r\n swiperAnimationfinishSelect: false,\r\n swiperChangeSelect: false,\r\n currentValChange: 0\r\n }\r\n },\r\n methods: {\r\n\r\n swiperChange: function (e : SwiperChangeEvent) {\r\n this.currentValChange = e.detail.current\r\n console.log(this.currentValChange)\r\n if (this.swiperChangeSelect) {\r\n console.log(\"swiperChange\")\r\n console.log(e)\r\n }\r\n },\r\n swiperTransition: function (e : SwiperTransitionEvent) {\r\n if (this.swiperTransitionSelect) {\r\n console.log(\"swiperTransition\")\r\n console.log(e)\r\n }\r\n },\r\n swiperAnimationfinish: function (e : SwiperAnimationFinishEvent) {\r\n if (this.swiperAnimationfinishSelect) {\r\n console.log(\"swiperAnimationfinish\")\r\n console.log(e)\r\n }\r\n },\r\n\r\n dotsChange: function (e : UniSwitchChangeEvent) {\r\n this.dotsSelect = e.detail.value\r\n },\r\n swiperTransitionChange: function (e : UniSwitchChangeEvent) {\r\n this.swiperTransitionSelect = e.detail.value\r\n },\r\n swiperChangeChange: function (e : UniSwitchChangeEvent) {\r\n this.swiperChangeSelect = e.detail.value\r\n },\r\n swiperAnimationfinishChange: function (e : UniSwitchChangeEvent) {\r\n this.swiperAnimationfinishSelect = e.detail.value\r\n },\r\n autoplayChange: function (e : UniSwitchChangeEvent) {\r\n this.autoplaySelect = e.detail.value\r\n },\r\n verticalChange: function (e : UniSwitchChangeEvent) {\r\n this.verticalSelect = e.detail.value\r\n },\r\n disableTouchChange: function (e : UniSwitchChangeEvent) {\r\n this.disableTouchSelect = e.detail.value\r\n },\r\n currentItemIdChange: function (e : UniSwitchChangeEvent) {\r\n this.currentItemIdSelect = e.detail.value\r\n if (this.currentItemIdSelect) {\r\n this.currentItemIdVal = 'C'\r\n } else {\r\n this.currentItemIdVal = 'A'\r\n }\r\n },\r\n currentChange: function (e : UniSwitchChangeEvent) {\r\n this.currentSelect = e.detail.value\r\n if (this.currentSelect) {\r\n this.currentVal = 2\r\n } else {\r\n this.currentVal = 0\r\n }\r\n\r\n },\r\n circularChange: function (e : UniSwitchChangeEvent) {\r\n this.circularSelect = e.detail.value\r\n console.log(this.circularSelect)\r\n },\r\n reboundSelectChange: function (e : UniSwitchChangeEvent) {\r\n this.reboundSelect = e.detail.value\r\n console.log(this.reboundSelect)\r\n },\r\n sliderChange(e : UniSliderChangeEvent) {\r\n this.intervalSelect = e.detail.value\r\n },\r\n indicatorColorChange(e : UniSwitchChangeEvent) {\r\n this.indicatorColorSelect = e.detail.value\r\n if (this.indicatorColorSelect) {\r\n // 选择了定制指示器颜色\r\n this.indicatorColor = \"#ff00ff\"\r\n this.indicatorColorActive = \"#0000ff\"\r\n } else {\r\n // 没有选择颜色\r\n this.indicatorColor = \"\"\r\n this.indicatorColorActive = \"\"\r\n }\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### swiper 属性兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| indicator-dots | 5.0 | 3.9 | x | 4.0 |\n| indicator-color | 5.0 | 3.9 | x | 4.0 |\n| indicator-active-color | 5.0 | 3.9 | x | 4.0 |\n| disable-touch | 5.0 | 3.9 | x | - |\n| autoplay | 5.0 | 3.9 | x | 4.0 |\n| current | 5.0 | 3.9 | x | 4.0 |\n| current-item-id | 5.0 | 3.9 | x | 4.0 |\n| interval | 5.0 | 3.9 | x | 4.0 |\n| duration | x | x | x | 4.0 |\n| circular | 5.0 | 3.9 | x | 4.0 |\n| vertical | 5.0 | 3.9 | x | 4.0 |\n| rebound | 5.0 | 3.9 | x | - |\n| @change | 5.0 | 3.9 | x | 4.0 |\n| @transition | 5.0 | 3.9 | x | 4.0 |\n| @animationfinish | 5.0 | 3.9 | x | 4.0 |\n","children":"### 子组件 @children-tags \n - [swiper-item](#swiper-item)","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/swiper)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/swiper.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.swiper)\n"},"switch":{"name":"## switch","description":"> 组件类型：UniSwitchElement \n\n 开关选择器\n\n### switch 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| name | string | - | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |\n| checked | boolean | - | 是否选中 |\n| type | string | - | 样式，有效值：switch, checkbox |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| switch | - |\n@| checkbox | - |\n| color | string([string.ColorString](/uts/data-type.md#ide-string)) | - | switch 的颜色，同 css 的 color |\n| disabled | boolean | - | 是否禁用 |\n| @change | (event: [UniSwitchChangeEvent](#uniswitchchangeevent)) => void | - | checked 改变时触发 change 事件，event.detail={ value:checked} |\n","event":"\n### 事件\n#### UniSwitchChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| value | boolean | 是 | - | - |\n\n##### UniSwitchChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniSwitchChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | boolean | 是 | - | - |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniSwitchChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/switch/switch.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/switch/switch\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n title: 'switch 开关',\r\n checked: true,\r\n color: '#FFCC33',\r\n clickCheckedValue: true\r\n }\r\n },\r\n methods: {\r\n switch1Change: function (e : UniSwitchChangeEvent) {\r\n this.clickCheckedValue = e.detail.value\r\n console.log('switch1 发生 change 事件，携带值为', e.detail.value)\r\n },\r\n switch2Change: function (e : UniSwitchChangeEvent) {\r\n console.log('switch2 发生 change 事件，携带值为', e.detail.value)\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### switch 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| name | 3.9 | 4.11 | 4.0 |\n| checked | 3.9 | 4.11 | 4.0 |\n| type | x | 4.11 | 4.0 |\n| color | 3.9 | 4.11 | 4.0 |\n| disabled | 3.9 | 4.11 | 4.0 |\n| @change | 3.9 | 4.11 | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/switch)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/switch.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.switch)\n"},"text":{"name":"## text","description":"> 组件类型：[UniTextElement](#unitextelement) \n\n 文本\n\n### text 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| selectable | boolean | false | 文本是否可选 |\n| space | string | - | 显示连续空格 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| ensp | 中文字符空格一半大小 |\n@| emsp | 中文字符空格大小 |\n@| nbsp | 根据字体设置的空格大小 |\n| decode | boolean | false | 是否解码 (Android 端如需解析字符实体，需要配置为 true) |\n\n#### space 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| ensp | 3.9 | 4.11 | 4.0 |\n| emsp | 3.9 | 4.11 | 4.0 |\n| nbsp | 3.9 | 4.11 | 4.0 |\n","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/text/text.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/text/text\n>Template\n```vue\n\n\r\n\r\n\r\n\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n title: 'text',\r\n texts: [\r\n 'HBuilderX，轻巧、极速，极客编辑器',\r\n 'uni-app x，终极跨平台方案',\r\n 'uniCloud，js serverless云服务',\r\n 'uts，大一统语言',\r\n 'uniMPSdk，让你的App具备小程序能力',\r\n 'uni-admin，开源、现成的全端管理后台',\r\n 'uni-id，开源、全端的账户中心',\r\n 'uni-pay，开源、云端一体、全平台的支付',\r\n 'uni-ai，聚合ai能力',\r\n 'uni-cms，开源、云端一体、全平台的内容管理平台',\r\n 'uni-im，开源、云端一体、全平台的im即时消息',\r\n 'uni统计，开源、完善、全平台的统计报表',\r\n '......'\r\n ] as string[],\r\n text: '',\r\n canAdd: true,\r\n canRemove: false,\r\n extraLine: [] as string[]\r\n }\r\n },\r\n methods: {\r\n add: function () {\r\n this.extraLine.push(this.texts[this.extraLine.length % 12]);\r\n this.text = this.extraLine.join('\\n');\r\n this.canAdd = this.extraLine.length < 12;\r\n this.canRemove = this.extraLine.length > 0;\r\n },\r\n remove: function () {\r\n if (this.extraLine.length > 0) {\r\n this.extraLine.pop();\r\n this.text = this.extraLine.join('\\n');\r\n this.canAdd = this.extraLine.length < 12;\r\n this.canRemove = this.extraLine.length > 0;\r\n }\r\n },\r\n textProps: function () {\r\n uni.navigateTo({\r\n url: '/pages/component/text/text-props'\r\n })\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### text 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| selectable | 3.9 | 4.11 | 4.0 |\n| space | 3.9 | 4.11 | 4.0 |\n| decode | 3.9 | 4.11 | 4.0 |\n","children":"### 子组件 @children-tags \n - [text](#text)","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/text)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/text.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.text)\n","component_type":"### UniTextElement\n\ntext元素对象\n#### UniTextElement 的属性值\n| 名称 | 类型 | 必填 | 描述 |\n| :- | :- | :- | :- |\n| value | string | 是 | 只读属性 text元素的文案内容 |\n#### UniTextElement 的方法\n##### getTextExtra() @gettextextra\n\n\n###### 返回值 \n\n| 类型 | 必备 |\n| :- | :- |\n| any \\| null | 否 |\n \n\n\n"},"textarea":{"name":"## textarea","description":"> 组件类型：[UniTextareaElement](#unitextareaelement) \n\n 多行输入框\n\n### textarea 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | - | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| name | string | - | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |\n| value | string | \"\" | 输入框的初始内容 |\n| placeholder | string | \"\" | 输入框为空时占位符 |\n| placeholder-style | string | \"\" | 指定 placeholder 的样式 |\n| placeholder-class | string([string.ClassString](/uts/data-type.md#ide-string)) | \"\" | 指定 placeholder 的样式类，目前仅支持color,font-size和font-weight |\n| maxlength | number | \"不限制长度\" | 最大输入长度，0和正数为合法值，非法值的时候不限制最大长度 |\n| auto-focus | boolean | false | 自动获取焦点 |\n| focus | boolean | false | 获取焦点 |\n| cursor | number | 0 | 指定focus时的光标位置 |\n| confirm-hold | boolean | false | 点击键盘右下角按钮时是否保持键盘不收起 |\n| auto-height | boolean | false | 是否自动增高，设置auto-height时，style.height不生效 |\n| fixed | boolean | - | 如果 textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true |\n| cursor-spacing | number | 0 | 指定光标与键盘的距离，单位 px 。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |\n| cursor-color | string([string.ColorString](/uts/data-type.md#ide-string)) | \"\" | 指定光标颜色 |\n| show-confirm-bar | boolean | - | 是否显示键盘上方带有”完成“按钮那一栏 |\n| selection-start | number | -1 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |\n| selection-end | number | -1 | 光标结束位置，自动聚集时有效，需与selection-satrt搭配使用 |\n| adjust-position | boolean | true | 键盘弹起时，是否自动上推页面 |\n| hold-keyboard | boolean | false | focus时，点击页面的时候不收起键盘 |\n| @confirm | (event: [UniInputConfirmEvent](#uniinputconfirmevent)) => void | - | 点击完成时， 触发 confirm 事件，event.detail = {value: value} |\n| @input | (event: [UniInputEvent](#uniinputevent)) => void | - | 当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上 |\n| @linechange | (event: [UniTextareaLineChangeEvent](#unitextarealinechangeevent)) => void | - | 输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0} |\n| @blur | (event: [UniTextareaBlurEvent](#unitextareablurevent)) => void | - | 输入框失去焦点时触发，event.detail = {value, cursor} |\n| @keyboardheightchange | (event: [UniInputKeyboardHeightChangeEvent](#uniinputkeyboardheightchangeevent)) => void | - | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |\n| @focus | (event: [UniTextareaFocusEvent](#unitextareafocusevent)) => void | - | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持 |","event":"\n### 事件\n#### UniInputConfirmEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputConfirmEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputConfirmEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | string | 是 | - | 输入框内容 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniInputConfirmEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniInputEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | string | 是 | - | 输入框内容 |\n@| cursor | number | 是 | - | 光标的位置 |\n@| keyCode | number | 是 | - | 输入字符的Unicode值 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniInputEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniTextareaLineChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniTextareaLineChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniTextareaLineChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| lineCount | number | 是 | - | 行数 |\n@| heightRpx | number | 是 | - | textarea的高度 |\n@| height | number | 是 | - | textarea的高度 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniTextareaLineChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniTextareaBlurEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniTextareaBlurEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniTextareaBlurEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| value | string | 是 | - | 输入框内容 |\n@| cursor | number | 是 | - | 选择区域的起始位置 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniTextareaBlurEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniInputKeyboardHeightChangeEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniInputKeyboardHeightChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniInputKeyboardHeightChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| height | number | 是 | - | 键盘高度 |\n@| duration | number | 是 | - | 持续时间 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniInputKeyboardHeightChangeEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniTextareaFocusEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniTextareaFocusEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniTextareaFocusEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| height | number | 是 | - | 键盘高度 |\n@| value | string | 是 | - | 输入框内容 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| type | string | 是 | - | 事件类型 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n###### UniTextareaFocusEventDetail 兼容性 \n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| height | √ | - | 4.0 |\n\n##### UniTextareaFocusEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/textarea/textarea.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/textarea/textarea\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\nimport { ItemType } from '@/components/enum-data/enum-data'\r\nexport default {\r\n\tdata() {\r\n\t\treturn {\r\n\t\t\tadjust_position_boolean: false,\r\n\t\t\tshow_confirm_bar_boolean: false,\r\n\t\t\tfixed_boolean: false,\r\n\t\t\tauto_height_boolean: false,\r\n\t\t\tconfirm_hold_boolean: false,\r\n\t\t\tfocus_boolean: true,\r\n\t\t\tauto_focus_boolean: false,\n default_value:\"1\\n2\\n3\\n4\\n5\\n6\",\n maxlength:-1,\r\n\t\t\tinputmode_enum: [{\"value\":1,\"name\":\"text\"},{\"value\":2,\"name\":\"decimal\"},{\"value\":3,\"name\":\"numeric\"},{\"value\":4,\"name\":\"tel\"},{\"value\":5,\"name\":\"search\"},{\"value\":6,\"name\":\"email\"},{\"value\":7,\"name\":\"url\"},{\"value\":0,\"name\":\"none\"}] as ItemType[],\n cursor_color: \"#3393E2\",\r\n\t\t\tinputmode_enum_current: 0\r\n\t\t}\r\n\t},\n\r\n\tmethods: {\r\n\t\ttextarea_click() { console.log(\"组件被点击时触发\") },\r\n\t\ttextarea_touchstart() { console.log(\"手指触摸动作开始\") },\r\n\t\ttextarea_touchmove() { console.log(\"手指触摸后移动\") },\r\n\t\ttextarea_touchcancel() { console.log(\"手指触摸动作被打断，如来电提醒，弹窗\") },\r\n\t\ttextarea_touchend() { console.log(\"手指触摸动作结束\") },\r\n\t\ttextarea_tap() { console.log(\"手指触摸后马上离开\") },\r\n\t\ttextarea_longpress() { console.log(\"如果一个组件被绑定了 longpress 事件，那么当用户长按这个组件时，该事件将会被触发。\") },\r\n\t\ttextarea_confirm() { console.log(\"点击完成时， 触发 confirm 事件，event.detail = {value: value}\") },\r\n\t\ttextarea_input() { console.log(\"当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上\") },\r\n\t\ttextarea_linechange() { console.log(\"输入框行数变化时调用，event.detail = {height: 0, height: 0, lineCount: 0}\") },\r\n\t\ttextarea_blur() { console.log(\"输入框失去焦点时触发，event.detail = {value, cursor}\") },\r\n\t\ttextarea_keyboardheightchange() { console.log(\"键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration}\") },\r\n\t\ttextarea_focus() { console.log(\"输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度\") },\r\n\t\tchange_adjust_position_boolean(checked : boolean) { this.adjust_position_boolean = checked },\r\n\t\tchange_show_confirm_bar_boolean(checked : boolean) { this.show_confirm_bar_boolean = checked },\r\n\t\tchange_fixed_boolean(checked : boolean) { this.fixed_boolean = checked },\r\n\t\tchange_auto_height_boolean(checked : boolean) { this.auto_height_boolean = checked },\r\n\t\tchange_confirm_hold_boolean(checked : boolean) { this.confirm_hold_boolean = checked },\r\n\t\tchange_focus_boolean(checked : boolean) { this.focus_boolean = checked },\r\n\t\tchange_auto_focus_boolean(checked : boolean) { this.auto_focus_boolean = checked },\n change_cursor_color_boolean(checked : boolean) { if(checked){ this.cursor_color = \"transparent\"} else {this.cursor_color = \"#3393E2\"}},\r\n\t\tradio_change_inputmode_enum(checked : number) { this.inputmode_enum_current = checked }\r\n\t}\r\n}\r\n\n```\n\n:::","compatibility":"### textarea 属性兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| name | 5.0 | 3.9 | x | 4.0 |\n| value | 5.0 | 3.9 | x | 4.0 |\n| placeholder | 5.0 | 3.9 | x | 4.0 |\n| placeholder-style | 5.0 | 3.9 | x | 4.0 |\n| placeholder-class | 5.0 | 3.9 | x | 4.0 |\n| maxlength | 5.0 | 3.9 | x | 4.0 |\n| auto-focus | 5.0 | 3.9 | x | 4.0 |\n| focus | 5.0 | 3.9 | x | 4.0 |\n| cursor | 5.0 | 3.9 | x | 4.0 |\n| confirm-hold | 5.0 | 3.9 | x | 4.0 |\n| auto-height | 5.0 | 3.9 | x | 4.0 |\n| fixed | x | x | x | 4.0 |\n| cursor-spacing | 5.0 | 3.9 | x | 4.0 |\n| cursor-color | 5.0 | 3.99 | x | - |\n| show-confirm-bar | x | x | x | 4.0 |\n| selection-start | 5.0 | 3.9 | x | 4.0 |\n| selection-end | 5.0 | 3.9 | x | 4.0 |\n| adjust-position | 5.0 | 3.9 | x | 4.0 |\n| hold-keyboard | 5.0 | 4.0 | x | 4.0 |\n| @confirm | 5.0 | 3.9 | x | 4.0 |\n| @input | 5.0 | 3.9 | x | 4.0 |\n| @linechange | 5.0 | 3.9 | x | 4.0 |\n| @blur | 5.0 | 3.9 | x | 4.0 |\n| @keyboardheightchange | 5.0 | 3.9 | x | 4.0 |\n| @focus | 5.0 | 3.9 | x | 4.0 |\n","children":"### 子组件 @children-tags \n 不可以嵌套组件","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/textarea)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/textarea.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.textarea)\n","component_type":"### UniTextareaElement\n\ntextarea元素对象\n#### UniTextareaElement 的属性值\n| 名称 | 类型 | 必填 | 描述 |\n| :- | :- | :- | :- |\n| name | string | 是 | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交\n |\n| type | string | 是 | input的类型\n |\n| disabled | boolean | 是 | 是否禁用\n |\n| autofocus | boolean | 是 | 自动获取焦点\n |\n| value | string | 是 | 输入框的初始内容\n |"},"video":{"name":"## video","description":"> 组件类型：[UniVideoElement](#univideoelement) \n\n 视频\n\n### video 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| loop | boolean | false | 是否循环播放 |\n| src | string([string.VideoURIString](/uts/data-type.md#ide-string)) | - | 视频资源地址 |\n| initial-time | number | - | 指定视频初始播放位置 |\n| duration | number | - | 指定视频长度 |\n| controls | boolean | true | 是否显示默认播放控件（播放/暂停按钮、播放进度、时间） |\n| danmu-list | array | - | 弹幕列表 |\n| danmu-btn | boolean | false | 是否显示弹幕按钮，只在初始化时有效，不能动态变更 |\n| enable-danmu | boolean | false | 是否展示弹幕，只在初始化时有效，不能动态变更 |\n| autoplay | boolean | false | 是否自动播放 |\n| muted | boolean | false | 是否静音播放 |\n| page-gesture | boolean | false | 在非全屏模式下，是否开启亮度与音量调节手势 |\n| direction | number | -90 | 设置全屏时视频的方向，不指定则根据宽高比自动判断。有效值为 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度） |\n| show-progress | boolean | true | 若不设置，宽度大于240时才会显示 |\n| show-fullscreen-btn | boolean | true | 是否显示全屏按钮 |\n| show-play-btn | boolean | true | 是否显示视频底部控制栏的播放按钮 |\n| show-center-play-btn | boolean | true | 是否显示视频中间的播放按钮 |\n| show-loading | boolean | true | 是否显示loading控件 |\n| enable-progress-gesture | boolean | true | 是否开启控制进度的手势 |\n| objectFit | string | \"contain\" | 当视频大小与 video 容器大小不一致时，视频的表现形式。 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| contain | 包含 |\n@| fill | 填充 |\n@| cover | 覆盖 |\n| poster | string | - | 视频封面的图片网络资源地址，如果 controls 属性值为 false 则设置 poster 无效 |\n| show-mute-btn | boolean | false | 是否显示静音按钮 |\n| title | string | - | 视频的标题，全屏时在顶部展示 |\n| play-btn-position | string | - | 播放按钮的位置 |\n| enable-play-gesture | boolean | false | 是否开启播放手势，即双击切换播放、暂停 |\n| auto-pause-if-navigate | boolean | - | 当跳转到其它小程序页面时，是否自动暂停本页面的视频 |\n| auto-pause-if-open-native | boolean | - | 当跳转到其它微信原生页面时，是否自动暂停本页面的视频 |\n| vslide-gesture | boolean | false | 在非全屏模式下，是否开启亮度与音量调节手势（同 page-gesture） |\n| vslide-gesture-in-fullscreen | boolean | true | 在全屏模式下，是否开启亮度与音量调节手势 |\n| poster-for-crawler | string | - | 用于给搜索等场景作为视频封面展示，建议使用无播放 icon 的视频封面图，只支持网络地址 |\n| codec | string | \"hardware\" | 解码器选择 |\n| http-cache | boolean | false | 是否对 http、https 视频源开启本地缓存 |\n| play-strategy | number | 0 | 播放策略 |\n| is-live | boolean | - | 是否为直播源 |\n| @loadedmetadata | (event: [UniVideoLoadedMetadataEvent](#univideoloadedmetadataevent)) => void | - | 视频元数据加载完成时触发 |\n| @play | (event: [UniEvent](/component/common#unievent)) => void | - | 当开始/继续播放时触发 |\n| @pause | (event: [UniEvent](/component/common#unievent)) => void | - | 当暂停播放时触发 |\n| @ended | (event: [UniEvent](/component/common#unievent)) => void | - | 当播放到视频末尾时触发 |\n| @timeupdate | (event: [UniVideoTimeUpdateEvent](#univideotimeupdateevent)) => void | - | 播放进度变化时触发，event.detail = { currentTime, duration }。触发频率 250ms 一次 |\n| @fullscreenchange | (event: [UniVideoFullScreenChangeEvent](#univideofullscreenchangeevent)) => void | - | 当视频进入和退出全屏时触发，event.detail = { fullScreen, direction }，direction取为 vertical 或 horizontal |\n| @waiting | (event: [UniEvent](/component/common#unievent)) => void | - | 视频出现缓冲时触发 |\n| @error | (event: [UniVideoErrorEvent](#univideoerrorevent)) => void | - | 播放出错时触发 |\n| @progress | (event: [UniVideoProgressEvent](#univideoprogressevent)) => void | - | 加载进度变化时触发，只支持一段加载。event.detail = { buffered }，百分比 |\n| @fullscreenclick | (event: [UniVideoFullScreenClickEvent](#univideofullscreenclickevent)) => void | - | 视频全屏播放时点击屏幕触发。event.detail = { screenX, screenY, screenWidth, screenHeight } |\n| @controlstoggle | (event: [UniVideoControlsToggleEvent](#univideocontrolstoggleevent)) => void | - | 切换 controls 显示隐藏时触发。event.detail = { show } |\n\n#### objectFit 兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| contain | 3.9 | 4.11 | 4.0 |\n| fill | 3.9 | 4.11 | 4.0 |\n| cover | 3.9 | 4.11 | 4.0 |\n","event":"\n### 事件\n#### UniVideoTimeUpdateEvent\n\ntimeupdate 事件\n播放进度变化时触发\n##### UniVideoTimeUpdateEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniVideoTimeUpdateEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| currentTime | number | 是 | - | 当前进度 |\n@| duration | number | 是 | - | 总进度 |\n| type | string | 是 | - | - |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | Long | 是 | - | - |\n\n\n#### UniVideoFullScreenChangeEvent\n\nfullscreenchange 事件\n当视频进入和退出全屏是触发\n##### UniVideoFullScreenChangeEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniVideoFullScreenChangeEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| fullScreen | boolean | 是 | - | 是否全屏 |\n@| direction | string | 是 | - | 横竖屏，取值 vertical 或 horizontal |\n| type | string | 是 | - | - |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | Long | 是 | - | - |\n\n\n#### UniVideoErrorEvent\n\nerror 事件\n视频播放出错时触发\n##### UniVideoErrorEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **VideoError** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| errCode | 100001 \\| 200001 \\| 300001 | 是 | - | 统一错误码
100001 网络错误
200001 内部错误
300001 SDK错误 |\n@| errSubject | string | 是 | - | 统一错误主题（模块）名称 |\n@| data | any \\| null | 否 | - | 错误信息中包含的数据 |\n@| cause | [Error](https://uniapp.dcloud.net.cn/tutorial/err-spec.html#unierror) \\| null | 否 | - | UTS错误信息对象 |\n@| errMsg | string | 是 | - | - |\n| type | string | 是 | - | - |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | Long | 是 | - | - |\n\n\n#### UniVideoProgressEvent\n\nprogress 事件\n加载进度变化时触发\n##### UniVideoProgressEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniVideoProgressEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| buffered | number | 是 | - | 加载进度百分比 |\n| type | string | 是 | - | - |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | Long | 是 | - | - |\n\n\n#### UniVideoFullScreenClickEvent\n\nfullscreenclick 事件\n视频播放全屏播放时点击事件\n##### UniVideoFullScreenClickEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniVideoFullScreenClickEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| screenX | number | 是 | - | 点击点相对于屏幕左侧边缘的 X 轴坐标 |\n@| screenY | number | 是 | - | 点击点相对于屏幕顶部边缘的 Y 轴坐标 |\n@| screenWidth | number | 是 | - | 屏幕总宽度 |\n@| screenHeight | number | 是 | - | 屏幕总高度 |\n| type | string | 是 | - | - |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | Long | 是 | - | - |\n\n\n#### UniVideoControlsToggleEvent\n\ncontrolstoggle 事件\n切换播放控件显示隐藏时触发\n##### UniVideoControlsToggleEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| detail | **UniVideoControlsToggleEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| show | boolean | 是 | - | 是否显示 |\n| type | string | 是 | - | - |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | Long | 是 | - | - |\n\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/video/video.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/video/video\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n onReady() {\r\n this.videoContext = uni.createVideoContext('video', this);\r\n },\r\n data() {\r\n return {\r\n videoContext: null as VideoContext | null,\r\n // 属性\r\n src: \"https://qiniu-web-assets.dcloud.net.cn/video/sample/2minute-demo.mp4\",\r\n _src: \"https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/uni-app-video-courses.mp4\",\r\n autoplay: false,\r\n loop: false,\r\n muted: false,\r\n initialTime: 0,\r\n _initialTime: 6,\r\n duration: -1,\r\n _duration: 60,\r\n controls: true,\r\n danmuList: [{\r\n text: '要显示的文本',\r\n color: '#FF0000',\r\n time: 3\r\n }, {\r\n text: '要显示的文本2',\r\n color: '#31ff23',\r\n time: 5\r\n }, {\r\n text: '要显示的文本3',\r\n color: '#f13ef8',\r\n time: 7\r\n }, {\r\n text: '要显示的文本4',\r\n color: '#4972f8',\r\n time: 9\r\n }, {\r\n text: '要显示的文本5',\r\n color: '#000000',\r\n time: 11\r\n }] as Array,\r\n danmuBtn: false,\r\n enableDanmu: true,\r\n pageGesture: false,\r\n direction: -90,\r\n _direction: 0,\r\n requestFullScreenOptions: {\r\n direction: -90\r\n } as RequestFullScreenOptions,\r\n showProgress: true,\r\n showFullscreenBtn: true,\r\n showPlayBtn: true,\r\n showCenterPlayBtn: true,\r\n showLoading: true,\r\n enableProgressGesture: true,\r\n objectFit: \"contain\",\r\n _objectFit: \"fill\",\r\n poster: \"https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/uni-android.png\",\r\n _poster: \"https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/uni-ios.png\",\r\n showMuteBtn: false,\r\n title: \"video-component\",\r\n _title: \"video-component video-component\",\r\n enablePlayGesture: false,\r\n vslideGesture: false,\r\n vslideGestureInFullscreen: true,\r\n codec: \"hardware\",\r\n _codec: \"software\",\r\n httpCache: true,\r\n playStrategy: 0,\r\n _playStrategy: 2,\r\n header: {\r\n 'User-Agent': 'header test'\r\n } as UTSJSONObject,\r\n _header: {\r\n 'User-Agent': 'header test2'\r\n } as UTSJSONObject,\r\n // API\r\n pos: 10,\r\n rate: 1.5,\r\n danmu: {\r\n text: '要显示的文本',\r\n color: '#FF0000'\r\n } as Danmu,\r\n // 自动化测试\r\n isPlaying: false,\r\n isPause: false,\r\n isError: false\r\n }\r\n },\r\n onLoad() {\r\n // #ifdef WEB\r\n this.muted = true // web端非静音视频不可自动播放\r\n // #endif\r\n },\r\n methods: {\r\n // API\r\n play: function () {\r\n console.log(\"play\");\r\n this.videoContext?.play();\r\n },\r\n pause: function () {\r\n console.log(\"pause\");\r\n (uni.getElementById(\"video\") as UniVideoElement).pause(); //as写法测试。注意id不对时as会崩溃\r\n // this.videoContext?.pause();\r\n },\r\n seek: function (pos : number) {\r\n console.log(\"seek -> \" + pos);\r\n this.videoContext?.seek(pos);\r\n },\r\n requestFullScreen: function (options : RequestFullScreenOptions | null) {\r\n console.log(\"requestFullScreen -> \" + options);\r\n this.videoContext?.requestFullScreen(options);\r\n },\r\n exitFullScreen: function () {\r\n console.log(\"exitFullScreen\");\r\n this.videoContext?.exitFullScreen();\r\n },\r\n stop: function () {\r\n console.log(\"stop\");\r\n uni.getElementById(\"video\")?.stop(); //泛型写法测试\r\n // this.videoContext?.stop();\r\n },\r\n sendDanmu: function (danmu : Danmu) {\r\n console.log(\"sendDanmu -> \" + danmu);\r\n this.videoContext?.sendDanmu(danmu);\r\n },\r\n playbackRate: function (rate : number) {\r\n console.log(\"playbackRate -> \" + rate);\r\n this.videoContext?.playbackRate(rate);\r\n },\r\n // 属性\r\n setSrc: function (src : string) {\r\n this.src = src;\r\n console.log(\"src -> \" + this.src)\r\n },\r\n setAutoplay: function () {\r\n this.autoplay = !this.autoplay;\r\n console.log(\"autoplay -> \" + this.autoplay)\r\n },\r\n setLoop: function () {\r\n this.loop = !this.loop;\r\n console.log(\"loop -> \" + this.loop)\r\n },\r\n setMuted: function () {\r\n this.muted = !this.muted;\r\n console.log(\"muted -> \" + this.muted)\r\n },\r\n setInitialTime: function (initialTime : number) {\r\n this.initialTime = initialTime;\r\n console.log(\"initialTime -> \" + this.initialTime)\r\n },\r\n setDuration: function (duration : number) {\r\n this.duration = duration;\r\n console.log(\"duration -> \" + this.duration)\r\n },\r\n setControls: function () {\r\n this.controls = !this.controls;\r\n console.log(\"controls -> \" + this.controls)\r\n },\r\n setDanmuBtn: function () {\r\n this.danmuBtn = !this.danmuBtn;\r\n console.log(\"danmuBtn -> \" + this.danmuBtn)\r\n },\r\n setPageGesture: function () {\r\n this.pageGesture = !this.pageGesture;\r\n console.log(\"pageGesture -> \" + this.pageGesture)\r\n },\r\n setDirection: function (direction : number) {\r\n this.direction = direction;\r\n console.log(\"direction -> \" + this.direction)\r\n },\r\n setShowProgress: function () {\r\n this.showProgress = !this.showProgress;\r\n console.log(\"showProgress -> \" + this.showProgress)\r\n },\r\n setShowFullscreenBtn: function () {\r\n this.showFullscreenBtn = !this.showFullscreenBtn;\r\n console.log(\"showFullscreenBtn -> \" + this.showFullscreenBtn)\r\n },\r\n setShowPlayBtn: function () {\r\n this.showPlayBtn = !this.showPlayBtn;\r\n console.log(\"showPlayBtn -> \" + this.showPlayBtn)\r\n },\r\n setShowCenterPlayBtn: function () {\r\n this.showCenterPlayBtn = !this.showCenterPlayBtn;\r\n console.log(\"showCenterPlayBtn -> \" + this.showCenterPlayBtn)\r\n },\r\n setShowLoading: function () {\r\n this.showLoading = !this.showLoading;\r\n console.log(\"showLoading -> \" + this.showLoading)\r\n },\r\n setEnableProgressGesture: function () {\r\n this.enableProgressGesture = !this.enableProgressGesture;\r\n console.log(\"enableProgressGesture -> \" + this.enableProgressGesture)\r\n },\r\n setObjectFit: function (objectFit : string) {\r\n this.objectFit = objectFit;\r\n console.log(\"objectFit -> \" + this.objectFit)\r\n },\r\n setPoster: function (poster : string) {\r\n this.poster = poster;\r\n console.log(\"poster -> \" + this.poster)\r\n },\r\n setShowMuteBtn: function () {\r\n this.showMuteBtn = !this.showMuteBtn;\r\n console.log(\"showMuteBtn -> \" + this.showMuteBtn)\r\n },\r\n setTitle: function (title : string) {\r\n this.title = title;\r\n console.log(\"title -> \" + this.title)\r\n },\r\n setEnablePlayGesture: function () {\r\n this.enablePlayGesture = !this.enablePlayGesture;\r\n console.log(\"enablePlayGesture -> \" + this.enablePlayGesture)\r\n },\r\n setVslideGesture: function () {\r\n this.vslideGesture = !this.vslideGesture;\r\n console.log(\"vslideGesture -> \" + this.vslideGesture)\r\n },\r\n setVslideGestureInFullscreen: function () {\r\n this.vslideGestureInFullscreen = !this.vslideGestureInFullscreen;\r\n console.log(\"vslideGestureInFullscreen -> \" + this.vslideGestureInFullscreen)\r\n },\r\n setCodec: function (codec : string) {\r\n this.codec = codec;\r\n console.log(\"codec -> \" + this.codec)\r\n },\r\n setHttpCache: function () {\r\n this.httpCache = !this.httpCache;\r\n console.log(\"httpCache -> \" + this.httpCache)\r\n },\r\n setPlayStrategy: function (playStrategy : number) {\r\n this.playStrategy = playStrategy;\r\n console.log(\"playStrategy -> \" + this.playStrategy)\r\n },\r\n setHeader: function (header : UTSJSONObject) {\r\n this.header = header;\r\n console.log(\"header -> \" + this.header)\r\n },\r\n // 事件\r\n onPlay: function (res : UniEvent) {\r\n console.log(res.type);\r\n this.isPlaying = true;\r\n this.isPause = false;\r\n },\r\n onPause: function (res : UniEvent) {\r\n console.log(res.type);\r\n this.isPlaying = false;\r\n this.isPause = true;\r\n },\r\n onEnded: function (res : UniEvent) {\r\n console.log(res.type);\r\n },\r\n onTimeUpdate: function (res : UniVideoTimeUpdateEvent) {\r\n console.log(res.type + \" -> \" + JSON.stringify(res.detail));\r\n },\r\n onFullScreenChange: function (res : UniVideoFullScreenChangeEvent) {\r\n console.log(res.type + \" -> \" + JSON.stringify(res.detail));\r\n },\r\n onWaiting: function (res : UniEvent) {\r\n console.log(res.type);\r\n },\r\n onError: function (res : UniVideoErrorEvent) {\r\n console.log(res.type + \" -> \" + JSON.stringify(res.detail));\r\n this.isError = true;\r\n },\r\n onProgress: function (res : UniVideoProgressEvent) {\r\n console.log(res.type + \" -> \" + JSON.stringify(res.detail));\r\n },\r\n onFullScreenClick: function (res : UniVideoFullScreenClickEvent) {\r\n console.log(res.type + \" -> \" + JSON.stringify(res.detail));\r\n },\r\n onControlsToggle: function (res : UniVideoControlsToggleEvent) {\r\n console.log(res.type + \" -> \" + JSON.stringify(res.detail));\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### video 属性兼容性\n| | Android 系统版本 | Android | iOS | web |\n| :- | :- | :- | :- | :- |\n| loop | 5.0 | 3.9 | 4.11 | 4.0 |\n| src | 5.0 | 3.9 | 4.11 | 4.0 |\n| initial-time | 5.0 | 3.9 | 4.11 | 4.0 |\n| duration | 5.0 | 3.9 | 4.11 | 4.0 |\n| controls | 5.0 | 3.9 | 4.11 | 4.0 |\n| danmu-list | 5.0 | 3.9 | 4.11 | 4.0 |\n| danmu-btn | 5.0 | 3.9 | 4.11 | 4.0 |\n| enable-danmu | 5.0 | 3.9 | 4.11 | 4.0 |\n| autoplay | 5.0 | 3.9 | 4.11 | 4.0 |\n| muted | 5.0 | 3.9 | 4.11 | 4.0 |\n| page-gesture | 5.0 | 3.9 | 4.11 | 4.0 |\n| direction | 5.0 | 3.9 | 4.11 | 4.0 |\n| show-progress | 5.0 | 3.9 | 4.11 | 4.0 |\n| show-fullscreen-btn | 5.0 | 3.9 | 4.11 | 4.0 |\n| show-play-btn | 5.0 | 3.9 | 4.11 | 4.0 |\n| show-center-play-btn | 5.0 | 3.9 | 4.11 | 4.0 |\n| show-loading | 5.0 | 3.9 | 4.11 | 4.0 |\n| enable-progress-gesture | 5.0 | 3.9 | 4.11 | 4.0 |\n| objectFit | 5.0 | 3.9 | 4.11 | 4.0 |\n| poster | 5.0 | 3.9 | 4.11 | 4.0 |\n| show-mute-btn | 5.0 | 3.9 | 4.11 | 4.0 |\n| title | 5.0 | 3.9 | 4.11 | 4.0 |\n| play-btn-position | 5.0 | x | x | 4.0 |\n| enable-play-gesture | 5.0 | 3.9 | 4.11 | 4.0 |\n| auto-pause-if-navigate | 5.0 | x | x | 4.0 |\n| auto-pause-if-open-native | 5.0 | x | x | 4.0 |\n| vslide-gesture | 5.0 | 3.9 | 4.11 | 4.0 |\n| vslide-gesture-in-fullscreen | 5.0 | 3.9 | 4.11 | 4.0 |\n| poster-for-crawler | 5.0 | x | x | 4.0 |\n| codec | 5.0 | 3.9 | 4.11 | x |\n| http-cache | 5.0 | 3.9 | 4.11 | x |\n| play-strategy | 5.0 | 3.9 | 4.11 | 4.0 |\n| is-live | 5.0 | x | x | 4.0 |\n| @loadedmetadata | x | x | x | 4.0 |\n| @play | 5.0 | 3.9 | 4.11 | 4.0 |\n| @pause | 5.0 | 3.9 | 4.11 | 4.0 |\n| @ended | 5.0 | 3.9 | 4.11 | 4.0 |\n| @timeupdate | 5.0 | 3.9 | 4.11 | 4.0 |\n| @fullscreenchange | 5.0 | 3.9 | 4.11 | 4.0 |\n| @waiting | 5.0 | 3.9 | 4.11 | 4.0 |\n| @error | 5.0 | 3.9 | 4.11 | 4.0 |\n| @progress | 5.0 | 3.9 | 4.11 | 4.0 |\n| @fullscreenclick | 5.0 | 3.9 | 4.11 | 4.0 |\n| @controlstoggle | 5.0 | 3.9 | 4.11 | 4.0 |\n","children":"### 子组件 @children-tags \n 不可以嵌套组件","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/video)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/video.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.video)\n","component_type":"### UniVideoElement\n\nvideo元素对象\n#### UniVideoElement 的方法\n##### play() @play\n\n播放\n\n\n\n\n##### pause() @pause\n\n暂停\n\n\n\n\n##### seek(position) @seek\n\n跳转到指定位置\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| position | number | 是 | - | 跳转到指定位置(秒) | \n\n\n\n\n##### stop() @stop\n\n停止视频\n\n\n\n\n##### sendDanmu(danmu) @senddanmu\n\n发送弹幕\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| danmu | **Danmu** | 是 | - | 弹幕数据 |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| text | string \\| null | 否 | - | 弹幕文字 |\n@| color | string \\| null | 否 | - | 弹幕颜色 |\n@| time | number \\| null | 否 | - | 显示时刻 | \n\n\n\n\n##### playbackRate(rate) @playbackrate\n\n设置倍速播放\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| rate | number | 是 | - | 支持倍率 0.5/0.8/1.0/1.25/1.5 | \n\n\n\n\n##### requestFullScreen(direction?) @requestfullscreen\n\n进入全屏\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| direction | **RequestFullScreenOptions** | 否 | - | 0\\|正常竖向, 90\\|屏幕逆时针90度, -90\\|屏幕顺时针90度 |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| direction | number \\| null | 否 | - | direction
- 0: 正常竖向
- 90: 屏幕逆时针90度
- -90: 屏幕顺时针90度 | \n\n\n\n\n##### exitFullScreen() @exitfullscreen\n\n退出全屏\n\n\n\n"},"unicloud-db":{"name":"## unicloud-db","description":"> 组件类型：UniCloudDBElement \n\n 是一个数据库查询组件，它将clientDB的API封装为组件，进一步减少开发者使用所需的代码量。\n\n### unicloud-db 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.93 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| id | string([string.IDString](/uts/data-type.md#ide-string)) | - | 唯一标识 |\n| v-slot:default | string | - | {data, loading, hasMore, pagination, error} |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| data | 查询结果，类型为Array\\ |\n@| loading | 查询中的状态。可根据此状态，在template中通过v-if显示等待内容 |\n@| hasMore | 是否有更多数据。可根据此状态，在template中通过v-if显示没有更多数据了 |\n@| error | 查询错误。可根据此状态，在template中通过v-if显示等待内容 |\n@| pagination | 分页属性 |\n@@| 值名称 | 描述 |\n@@| :- | :- |\n@@| current | 当前页号 |\n@@| size | 分页大小 |\n@@| count | 数据库的总数据量, 设置 :getcount=true 时有效 |\n| collection | string([string.DBCollectionString](/uts/data-type.md#ide-string)) | - | 表名 |\n| field | string([string.DBFieldString](/uts/data-type.md#ide-string)) | - | 查询字段，多个字段用 `,` 分割 |\n| where | string([string.JQLString](/uts/data-type.md#ide-string)) | - | 查询条件 |\n| orderby | string | - | 排序字段及正序倒叙设置 |\n| groupby | string | - | 对数据进行分组 |\n| group-field | string | - | 对数据进行分组统计 |\n| distinct | boolean | - | 是否对数据查询结果中重复的记录进行去重 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| true | 去重 |\n@| false | 不去重 |\n| page-data | string | - | add 多次查询的集合, replace 当前查询的集合 |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| add | 多次查询的集合 |\n@| replace | 当前查询的集合 |\n| page-current | number | - | 当前页 |\n| page-size | number | - | 每页数据数量 |\n| getone | boolean | - | 指定查询结果是否返回数组第一条数据，默认 false。在false情况下返回的是数组，即便只有一条结果，也需要[0\\]的方式获取。在true下，直接返回结果数据，少一层数组 |\n| getcount | boolean | - | 是否查询总数量 |\n| gettree | boolean | - | 是否查询树状结构数据 |\n| startwith | string | - | gettree的第一层级条件，此初始条件可以省略，不传startWith时默认从最顶级开始查询 |\n| limitlevel | number | - | gettree查询返回的树的最大层级。超过设定层级的节点不会返回。默认10级，最大15，最小1 |\n| manual | boolean | - | 是否手动加载数据，默认为 false，页面onLoad时自动联网加载数据 |\n| loadtime | string | - | 加载数据时机，默认auto，可选值 auto\\|onready\\|manual |\n@| 值名称 | 描述 |\n@| :- | :- |\n@| auto | 页面就绪后或属性变化后加载数据，默认为auto |\n@| onready | 页面就绪后不自动加载数据，属性变化后加载。适合在onLoad中接收上个页面的参数作为where条件时 |\n@| manual | 手动模式，不自动加载数据。如果涉及到分页，需要先手动修改当前页，在调用加载数据 |\n| action | string([string.ClientDBActionString](/uts/data-type.md#ide-string)) | - | 云端执行数据库查询的前或后，触发某个action函数操作，进行预处理或后处理 |\n| @load | (data : Array\\, ended : boolean, pagination : [UTSJSONObject](/uts/buildin-object-api/utsjsonobject.md)) => void | - | 成功回调。如联网返回结果后，想修改下数据再渲染界面，则在本方法里对data进行修改 |\n| @error | (event: [UniEvent](/component/common#unievent)) => void | - | 失败回调 |\n\n\n\n\n","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/unicloud-db/unicloud-db.uvue) \n ```vue\n\r\n\r\n\r\n\r\n\r\n\n```","compatibility":"### unicloud-db 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| v-slot:default | 3.93 | 4.11 | 4.0 |\n| collection | 3.93 | 4.11 | 4.0 |\n| field | 3.93 | 4.11 | 4.0 |\n| where | 3.93 | 4.11 | 4.0 |\n| orderby | 3.93 | 4.11 | 4.0 |\n| groupby | 3.93 | 4.11 | 4.0 |\n| group-field | 3.93 | 4.11 | 4.0 |\n| distinct | 3.93 | 4.11 | 4.0 |\n| page-data | 3.93 | 4.11 | 4.0 |\n| page-current | 3.93 | 4.11 | 4.0 |\n| page-size | 3.93 | 4.11 | 4.0 |\n| getone | x | x | 4.0 |\n| getcount | 3.93 | 4.11 | 4.0 |\n| gettree | 3.93 | 4.11 | 4.0 |\n| startwith | 3.93 | 4.11 | 4.0 |\n| limitlevel | 3.93 | 4.11 | 4.0 |\n| manual | 3.93 | 4.11 | 4.0 |\n| loadtime | 3.93 | 4.11 | 4.0 |\n| action | x | x | 4.0 |\n| @load | 3.93 | 4.11 | 4.0 |\n| @error | 3.93 | 4.11 | 4.0 |\n","children":"","reference":"\n### 参见\n- [unicloud-db组件教程](https://uniapp.dcloud.io/uniCloud/unicloud-db)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/unicloud-db.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.unicloud-db)\n"},"view":{"name":"## view","description":"> 组件类型：UniViewElement \n\n 基本视图容器\n\n### view 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| hover-class | string([string.ClassString](/uts/data-type.md#ide-string)) | \"none\" | 指定按下去的样式类。当 hover-class=\"none\" 时，没有点击态效果 |\n| hover-stop-propagation | boolean | false | 指定是否阻止本节点的祖先节点出现点击态(祖先节点：指根节点到该节点路径上的所有节点都是这个节点的祖先节点) |\n| hover-start-time | number | 50 | 按住后多久出现点击态，单位毫秒 |\n| hover-stay-time | number | 400 | 手指松开后点击态保留时间，单位毫秒 |","event":"","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/view/view.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/view/view\n>Template\n```vue\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n import { ItemType } from '@/components/enum-data/enum-data'\r\n export default {\r\n data() {\r\n return {\r\n hover_class: false,\r\n stop_propagation: false,\r\n start_time: 50,\r\n stay_time: 400,\r\n start_time_enum: [{ \"value\": 50, \"name\": \"50毫秒\" }, { \"value\": 200, \"name\": \"200毫秒\" }] as ItemType[],\r\n stay_time_enum: [{ \"value\": 400, \"name\": \"400毫秒\" }, { \"value\": 200, \"name\": \"200毫秒\" }] as ItemType[]\r\n }\r\n },\r\n methods: {\r\n change_hover_class_boolean(checked : boolean) {\r\n this.hover_class = checked\r\n },\r\n change_stop_propagation_boolean(checked : boolean) {\r\n this.stop_propagation = checked\r\n },\r\n radio_change_start_time_enum(time : number) {\r\n this.start_time = time\r\n },\r\n radio_change_stay_time_enum(time : number) {\r\n this.stay_time = time\r\n },\r\n },\r\n }\r\n\n```\n\n:::","compatibility":"### view 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| hover-class | 3.9 | 4.11 | 4.0 |\n| hover-stop-propagation | 3.9 | 4.11 | 4.0 |\n| hover-start-time | 3.9 | 4.11 | 4.0 |\n| hover-stay-time | 3.9 | 4.11 | 4.0 |\n","children":"","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/view)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/view.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.view)\n"},"web-view":{"name":"## web-view","description":"> 组件类型：[UniWebViewElement](#uniwebviewelement) \n\n 承载网页的容器\n\n### web-view 兼容性\n| Android | iOS | web |\n| :- | :- | :- |\n| 3.9 | 4.11 | 4.0 |\n","attribute":"### 属性 \n| 名称 | 类型 | 默认值 | 描述 |\n| :- | :- | :- | :- |\n| src | string([string.URIString](/uts/data-type.md#ide-string)) | - | webview 指向网页的链接 |\n| webview-styles | **WebViewStyles** | {\"progress\":{\"color\":\"#00FF00\"}} | webview 网络地址页面加载进度条样式 |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| progress | **WebViewProgressStyles** \\| boolean | 是 | false | 网络地址页面加载进度条样式，设置为 false 时表示不显示加载进度条。 |\n@@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@@| :- | :- | :- | :- | :- |\n@@| color | [string.ColorString](/uts/data-type.md#ide-string) | 是 | - | 网页加载进度条颜色，默认值为 #00FF00 。 |\n@\n| @message | (event: [UniWebViewMessageEvent](#uniwebviewmessageevent)) => void | - | 网页向应用 postMessage 时触发。e.detail = { data } |\n| @error | (event: [UniWebViewErrorEvent](#uniwebviewerrorevent)) => void | - | 网页加载错误时触发。e.detail = { errSubject, errCode, errMsg } |\n| @load | (event: [UniWebViewLoadEvent](#uniwebviewloadevent)) => void | - | 网页加载完成后触发。e.detail = { url } |\n| ~~@loaded~~ | (event: [UniWebViewLoadEvent](#uniwebviewloadevent)) => void | - | 网页加载完成后触发。e.detail = { url }。已废弃，请改用load |\n| @loading | (event: [UniWebViewLoadingEvent](#uniwebviewloadingevent)) => void | - | 网页加载中触发。e.detail = { url } |\n| @download | (event: [UniWebViewDownloadEvent](#uniwebviewdownloadevent)) => void | - | 点击网页中可下载链接时触发。e.detail = { url, userAgent, contentDisposition, mimetype, contentLength } |","event":"\n### 事件\n#### UniWebViewMessageEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniWebViewMessageEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | 事件类型，固定值message |\n| detail | **UniWebViewMessageEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| data | Map\\ \\| null | 否 | - | 消息包含的数据 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniWebViewMessageEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniWebViewErrorEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniWebViewErrorEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | 事件类型，固定值error |\n| detail | **UniWebViewErrorEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| errSubject | string | 是 | - | 统一错误主题（模块）名称，固定值uni-web-view |\n@| errCode | 100001 \\| 100002 \\| 100003 | 是 | - | 统一错误码
100001 ssl error
100002 page error
100003 http error |\n@| errMsg | string | 是 | - | 统一错误描述信息 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniWebViewErrorEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniWebViewLoadEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniWebViewLoadEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | 事件类型，固定值load |\n| detail | **UniWebViewLoadEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| url | string | 是 | - | 加载完成的网页链接 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniWebViewLoadEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniWebViewLoadingEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniWebViewLoadingEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | 事件类型，固定值loading |\n| detail | **UniWebViewLoadingEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| url | string | 是 | - | 加载中的网页链接 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniWebViewLoadingEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n\n#### UniWebViewDownloadEvent\n\n##### 构造函数\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | - |\n| detail | any | 是 | - | - |\n\n##### UniWebViewDownloadEvent 的属性值\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| type | string | 是 | - | 事件类型，固定值download |\n| detail | **UniWebViewDownloadEventDetail** | 是 | - | - |\n@| 名称 | 类型 | 必备 | 默认值 | 描述 |\n@| :- | :- | :- | :- | :- |\n@| ctors | Constructor | 是 | - | - |\n@| url | string | 是 | - | 下载链接 |\n@| userAgent | string | 是 | - | 用户代理 |\n@| contentDisposition | string | 是 | - | 指示回复的内容该以何种形式展示，是以内联的形式（即网页或者页面的一部分），还是以附件的形式下载并保存到本地 |\n@| mimetype | string | 是 | - | 媒体类型 |\n@| contentLength | number | 是 | - | 文件大小 |\n| bubbles | boolean | 是 | - | 是否冒泡 |\n| cancelable | boolean | 是 | - | 是否可以取消 |\n| target | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| currentTarget | [UniElement](/dom/unielement.md) \\| null | 否 | - | UVUE DOM 元素对象，描述了 UVUE DOM 元素所普通具有的属性和方法。 |\n| timeStamp | number | 是 | - | 事件发生时的时间戳 |\n\n\n##### UniWebViewDownloadEvent 的方法\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |\n| preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |\n","example":"### 示例 \n> [hello uni-app x](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/alpha/pages/component/web-view/web-view.uvue) \n ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/web-view/web-view\n>Template\n```vue\n\r\n\r\n\r\n\r\n\r\n\n```\n>Script\n```uts\n\r\n export default {\r\n data() {\r\n return {\r\n src: 'https://www.dcloud.io',\r\n webview_styles: {\r\n progress: {\r\n color: '#FF3333'\r\n }\r\n },\r\n webviewContext: null as WebviewContext | null,\r\n loadError: false\r\n }\r\n },\r\n onReady() {\r\n // #ifdef APP\r\n // TODO web 实现createWebviewContext\r\n this.webviewContext = uni.createWebviewContext('web-view', this)\r\n // #endif\r\n },\r\n methods: {\r\n back() {\r\n this.webviewContext?.back();\r\n },\r\n forward() {\r\n this.webviewContext?.forward();\r\n },\r\n reload() {\r\n this.webviewContext?.reload();\r\n },\r\n stop() {\r\n this.webviewContext?.stop();\r\n },\r\n nativeToWeb() {\r\n this.webviewContext?.evalJS(\"alert('hello uni-app x')\");\r\n },\r\n message(event : UniWebViewMessageEvent) {\r\n console.log(JSON.stringify(event));\r\n },\r\n error(event : UniWebViewErrorEvent) {\r\n this.loadError = true\r\n console.log(JSON.stringify(event));\r\n },\r\n loading(event : UniWebViewLoadingEvent) {\r\n console.log(JSON.stringify(event));\r\n },\r\n load(event : UniWebViewLoadEvent) {\r\n console.log(JSON.stringify(event));\r\n },\r\n download(event : UniWebViewDownloadEvent) {\r\n console.log(JSON.stringify(event));\r\n uni.showModal({\r\n content: \"下载链接: \" + event.detail.url + \"\\n文件大小: \" + event.detail.contentLength / 1024 + \"KB\",\r\n showCancel: false\r\n });\r\n },\r\n confirm(event : UniInputConfirmEvent) {\r\n console.log(JSON.stringify(event));\r\n let url = event.detail.value;\r\n if (!url.startsWith('https://') && !url.startsWith('http://')) {\r\n url = 'https://' + url;\r\n }\r\n this.src = url;\r\n }\r\n }\r\n }\r\n\n```\n\n:::","compatibility":"### web-view 属性兼容性\n| | Android | iOS | web |\n| :- | :- | :- | :- |\n| src | 3.9 | 4.11 | 4.0 |\n| webview-styles | 3.9 | 4.11 | x |\n| @message | 3.9 | 4.11 | x |\n| @error | 3.9 | 4.11 | x |\n| @load | 4.0 | 4.11 | x |\n| @loading | 3.9 | 4.11 | x |\n| @download | 3.9 | 4.11 | x |\n","children":"### 子组件 @children-tags \n 不可以嵌套组件","reference":"\n### 参见\n- [uni-app相关参考](https://uniapp.dcloud.io/component/web-view)\n- [uni-app x相关参考](https://doc.dcloud.net.cn/uni-app-x/component/web-view.html)\n- [相关 Bug](https://issues.dcloud.net.cn/?mid=component.web-view)\n","component_type":"### UniWebViewElement\n\nweb-view元素对象\n#### UniWebViewElement 的方法\n##### back() @back\n\n后退\n\n\n\n\n##### forward() @forward\n\n前进\n\n\n\n\n##### reload() @reload\n\n重新加载\n\n\n\n\n##### stop() @stop\n\n停止加载\n\n\n\n\n##### evalJS(js) @evaljs\n\n原生和WebView通信（执行JS脚本）\n##### 参数 \n\n| 名称 | 类型 | 必填 | 默认值 | 描述 |\n| :- | :- | :- | :- | :- |\n| js | string | 是 | - | - | \n\n\n\n"}}