tmui-cli 5.3.2 → 5.3.3

package/data/uniappx/app-vapor.md

@@ -491,46 +491,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不支持：
-    + 不支持 [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存在子元素，这些样式不会对非拍平的子元素产生效果
-  * 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属性，则会被自动忽略。
-
-#### 拍平（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
 - TODO：缺少Drawable。dom2的view、text创建足够快且支持拍平，故优先级不高
@@ -540,7 +501,7 @@ ninja: error: failed recompaction: Permission denied。
 
 其他还有一些差异，见文档的兼容性说明。
 
-## 使用uni-agent，从VDOM模式升级到蒸汽模式@vom2vapor
+## 使用uni-agent，从VDOM模式升级到蒸汽模式@vdom2vapor
 
 在uni-agent中有内置的skill，可以方便的升级vdom到蒸汽。
 

package/data/uniappx/collocation/manifest-android.md

@@ -768,7 +768,7 @@ Google V8 引擎通过 Android NDK 编译为 .so 动态链接库，且需要针
 
 在uni-app x项目中使用包含 ICU 功能的 V8 引擎，需在manifest.json中配置：  
 
-- HBuilderX 5.33 及以上版本  
+- HBuilderX 5.35 及以上版本  
   需通过 manifest.json 的`源码视图`在 "app-android" -> "distribute" -> "modules" 下添加 "v8-icu" 节点，如下示例：  
   ```json
   {

package/data/uniappx/component/_sidebar.md

@@ -77,8 +77,9 @@
   * [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-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/uniappx/component/animation-view.md

@@ -1,9 +1,9 @@
 ::: sourceCode
 ## animation-view
 
-> GitCode: https://gitcode.com/dcloud/uni-component/tree/alpha/uni_modules/uni-animation-view-x/components/animation-view
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-animation-view/components/animation-view
 
-> GitHub: https://github.com/dcloudio/uni-component/tree/alpha/uni_modules/uni-animation-view-x/components/animation-view
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-animation-view/components/animation-view
 
 Lottie 动画
 

package/data/uniappx/component/camera.md

@@ -15,7 +15,7 @@
 ### 属性 
 | 名称 | 类型 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| flash | auto \| on \| off \| torch | "auto" | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 4.61 / iOS 4.61（部分支持，见上） | 闪光灯，值为auto, on, off, torch |
+| flash | auto \| on \| off \| torch | "auto" | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 4.61 / iOS 4.61 / HarmonyOS x（部分支持，见上） | 闪光灯，值为auto, on, off, torch |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
 | auto | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 4.61 / iOS 4.61 / HarmonyOS x（部分支持，见上） | 自动 |

package/data/uniappx/component/canvas.md

@@ -1,9 +1,9 @@
 ::: sourceCode
 ## canvas
 
-> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-canvas-dom2/components/canvas
+> GitCode: https://gitcode.com/dcloud/uni-component/tree/alpha/uni_modules/uni-canvas
 
-> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-canvas-dom2/components/canvas
+> GitHub: https://github.com/dcloudio/uni-component/tree/alpha/uni_modules/uni-canvas
 
 > 组件类型：UniCanvasElement 
 

package/data/uniappx/component/common.md

@@ -11,9 +11,10 @@
 | class | string(string.ClassString) \| UTSJSONObject \| Array\<string(string.ClassString) \| UTSJSONObject> | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 组件的样式类，在对应的 css 中定义的样式类 |
 | ref | string \| Function | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | vue中组件的唯一标识，用来给子组件注册引用信息，[详见](https://doc.dcloud.net.cn/uni-app-x/vue/built-in.html#ref) |
 | data-* | any | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android √ / iOS(VDOM) 4.11 / iOS(Vapor) 5.21 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.21（部分支持，见上） | 自定义属性，组件上触发的事件时，会发送给事件处理函数 |
+| flatten | boolean | Web x / 微信小程序 x / 支付宝小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.0（部分支持，见上） | 拍平元素，仅蒸汽（vapor）模式的[view](https://doc.dcloud.net.cn/uni-app-x/component/view.html)、[text](https://doc.dcloud.net.cn/uni-app-x/component/text.html)、[image](https://doc.dcloud.net.cn/uni-app-x/component/image.html) 组件支持 |
 | android-* | any | Web x / Android 3.9 / iOS x / HarmonyOS x（部分支持，见上） | App-Android平台专有属性，详见[App-Android平台专有属性](https://doc.dcloud.net.cn/uni-app-x/component/common.html#attribute-android)章节 |
 
-#### data-*@dataset
+### data-*@dataset
 
 从 5.21 起全平台 dataset 调整为 UniDOMStringMap 类型。
 
@@ -31,6 +32,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），则无法优化。
+- 混合情况
+  只要存在至少两个相邻节点（父子或兄弟）同时拍平，即可获得性能优化。
+
 ### App-Android平台专有属性@attribute-android
 
 > android-开头的属性名称为App-Android平台专有属性