npm - tmui-cli - Versions diffs - 2.0.6 → 5.3.2 - Mend

tmui-cli 2.0.6 → 5.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (630) hide show

package/data/uniappx/vue/built-in.md CHANGED Viewed

@@ -4,21 +4,21 @@
 |  | 兼容性 |
 | :- | :- |
-| v-text | Web 4.0 / 微信小程序 √ / Android x / iOS x / HarmonyOS x（部分支持，见上） |
-| v-html | Web 4.0 / 微信小程序 x / Android(VDOM) 3.99 / Android(Vapor) x / iOS x / HarmonyOS x（部分支持，见上） |
-| v-show | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-if | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-else | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-else-if | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-for | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-on | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-bind | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-model | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-slot | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
-| v-pre | Web 4.0 / 微信小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
-| v-once | Web x / 微信小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
-| v-memo | Web x / 微信小程序 x / Android(VDOM) 3.99 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） |
-| v-cloak | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
+| v-text | Web 4.0 / 微信小程序 √ / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
+| v-html | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android(VDOM) 3.99 / Android(Vapor) x / iOS x / HarmonyOS x（部分支持，见上） |
+| v-show | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-if | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-else | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-else-if | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-for | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-on | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-bind | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-model | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-slot | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| v-pre | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| v-once | Web x / 微信小程序 x / 支付宝小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| v-memo | Web x / 微信小程序 x / 支付宝小程序 x / Android(VDOM) 3.99 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） |
+| v-cloak | Web x / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
 ### v-text
@@ -74,7 +74,7 @@
 更新元素的内容，并且不会被解析。
 ::: warning 注意
-在 `App-android` 平台，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式。\
+在 `App-android VDOM 模式`，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式。\
 同时，受限于 `rich-text` 组件不支持 `class` 样式，`v-html` 指令中同样不支持 `class` 样式。\
 绑定 `v-html` 的标签内的内容会被忽略，`v-html` 指令的内容会编译为 `rich-text` 组件渲染为该标签的子节点。
@@ -399,7 +399,7 @@
 基于原始数据多次渲染元素或模板块。
-- 期望的绑定值类型：`Array | UTSJSONObject | number | string | Iterable`
+- 期望的绑定值类型：`Array | Object/UTSJSONObject | number | string | Iterable`
 - 详细信息
@@ -1262,7 +1262,8 @@
   当组件的 `selected` 状态改变，默认会重新创建大量的 vnode，尽管绝大部分都跟之前是一模一样的。`v-memo` 用在这里本质上是在说“只有当该项的被选中状态改变时才需要更新”。这使得每个选中状态没有变的项能完全重用之前的 vnode 并跳过差异比较。注意这里 memo 依赖数组中并不需要包含 `item.id`，因为 Vue 也会根据 item 的 `:key` 进行判断。
   ::: warning 警告
-  当搭配 `v-for` 使用 `v-memo`，确保两者都绑定在同一个元素上。`v-memo` 不能用在 `v-for` 内部。
+  - 当搭配 `v-for` 使用 `v-memo`，确保两者都绑定在同一个元素上。`v-memo` 不能用在 `v-for` 内部。
+  - `v-memo` 的作用是在 VDOM 模式下缓存虚拟 DOM 子树，在依赖未变化时跳过 vnode 创建和虚拟 DOM diff。蒸汽模式去除了虚拟 DOM，不会创建 vnode，也不需要进行虚拟 DOM diff，因此不支持且不需要使用 `v-memo`。
   `v-memo` 也能被用于在一些默认优化失败的边际情况下，手动避免子组件出现不需要的更新。但是一样的，开发者需要负责指定正确的依赖数组以免跳过必要的更新。
