tmui-cli 5.3.1 → 5.3.3

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的蒸汽模式比原生渲染更快？
 
@@ -507,43 +507,7 @@ ninja: error: failed recompaction: Permission denied。
     * 支持3D轮播
     * swiper-item的position属性的值固定为absolute
     * swiper默认高度为150px。如需根据内容高度撑开，可使用auto-height属性。
-- 新增：view、text、image这3个组件的flatten拍平属性
-
-  拍平即不创建独立元素，而是绘制在父上。在审查元素边界时无法看到红框。
-
-  `<view flatten></view>`
-
-  该属性为初始化属性，不支持动态修改。
-
-  被拍平的元素存在一些限制，因为本质上是把这拍平元素画在了它的父级上。限制具体如下：
-  * 拍平的元素无法支持事件（如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)
-    + [box-shadow](css/box-shadow.md) 不支持设置 inset 及 spreadRadius
-    + [display](css/display.md) 为 fixed 时显示存在缺陷，无法覆盖其它非 fixed 的元素
-    + [transition](css/transform.md) 动画不支持渲染相关（如background-color）的样式
-  * image组件拍平后无法播放动画，gif、webp动画仅显示第一帧
-  * view组件拍平后css属性transform、overflow、display、opacity存在缺陷，如果view存在子元素，这些样式不会对非拍平的子元素产生效果
-
-  注意：当自定义组件的单根节点是（view、text、image）时，该自定义组件会自动支持flatten属性，并将其传递给它的单根节点，如果在不符合要求的自定义组件上使用flatten属性，则会被自动忽略。
-
-#### 拍平（flatten）在鸿蒙平台注意事项
-支持 flatten属性的组件（如 View、Text、Image）在逻辑上均可设置为 true 以进行“拍平”，但实际性能优化效果需满足以下条件：
-`仅当存在至少两个相邻元素同时设置为拍平时，才能提升性能，否则可能导致性能下降。`
-
-相邻元素包括：
-- 兄弟节点
-  不要求直接紧挨，例如父元素 P 下有 C1、C2、C3 三个子元素，只要其中任意两个或以上设置为拍平，即可带来性能提升。
-- 父子节点
-  要求直接紧邻，例如 P → C → G 三层结构中：
-  + 对 P 和 C、C 和 G，或 P、C、G 同时拍平，可优化性能。
-  + 若仅对 P 和 G 拍平（中间隔了 C），则无法优化。
-- 混合情况
-  只要存在至少两个相邻节点（父子或兄弟）同时拍平，即可获得性能优化。
+- 新增：view、text、image这3个组件的[flatten](component/common.md#flatten)拍平属性
 
 
 ### Element API
@@ -555,7 +519,11 @@ ninja: error: failed recompaction: Permission denied。
 其他还有一些差异，见文档的兼容性说明。
 
 
-## 使用uni-agent，从VDOM模式升级到蒸汽模式@vom2vapor
+## 使用uni-agent，从VDOM模式升级到蒸汽模式@vdom2vapor
+
+在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/) 是支持的。

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.35 及以上版本  
+  需通过 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,15 @@
     * [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-expandable-text | 可折叠文本](./uni-ui-x/uni-expandable-text.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/common.md

@@ -6,7 +6,9 @@
 
 <!-- CUSTOMTYPEJSON.general-attribute.attribute -->
 
-#### data-*@dataset
+<!-- CUSTOMTYPEJSON.general-attribute.compatibility -->
+
+### data-*@dataset
 
 从 5.21 起全平台 dataset 调整为 UniDOMStringMap 类型。
 
@@ -24,8 +26,52 @@
 - App 蒸汽模式目前仅支持在 uvue 中使用 dataset；uts插件的utssdk中暂不支持获取 uvue/JS 层设置的 dataset。
 - 小程序平台仅支持通过事件 target/currentTarget 以及 createSelectorQuery、createIntersectionObserver 获取实际 dataset；通过 getElementById 无法获取到实际 dataset。
 
+### flatten@flatten
+蒸汽（vapor）模式新增的拍平属性，仅view、text、image 组件支持，此属性为初始化属性，不支持动态修改。
+
+拍平即不创建独立元素，而是绘制在父上。在审查元素边界时无法看到红框。
+
+`<view flatten></view>`
+
+被拍平的元素存在一些限制，因为本质上是把这拍平元素画在了它的父级上。限制具体如下：
+* 拍平的元素无法支持事件（如click、touch）
+* 拍平的元素不支持截图API：takeSnapshot
+* 拍平时如下css不支持：
+  + 不支持 [z-index](../css/z-index.md)
+  + 不支持 [background-image](../css/background-image.md)、[background-clip](../css/background-clip.md)
+  + 不支持 [pointer-events](../css/pointer-events.md)
+  + [box-shadow](../css/box-shadow.md) 不支持设置 inset 及 spreadRadius
+  + [position](../css/position.md) 为 fixed 时显示存在缺陷，无法覆盖其它非 fixed 的元素
+  + [transition](../css/transition.md) 动画不支持渲染相关（如background-color）的样式
+* 拍平时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组件拍平后存在以下缺陷：
+  + css样式transform、overflow、display、opacity，如果view存在子元素，这些样式不会对非拍平的子元素产生效果
+  + hover-class、hover-stop-propagation、hover-start-time、hover-stay-time属性在拍平时无效
+* image组件拍平后存在以下缺：
+  + 无法播放动画，gif、webp动画仅显示第一帧
+* text组件拍平后存在以下缺陷：
+  + hover-class、hover-stop-propagation、hover-start-time、hover-stay-time属性在拍平时无效
+  + user-select、selectable属性在拍平时无效
+
+注意：当自定义组件的单根节点是（view、text、image）时，该自定义组件会自动支持flatten属性，并将其传递给它的单根节点，如果在不符合要求的自定义组件上使用flatten属性，则会被自动忽略。
+
+#### 拍平（flatten）在鸿蒙平台注意事项
+支持 flatten属性的组件（如 View、Text、Image）在逻辑上均可设置为 true 以进行“拍平”，但实际性能优化效果需满足以下条件：
+`仅当存在至少两个相邻元素同时设置为拍平时，才能提升性能，否则可能导致性能下降。`
+
+相邻元素包括：
+- 兄弟节点
+  不要求直接紧挨，例如父元素 P 下有 C1、C2、C3 三个子元素，只要其中任意两个或以上设置为拍平，即可带来性能提升。
+- 父子节点
+  要求直接紧邻，例如 P → C → G 三层结构中：
+  + 对 P 和 C、C 和 G，或 P、C、G 同时拍平，可优化性能。
+  + 若仅对 P 和 G 拍平（中间隔了 C），则无法优化。
+- 混合情况
+  只要存在至少两个相邻节点（父子或兄弟）同时拍平，即可获得性能优化。
 
-<!-- CUSTOMTYPEJSON.general-attribute.compatibility -->
 
 ### App-Android平台专有属性@attribute-android