tmui-cli 2.0.6 → 5.3.2

package/data/uniappx/component/input.md

@@ -1,94 +1,94 @@
 ::: sourceCode
 ## input
 
-> GitCode: https://gitcode.com/dcloud/uni-component/tree/alpha/uni_modules/uni-input
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/input
 
-> GitHub: https://github.com/dcloudio/uni-component/tree/alpha/uni_modules/uni-input
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/input
 
 > 组件类型：UniInputElement 
 
  输入框
 
 ### 兼容性 
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | 4.41 | 3.9 | 4.11 | 4.61 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 5.31 | 3.9 | 4.11 | 4.61 |
 
 ### 属性 
 | 名称 | 类型 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| name | string | "input" | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |
-| disabled | boolean | false | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 是否禁用 |
-| value | string \| number | "" | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框的初始内容 |
-| type | string | "text" | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | input的类型 |
+| name | string | "input" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 表单的控件名称，作为键值对的一部分与表单(form组件)一同提交 |
+| disabled | boolean | false | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 是否禁用 |
+| value | string \| number | "" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框的初始内容 |
+| type | string | "text" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | input的类型 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| none | Web 5.0 / 微信小程序 x / Android 4.73 / iOS 4.73 / HarmonyOS 5.08（部分支持，见上） | 获取焦点时不显示软键盘 |
-| email | Web 5.0 / 微信小程序 x / Android 4.73 / iOS 4.73 / HarmonyOS 4.73（部分支持，见上） | 为邮件地址输入优化的虚拟键盘 |
-| url | Web 5.0 / 微信小程序 x / Android 4.73 / iOS 4.73 / HarmonyOS 4.73（部分支持，见上） | 为网址输入优化的虚拟键盘 |
-| text | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 文本输入键盘 |
-| number | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 数字输入键盘 |
-| idcard | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 身份证输入键盘 |
-| digit | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 带小数点数字输入键盘 |
-| tel | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 电话输入键盘 |
-| safe-password | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 密码安全输入键盘 |
-| nickname | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 昵称输入键盘 |
-| password | boolean | false | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 是否是密码类型 |
-| placeholder | string | "" | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框为空时占位符 |
-| placeholder-style | string | "" | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 指定 placeholder 的样式 |
-| placeholder-class | string(string.ClassString) | "" | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 指定 placeholder 的样式类 |
-| maxlength | string \| number | -1 | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 最大输入长度，0和正数为合法值，非法值的时候不限制最大长度 |
-| cursor-spacing | number | 0 | Web x / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
-| cursor-color | string(string.ColorString) | "" | Web 4.0 / 微信小程序 4.41 / Android 3.99 / iOS 4.11 / HarmonyOS 4.61 | 指定光标颜色 |
-| auto-focus | boolean | false | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 自动获取焦点，与`focus`属性对比，此属性只会首次生效。 |
-| focus | boolean | false | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 获取焦点 |
-| confirm-type | string | "done" | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 设置键盘右下角按钮的文字，仅在 type为text 时生效。 |
+| none | Web 5.0 / 微信小程序 x / 支付宝小程序 x / Android 4.73 / iOS 4.73 / HarmonyOS 5.08（部分支持，见上） | 获取焦点时不显示软键盘 |
+| email | Web 5.0 / 微信小程序 x / 支付宝小程序 x / Android 4.73 / iOS 4.73 / HarmonyOS 4.73（部分支持，见上） | 为邮件地址输入优化的虚拟键盘 |
+| url | Web 5.0 / 微信小程序 x / 支付宝小程序 x / Android 4.73 / iOS 4.73 / HarmonyOS 4.73（部分支持，见上） | 为网址输入优化的虚拟键盘 |
+| text | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 文本输入键盘 |
+| number | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 数字输入键盘 |
+| idcard | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 身份证输入键盘 |
+| digit | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 带小数点数字输入键盘 |
+| tel | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 电话输入键盘 |
+| safe-password | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） | 密码安全输入键盘 |
+| nickname | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 昵称输入键盘 |
+| password | boolean | false | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 是否是密码类型 |
+| placeholder | string | "" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框为空时占位符 |
+| placeholder-style | string | "" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 指定 placeholder 的样式 |
+| placeholder-class | string(string.ClassString) | "" | Web x / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 指定 placeholder 的样式类 |
+| maxlength | string \| number | -1 | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 最大输入长度，0和正数为合法值，非法值的时候不限制最大长度 |
+| cursor-spacing | number | 0 | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS x（部分支持，见上） | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 |
+| cursor-color | string(string.ColorString) | "" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 指定光标颜色 |
+| auto-focus | boolean | false | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 自动获取焦点，与`focus`属性对比，此属性只会首次生效。 |
+| focus | boolean | false | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 获取焦点 |
+| confirm-type | string | "done" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 设置键盘右下角按钮的文字，仅在 type为text 时生效。 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| send | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 发送 |
-| search | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 搜索 |
-| next | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 下一个 |
-| go | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 前往 |
-| done | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11（部分支持，见上） | 完成 |
-| confirm-hold | boolean | false | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 点击键盘右下角按钮时是否保持键盘不收起 |
-| cursor | number | -1 | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 指定focus时的光标位置 |
-| selection-start | number | -1 | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
-| selection-end | number | -1 | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 光标结束位置，自动聚集时有效，需与selection-start搭配使用 |
-| adjust-position | boolean | true | Web x / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 键盘弹起时，是否自动上推页面 |
-| ~~inputmode~~ | none \| text \| decimal \| numeric \| tel \| search \| email \| url | "text" | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是一个枚举属性，它提供了用户在编辑元素或其内容时可能输入的数据类型的提示。在符合条件的高版本webview里，uni-app的 web 和 app-vue 平台中可使用本属性。(自 5.0+ 废弃，推荐使用 type，同时配置以 inputmode 为准) |
-| 合法值 | 兼容性 | 描述 |
-| :- |  :-: | :- |
-| none | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 无虚拟键盘。在应用程序或者站点需要实现自己的键盘输入控件时很有用。 |
-| text | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 使用用户本地区域设置的标准文本输入键盘。 |
-| decimal | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 小数输入键盘，包含数字和分隔符（通常是“ . ”或者“ , ”），设备可能也可能不显示减号键。 |
-| numeric | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 数字输入键盘，所需要的就是 0 到 9 的数字，设备可能也可能不显示减号键。 |
-| tel | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 电话输入键盘，包含 0 到 9 的数字、星号（*）和井号（#）键。表单输入里面的电话输入通常应该使用 \<input type="tel"\> 。 |
-| search | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 为搜索输入优化的虚拟键盘，比如，返回键可能被重新标记为“搜索”，也可能还有其他的优化。 |
-| email | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 为邮件地址输入优化的虚拟键盘，通常包含"@"符号和其他优化。表单里面的邮件地址输入应该使用 \<input type="email"\> 。 |
-| url | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 为网址输入优化的虚拟键盘，比如，“/”键会更加明显、历史记录访问等。表单里面的网址输入通常应该使用 \<input type="url"\> 。 |
-| text-content-type | string |   | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 文本区域的语义，根据类型自动填充 |
+| send | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 发送 |
+| search | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11（部分支持，见上） | 搜索 |
+| next | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11（部分支持，见上） | 下一个 |
+| go | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11（部分支持，见上） | 前往 |
+| done | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11（部分支持，见上） | 完成 |
+| confirm-hold | boolean | false | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 点击键盘右下角按钮时是否保持键盘不收起 |
+| cursor | number | -1 | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 指定focus时的光标位置 |
+| selection-start | number | -1 | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 光标起始位置，自动聚集时有效，需与selection-end搭配使用 |
+| selection-end | number | -1 | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 光标结束位置，自动聚集时有效，需与selection-start搭配使用 |
+| adjust-position | boolean | true | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 键盘弹起时，是否自动上推页面 |
+| text-content-type | string |   | Web x / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 文本区域的语义，根据类型自动填充 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
 | oneTimeCode | Web x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 一次性验证码 |