@@ -1359,9 +1360,6 @@
 - [监听页面生命周期](../component/README.md#监听页面生命周期)
 - [vue 与 uvue 不同文件后缀的优先级](../component/README.md#priority)
-::: warning 注意
-- App 端，如需页面级滚动，根节点必须是 `scroll-view` 标签。
 ### \<KeepAlive> @keep-alive
 > 组件类型：string
@@ -1369,16 +1367,16 @@
  \<keep-alive> 包裹动态组件时，会缓存不活动的组件实例，而不是销毁它们。和 \<transition> 相似，\<keep-alive> 是一个抽象组件：它自身不会渲染一个 DOM 元素，也不会出现在父组件链中。
 ##### 兼容性
-| Web | 微信小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
-| :- | :- | :- | :- | :- | :- | :- | :- |
-| 4.0 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.0 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.11 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.61 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
+| Web | 微信小程序 | 支付宝小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
+| :- | :- | :- | :- | :- | :- | :- | :- | :- |
+| 4.0 | <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> | 4.0 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.11 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.61 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
 ##### 属性
 | 名称 | 类型 | 兼容性 | 描述 |
 | :- | :- |  :-: | :- |
-| include | string | Web 4.0 / 微信小程序 x / Android(VDOM) 4.0 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） | 字符串或正则表达式。只有名称匹配的组件会被缓存。 |
-| exclude | string | Web 4.0 / 微信小程序 x / Android(VDOM) 4.0 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） | 字符串或正则表达式。任何名称匹配的组件都不会被缓存。 |
-| max | string | Web 4.0 / 微信小程序 x / Android(VDOM) 4.0 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） | 最多可以缓存多少组件实例。 |
+| include | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android(VDOM) 4.0 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） | 字符串或正则表达式。只有名称匹配的组件会被缓存。 |
+| exclude | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android(VDOM) 4.0 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） | 字符串或正则表达式。任何名称匹配的组件都不会被缓存。 |
+| max | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android(VDOM) 4.0 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） | 最多可以缓存多少组件实例。 |
 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/built-in/component/keep-alive/keep-alive-composition.uvue)
@@ -1494,47 +1492,47 @@
  \<transition> 元素作为单个元素/组件的过渡效果。\<transition> 只会把过渡效果应用到其包裹的内容上，而不会额外渲染 DOM 元素，也不会出现在检测过的组件层级中。
 ##### 兼容性
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | <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> |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | <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> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
 ##### 属性
 | 名称 | 类型 | 兼容性 | 描述 |
 | :- | :- |  :-: | :- |
-| name | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 用于自动生成 CSS 过渡类名。例如：name: 'fade' 将自动拓展为.fade-enter，.fade-enter-active等。默认类名为 "v" |
-| appear | boolean | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否在初始渲染时使用过渡。默认为 false。 |
-| css | boolean | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否使用 CSS 过渡类。默认为 true。如果设置为 false，将只通过组件事件触发注册的 JavaScript 钩子。 |
-| type | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡事件类型，侦听过渡何时结束。有效值为 "transition" 和 "animation"。默认 Vue.js 将自动检测出持续时间长的为过渡事件类型。 |
+| name | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 用于自动生成 CSS 过渡类名。例如：name: 'fade' 将自动拓展为.fade-enter，.fade-enter-active等。默认类名为 "v" |
+| appear | boolean | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否在初始渲染时使用过渡。默认为 false。 |
+| css | boolean | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否使用 CSS 过渡类。默认为 true。如果设置为 false，将只通过组件事件触发注册的 JavaScript 钩子。 |
+| type | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡事件类型，侦听过渡何时结束。有效值为 "transition" 和 "animation"。默认 Vue.js 将自动检测出持续时间长的为过渡事件类型。 |
 | 合法值 |
 | :- |
 | transition |
 | animation |
-| mode | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 控制离开/进入的过渡时间序列。有效的模式有 "out-in" 和 "in-out"；默认同时生效。 |
+| mode | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 控制离开/进入的过渡时间序列。有效的模式有 "out-in" 和 "in-out"；默认同时生效。 |
 | 合法值 |
 | :- |
 | out-in |
 | in-out |
-| duration | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡的持续时间。默认情况下，Vue 会等待过渡所在根元素的第一个 transitionend 或 animationend 事件。 |
-| enter-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| leave-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| appear-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| enter-to-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| leave-to-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| appear-to-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| enter-active-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| leave-active-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| appear-active-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @before-enter | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @before-leave | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @before-appear | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @enter | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @leave | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @appear | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @after-enter | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @after-leave | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @after-appear | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @enter-cancelled | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @leave-cancelled | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | v-show only |
+| duration | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡的持续时间。默认情况下，Vue 会等待过渡所在根元素的第一个 transitionend 或 animationend 事件。 |
+| enter-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| leave-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| appear-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| enter-to-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| leave-to-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| appear-to-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| enter-active-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| leave-active-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| appear-active-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @before-enter | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @before-leave | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @before-appear | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @enter | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @leave | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @appear | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @after-enter | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @after-leave | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @after-appear | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @enter-cancelled | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @leave-cancelled | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | v-show only |
 | @appear-cancelled | Any |   |   |
 ##### 参见
@@ -1547,46 +1545,46 @@
  \<transition-group> 元素作为多个元素/组件的过渡效果。\<transition-group> 渲染一个真实的 DOM 元素。默认渲染 \<span>，可以通过 tag 属性配置哪个元素应该被渲染。
 ##### 兼容性
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | <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> |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | <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> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
 ##### 属性
 | 名称 | 类型 | 兼容性 | 描述 |
 | :- | :- |  :-: | :- |
-| tag | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 默认为 span。 |
-| move-class | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 覆盖移动过渡期间应用的 CSS 类。 |
-| name | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 用于自动生成 CSS 过渡类名。例如：name: 'fade' 将自动拓展为.fade-enter，.fade-enter-active等。默认类名为 "v" |
-| appear | boolean | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否在初始渲染时使用过渡。默认为 false。 |
-| css | boolean | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否使用 CSS 过渡类。默认为 true。如果设置为 false，将只通过组件事件触发注册的 JavaScript 钩子。 |
-| type | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡事件类型，侦听过渡何时结束。有效值为 "transition" 和 "animation"。默认 Vue.js 将自动检测出持续时间长的为过渡事件类型。 |
+| tag | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 默认为 span。 |
+| move-class | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 覆盖移动过渡期间应用的 CSS 类。 |
+| name | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 用于自动生成 CSS 过渡类名。例如：name: 'fade' 将自动拓展为.fade-enter，.fade-enter-active等。默认类名为 "v" |
+| appear | boolean | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否在初始渲染时使用过渡。默认为 false。 |
+| css | boolean | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 是否使用 CSS 过渡类。默认为 true。如果设置为 false，将只通过组件事件触发注册的 JavaScript 钩子。 |
+| type | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡事件类型，侦听过渡何时结束。有效值为 "transition" 和 "animation"。默认 Vue.js 将自动检测出持续时间长的为过渡事件类型。 |
 | 合法值 |
 | :- |
 | transition |
 | animation |
 | mode | Any |   |   |
-| duration | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡的持续时间。默认情况下，Vue 会等待过渡所在根元素的第一个 transitionend 或 animationend 事件。 |
-| enter-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| leave-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| appear-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| enter-to-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| leave-to-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| appear-to-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| enter-active-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| leave-active-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| appear-active-class | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @before-enter | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @before-leave | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @before-appear | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @enter | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @leave | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @appear | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @after-enter | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @after-leave | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @after-appear | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @enter-cancelled | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
-| @leave-cancelled | string | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | v-show only |
-| @appear-cancelled | Any | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| duration | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 指定过渡的持续时间。默认情况下，Vue 会等待过渡所在根元素的第一个 transitionend 或 animationend 事件。 |
+| enter-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| leave-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| appear-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| enter-to-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| leave-to-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| appear-to-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| enter-active-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| leave-active-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| appear-active-class | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @before-enter | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @before-leave | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @before-appear | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @enter | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @leave | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @appear | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @after-enter | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @after-leave | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @after-appear | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @enter-cancelled | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
+| @leave-cancelled | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | v-show only |
+| @appear-cancelled | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |   |
 ##### 参见
 - [Reference](https://v3.cn.vuejs.org/api/built-in-components.html#transition-group)
@@ -1598,15 +1596,15 @@
  Teleport 提供了一种干净的方法，允许我们控制在 DOM 中哪个父节点下呈现 HTML，而不必求助于全局状态或将其拆分为两个组件。
 ##### 兼容性
-| Web | 微信小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
-| :- | :- | :- | :- | :- | :- | :- | :- |
-| 4.0 | 5.14 | 4.0 | 5.25 | 4.11 | 5.25 | 4.61 | 5.25 |
+| Web | 微信小程序 | 支付宝小程序 | Android(VDOM) | Android(Vapor) | iOS(VDOM) | iOS(Vapor) | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
+| :- | :- | :- | :- | :- | :- | :- | :- | :- |
+| 4.0 | 5.14 | 5.31 | 4.0 | 5.25 | 4.11 | 5.25 | 4.61 | 5.25 |
 ##### 属性
 | 名称 | 类型 | 兼容性 | 描述 |
 | :- | :- |  :-: | :- |
-| to | string | Web 4.0 / 微信小程序 x / Android(VDOM) 4.0 / Android(Vapor) 5.25 / iOS(VDOM) 4.11 / iOS(Vapor) 5.25 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.25（部分支持，见上） | 必须是有效的查询选择器或 HTMLElement (如果在浏览器环境中使用)。指定将在其中移动 \<teleport> 内容的目标元素 |
-| disabled | boolean | Web 4.0 / 微信小程序 5.14 / Android(VDOM) 4.0 / Android(Vapor) 5.25 / iOS(VDOM) 4.11 / iOS(Vapor) 5.25 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.25 | 此可选属性可用于禁用 \<teleport> 的功能，这意味着其插槽内容将不会移动到任何位置，而是在您在周围父组件中指定了 \<teleport> 的位置渲染。 |
+| to | string | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android(VDOM) 4.0 / Android(Vapor) 5.25 / iOS(VDOM) 4.11 / iOS(Vapor) 5.25 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.25（部分支持，见上） | 必须是有效的查询选择器或 HTMLElement (如果在浏览器环境中使用)。指定将在其中移动 \<teleport> 内容的目标元素 |
+| disabled | boolean | Web 4.0 / 微信小程序 5.14 / 支付宝小程序 5.31 / Android(VDOM) 4.0 / Android(Vapor) 5.25 / iOS(VDOM) 4.11 / iOS(Vapor) 5.25 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.25 | 此可选属性可用于禁用 \<teleport> 的功能，这意味着其插槽内容将不会移动到任何位置，而是在您在周围父组件中指定了 \<teleport> 的位置渲染。 |
 **VDOM模式注意事项**
@@ -1746,9 +1744,9 @@
  当我们想要使用内置指令而不在 DOM 中渲染元素时，\<template> 标签可以作为占位符使用。
 ##### 兼容性
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | √ | 3.9 | 4.11 | 4.61 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | √ | 5.31 | 3.9 | 4.11 | 4.61 |
 `<template>` 有2个用途：
 1. 作为单文件组件规范的模板根节点。在 `<template>` 下面放置页面模板真正的组件内容。
@@ -1785,11 +1783,11 @@
 ##### 属性
 | 名称 | 类型 | 兼容性 |
 | :- | :- |  :-: |
-| lang | string | Web 4.0 / 微信小程序 √ / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
+| lang | string | Web 4.0 / 微信小程序 √ / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| html | Web 4.0 / 微信小程序 4.11 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | html |
-| pug | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | pug |
+| html | Web 4.0 / 微信小程序 4.11 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | html |
+| pug | Web x / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | pug |
 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/built-in/special-elements/template/template-composition.uvue)
@@ -1877,14 +1875,14 @@
  \<slot> 元素作为组件模板之中的内容分发插槽。\<slot> 元素自身将被替换。
 ##### 兼容性
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | 4.11 | 3.9 | 4.11 | 4.61 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.11 | 5.31 | 3.9 | 4.11 | 4.61 |
 ##### 属性
 | 名称 | 类型 | 兼容性 | 描述 |
 | :- | :- |  :-: | :- |
-| name | string | Web 4.0 / 微信小程序 √ / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 用于命名插槽。 |
+| name | string | Web 4.0 / 微信小程序 √ / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 用于命名插槽。 |
 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/built-in/special-elements/slots/slots-composition.uvue)
