tmui-cli 2.0.5 → 5.3.1

package/data/uniappx/vue/composition-api.md

@@ -2,8 +2,8 @@
 
 > `App.uvue` 从HBuilderX 5.0+起支持组合式 API。
 
-::: warning Android注意
-- 暂不支持 `
+::: warning 注意
+- App-Android VDOM 模式和 App 平台蒸汽模式均不支持同时使用 `
 ```
 
 - 使用 `<template ref>`
@@ -238,8 +238,7 @@ watch(
 
   若要避免深层响应式转换，只想保留对这个对象顶层次访问的响应性，请使用 [shallowReactive()](#shallowreactive) 作替代。
 
-::: warning 注意
-- `reactive` 在 App-Android VDOM 模式不支持对 class 做响应式，推荐使用 type 定义存储数据的对象类型。
+注意： `reactive` 在 App-Android VDOM 模式不支持对 class 做响应式，此时推荐使用 type 定义存储数据的对象类型。
 
 - 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/reactivity/core/reactive/reactive.uvue)
 
@@ -484,6 +483,7 @@ watch(
       margin-bottom: 10px;
     }
 </style>
+
 ```
 
 #### readonly
@@ -1177,15 +1177,15 @@ watch(
 
 |  | 兼容性 |
 | :- | :- |
-| shallowRef() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| triggerRef() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| customRef() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| shallowReactive() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| shallowReadonly() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| toRaw() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| effectScope() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| getCurrentScope() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| onScopeDispose() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
+| shallowRef() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| triggerRef() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| customRef() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| shallowReactive() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| shallowReadonly() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| toRaw() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| effectScope() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| getCurrentScope() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| onScopeDispose() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
 
 ### 示例代码 @example
 
@@ -1548,7 +1548,7 @@ watch(
 
 ::: warning 注意
 - `getCurrentInstance` 只能在 setup 或生命周期钩子中调用。
-- 在 `app` 端 `proxy` 属性可能为空，需使用 `!` 非空断言操作符。
+- 在 `app` 端 `proxy` 属性可能为空，在uts/ts等涉及类型的语言中需使用 `!` 非空断言操作符。
 
 ```uts
 
@@ -1654,12 +1654,12 @@ watch(
 
 |  | 兼容性 | 描述 |
 | :- | :- | :- |
-| onMounted() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | el 被新创建的 vm.$el 替换，并挂载到实例上去之后调用该钩子。<br/>如果 root 实例挂载了一个文档内元素，当 mounted 被调用时 vm.$el 也在文档内。 |
-| onUpdated() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | 由于数据更改导致的虚拟 DOM 重新渲染和打补丁，在这之后会调用该钩子。 |
-| onUnmounted() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | 在一个组件实例被卸载之后调用。 |
-| onBeforeMount() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | 在挂载开始之前被调用：相关的 render 函数首次被调用。 |
-| onBeforeUpdate() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | 数据更新时调用，发生在虚拟 DOM 打补丁之前。<br/>这里适合在更新之前访问现有的 DOM，比如手动移除已添加的事件监听器。 |
-| onBeforeUnmount() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | 在一个组件实例被卸载之前调用。 |
+| onMounted() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | el 被新创建的 vm.$el 替换，并挂载到实例上去之后调用该钩子。<br/>如果 root 实例挂载了一个文档内元素，当 mounted 被调用时 vm.$el 也在文档内。 |
+| onUpdated() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 由于数据更改导致的虚拟 DOM 重新渲染和打补丁，在这之后会调用该钩子。 |
+| onUnmounted() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在一个组件实例被卸载之后调用。 |
+| onBeforeMount() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在挂载开始之前被调用：相关的 render 函数首次被调用。 |
+| onBeforeUpdate() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 数据更新时调用，发生在虚拟 DOM 打补丁之前。<br/>这里适合在更新之前访问现有的 DOM，比如手动移除已添加的事件监听器。 |
+| onBeforeUnmount() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在一个组件实例被卸载之前调用。 |
 | onErrorCaptured() | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 注册一个钩子，在捕获了后代组件传递的错误时调用。 |
 | onRenderTracked() | Web x / 微信小程序 - / Android x / iOS x / HarmonyOS x（部分支持，见上） | 注册一个调试钩子，当组件渲染过程中追踪到响应式依赖时调用。 |
 | onRenderTriggered() | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 注册一个调试钩子，当响应式依赖的变更触发了组件渲染时调用。 |
@@ -1668,16 +1668,16 @@ watch(
 | onServerPrefetch() | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 注册一个异步函数，在组件实例在服务器上被渲染之前调用。<br/>如果这个钩子返回了一个 Promise，服务端渲染会在渲染该组件前等待该 Promise 完成。<br/>这个钩子仅会在服务端渲染中执行，可以用于执行一些仅存在于服务端的数据抓取过程。 |
 | onRecycle() | Web x / 微信小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.0（部分支持，见上） | 组件回收时的生命周期钩子 |
 | onReuse() | Web x / 微信小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.0（部分支持，见上） | 组件复用时的生命周期钩子 |
-| onLoad() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面加载<br/><br/>页面加载时触发。一个页面只会调用一次，可以在 onLoad 的参数中获取打开当前页面路径中的参数。 |
-| onReady() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面初次渲染完成<br/><br/>页面初次渲染完成时触发。一个页面只会调用一次，代表页面已经准备妥当，可以和视图层进行交互。<br/> |
-| onUnload() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面卸载<br/><br/>页面卸载时触发。如 `redirectTo` 或 `navigateBack` 到其他页面时。<br/> |
-| onPageShow() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面显示<br/><br/>页面显示/切入前台时触发。<br/> |
-| onPageHide() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面隐藏<br/><br/>页面隐藏/切入后台时触发。 如 `navigateTo` 或底部 `tab` 切换到其他页面，应用切入后台等。<br/> |
-| onPageScroll() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS(VDOM) 4.13 / iOS(Vapor) 5.21 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.08 | 页面滚动触发事件的处理函数<br/><br/>监听用户滑动页面事件。 |
-| onBackPress() | Web 4.0 / 微信小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 监听页面返回 |
-| onReachBottom() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.08 | 页面上拉触底事件的处理函数<br/>- 可以在 `pages.json` 的页面配置中设置触发距离 `onReachBottomDistance` 。<br/>- 在触发距离内滑动期间，本事件只会被触发一次。<br/> |
-| onPullDownRefresh() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS(VDOM) 4.11 / iOS(Vapor) 5.21 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.21 | 监听用户下拉动作<br/>- 需要在 `pages.json` 的页面配置中开启 `enablePullDownRefresh` 。<br/>- 可以通过 `uni.startPullDownRefresh` 触发下拉刷新，调用后触发下拉刷新动画，效果与用户手动下拉刷新一致。<br/>- 当处理完数据刷新后，`uni.stopPullDownRefresh` 可以停止当前页面的下拉刷新。<br/> |
-| onResize() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 页面尺寸改变时触发 |
+| onLoad() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面加载<br/><br/>页面加载时触发。一个页面只会调用一次，可以在 onLoad 的参数中获取打开当前页面路径中的参数。 |
+| onReady() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面初次渲染完成<br/><br/>页面初次渲染完成时触发。一个页面只会调用一次，代表页面已经准备妥当，可以和视图层进行交互。<br/> |
+| onUnload() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面卸载<br/><br/>页面卸载时触发。如 `redirectTo` 或 `navigateBack` 到其他页面时。<br/> |
+| onPageShow() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面显示<br/><br/>页面显示/切入前台时触发。<br/> |
+| onPageHide() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 生命周期回调 监听页面隐藏<br/><br/>页面隐藏/切入后台时触发。 如 `navigateTo` 或底部 `tab` 切换到其他页面，应用切入后台等。<br/> |
+| onPageScroll() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS(VDOM) 4.13 / iOS(Vapor) 5.21 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.08 | 页面滚动触发事件的处理函数<br/><br/>监听用户滑动页面事件。 |
+| onBackPress() | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 监听页面返回 |
+| onReachBottom() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.08 | 页面上拉触底事件的处理函数<br/>- 可以在 `pages.json` 的页面配置中设置触发距离 `onReachBottomDistance` 。<br/>- 在触发距离内滑动期间，本事件只会被触发一次。<br/> |
+| onPullDownRefresh() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS(VDOM) 4.11 / iOS(Vapor) 5.21 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.21 | 监听用户下拉动作<br/>- 需要在 `pages.json` 的页面配置中开启 `enablePullDownRefresh` 。<br/>- 可以通过 `uni.startPullDownRefresh` 触发下拉刷新，调用后触发下拉刷新动画，效果与用户手动下拉刷新一致。<br/>- 当处理完数据刷新后，`uni.stopPullDownRefresh` 可以停止当前页面的下拉刷新。<br/> |
+| onResize() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 页面尺寸改变时触发 |
 
 #### onMounted、onUnmounted 使用注意事项 @mounted-unmounted-tips
 
@@ -1726,14 +1726,14 @@ watch(
 
 |  | 兼容性 |
 | :- | :- |
-| defineProps() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| defineEmits() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| defineModel() | Web 4.11 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| defineExpose() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| defineOptions() | Web 4.11 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| defineSlots() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| useSlots() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| useAttrs() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
+| defineProps() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| defineEmits() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| defineModel() | Web 4.11 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| defineExpose() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| defineOptions() | Web 4.11 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| defineSlots() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| useSlots() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| useAttrs() | Web 4.0 / 微信小程序 4.41 / Android 4.0 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
 | useRecycleState() | Web x / 微信小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.0（部分支持，见上） |
 
 ### defineProps()
@@ -2069,6 +2069,9 @@ const props = withDefaults(defineProps<Props>(), {
 
 ### 与渲染函数一起使用
 
+::: warning 注意
+`render()` 函数仅在 `VDOM 模式`下支持。
+
 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/render-function/render/render-composition.uvue)
 
 ::: preview https://hellouvue.dcloud.net.cn/#/pages/render-function/render/render-composition

package/data/uniappx/vue/data-bind.md

@@ -8,73 +8,19 @@ vue的一大特色，就是可以定义一个响应式变量，通过模板绑
 
 响应式变量被绑定到UI界面后（template和style都可以），
 1. 在逻辑script中修改变量，UI界面会自动更新。省却再编写dom代码操作UI。
-2. 响应式变量有diff更新机制。比如对于一个大列表的UTSJSONObject数据，其中一项变更时，框架底层会自动计算diff，给UI层差量同步数据。这在大多数情况是很好的，但注意diff这个计算过程本身也会增加耗时。
+2. 响应式变量有diff更新机制。比如对于一个大列表数据，其中一项变更时，框架底层会自动计算diff，给UI层差量同步数据。这在大多数情况是很好的，但注意diff这个计算过程本身也会增加耗时。
 
 下面分别讲解各种方式的用法。
 
 ## 声明响应式状态 @declaring-reactive-state
 
-### 选项式 API @options-api
-
-选用选项式 API 时，会用 `data` 选项来声明组件的响应式状态。此选项的值应为返回一个对象的函数。Vue 将在创建新组件实例的时候调用此函数，并将函数返回的对象用响应式系统进行包装。此对象的所有顶层属性都会被代理到组件实例 (即方法和生命周期钩子中的 `this`) 上。
-
-data需要特殊类型时，通过 as 来转换。
-
-如下示例中，
-- 首先在data的return中定义了响应式变量：str、num、arr，并赋值了初始值。
-- 第2步在模板template中通过`{{}}`的方式绑定和显示在text组件的内容区中。即右边预览区显示的3行内容，显示了3个响应式变量的初始值。
-- 第3步点击按钮“update data”，触发`updateData()`，在这个方法里通过`this.`来访问响应式变量，给它们重新赋值。然后界面上3行内容会被自动更新为新值。
-
-示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/component-instance/data/data-options.uvue)
-
-::: preview https://hellouvue.dcloud.net.cn/#/pages/component-instance/data/data-options
-```vue
-<template>
-  <view class="page">
-    <view class="flex justify-between flex-row mb-10">
-      <text>str: </text>
-      <text id="str">{{ str }}</text>
-    </view>
-    <view class="flex justify-between flex-row mb-10">
-      <text>num: </text>
-      <text id="num">{{ num }}</text>
-    </view>
-    <view class="flex justify-between flex-row mb-10">
-      <text>arr: </text>
-      <text id="arr">{{ arr.join(',') }}</text>
-    </view>
-    <view class="flex justify-between flex-row mb-10">
-      <text>obj.str: </text>
-      <text id="obj-str">{{ obj.str }}</text>
-    </view>
-    <view class="flex justify-between flex-row mb-10">
-      <text>obj.num: </text>
-      <text id="obj-num">{{ obj.num }}</text>
-    </view>
-    <view class="flex justify-between flex-row mb-10">
-      <text>obj.arr: </text>
-      <text id="obj-arr">{{ obj.arr.join(',') }}</text>
-    </view>
-    <view ref='htmlRef' id="idRef" class="flex justify-between flex-row mb-10">
-      <text>data 存储 element不需要被包装</text>
-      <text id="isSameRefText">{{ refElementIsSame }}</text>
-    </view>
-
-    <button @click="updateData">update data</button>
-  </view>
-</template>
-
-```
-
-data中的响应式变量，如需在script中使用，需通过 `this.xx` 的方式，比如上述的`this.str`。
-
 ### 组合式 API @composition-api
 
 组合式 API 没有 data 这种选项，而是通过 `ref`、`reactive` 方法来声明组件的响应式状态。
 
 这种定义方式更加灵活和简洁。
 
-建议把 `ref` 定义都写在开头，否则到处都写也不好找。
+建议把 `ref` 定义都写在开头，方便统一管理。
 
 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/component-instance/data/data-composition.uvue)
 
@@ -120,13 +66,13 @@ data中的响应式变量，如需在script中使用，需通过 `this.xx` 的
 
 使用 `ref()` 函数来定义一个响应式变量。
 
-需要给 `ref` 标注类型时，可通过泛型的写法，如：`ref<string>()`， 或使用 `as` 的写法。
+需要给 `ref` 标注类型时，在uts/ts中可通过泛型的写法，如：`ref<string>()`， 或使用 `as` 的写法。
 
-当然 uts 有一定的自动推导能力，对于特别简单的布尔值/数字/字符串的字面量，不写泛型或as，也可以自动推导类型。
+当然 uts/ts 有一定的自动推导能力，对于特别简单的布尔值/数字/字符串的字面量，不写泛型或as，也可以自动推导类型。
 
 `ref()` 接收参数，并将其包裹在一个带有 `.value` 属性的 `ref` 对象中返回。这个对象，
 
-- 在 uts 中取值时，需要使用 `.value`属性。
+- ref定义的响应式变量，在script代码中取值时，需要使用 `.value`属性。
 - 而在模板中使用 ref 时，不需要附加 `.value`（为了方便起见，在模板中使用时，ref 会自动解包，这样模板里的写法和选项式保持了一致）。
 
 如下示例中，
@@ -272,6 +218,61 @@ data中的响应式变量，如需在script中使用，需通过 `this.xx` 的
 
 ```
 
+### 选项式 API @options-api
+
+选用选项式 API 时，会用 `data` 选项来声明组件的响应式状态。此选项的值应为返回一个对象的函数。
+Vue 将在创建新组件实例的时候调用此函数，并将函数返回的对象用响应式系统进行包装。此对象的所有顶层属性都会被代理到组件实例 (即方法和生命周期钩子中的 `this`) 上。
+
+data需要特殊类型时，通过 as 来转换。
+
+如下示例中，
+- 首先在data的return中定义了响应式变量：str、num、arr，并赋值了初始值。
+- 第2步在模板template中通过`{{}}`的方式绑定和显示在text组件的内容区中。即右边预览区显示的3行内容，显示了3个响应式变量的初始值。
+- 第3步点击按钮“update data”，触发`updateData()`，在这个方法里通过`this.`来访问响应式变量，给它们重新赋值。然后界面上3行内容会被自动更新为新值。
+
+示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/component-instance/data/data-options.uvue)
+
+::: preview https://hellouvue.dcloud.net.cn/#/pages/component-instance/data/data-options
+```vue
+<template>
+  <view class="page">
+    <view class="flex justify-between flex-row mb-10">
+      <text>str: </text>
+      <text id="str">{{ str }}</text>
+    </view>
+    <view class="flex justify-between flex-row mb-10">
+      <text>num: </text>
+      <text id="num">{{ num }}</text>
+    </view>
+    <view class="flex justify-between flex-row mb-10">
+      <text>arr: </text>
+      <text id="arr">{{ arr.join(',') }}</text>
+    </view>
+    <view class="flex justify-between flex-row mb-10">
+      <text>obj.str: </text>
+      <text id="obj-str">{{ obj.str }}</text>
+    </view>
+    <view class="flex justify-between flex-row mb-10">
+      <text>obj.num: </text>
+      <text id="obj-num">{{ obj.num }}</text>
+    </view>
+    <view class="flex justify-between flex-row mb-10">
+      <text>obj.arr: </text>
+      <text id="obj-arr">{{ obj.arr.join(',') }}</text>
+    </view>
+    <view ref='htmlRef' id="idRef" class="flex justify-between flex-row mb-10">
+      <text>data 存储 element不需要被包装</text>
+      <text id="isSameRefText">{{ refElementIsSame }}</text>
+    </view>
+
+    <button @click="updateData">update data</button>
+  </view>
+</template>
+
+```
+
+data中的响应式变量，如需在script中使用，需通过 `this.xx` 的方式，比如上述的`this.str`。
+
 ## 绑定变量 @bind-data
 
 ### 在模板里绑定 @bind-template-data

package/data/uniappx/vue/global-api.md

@@ -6,28 +6,28 @@
 
 |  | 兼容性 |
 | :- | :- |
-| createApp() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61 |
-| createSSRApp() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61 |
-| app.mount() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61 |
-| app.unmount() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61 |
-| app.component() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61 |
+| createApp() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| createSSRApp() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| app.mount() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| app.unmount() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| app.component() | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
 | app.use() | Web 4.0 / 微信小程序 4.41 / Android(VDOM) 3.99 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） |
 | app.mixin() | Web 4.0 / 微信小程序 4.41 / Android(VDOM) 3.99 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） |
-| app.provide() | Web 4.0 / 微信小程序 4.41 / Android 3.99 / iOS 4.11 / HarmonyOS 4.61 |
-| app.version | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61 |
-| app.config | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61 |
+| app.provide() | Web 4.0 / 微信小程序 4.41 / Android 3.99 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| app.version | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
+| app.config | Web 4.0 / 微信小程序 4.41 / Android √ / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
 | app.config.errorHandler | Web 4.0 / 微信小程序 4.41 / Android(VDOM) x / Android(Vapor) 5.21 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） |
 | app.config.globalProperties | Web 4.0 / 微信小程序 4.41 / Android(VDOM) 3.99 / Android(Vapor) x / iOS(VDOM) 4.11 / iOS(Vapor) x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） |
-| globalData | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
-| onLaunch() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
-| onShow() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
-| onHide() | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
-| onLastPageBackPress() | Web x / 微信小程序 x / Android 3.9 / iOS x / HarmonyOS 4.71（部分支持，见上） |
-| onExit() | Web x / 微信小程序 x / Android 3.9 / iOS x / HarmonyOS 4.72（部分支持，见上） |
-| onError() | Web 4.0 / 微信小程序 4.41 / Android 4.21 / iOS 4.21 / HarmonyOS 4.61 |
-| onPageNotFound() | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） |
-| onUniNViewMessage() | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
-| onThemeChange() | Web x / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） |
+| globalData | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
+| onLaunch() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
+| onShow() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
+| onHide() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.0 / HarmonyOS 4.61 |
+| onLastPageBackPress() | Web x / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS x / HarmonyOS 4.71（部分支持，见上） |
+| onExit() | Web x / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS x / HarmonyOS 4.72（部分支持，见上） |
+| onError() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 4.21 / iOS 4.21 / HarmonyOS 4.61 |
+| onPageNotFound() | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） |
+| onUniNViewMessage() | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
+| onThemeChange() | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） |
 
 ### app.component
 

package/data/uniappx/vue/options-api.md

@@ -503,14 +503,14 @@ export default {
 
 |  | 兼容性 | 描述 |
 | :- | :- | :- |
-| beforeCreate | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在组件实例初始化完成之后立即调用。<br/>在实例初始化之后，数据观测 (data observer) 和 event/watcher 事件配置之前被调用。 |
-| created | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在组件实例处理完所有与状态相关的选项后调用。<br/>在这一步，实例已完成以下的配置：数据观测 (data observer)，属性和方法的运算，watch/event 事件回调。<br/>然而，此时挂载阶段还未开始，因此 $el 属性仍不可用。 |
-| beforeMount | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在组件被挂载之前调用。<br/>相关的 render 函数首次被调用。<br/>当这个钩子被调用时，组件已经完成了其响应式状态的设置，但还没有创建 DOM 节点。<br/>它即将首次执行 DOM 渲染过程。 |
-| mounted | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在组件被挂载之后调用。<br/>el 被新创建的 vm.$el 替换，并挂载到实例上去之后调用该钩子。<br/>如果 root 实例挂载了一个文档内元素，当 mounted 被调用时 vm.$el 也在文档内。 |
-| beforeUpdate | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在组件即将因为一个响应式状态变更而更新其 DOM 树之前调用。<br/>数据更新时调用，发生在虚拟 DOM 打补丁之前。<br/>这里适合在更新之前访问现有的 DOM，比如手动移除已添加的事件监听器。 |
-| updated | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在组件因为一个响应式状态变更而更新其 DOM 树之后调用。<br/>父组件的更新钩子将在其子组件的更新钩子之后调用。<br/>这个钩子会在组件的任意 DOM 更新后被调用，这些更新可能是由不同的状态变更导致的。<br/>如果你需要在某个特定的状态更改后访问更新后的 DOM，请使用 nextTick() 作为替代。 |
-| beforeUnmount | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在一个组件实例被卸载之前调用。<br/>当这个钩子被调用时，组件实例依然还保有全部的功能。 |
-| unmounted | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 在一个组件实例被卸载之后调用。<br/>可以在这个钩子中手动清理一些副作用，例如计时器、DOM 事件监听器或者与服务器的连接。 |
+| beforeCreate | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在组件实例初始化完成之后立即调用。<br/>在实例初始化之后，数据观测 (data observer) 和 event/watcher 事件配置之前被调用。 |
+| created | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在组件实例处理完所有与状态相关的选项后调用。<br/>在这一步，实例已完成以下的配置：数据观测 (data observer)，属性和方法的运算，watch/event 事件回调。<br/>然而，此时挂载阶段还未开始，因此 $el 属性仍不可用。 |
+| beforeMount | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在组件被挂载之前调用。<br/>相关的 render 函数首次被调用。<br/>当这个钩子被调用时，组件已经完成了其响应式状态的设置，但还没有创建 DOM 节点。<br/>它即将首次执行 DOM 渲染过程。 |
+| mounted | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在组件被挂载之后调用。<br/>el 被新创建的 vm.$el 替换，并挂载到实例上去之后调用该钩子。<br/>如果 root 实例挂载了一个文档内元素，当 mounted 被调用时 vm.$el 也在文档内。 |
+| beforeUpdate | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在组件即将因为一个响应式状态变更而更新其 DOM 树之前调用。<br/>数据更新时调用，发生在虚拟 DOM 打补丁之前。<br/>这里适合在更新之前访问现有的 DOM，比如手动移除已添加的事件监听器。 |
+| updated | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在组件因为一个响应式状态变更而更新其 DOM 树之后调用。<br/>父组件的更新钩子将在其子组件的更新钩子之后调用。<br/>这个钩子会在组件的任意 DOM 更新后被调用，这些更新可能是由不同的状态变更导致的。<br/>如果你需要在某个特定的状态更改后访问更新后的 DOM，请使用 nextTick() 作为替代。 |
+| beforeUnmount | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在一个组件实例被卸载之前调用。<br/>当这个钩子被调用时，组件实例依然还保有全部的功能。 |
+| unmounted | Web 4.0 / 微信小程序 4.41 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 在一个组件实例被卸载之后调用。<br/>可以在这个钩子中手动清理一些副作用，例如计时器、DOM 事件监听器或者与服务器的连接。 |
 | errorCaptured | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 在捕获了后代组件传递的错误时调用。<br/>这个钩子带有三个实参：错误对象、触发该错误的组件实例，以及一个说明错误来源类型的信息字符串。<br/>这个钩子可以通过返回 false 来阻止错误继续向上传递。 |
 | renderTracked | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 在一个响应式依赖被组件的渲染作用追踪后调用。<br/>跟踪虚拟 DOM 重新渲染时调用。钩子接收 debugger event 作为参数。<br/>此事件告诉你哪个操作跟踪了组件以及该操作的目标对象和键。 |
 | renderTriggered | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 在一个响应式依赖被组件触发了重新渲染之后调用。<br/>当虚拟 DOM 重新渲染为 triggered.Similarly 为renderTracked，接收 debugger event 作为参数。<br/>此事件告诉你是什么操作触发了重新渲染，以及该操作的目标对象和键。 |

package/data/uniappx/web/README.md

@@ -9,7 +9,7 @@
 web版默认有页面滚动；app平台vdom模式时没有页面滚动，但蒸汽模式时已经支持页面滚动了。所以从蒸汽开始，这点平台差异不再存在。
 
 - 与老uni-app x相比，uni-app x 编译到web平台时，有几处不同：
-1. 如果使用uts代码，会走uts2js逻辑，会注入UTSJSONObject。如果使用ts/js则无法使用UTSJSONObject。
+1. 如果使用uts代码，会走[uts2js](../uts/uts2js.md)逻辑，会注入UTSJSONObject。如果使用ts/js则无法使用UTSJSONObject。
 2. 重置了css，拉齐App布局引擎，比如统一使用flex布局。详见[css重置](../css/README.md#css-reset)
 
 ## web运行失败注意事项@faq
@@ -146,15 +146,11 @@ position: fixed定位时，web端为相对于整个浏览器页面进行定位
   height: 100px;
   background-color: #FF0000;
   left: 10px;
-  /* #ifdef WEB */
   /*
    * HBuilderX 4.52之前只能使用--window-top，不可使用--uni-safe-area-inset-top
+	 * App端蒸汽模式5.31+起支持calc
    */
   top: calc(--uni-safe-area-inset-top + 10px);
-  /* #endif */
-  /* #ifdef APP */
-  top: 10px;  /* App端暂不支持calc */
-  /* #endif */
 }
 ```
 

package/data/uniappx//346/250/241/346/235/277.md

@@ -0,0 +1,34 @@
+title: tmui 3.0 组件库
+
+#### 组件库文档 tmui.design
+
+# 应用节点 App
+这是所有页面的根节点，请务必在创建页面是把它作为页面的根节点。以后可扩展性非常强。
+
+
+## :hot_pepper: 示例
+
+
+
+::: details 示例模板
+## :hot_pepper: 兼容性
+
+| APP-VUE | APP-NVUE | 小程序 | WEB/H5 | VUE3/TS |
+| --- | --- | --- | --- | --- |
+| :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
+
+## :seedling: 参数
+本组件含有公共属性 [公共属性](/spec/组件公共样式.html)
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+
+## :corn: slot插槽
+默认default
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |