tmui-cli 5.3.1 → 5.3.2

package/data/uni-app-x-docs/api/unicloud/README.md

@@ -23,3 +23,44 @@ uniCloud是基于serverless的云开发服务，它大幅降低开发者的开
 <!-- UTSUNICLOUDAPIJSON.uniCloud_props.returnValue -->
 
 <!-- UTSUNICLOUDAPIJSON.uniCloud_props.tutorial -->
+
+### datacom 组件示例
+
+Vue 蒸汽模式不支持 `mixin` 语法，可使用属性展开和方法替代，详见 [datacom 组件规范](https://uniapp.dcloud.net.cn/component/datacom.html)。
+
+```html
+<template>
+  <view>
+    <view v-if="datacom.loading">Loading...</view>
+    <view v-else-if="datacom.errorMessage">
+      请求错误：{{datacom.errorMessage}}
+    </view>
+    <view v-else>
+      <!-- 需要自行处理数据及相关UI展现 -->
+      {{datacom.resData}}
+    </view>
+  </view>
+</template>
+
+<script setup lang="ts">
+  const props = defineProps({
+    ...uniCloud.datacomProps, // HBuilderX 5.32
+    multiple: {
+      type: Boolean,
+      default: false
+    }
+  })
+
+  // HBuilderX 5.32
+  const datacom = uniCloud.useDatacom(props)
+
+  // 调用 useDatacom 中的方法加载数据
+  datacom.easyGet()
+
+  defineExpose({
+    loadData: datacom.easyGet,
+    refresh: datacom.refresh,
+    clear: datacom.reset
+  })
+</script>
+```

package/data/uni-app-x-docs/api/unicloud/function.md

@@ -46,7 +46,7 @@ type CallFunctionResult = {
 uniCloud.callFunction<CallFunctionResult>(
   {
     name: 'fn',
-    data: { a: 1 } as UTSJSONObject,
+    data: { a: 1 },
   } as UniCloudCallFunctionOptions
 ).then(function (res) {
   const result = res.result // result的类型为CallFunctionResult

package/data/uni-app-x-docs/api/unicloud/object.md

@@ -40,7 +40,7 @@ export { // 上面的写法可以自己调整，仅需保证export内包含所
 
 用法：`obj.add<泛型类型>()`
 
-在不传泛型时云对象方法返回的类型为`Promise<UTSJSONObject>`，传入泛型后callFunction返回的类型为`Promise<泛型类型>`
+在不传泛型时云对象方法返回的类型为`Promise<any>`，传入泛型后callFunction返回的类型为`Promise<泛型类型>`
 
 **代码示例**
 

package/data/uni-app-x-docs/api/uniresizeobserver.md

@@ -0,0 +1,50 @@
+## UniResizeObserver
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.compatibility -->
+
+小程序自身未提供ResizeObserver。社区有三方库可模拟实现，虽性能不及原生ResizeObserver，但在需要时也可以使用。参考[lime-resize](https://ext.dcloud.net.cn/plugin?id=14117)
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.extends -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.param -->
+
+### UniResizeObserver 的方法 @uniresizeobserver-methods
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.name -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.param -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.disconnect.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.name -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.param -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.observe.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.name -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.description -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.compatibility -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.param -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.returnValue -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.methods.unobserve.tutorial -->
+
+<!-- CUSTOMTYPEJSON.UniResizeObserver.example -->

package/data/uni-app-x-docs/app-vapor.md

@@ -318,7 +318,7 @@ uni-app x 蒸汽模式 提供了应该是业内最好的rich-text组件。
 
 - uni-app x 的App平台到底是自渲染还是原生渲染？
 
-答案是原生渲染。uni-app x 选择原生渲染是为了更好的和原生生态无缝融合、以及降低内存占用（无需2套渲染管线）。
+答案是原生渲染。uni-app x 选择原生渲染是为了更好的和原生生态无缝融合、以及降低内存占用（无需2套渲染管线）。自渲染在冷启动和原生混合渲染时劣势明显，参考[《一文讲透原生渲染和自渲染》](./select/native-render-and-self-render.md)
 
 - 为什么都是原生渲染，uni-app x的蒸汽模式比原生渲染更快？
 
@@ -519,7 +519,6 @@ ninja: error: failed recompaction: Permission denied。
   * 拍平的元素无法支持事件（如click、touch）
   * 拍平的元素不支持截图API：takeSnapshot
   * 拍平时如下css不支持：
-    + 不支持 [visibility](css/visibility.md)
     + 不支持 [z-index](css/z-index.md)
     + 不支持 [background-image](css/background-image.md)、[background-clip](css/background-clip.md)
     + 不支持 [pointer-events](css/pointer-events.md)
@@ -528,6 +527,10 @@ ninja: error: failed recompaction: Permission denied。
     + [transition](css/transform.md) 动画不支持渲染相关（如background-color）的样式
   * image组件拍平后无法播放动画，gif、webp动画仅显示第一帧
   * view组件拍平后css属性transform、overflow、display、opacity存在缺陷，如果view存在子元素，这些样式不会对非拍平的子元素产生效果
+  * css属性[visibility](css/visibility.md)存在差异
+    + app-android平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的子元素默认仍然会显示，子元素的显示状态由其自身的visibility决定
+    + app-ios平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的非拍平子元素默认仍然会显示，非拍平子元素的显示状态由其自身的visibility决定，而拍平子元素会跟随此view不可见
+    + app-harmony平台visibility暂不支持拍平
 
   注意：当自定义组件的单根节点是（view、text、image）时，该自定义组件会自动支持flatten属性，并将其传递给它的单根节点，如果在不符合要求的自定义组件上使用flatten属性，则会被自动忽略。
 
@@ -557,6 +560,10 @@ ninja: error: failed recompaction: Permission denied。
 
 ## 使用uni-agent，从VDOM模式升级到蒸汽模式@vom2vapor
 
+在uni-agent中有内置的skill，可以方便的升级vdom到蒸汽。
+
+如果你需要手动处理，可以参考以下步骤：
+
 1. 在vdom模式下，要求uni-agent把复杂的组合选择器，改成 简单的class选择器或分组选择器，确认是否正常
 2. 在vdom模式下，打开manifest.json中的样式隔离策略2.0，把[文档](css/common/style-isolation.md)贴给ai，要求ai改造，确认是否正常。如涉及三方组件，核对三方组件的新版是否支持样式隔离策略2.0，尽量选择支持该策略的组件。官方的 [uni ui x](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/) 是支持的。
 3. 由于改用js驱动，Android的uvue页面中，不能直接调用原生API，相关调用需挪到uts插件中，包括utsAndroid，在uvue页面下将不可用。让uni-agent协助完成改造。

package/data/uni-app-x-docs/collocation/app.md

@@ -218,7 +218,7 @@ globalData依赖于vue和js环境，在页面里都使用，但在uts插件中
 ### 组合式 API 示例：
 
 ```ts
-<script setup lang="uts">
+<script setup lang="ts">
   defineOptions({
     globalData: {
       str: 'global data str',
@@ -233,7 +233,7 @@ globalData依赖于vue和js环境，在页面里都使用，但在uts插件中
 页面或组件中通过 `getApp().globalData` 访问。
 
 ```ts
-<script setup lang="uts">
+<script setup lang="ts">
   const globalDataStr = ref('')
   const globalDataNum = ref(0)
   const globalDataBool = ref(false)

package/data/uni-app-x-docs/collocation/manifest-android.md

@@ -784,7 +784,21 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。
 蒸汽模式下 Android 平台业务逻辑代码运行在Google V8 JS 引擎中。  
 Google V8 引擎通过 Android NDK 编译为 .so 动态链接库，且需要针对多种 CPU 架构（如 armeabi-v7a、arm64-v8a 等）分别打包。为严格控制 APK 的安装包体积，构建时默认禁用了 ICU 模块（编译参数 v8_enable_i18n_support = false）。  
 
-> 后续会提供配置使用包含 ICU 功能的 V8 引擎
+在uni-app x项目中使用包含 ICU 功能的 V8 引擎，需在manifest.json中配置：  
+
+- HBuilderX 5.33 及以上版本  
+  需通过 manifest.json 的`源码视图`在 "app-android" -> "distribute" -> "modules" 下添加 "v8-icu" 节点，如下示例：  
+  ```json
+  {
+    "app-android": {
+      "distribute": {
+        "modules": {
+          "v8-icu": {}
+        }
+      }
+    }
+  }
+  ```
 
 启用该裁剪后，所有与国际化（i18n）、本地化格式化以及复杂 Unicode 字符处理相关的 API 与特性将被限制或禁用，具体影响如下：  
 + [Intl](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl) 全局对象不可用  

package/data/uni-app-x-docs/compiler/README.md

@@ -94,7 +94,7 @@ uni-app发明了完善的条件编译，帮助开发者处理平台差异。即
 	<image :src="imga"/> <!-- 变量的静态资源，不会被编译器打包，文件丢失。不推荐 -->
 	<image src="/static/3.png"/> <!-- static目录会整体被copy到编译产物。推荐 -->
 </template>
-<script setup lang="uts">
+<script setup>
 	import logo from './logo.png';
 
 	const imga = './2.png'

package/data/uni-app-x-docs/component/_sidebar.md

@@ -62,6 +62,7 @@
     * [canvas | 画布](canvas.md)
   * 广告
     * [ad | 信息流广告](ad.md)
+    * [ad-drama | 短剧](ad-drama.md)
   * 网页
     * [web-view](web-view.md)
   * 页面属性配置节点
@@ -70,12 +71,14 @@
     * [page-meta](page-meta.md)
   * unicloud
     * [unicloud-db](unicloud-db.md)
-* [uni-ui x 扩展组件](./uni-ui-x/README.md)
+* uni-ui x 扩展组件
+  * [概述](./uni-ui-x/README.md)
   * [uni-badge-view | 数字角标](./uni-ui-x/uni-badge-view.md)
   * [uni-collapse | 折叠面板容器](./uni-ui-x/uni-collapse.md)
   * [uni-combox | 组合框](./uni-ui-x/uni-combox.md)
   * [uni-drag-cell | 可拖拽排序](./uni-ui-x/uni-drag-cell.md)
   * [uni-fab-button | 悬浮按钮](./uni-ui-x/uni-fab-button.md)
+	* [uni-icons | 字体图标](./uni-ui-x/uni-icons.md)
   * [uni-index-bar | 索引条](./uni-ui-x/uni-index-bar.md)
   * [uni-link | 链接](./uni-ui-x/uni-link.md)
   * [uni-number-box | 数字输入框](./uni-ui-x/uni-number-box.md)

package/data/uni-app-x-docs/component/ad-drama.md

@@ -4,30 +4,29 @@
 
 <!-- UTSCOMJSON.ad-drama.description -->
 
-ad-drama 组件是短剧广告的组件模式接入方式：组件挂载即自动加载短剧模块，适合快速接入短剧广告。
+短剧广告：通过短剧内容生态 `穿山甲内容联盟(短剧)` 变现的高价值广告形式。将短剧内容（列表）嵌入自己的应用中，用户免费观看指定集数后，需观看激励视频解锁后续剧集，从而实现广告变现。
 
-与 API 模式（[uni.createDramaAd](../api/create-drama-ad.md)）的区别：组件模式直接使用渠道提供的短剧首页界面（含推荐、榜单等内容分发），无需自行搭建短剧列表页；API 模式则自行搭建列表页，可深度定制样式与业务。
+ad-drama 组件是短剧广告的组件模式接入方式：组件挂载即自动加载短剧列表，适合快速接入短剧。如需自定义显示短剧列表界面，请使用 API 模式（[uni.createDramaAd](../api/create-drama-ad.md)）接入。
 
-- 示例Demo介绍：[详见](https://gitcode.com/dcloud/uni-ad-drama)
 - uni-ad的业务介绍：[详见](https://uniapp.dcloud.net.cn/uni-ad/)
+- 示例Demo：[详见](https://gitcode.com/dcloud/uni-ad-drama)
 
 **开通配置广告**
 
 [开通广告步骤详情](https://uniapp.dcloud.net.cn/uni-ad/ad-open.html)
 
 **Tips**
-- 标准基座不支持测试短剧功能。
-- 使用短剧组件需要先开通穿山甲广告。开通问题请咨询：[uni-ad交流群](https://im.dcloud.net.cn/#/?joinGroup=65d85fc09847e92db03ff81a)。
-- 标准基座不包含短剧运行时，需制作自定义基座后运行，否则报错 `-5020`。
+- HBuilder 5.32 版本 app-android 平台支持。
+- 使用短剧组件需要先开通穿山甲广告，相关问题请咨询：[uni-ad交流群](https://im.dcloud.net.cn/#/?joinGroup=65d85fc09847e92db03ff81a)。
+- 标准基座不包含短剧功能，需勾选广告联盟中的“穿山甲内容联盟(短剧)”，打包自定义基座后运行，否则报错 `-5020` 错误。
 
 ### 配置文件
 
-在穿山甲后台 内容输出->接入管理 找到需要接入内容SDK的应用，点击"下载SDK参数配置"，然后将SDK配置文件（例如 sdk_setting_file.json）拷贝到项目的 assets 文件夹下。
+短剧功能使用的“穿山甲内容联盟(短剧)”要求配置 `SDK参数配置` 文件，在穿山甲后台 "内容输出" -> "接入管理" 找到需要接入内容SDK的应用，点击"下载SDK参数配置"：
 
 ![](https://lf3-plat.pglstatp-toutiao.com/obj/union-platform/a30bc3001dff716fcf6876da15151ecf.png)
 
-文件下载之后重命名为：`gm_SDK_Setting.json`，然后将文件放到项目根目录的`nativeResources->android->assets`目录下。
-完整配置说明与错误码见 [uni.createDramaAd](../api/create-drama-ad.md)。
+配置文件下载之后重命名为 `gm_SDK_Setting.json`，然后将文件放到到 uni-app x 项目的 `nativeResources\android\assets` 文件夹中。
 
 <!-- UTSCOMJSON.ad-drama.readme -->
 
@@ -43,10 +42,6 @@ ad-drama 组件是短剧广告的组件模式接入方式：组件挂载即自
 
 <!-- UTSCOMJSON.ad-drama.children -->
 
-## Tips
-
-
-+ 短剧广告仅支持 Android 平台。
 
 <!-- UTSCOMJSON.ad-drama.example -->
 

package/data/uni-app-x-docs/component/button.md

@@ -79,7 +79,7 @@ button 组件没有 url 属性，点击后需要跳转页面时，可在 @click
 	</view>
 </template>
 
-<script setup lang="uts">
+<script setup>
 	function gotoAbout() {
 		uni.navigateTo({
 			url: '/pages/about/about'

package/data/uni-app-x-docs/component/icon.md

@@ -4,6 +4,8 @@
 
 <!-- UTSCOMJSON.icon.description -->
 
+跨平台字体图标组件，推荐使用 uni-ui x 的[uni-icons组件](./uni-ui-x/uni-icons.md)
+
 <!-- UTSCOMJSON.icon.compatibility -->
 
 <!-- UTSCOMJSON.icon.attribute -->

package/data/uni-app-x-docs/component/image.md

@@ -67,10 +67,12 @@
 - 替代方案3：小程序平台，可以利用 filter: drop-shadow 配合 overflow: hidden，可以将原图标的形状“投影”出新的颜色，并把原图标隐藏。App平台不支持此用法。
 
 3. 鸿蒙平台部分情况会按位图渲染，失去矢量能力
+
 svg 是矢量图片，可以无极缩放而不失真。但鸿蒙平台以下情况，会把svg转成位图渲染，此时将丢失矢量能力。
 * 如果启用了 `flatten` 拍平，则会转为位图。
-* 设置部分 `mode` 属性进行图像裁剪，会转为位图进行裁剪。`mode` 设置为 `scaleToFill/aspectFit/aspectFill` 可以保持矢量能力，设置为其它值会转位图裁剪。
-* 如果 `src` 设置了 `data:image/svg+xml;base64,...` 这种形式的 url，则会转为位图。
+* 设置部分 `mode` 属性时会转为位图进行处理。`mode` 设置为 `scaleToFill/aspectFit/aspectFill/widthFix/heightFix` 可以保持矢量能力，设置为其它值会转位图处理。
+* 如果 `src` 设置了 `data:image/svg+xml;base64,...` 这种形式的 data url，则会转为位图。
+  （例外：鸿蒙系统 API ≥ 26 的时候不会转为位图；svg 图片中包含 `text` 内容的时候会被内部转换成 `path` 并本地缓存，实际使用不再是 data url 从而不会转换成位图）
 
 <!-- UTSCOMJSON.image.children -->
 

package/data/uni-app-x-docs/component/swiper.md

@@ -55,7 +55,7 @@
 	</swiper>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
 	const current = ref(0)
 
 	const handleSwiperChange = (e : UniSwiperChangeEvent) => {
@@ -76,6 +76,10 @@
 </style>
 ```
 
+**注意事项**
+
+- swiper 滑动时会视情况阻止默认行为。如需在 swiper-item 内自定义滚动效果，需在相应容器中阻止事件冒泡，此时 swiper 将不再接收该事件，从而不触发滚动。
+
 
 ## swiper-item
 

package/data/uni-app-x-docs/component/text.md

@@ -57,7 +57,7 @@ hi </text>
 <template>
   <text>{{text}}</text>
 </template>
-<script lang="uts" setup>
+<script setup>
   let text = ' a   bc def\tg\nhi '
 </script>
 ```
@@ -129,7 +129,7 @@ web的默认值preline，虽然支持\n换行，同时会合并\n以外的其他
 <template>
   <text decode="false">{{text}}</text>
 </template>
-<script lang="uts" setup>
+<script setup>
   let text = '5 &lt; 10'
 </script>
 ```
@@ -148,10 +148,10 @@ text组件在web浏览器渲染（含浏览器、小程序webview渲染模式、
 
 app平台 text 组件虽然支持嵌套，但注意限制：
 1. 子组件不继承父组件样式。这样使用会在编译到web渲染的平台时产生差异。
-2. 子组件设置的排版相关样式（如position、display、width、height、margin、padding等）以及部分text独有样式（如text-align、lines、white-space、text-overflow）不生效
+2. 子组件设置的排版相关样式（如display、flex、position、width、max-width、min-width、height、max-height、min-height、margin、padding、top、left、right、bottom等），渲染样式（如box-shadow、transform、transition、visibility、z-index等）以及部分text独有样式（如text-align、lines、line-height、white-space、text-overflow、world-break等）不生效
 3. 嵌套时建议将文本写在`<text></text>`标签之间，例如：`<text><text>嵌套文本1</text><text>嵌套文本2</text></text>`，避免出现预期外的效果。
 
-HBuilderX4.51版本起 text组件嵌套时，子组件支持点击事件响应。之前版本如有这方面需求，请改用 [rich-text](./rich-text.md)
+HBuilderX 4.51版本+ text组件嵌套时，子组件支持点击事件响应。
 
 <!-- UTSCOMJSON.text.example -->
 
@@ -174,7 +174,7 @@ App 端不支持 `text` 组件中渲染多段文本，如果 `text` 组件中的
   </view>
 </template>
 
-<script setup lang="uts">
+<script setup>
   const list = ref([
     {
       show: true,
@@ -199,7 +199,7 @@ App 端不支持 `text` 组件中渲染多段文本，如果 `text` 组件中的
   </view>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
   const list = ref([
     {
       show: true,

package/data/uni-app-x-docs/component/uni-ui-x/uni-collapse.md

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-collapse
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-collapse-x
 ---
 
 <!-- UTSCOMJSON.uni-collapse.name -->

package/data/uni-app-x-docs/component/uni-ui-x/uni-combox.md

@@ -1,3 +1,7 @@
+---
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-combox-x
+---
+
 <!-- UTSCOMJSON.uni-combox.name -->
 
 <!-- UTSCOMJSON.uni-combox.description -->

package/data/uni-app-x-docs/component/uni-ui-x/uni-icons.md

@@ -0,0 +1,25 @@
+---
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-icons-x
+---
+
+<!-- UTSCOMJSON.uni-icons.name -->
+
+<!-- UTSCOMJSON.uni-icons.description -->
+
+<!-- UTSCOMJSON.uni-icons.readme -->
+
+<!-- UTSCOMJSON.uni-icons.compatibility -->
+
+<!-- UTSCOMJSON.uni-icons.attribute -->
+
+<!-- UTSCOMJSON.uni-icons.fileFormates -->
+
+<!-- UTSCOMJSON.uni-icons.event -->
+
+<!-- UTSCOMJSON.uni-icons.component_type -->
+
+<!-- UTSCOMJSON.uni-icons.children -->
+
+<!-- UTSCOMJSON.uni-icons.example -->
+
+<!-- UTSCOMJSON.uni-icons.reference -->

package/data/uni-app-x-docs/component/uni-ui-x/uni-link.md

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-link
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-link-x
 ---
 
 <!-- UTSCOMJSON.uni-link.name -->

package/data/uni-app-x-docs/component/uni-ui-x/uni-nav-bar.md

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-nav-bar
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-nav-bar-x
 ---
 
 <!-- UTSCOMJSON.uni-nav-bar.name -->

package/data/uni-app-x-docs/component/uni-ui-x/uni-number-box.md

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-number-box
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-number-box-x
 ---
 
 <!-- UTSCOMJSON.uni-number-box.name -->

package/data/uni-app-x-docs/component/uni-ui-x/uni-rate.md

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-rate
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-rate-x
 ---
 
 <!-- UTSCOMJSON.uni-rate.name -->

package/data/uni-app-x-docs/component/video.md

@@ -102,7 +102,7 @@ video的操作api为[uni.createVideoContext()](../api/create-video-context.md)
 	</list-item>
 </list-view>
 
-<script setup lang="uts">
+<script setup lang="ts">
 //... 其他代码
 function _onRecycle(e: UniVideoRecycleEvent, index: number) {
   console.log(`onRecycle ${index}`, JSON.stringify(e.detail));
@@ -135,5 +135,5 @@ function _onReuse(e: UniVideoReuseEvent, index: number) {
 - video 默认宽度为300px，高度为225px。（App平台从 uni-app x 4.0起支持该默认宽高）
 - 5.13版本以前，App平台的video默认拦截触摸事件，会导致父组件无法响应触摸事件。5.13起在非全屏时不再拦截touch，仅在全屏时拦截。
 - `HarmonyOS` 平台适配小窗需要在 `modules.json5` 中配置 `"preferMultiWindowOrientation": "landscape_auto"` [详情](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V13/module-configuration-file-V13#abilities%E6%A0%87%E7%AD%BE?ha_source=Dcloud&ha_sourceId=89000448)
-- app-iOS平台暂不支持在dialogPage中调用createVideoContext。
+- app-iOS平台VDOM模式下暂不支持`(Vapor模式支持)` 在dialogPage中调用createVideoContext（）。
 - 5.07版本起，app-android、app-iOS平台不再支持codec、play-strategy属性。

package/data/uni-app-x-docs/component/view.md

@@ -13,7 +13,8 @@ view组件是 uni-app x 最基本的视图容器，它的作用类似于HTML中
 #### hover-class说明@hover-class
 
 - 为什么使用`hover-class`？使用 css :active伪类来实现点击态，很容易触发，并且滚动或滑动时点击态不会消失，体验较差。小程序平台均给view引入了`hover-class`，考虑到跨端兼容和体验，建议使用 `hover-class` 属性来实现点击态效果。并且App平台目前暂不支持css伪类。
-
+- ios/harmony 暂不支持透传属性 `hover-stop-propagation`、`hover-start-time`、`hover-stay-time`
+- 微信小程序/支付宝小程序 暂不支持透传
 
 <!-- UTSCOMJSON.view.event -->
 

package/data/uni-app-x-docs/css/common/at-rules.md

@@ -31,7 +31,13 @@ web中加载字体图标，有 `unicode直显` 和 `伪元素+content` 2种方
 
 有些字体图标网站导出代码时，默认使用`伪元素+content`方式，需要注意这个坑，改用 unicode直显。
 
-unicode直显方式的性能优于伪元素方式，尤其是text组件设置flatten属性拍平后性能更佳。缺点是源码阅读的直观性略差，但对于AI来说倒不是问题。
+unicode直显方式的性能优于伪元素方式，尤其是text组件设置flatten属性拍平后性能更佳。
+缺点是源码阅读的直观性略差。
+
+还有一种解决方式是封装成组件，参考[uni-icons组件](../../component/uni-ui-x/uni-icons.md)，用type来表示，这样源码的可读性更佳。比如
+```vue
+<uni-icons type="search" />
+```
 
 注意text组件直显unicode，需要用 <code v-pre>{{'\u'}}</code> 的方式包裹。
 另外注意实体字符和unicode的区别。
@@ -64,7 +70,7 @@ app平台的内置组件和API用到了一些字体，同时共享出来给开
   <text style="font-family: uni-icon;font-size: 64px;">{{uniIcon}}</text>
 </template>
 
-<script setup lang="uts">
+<script setup>
   const uniIcon = ref<string>('\ue601')
 </script>
 ```

package/data/uni-app-x-docs/css/common/selector.md

@@ -2,10 +2,10 @@
 
 App平台，支持的选择器比web少。这源于开发进度、性能、运行时体积、AI友好度等多方面考虑。
 
-支持过多的选择器，会引入复杂的css优先级问题，这会导致性能下降，AI也容易搞错css优先级。
-简单的class，可能多写几行代码，但对AI来说这不算什么，反而复杂的css权重让AI难以排查问题。\
+支持过多的选择器，会引入复杂的css优先级问题，这会导致性能下降，AI也容易搞错css优先级。\
+简单的class，可能多写几行代码，但对AI来说这不算什么，反而复杂的css权重让AI难以排查问题。
 
-uni-app x 额外引入了page选择器，该选择器是小程序规范，uni-app x 中全平台均支持。
+uni-app x 额外引入了 `page` 选择器，该选择器是小程序规范，uni-app x 中全平台均支持。
 
 <!-- CSSJSON.selector_values.compatibility -->
 

package/data/uni-app-x-docs/css/common/style-isolation.md

@@ -92,7 +92,7 @@ VDOM 模式，考虑到向下兼容问题，目前没有废弃老版样式隔离
 使用示例：
 - 组合式示例
 ```vue
-<script setup lang="uts">
+<script setup>
 	defineOptions({
 		styleIsolation: 'isolated' //表示隔离，不受外部影响
 	})
@@ -159,7 +159,7 @@ Switch组件示例源码：
     <view class="uni-switch-thumb" :class="thumbClass"></view> <!-- 这里是圆球view -->
   </view>
 </template>
-<script lang="uts" setup>
+<script lang="ts" setup>
 const props = withDefaults(defineProps<SwitchProps>(), {
   thumbClass: '' // 定义一个thumbClass属性
 })
@@ -240,7 +240,7 @@ external-style是内联字符串，不受样式隔离策略影响，它永远生
     <view :style="thumbStyle" class="uni-switch-thumb" :class="thumbClass"></view> <!-- 这里是圆球view -->
   </view>
 </template>
-<script lang="uts" setup>
+<script lang="ts" setup>
 const props = withDefaults(defineProps<SwitchProps>(), {
   thumbClass: '' // 定义一个thumbClass属性
   thumbStyle: '' // 定义一个thumbStyle属性

package/data/uni-app-x-docs/css/visibility.md

@@ -12,6 +12,14 @@
 **注意**
 设置 visibility 为 hidden，或设置 display 为 none 都可以隐藏元素。差异是通过 visibility 隐藏元素仍然占据页面位置，通过 display 隐藏元素不占据页面位置。
 
+#### App平台差异
+App平台设置如果元素的 visibility 设置为 hidden，其子元素将不可见，即使子元素的 visibility 设置为 visible 也不可见。
+
+**蒸汽模式拍平(flatten)**  
+- app-android平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的子元素默认仍然会显示，子元素的显示状态由其自身的visibility决定
+- app-ios平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的非拍平子元素默认仍然会显示，非拍平子元素的显示状态由其自身的visibility决定，而拍平子元素会跟随此view不可见
+- app-harmony平台visibility暂不支持拍平
+
 <!-- CSSJSON.visibility.defaultValue -->
 
 <!-- CSSJSON.visibility.unixTags -->
@@ -20,7 +28,4 @@
 
 <!-- CSSJSON.visibility.example -->
 
-#### App平台差异
-App平台设置如果元素的 visibility 设置为 hidden，其子元素将不可见，即使子元素的 visibility 设置为 visible 也不可见。
-
 <!-- CSSJSON.visibility.reference -->