@@ -1942,15 +1940,15 @@
  渲染一个“元组件”为动态组件。依 is 的值，来决定哪个组件被渲染。
 ##### 兼容性
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 3.99 | 4.11 | 4.61 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | <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> | 3.99 | 4.11 | 4.61 |
 ##### 属性
 | 名称 | 类型 | 兼容性 |
 | :- | :- |  :-: |
-| is | Any | Web 4.0 / 微信小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
-| inline-template | boolean | Web 4.0 / 微信小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| is | Any | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| inline-template | boolean | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/built-in/special-elements/component/component-composition.uvue)
@@ -2008,11 +2006,11 @@
 ## 特殊 Attributes @special-attributes
-|  | Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- | :- |
-| key | 4.0 | √ | 3.9 | 4.11 | 4.61 |
-| ref | 4.0 | √ | 3.9 | 4.11 | 4.61 |
-| is | 4.0 | √ | 3.99 | 4.11 | 4.61 |
+|  | Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- | :- |
+| key | 4.0 | √ | 5.31 | 3.9 | 4.11 | 4.61 |
+| ref | 4.0 | √ | 5.31 | 3.9 | 4.11 | 4.61 |
+| is | 4.0 | √ | 5.31 | 3.99 | 4.11 | 4.61 |
 ### key