-| hold-keyboard | boolean | false | Web x / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | focus时，点击页面的时候不收起键盘 |
-| safe-password-cert-path | string |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘加密公钥的路径，只支持包内路径 |
-| safe-password-length | number |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘输入密码长度 |
-| safe-password-time-stamp | number |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘加密时间戳 |
-| safe-password-nonce | string |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘加密盐值 |
-| safe-password-salt | string |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘计算 hash 盐值，若指定custom-hash 则无效 |
-| safe-password-custom-hash | string |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘计算 hash 的算法表达式 |
-| random-number | boolean |   | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 当 type 为 number, digit, idcard 数字键盘是否随机排列 |
-| controlled | boolean |   | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 是否为受控组件。为 true 时，value 内容会完全受 setData 控制 |
-| always-system | boolean |   | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 是否强制使用系统键盘和 Web-view 创建的 input 元素。为 true 时，confirm-type、confirm-hold 可能失效 |
-| always-embed | boolean |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 强制 input 处于同层状态，默认 focus 时 input 会切到非同层状态 (仅在 iOS 下生效) |
-| @input | (event: [UniInputEvent](#uniinputevent)) => void |   | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |
-| @focus | (event: [UniInputFocusEvent](#uniinputfocusevent)) => void |   | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度 |
-| @blur | (event: [UniInputBlurEvent](#uniinputblurevent)) => void |   | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框失去焦点时触发，event.detail = {value: value} |
-| @keyboardheightchange | (event: [UniInputKeyboardHeightChangeEvent](#uniinputkeyboardheightchangeevent)) => void |   | Web x / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
-| @change | (event: [UniInputChangeEvent](#uniinputchangeevent)) => void |   | Web x / 微信小程序 4.41 / Android 4.73 / iOS 4.73 / HarmonyOS 4.73（部分支持，见上） | 非聚焦状态内容改变时触发（仅组件失去焦点时且用户输入改变内容才触发），event.detail = {value: value} |
-| @confirm | (event: [UniInputConfirmEvent](#uniinputconfirmevent)) => void |   | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 点击完成按钮时触发，event.detail = {value: value} |
-| @nicknamereview | eventhandle |   | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(eventhandle)*<br/>用户昵称审核完毕后触发，仅在 type 为 "nickname" 时有效，event.detail = { pass, timeout } |
+| hold-keyboard | boolean | false | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | focus时，点击页面的时候不收起键盘 |
+| safe-password-cert-path | string |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘加密公钥的路径，只支持包内路径 |
+| safe-password-length | number |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘输入密码长度 |
+| safe-password-time-stamp | number |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘加密时间戳 |
+| safe-password-nonce | string |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘加密盐值 |
+| safe-password-salt | string |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘计算 hash 盐值，若指定custom-hash 则无效 |
+| safe-password-custom-hash | string |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 安全键盘计算 hash 的算法表达式 |
+| random-number | boolean |   | Web x / 微信小程序 x / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 当 type 为 number, digit, idcard 数字键盘是否随机排列 |
+| controlled | boolean |   | Web x / 微信小程序 x / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否为受控组件。为 true 时，value 内容会完全受 setData 控制 |
+| always-system | boolean |   | Web x / 微信小程序 x / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否强制使用系统键盘和 Web-view 创建的 input 元素。为 true 时，confirm-type、confirm-hold 可能失效 |
+| always-embed | boolean |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 强制 input 处于同层状态，默认 focus 时 input 会切到非同层状态 (仅在 iOS 下生效) |
+| @input | (event: [UniInputEvent](#uniinputevent)) => void |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。 |
+| @focus | (event: [UniInputFocusEvent](#uniinputfocusevent)) => void |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度 |
+| @blur | (event: [UniInputBlurEvent](#uniinputblurevent)) => void |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 输入框失去焦点时触发，event.detail = {value: value} |
+| @keyboardheightchange | (event: [UniInputKeyboardHeightChangeEvent](#uniinputkeyboardheightchangeevent)) => void |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration} |
+| @change | (event: [UniInputChangeEvent](#uniinputchangeevent)) => void |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android 4.73 / iOS 4.73 / HarmonyOS 4.73（部分支持，见上） | 非聚焦状态内容改变时触发（仅组件失去焦点时且用户输入改变内容才触发），event.detail = {value: value} |
+| @confirm | (event: [UniInputConfirmEvent](#uniinputconfirmevent)) => void |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 点击完成按钮时触发，event.detail = {value: value} |
+| @nicknamereview | eventhandle |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(eventhandle)*<br/>用户昵称审核完毕后触发，仅在 type 为 "nickname" 时有效，event.detail = { pass, timeout } |
 | @update:value | Event |   |   |   |
+| ~~inputmode~~ | none \| text \| decimal \| numeric \| tel \| search \| email \| url | "text" | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是一个枚举属性，它提供了用户在编辑元素或其内容时可能输入的数据类型的提示。在符合条件的高版本webview里，uni-app的 web 和 app-vue 平台中可使用本属性。(自 5.0+ 废弃，推荐使用 type，同时配置以 inputmode 为准) |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| none | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 无虚拟键盘。在应用程序或者站点需要实现自己的键盘输入控件时很有用。 |
+| text | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 使用用户本地区域设置的标准文本输入键盘。 |
+| decimal | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 小数输入键盘，包含数字和分隔符（通常是“ . ”或者“ , ”），设备可能也可能不显示减号键。 |
+| numeric | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 数字输入键盘，所需要的就是 0 到 9 的数字，设备可能也可能不显示减号键。 |
+| tel | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 电话输入键盘，包含 0 到 9 的数字、星号（*）和井号（#）键。表单输入里面的电话输入通常应该使用 \<input type="tel"\> 。 |
+| search | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 为搜索输入优化的虚拟键盘，比如，返回键可能被重新标记为“搜索”，也可能还有其他的优化。 |
+| email | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 为邮件地址输入优化的虚拟键盘，通常包含"@"符号和其他优化。表单里面的邮件地址输入应该使用 \<input type="email"\> 。 |
+| url | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 为网址输入优化的虚拟键盘，比如，“/”键会更加明显、历史记录访问等。表单里面的网址输入通常应该使用 \<input type="url"\> 。 |
 
 ### 事件
 #### UniInputEvent
@@ -255,11 +255,8 @@ if (view != null && view instanceof UITextField) {
 >示例
 ```vue
 <template>
-  
-  <scroll-view class="uni-theme-root" style="flex: 1">
-  
     <page-head :title="data.title"></page-head>
-    <view class="input-page uni-common-mt uni-padding-wrap uni-theme-root" style="padding-bottom: 30px;">
+    <view class="input-page uni-common-mt uni-padding-wrap" style="padding-bottom: 30px;">
       <view>
         <view class="uni-title">
           <text class="uni-title-text">设置输入框的初始内容</text>
@@ -286,10 +283,12 @@ if (view != null && view instanceof UITextField) {
         <view class="input-wrapper">
           <input id="uni-input-type-digit" class="uni-input" type="digit" placeholder="带小数点的数字输入键盘" />
         </view>
+        
         <view class="input-wrapper">
           <input id="uni-input-type-tel" class="uni-input" :type="data.inputTypeTel" placeholder="电话输入键盘" />
         </view>
         
+        
         <view class="input-wrapper">
           <input id="uni-input-type-search" class="uni-input" type="search" placeholder="搜索输入键盘" />
         </view>
@@ -372,6 +371,7 @@ if (view != null && view instanceof UITextField) {
         </view>
       </view>
 
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">设置光标与键盘的距离</text>
@@ -380,6 +380,7 @@ if (view != null && view instanceof UITextField) {
           <input class="uni-input" :cursor-spacing="1000" placeholder="光标与键盘的距离为1000px" />
         </view>
       </view>
+      
 
       <view>
         <view class="uni-title">
@@ -391,6 +392,7 @@ if (view != null && view instanceof UITextField) {
         </view>
       </view>
 
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">confirm-type取值（不同输入法表现可能不一致）</text>
@@ -411,7 +413,9 @@ if (view != null && view instanceof UITextField) {
           <input id="uni-input-confirm-done" class="uni-input" confirmType="done" placeholder="键盘右下角按钮显示为完成" />
         </view>
       </view>
+      
 
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">点击键盘右下角按钮时保持键盘不收起</text>
@@ -420,6 +424,7 @@ if (view != null && view instanceof UITextField) {
           <input class="uni-input" :confirm-hold="true" />
         </view>
       </view>
+      
 
       <view>
         <view class="uni-title" @click="setCursor(4)">
@@ -430,6 +435,7 @@ if (view != null && view instanceof UITextField) {
         </view>
       </view>
 
+      
       <view>
         <view class="uni-title" @click="setSelection(0, 4)">
           <text class="uni-title-text">设置输入框聚焦时光标的起始位置和结束位置（点这里）</text>
@@ -439,15 +445,19 @@ if (view != null && view instanceof UITextField) {
             :selection-end="data.selectionEnd" :focus="data.selectionInputFocus" @blur="onSelectionBlurChange" />
         </view>
       </view>
+      
 
-      <view>
-        <boolean-data :defaultValue="data.cursor_color == '#FF0000'" title="设置光标颜色为红色（Android的微信小程序非skyline下仅支持黑和绿）"
-          @change="changeCursorColor"></boolean-data>
+      
+      <view>
+        <boolean-data :value="data.cursor_color == '#FF0000'" title="设置光标颜色为红色（Android的微信小程序非skyline下仅支持黑和绿）"
+          @change="changeCursorColor"></boolean-data>
         <view class="input-wrapper">
           <input id="uni-input-cursor-color" class="uni-input" :cursor-color="data.cursor_color" :focus="data.cursorColorInputFocus" @blur="cursorColorInputBlur" value="光标颜色" />
         </view>
       </view>
+      
 
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">键盘弹起时，自动上推页面</text>
@@ -456,14 +466,17 @@ if (view != null && view instanceof UITextField) {
           <input class="uni-input" :adjust-position="true" />
         </view>
       </view>
+      
 
-      <view>
-        <boolean-data :defaultValue="data.holdKeyboard" title="设置hold-keyboard"
-          @change="changeHoldKeyboard"></boolean-data>
+      
+      <view>
+        <boolean-data :value="data.holdKeyboard" title="设置hold-keyboard"
+          @change="changeHoldKeyboard"></boolean-data>
         <view class="input-wrapper">
           <input class="uni-input" :hold-keyboard="data.holdKeyboard" value="hold keyboard " />
         </view>
       </view>
+      
 
       <view>
         <view class="uni-title">
@@ -510,6 +523,7 @@ if (view != null && view instanceof UITextField) {
         </view>
       </view>
 
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">change事件</text>
@@ -521,6 +535,7 @@ if (view != null && view instanceof UITextField) {
           <input class="uni-input" @change="onChange" />
         </view>
       </view>
+      
 
       <view>
         <view class="uni-title">
@@ -555,6 +570,7 @@ if (view != null && view instanceof UITextField) {
         </view>
       </view>
 
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">同时存在 v-model 和 change事件</text>
@@ -563,14 +579,17 @@ if (view != null && view instanceof UITextField) {
           <input class="uni-input" v-model="data.demoValue2" value="123" @change="onChange" />
         </view>
       </view>
+      
 
-      <view>
-        <boolean-data :defaultValue="data.adjustPosition" title="设置adjust-position"
-          @change="changeAdjustPosition"></boolean-data>
+      
+      <view>
+        <boolean-data :value="data.adjustPosition" title="设置adjust-position"
+          @change="changeAdjustPosition"></boolean-data>
         <view class="input-wrapper">
           <input class="uni-input" :adjust-position="data.adjustPosition" />
         </view>
       </view>
+      
 
       <view>
         <view class="uni-title">
@@ -591,15 +610,17 @@ if (view != null && view instanceof UITextField) {
         </view>
       </view>
 
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">focus时type是none，键盘是否弹出</text>
-          <boolean-data :defaultValue="false" title="显示<input />示例" @change="changeCheckedTypeNoneAndFocusCase"></boolean-data>
+          <boolean-data :value="false" title="显示<input />示例" @change="changeCheckedTypeNoneAndFocusCase"></boolean-data>
         </view>
         <view v-if="data.showTypeNoneAndFocusCase" class="input-wrapper">
           <input class="uni-input" focus="true" type="none"/>
         </view>
       </view>
+      
 
       <view>
         <view class="uni-title">
@@ -666,6 +687,7 @@ if (view != null && view instanceof UITextField) {
       </view>
 
       
+      
       <view>
         <view class="uni-title">
           <text class="uni-title-text">keyboardheightchange事件</text>
@@ -687,6 +709,8 @@ if (view != null && view instanceof UITextField) {
         </view>
       </view>
 
+      
+
       <text class="uni-title-text">input样式大合集</text>
       <view class="input-wrap">
         <input class="input-all-styles" value="样式效果：文本颜色深蓝色、字号16px、字重400、文本居左对齐；外边距10px、内边距10px；圆角8px；浅蓝色渐变背景、蓝色边框、透明度70%、阴影效果。" />
@@ -719,9 +743,6 @@ if (view != null && view instanceof UITextField) {
         </navigator>
       
     </view>
-  
-  </scroll-view>
-  
 </template>
 
 
@@ -884,6 +905,8 @@ web平台的inputmode的浏览器兼容性如下： Chrome >= 66、Edge >= 79、
 - placeholder-style的`font-size`样式不支持rpx单位。
 
 ## Tips
+- 支付宝小程序二级页面设置 `focus` 为 `true` 时不会自动聚焦
+- 支付宝小程序 `type="number"` 且 `maxlength="-1"` 时不会触发 `input` 事件，也不能通过 CSS 修改光标颜色
 - html规范中input不仅是输入框，还有radio、checkbox、时间、日期、文件选择功能。但在uni-app规范中，input仅仅是输入框，其type属性代表不同的输入框。其他功能有单独的组件或API：[radio组件](radio-group.md)、[checkbox组件](checkbox-group.md)、[图片选择](../api/choose-image.md)、[视频选择](../api/choose-video.md)等。
 - input组件默认 width （宽度）为 100%。
 - 从uni-app x 4.0起，App-Android平台 input 点击输入框外的屏幕会自动收起软键盘。

package/data/uniappx/component/keyboard-accessory.md

@@ -2,9 +2,9 @@
 ## keyboard-accessory
 
 ### 兼容性 
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=component.wx.other.keyboard-accessory)

package/data/uniappx/component/label.md

@@ -1,20 +1,24 @@
 ::: sourceCode
 ## label
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/label
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/label
+
 用来改进表单组件的可用性，使用for属性找到对应的id，或者将控件放在该标签下，当点击时，就会触发对应的控件
 
 ### 兼容性 
-| Web | 微信小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
-| :- | :- | :- | :- | :- | :- | :- |
-| 4.0 | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.21 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.11 | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
+| :- | :- | :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 5.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.21 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.11 | 4.71 |
 
 App平台可以用view加事件来替代label。
 
 ### 属性 
 | 名称 | 类型 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| disabled | boolean | false | Web 4.0 / 微信小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS 4.71（部分支持，见上） | 是否禁用 |
-| for | string |   | Web 4.0 / 微信小程序 4.41 / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS 4.71（部分支持，见上） | 绑定控件的 id |
+| disabled | boolean | false | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS 4.71（部分支持，见上） | 是否禁用 |
+| for | string |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS 4.71（部分支持，见上） | 绑定控件的 id |
 
 ### 示例
 示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/component/label/label.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/component/label/label.uvue) 
@@ -25,7 +29,7 @@ App平台可以用view加事件来替代label。
 >示例
 ```vue
 <template>
-  <view class="label-page uni-theme-root">
+  <view class="label-page">
     <page-head :title="data.title"></page-head>
     <view class="uni-common-mt">
       <view class="uni-form-item uni-column">
@@ -75,19 +79,19 @@ App平台可以用view加事件来替代label。
       </view>
     </view>
 
-    
-      <navigator class="uni-common-mb" url="/pages/template/label-100/label-100">
-        <button>组件性能测试</button>
-      </navigator>
-    
-  </view>
-</template>
+    
+      <navigator class="uni-common-mb" url="/pages/template/label-100/label-100">
+        <button>组件性能测试</button>
+      </navigator>
+    
+  </view>
+</template>
 
 
 <style>
-  .uni-list-cell {
-    justify-content: flex-start;
-    color: var(--text-color, #333333);
+  .uni-list-cell {
+    justify-content: flex-start;
+    color: var(--text-color, #333333);
   }
 
   .label-3 {

package/data/uniappx/component/list-builder.md

@@ -2,24 +2,24 @@
 ## list-builder
 
 ### 兼容性 
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
 
 ### 属性 
 | 名称 | 类型 | 兼容性 | 描述 |
 | :- | :- |  :-: | :- |
-| padding | Array | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>长度为 4 的数组，按 top、right、bottom、left 顺序指定内边距 |
-| type | string | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(string)*<br/>类型，默认为定高模式 |
+| padding | Array | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>长度为 4 的数组，按 top、right、bottom、left 顺序指定内边距 |
+| type | string | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(string)*<br/>类型，默认为定高模式 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| static | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 定高模式，所有列表项等高，需要传入 child-height |
-| dynamic | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 不定高模式 |
-| list | Array | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>需要用于渲染的列表 |
-| child-count | Array | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>完整列表的长度，如果不传则取 list 的长度作为其值 |
-| child-height | Array | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>列表项的高度，当 type 为 static 时必须传入 |
-| @itembuild | eventhandle | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(eventhandle)*<br/>列表项创建时触发，event.detail = {index}，index 即被创建的列表项序号 |
-| @itemdispose | eventhandle | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(eventhandle)*<br/>列表项回收时触发，event.detail = {index}，index 即被回收的列表项序号 |
+| static | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 定高模式，所有列表项等高，需要传入 child-height |
+| dynamic | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 不定高模式 |
+| list | Array | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>需要用于渲染的列表 |
+| child-count | Array | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>完整列表的长度，如果不传则取 list 的长度作为其值 |
+| child-height | Array | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(Array)*<br/>列表项的高度，当 type 为 static 时必须传入 |
+| @itembuild | eventhandle | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(eventhandle)*<br/>列表项创建时触发，event.detail = {index}，index 即被创建的列表项序号 |
+| @itemdispose | eventhandle | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(eventhandle)*<br/>列表项回收时触发，event.detail = {index}，index 即被回收的列表项序号 |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=component.wx.skyline.list-builder)