tmui-cli 2.0.4 → 2.0.6

package/data/uniappx/vue/README.md

@@ -45,8 +45,6 @@ HBuilderX/uni-app x，会跟踪vue版本的升级，版本映射表如下
 
 可以看出整体和html还是很接近的。但响应式变量和绑定机制，可以免去写大量的dom操作代码，让开发更高效轻松。
 
-基于选项式的示例，下面章节会提供。
-
 ## template
 
 template中文名为`模板`，它类似html的标签。但有2个区别：
@@ -81,82 +79,11 @@ template中文名为`模板`，它类似html的标签。但有2个区别：
 ## script
 
 script中编写逻辑代码。
+uvue文件中只能有一个script标签。
 
-uvue中只能有一个script标签。
-
-script标签的属性如下：
-- lang
-目前不推荐设置此项。
-
-在VDOM模式，lang只能使用uts，Android平台按uts2kt执行。其他平台按uts2js执行。
-
-在蒸汽模式，在HBuilderX 5.27以前，仅支持uts，按uts2js执行，强行设置ts/js会触发bug。从5.27+，lang可以设置ts和js。
-
-设置js、ts、uts，会影响编译速度，编译速度逐渐变慢。ts需要执行ts2js编译，uts还需要再追加uts2js编译。
-
-uts2js，为了拉齐uts编译的强类型整体表现，支持UTSJSONObject、把部分js内置API返回值从undefined改为null、type没有擦除而是编译成了class。不使用uts时，将无法再使用UTSJSONObject，type会被擦除，所有API表现均与标准js一致。
-
-- setup
-setup属性声明代表script里的代码为组合式写法，如果没有setup属性则为选项式写法。
-
-**注意：** 所有 `vue` 公开的 `API` 都是不需要 `import` 的, `uni-app x` 会自动引入。
-
-比如不需要写：
-```js
-import { ref } from 'vue';
-```
-
-### 组合式和选项式的区别
-
-vue最初只有选项式API，从vue3起，新增了组合式API。uni-app x仅支持vue3。
-
-所谓选项式，就是把script的内容在export default {} 中约定不同的对象，在其中通过多个选项的对象来定义data、method和生命周期。
-
-框定好这些后，开发者就在这个框框里分别写自己的业务逻辑。
-
-这种方式易用但不够灵活。所以在vue3以前，部分开发者会认为react更难学、更灵活，所以更高级。
-
-vue3新增的组合式API，是纯编程的，解决了选项式不够灵活的问题。同时维持了易学的特点。让vue变的即容易、又灵活。
-
-在vue3中，组合式和选项式是可以混合使用的。
-1. 可以A页面使用组合式，B页面使用选项式，互相跳转。
-2. 可以页面使用组合式，其中的某些组件使用选项式。反之亦然。
-3. 一个页面或组件内，可以混合使用组合式和选项式
-- 在选项式的script里，可通过setup选项，在其中编写组合式代码
-- 在组合式script里（即script有setup属性），也可以通过defineOptions来定义选项式写法
-
-但注意不支持一个页面/组件有2个script，分别写选项式和组合式。
-
-开发者可以根据自己的喜好选择2种写法，但还有几个差别需要注意：
-1. vue推出了蒸汽模式，该模式抛弃了VNode，让页面加载速度更快。但该模式仅支持组合式。为了更高的性能，推荐使用组合式。
-1. 组合式API的组件，可以监听引用其页面的页面级生命周期。而选项式是不能的。有相关需求的组件，需使用组合式API，或在选项式中使用setup函数。[详见](./component.md#component-page-lifecycle)
-2. 选项式的type类型定义在`export default {}`外，这些都是应用级全局的，略微影响性能。[见下](#export-default-out)
-3. uts插件的兼容模式组件，其中的根index.vue，只支持选项式。兼容模式组件已经不再推荐使用，推荐使用标准模式组件。
-
-一般推荐的建议是：
-1. 如果有历史的选项式代码需要复用，这些选项式代码仍然可以使用。
-2. 如果新写页面和组件，建议直接使用组合式。
-3. 虽然选项式可以用，但强烈推荐通过[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)来转换选项式代码为组合式，可以使用如下提示词：[见下](#ai)
-
-### 组合式API
-组合式 API，也称 Composition API，或 setup函数。
-
-组合式提供了更灵活自由、更简洁的编程方式，通过代码而不是通过规范约定死的选项来定义data、method和生命周期。
-
-如下页面代码的逻辑是：
-
-1. 定义了一个响应式`title`，初始值是"Hello world"。
-2. 在页面中放置了一个button组件，按钮文字区使用`{{}}`模板写法，里面写响应式变量`title`，那么`title`的值就会绑定到按钮的文字区，即按钮的初始文字是"Hello world"
-3. 按钮的点击事件`@click`，指向了一个方法`buttonClick`，点击按钮即触发这个方法的执行
-4. 页面onReady生命周期中打印日志
+script标签有2个属性，lang和setup。
 
 ```vue
-<template>
-	<view>
-		
-		<button @click="buttonClick">{{title}}</button>
-	</view>
-</template>
 
 ```
 
@@ -202,7 +129,7 @@ vue3新增的组合式API，是纯编程的，解决了选项式不够灵活的
 
 ### JSX/TSX
 
-uni-app x 目前不支持使用 JSX/TSX 编写页面和组件，请使用 Vue 的 `template` 模板语法。
+uni-app x 除web平台外，其他平台不支持使用 JSX/TSX 编写页面和组件，请使用 Vue 的 `template` 模板语法。
 
 在 App 端蒸汽模式下，视图层代码，即 Vue 文件中 `template` 和 `style` 内的代码，会在编译期进行静态分析，并直接编译为高度优化的机器码或字节码，它的运行速度远快于arkts、kotlin及k/n。
 
@@ -210,7 +137,7 @@ JSX/TSX 是编写在 JavaScript/TypeScript 中的表达式语法，目前不支
 
 ## style（CSS功能） @css
 
-style的写法与web的css基本相同。但在App端，由于并非webview渲染，支持的css有限。[详见](../css/README.md)
+style的写法与web的css基本相同。但在App端，由于并非webview渲染，支持的css是子集。[详见](../css/README.md)
 
 本章节重点讲解uvue下样式的使用注意事项。
 
@@ -241,8 +168,8 @@ style通过lang属性，可以支持less、scss、stylus等css预处理语言。
 
 ### Class 与 Style 绑定 @class-style
 
-- `uni-app x` 支持绑定  `UTSJSONObject` 和 `Map` 类型数据。
-- 在App-Android平台上 `Map` 的性能高于 `UTSJSONObject` 数据类型。从 `uni-app x 4.01` 起，Web平台也支持了 `Map` 类型绑定。
+- `uni-app x` 在VDOM模式下支持绑定  `UTSJSONObject` 和 `Map` 类型数据。蒸汽模式不支持 `Map` 类型数据。
+- VDOM模式下，在App-Android平台上 `Map` 的性能高于 `UTSJSONObject` 数据类型。从 `uni-app x 4.01` 起，Web平台在uts2js时也支持了 `Map` 类型绑定。
 
 如下示例中，给 view 组件的 style 和 class 分别绑定了两个响应式变量，就可以通过在逻辑代码里修改变量而实现动态修改样式。
 ```vue
@@ -307,6 +234,8 @@ HBuilderX 4.71 起，App 端可以使用深度选择器控制台不再告警，
 
 单文件组件的 `<style>` 标签支持使用 `v-bind` CSS 函数将 CSS 的值链接到动态的组件状态：
 
+选项式写法：
+
 ```vue
 <template>
   <text class="text">hello</text>
@@ -319,7 +248,7 @@ HBuilderX 4.71 起，App 端可以使用深度选择器控制台不再告警，
 </style>
 ```
 
-这个语法同样也适用于 `
+组合式写法： `
 
 <template>
   <text class="view">hello</text>
@@ -334,8 +263,8 @@ HBuilderX 4.71 起，App 端可以使用深度选择器控制台不再告警，
 
 ## 利用AI将选项式转换为组合式@ai
 
-推荐使用[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，可以直接转换选项式代码为组合式代码，并自动监控控制台报错然后自动修复。
-官方的很多页面如hello uni-app x，都是这样转的。
+推荐使用[uni-agent](https://doc.dcloud.net.cn/uni-app-x/ai/)，可以直接转换选项式代码为组合式代码，并自动监控控制台报错然后自动修复。\
+官方的很多页面如 hello uni-app x，都是这样转的。
 
 如果您使用其他AI，可以使用下面的提示词：
 

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

@@ -4,7 +4,7 @@
 
 |  | 兼容性 |
 | :- | :- |
-| v-text | Web 4.0 / 微信小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
+| 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 |
@@ -74,7 +74,7 @@
 更新元素的内容，并且不会被解析。
 
 ::: warning 注意
-在 `App-android` 平台，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式, 并且要遵循标签嵌套规则，例如， `swiper` 标签内只允许嵌套 `swiper-item` 标签。\
+在 `App-android` 平台，`v-html` 指令通过编译为 [rich-text](../component/rich-text.md) 组件实现。因此，`v-html` 指令的内容必须是 `rich-text` 支持的格式。\
 同时，受限于 `rich-text` 组件不支持 `class` 样式，`v-html` 指令中同样不支持 `class` 样式。\
 绑定 `v-html` 的标签内的内容会被忽略，`v-html` 指令的内容会编译为 `rich-text` 组件渲染为该标签的子节点。
 

package/data/uniappx/vue/component.md

@@ -593,7 +593,7 @@ ComponentPublicInstance
 
 **bug&tips**
 
-- 目前uts组件，即封装原生ui给uni-app或uni-app x的页面中使用，类型与内置组件的 Uni`组件名(驼峰)`Element 方式相同。目前没有代码提示。
+- 目前uts插件 - uni-app兼容模式组件，即封装原生ui给uni-app或uni-app x VDOM模式的页面中使用，类型与内置组件的 Uni`组件名(驼峰)`Element 方式相同。目前没有代码提示。
 
 ### 组件监听应用、页面生命周期 @component-page-lifecycle
 

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

@@ -239,7 +239,7 @@ watch(
   若要避免深层响应式转换，只想保留对这个对象顶层次访问的响应性，请使用 [shallowReactive()](#shallowreactive) 作替代。
 
 ::: warning 注意
-- `reactive` 在 app-android 平台目前不支持对 class 做响应式，推荐使用 type 定义存储数据的对象类型。
+- `reactive` 在 App-Android VDOM 模式不支持对 class 做响应式，推荐使用 type 定义存储数据的对象类型。
 
 - 示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/reactivity/core/reactive/reactive.uvue)
 
@@ -827,7 +827,7 @@ watch(
 | isReadonly() | 4.0 | 4.41 | 4.0 | 4.11 | 4.61 |
 
 ::: warning 注意
-- `toRefs()` 仅支持 `Array` 和 `UTSJSONObject`, 不支持自定义类型。
+- App-Android VDOM 模式 `toRefs()` 仅支持 `Array` 和 `UTSJSONObject`, 不支持自定义类型。
 
 ### 示例代码 @example
 
@@ -1183,7 +1183,6 @@ watch(
 | 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 |
-| markRaw() |   |
 | 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 |
@@ -1720,87 +1719,6 @@ watch(
 ```
 
 ## \
-  ```
-
-##### 兼容性 
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | √ | 3.9 | 4.11 | 4.61 |
-
-##### 属性 
-| 名称 | 类型 | 兼容性 |
-| :- | :- |  :-: |
-| setup | Any | Web 4.0 / 微信小程序 √ / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| lang | Any | Web 4.0 / 微信小程序 √ / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 |
-| 合法值 | 兼容性 | 描述 |
-| :- |  :-: | :- |
-| ts | Web x / 微信小程序 √ / Android x / iOS x / HarmonyOS x（部分支持，见上） | typescript |
-| uts | Web 4.0 / 微信小程序 √ / Android 4.0 / iOS 4.11 / HarmonyOS 4.61 | uts |
-
-##### 参见
-
-### 示例 @example
-
-示例 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/component-instance/setup-function/setup-function.uvue)
-
-::: preview https://hellouvue.dcloud.net.cn/#/pages/component-instance/setup-function/setup-function
-
-```vue
-<template>
-  
-  <scroll-view style="flex: 1">
-    
-    <view class="page">
-      <view class="flex justify-between flex-row mt-10">
-        <text>str:</text>
-        <text id="str">{{ str }}</text>
-      </view>
-      <view class="flex justify-between flex-row mt-10">
-        <text>num:</text>
-        <text id="num">{{ num }}</text>
-      </view>
-      <view class="flex justify-between flex-row mt-10">
-        <text>bool:</text>
-        <text id="bool">{{ bool }}</text>
-      </view>
-      <view class="flex justify-between flex-row mt-10">
-        <text>count:</text>
-        <text id="count">{{ count }}</text>
-      </view>
-      <button class="mt-10" id="increment-btn" @click="increment">
-        increment count
-      </button>
-      <view class="flex justify-between flex-row mt-10">
-        <text>obj.str:</text>
-        <text id="obj-str">{{ obj['str'] }}</text>
-      </view>
-      <view class="flex justify-between flex-row mt-10">
-        <text>obj.num:</text>
-        <text id="obj-num">{{ obj['num'] }}</text>
-      </view>
-      <view class="flex justify-between flex-row mt-10">
-        <text>obj.bool:</text>
-        <text id="obj-bool">{{ obj['bool'] }}</text>
-      </view>
-      <button class="mt-10" id="update-obj-btn" @click="updateObj">
-        update obj
-      </button>
-      
-      <RenderFunction
-        :str="str"
-        :count="count"
-        :obj="obj"
-        @compUpdateObj="compUpdateObj"
-        :isShow="true" />
-      
-      <Foo id="component-foo">
-        <text class="mt-10" id="default-slot-in-foo">default slot in Foo</text>
-      </Foo>
-    </view>
-    
-  </scroll-view>
-  
-</template>
 
 ```
 
@@ -1957,8 +1875,6 @@ defineOptions({
 
 在底层，这个宏声明了一个 model prop 和一个相应的值更新事件。如果第一个参数是一个字符串字面量，它将被用作 prop 名称；否则，prop 名称将默认为 `"modelValue"`。在这两种情况下，你都可以再传递一个额外的对象，它可以包含 prop 的选项和 model ref 的值转换选项。
 
-**注意：** android 端 `defineModel` 暂不支持创建 `Array` 类型 `prop`。
-
 #### 示例
 
 [详情](https://gitcode.com/dcloud/hello-uvue/blob/alpha/pages/directive/v-model/Foo-composition.uvue)

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

@@ -304,4 +304,4 @@ uni-app x 新增了 [onLastPageBackPress](../collocation/App.md#applifecycle)
 
 ### nextTick 使用注意事项 @nexttick
 
-目前 nextTick 可以保证当前数据已经同步到 DOM，但是由于排版和渲染是异步的的，所以 nextTick 不能保证 DOM 排版以及渲染完毕。如果需要获取排版后的节点信息推荐使用 [uni.createSelectorQuery](../api/nodes-info.md) 不推荐直接使用 [Element](../dom/unielement.md) 对象。在修改 DOM 后，立刻使用 [Element](../dom/unielement.md) 对象的同步接口获取 DOM 状态可能获取到的是排版之前的，而 [uni.createSelectorQuery](../api/nodes-info.md) 可以保障获取到的节点信息是排版之后的。
+目前 nextTick 可以保证当前数据已经同步到 DOM，但是由于排版和渲染是异步的的，所以 nextTick 不能完全保证 DOM 排版以及渲染完毕（蒸汽模式在 5.21 版本之后可以保障渲染完毕）。如果需要获取排版后的节点信息推荐使用 [uni.createSelectorQuery](../api/nodes-info.md) 不推荐直接使用 [Element](../dom/unielement.md) 对象。在修改 DOM 后，立刻使用 [Element](../dom/unielement.md) 对象的同步接口获取 DOM 状态可能获取到的是排版之前的，而 [uni.createSelectorQuery](../api/nodes-info.md) 可以保障获取到的节点信息是排版之后的。

package/data/uniappx/vue/modifier.md

@@ -14,9 +14,9 @@
 阻止事件的默认行为（例如阻止链接跳转或表单提交）
 
 **兼容性 ** 
- | Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | √ | 4.51 | 4.51 | x |
+ | Web | 微信小程序 | Android | iOS | HarmonyOS(VDOM) | HarmonyOS(Vapor) |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | √ | 4.51 | 4.51 | x | 5.0 |
 
 `android & ios 4.51 +` 支持 `touch` 事件通过 `preventDefault` 阻止滚动与点击事件
 

package/data/uniappx-doc-index.json

@@ -1,7 +1,7 @@
 {
-  "updatedAt": "2026-09-09T09:08:57.328Z",
+  "updatedAt": "2026-09-20T01:56:13.187Z",
   "source": "/Volumes/app/myProjects/HBuilderProjects/tmui3.2/xui-cli/data/uni-app-x-docs",
-  "count": 549,
+  "count": 551,
   "components": [
     {
       "name": "ad",
@@ -1417,7 +1417,7 @@
         "样式",
         "css样式"
       ],
-      "count": 119
+      "count": 118
     },
     {
       "key": "api",
@@ -1469,7 +1469,7 @@
         "教程",
         "指南"
       ],
-      "count": 17
+      "count": 18
     },
     {
       "key": "native",
@@ -1499,7 +1499,7 @@
         "小程序",
         "miniprogram"
       ],
-      "count": 1
+      "count": 2
     },
     {
       "key": "app-harmony",
@@ -1566,6 +1566,12 @@
         "工作流"
       ],
       "count": 1
+    },
+    {
+      "key": "select",
+      "name": "select",
+      "aliases": [],
+      "count": 1
     }
   ],
   "docs": [
@@ -5482,17 +5488,6 @@
         "css/common/variable"
       ]
     },
-    {
-      "id": "css/css_diff_web",
-      "category": "CSS样式",
-      "categoryKey": "css",
-      "title": "uni-app x CSS 与标准 CSS 的差异",
-      "file": "uniappx/css/css_diff_web.md",
-      "aliases": [
-        "css_diff_web",
-        "css/css_diff_web"
-      ]
-    },
     {
       "id": "css/direction",
       "category": "CSS样式",
@@ -6163,6 +6158,17 @@
         "i18n"
       ]
     },
+    {
+      "id": "mp/native-component-and-wxs",
+      "category": "小程序",
+      "categoryKey": "mp",
+      "title": "小程序自定义组件支持",
+      "file": "uniappx/mp/native-component-and-wxs.md",
+      "aliases": [
+        "native-component-and-wxs",
+        "mp/native-component-and-wxs"
+      ]
+    },
     {
       "id": "mp/README",
       "category": "小程序",
@@ -6661,6 +6667,17 @@
         "select"
       ]
     },
+    {
+      "id": "select/native-render-and-self-render",
+      "category": "select",
+      "categoryKey": "select",
+      "title": "一文讲透原生渲染和自渲染",
+      "file": "uniappx/select/native-render-and-self-render.md",
+      "aliases": [
+        "native-render-and-self-render",
+        "select/native-render-and-self-render"
+      ]
+    },
     {
       "id": "tutorial/android-16kb",
       "category": "教程",
@@ -6727,6 +6744,17 @@
         "tutorial/app-playground"
       ]
     },
+    {
+      "id": "tutorial/app-update-wgt",
+      "category": "教程",
+      "categoryKey": "tutorial",
+      "title": "应用资源在线升级更新",
+      "file": "uniappx/tutorial/app-update-wgt.md",
+      "aliases": [
+        "app-update-wgt",
+        "tutorial/app-update-wgt"
+      ]
+    },
     {
       "id": "tutorial/bug_repair",
       "category": "教程",