@@ -2065,8 +2063,8 @@
 <template>
   <view>
-    <input ref="input" />
-    <text v-for="item in 3" ref="textItems" :key="item">{{
+    <input id="input" ref="input" />
+    <text v-for="item in 3" :id="'text-item-' + item" ref="textItems" :key="item">{{
       item
     }}</text>
     <Foo ref="foo" />
@@ -2075,13 +2073,25 @@
 ```
 `this.$refs` 也是非响应式的，因此你不应该尝试在模板中使用它来进行数据绑定。
+对应的 `Foo` 组件（选项式 API）：
+```vue
+<template>
+  <view>
+    <text>title: {{title}}</text>
+  </view>
+</template>
+```
 使用组合式 API，引用将存储在与名字匹配的 ref 里：
 ```vue
 <template>
   <view>
-    <input ref="input" />
-    <text v-for="item in 3" ref="textItems" :key="item">{{
+    <input id="input" ref="input" />
+    <text v-for="item in 3" :id="'text-item-' + item" ref="textItems" :key="item">{{
       item
     }}</text>
     <Foo ref="foo" />
@@ -2089,6 +2099,8 @@
 </template>
 ```
+对应的 `Foo` 组件（组合式 API），通过 `defineExpose` 暴露供父组件调用的方法：
 ```vue
 <template>
@@ -2100,9 +2112,9 @@
 ```
 #### 获取内置组件与自定义组件的区别
-- 使用 `ref` 获取内置组件实例时会获取到对应的 `Element`，例如上述代码示例中，`input` 组件获取到的是 `UniInputElement`, `text` 组件获取到的是 `UniTextElement`，可以调用 `Element` 的方法和属性。
+- App、Web 使用 `ref` 获取内置组件实例时会获取到对应的 `Element`，例如上述代码示例中，`input` 组件获取到的是 `UniInputElement`, `text` 组件获取到的是 `UniTextElement`，可以调用 `Element` 的方法和属性。
 - 使用 `ref` 获取自定义组件实例时会获取到对应的 vue 组件实例，例如上述代码示例中，`Foo` 组件获取到的是 `ComponentPublicInstance`，可以获取自定义组件的属性或调用方法，[详情](./component.md#page-call-component-method)。
-- 小程序平台如果期望使用`ref`获取到`UniElement`需要在此`UniElement`上设置id，此外小程序平台的`UniElement`使用是受限的，详情参考：[UniElement](../mp/README.md#unielement)
+- 小程序平台使用 `ref` 获取内置组件引用时，需要为节点设置 `id`，`v-for` 中各节点的 `id` 应保持唯一。小程序仅支持 `UniElement`，不支持 `UniInputElement`、`UniTextElement` 等类型，且可用的属性和方法受限，详情参考：[UniElement](../mp/README.md#unielement)。
 ### is