tmui-cli 5.3.1 → 5.3.3

package/data/uniappx/component/ad-drama.md

@@ -3,85 +3,53 @@
 
 uni-app x 短剧插件：uni.createDramaAd API 与 ad-drama 组件（独立运行，不依赖其他插件）
 
-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` 文件夹中。
 
 ### 兼容性 
 | Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
 | :- | :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.32 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
 
 ### 属性 
 | 名称 | 类型 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| adpid | string | "" | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 短剧广告位id，在uniAD官网申请广告位 |
-| free | number | 1 | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 初始可免费观看的剧集数 |
-| lock | number | 1 | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 单次激励视频可解锁的剧集数 |
-| urlCallback | any | null | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 服务端回调透传参数（userId/extra），激励发放时透传服务器校验 |
-| url-callback | any | null |   |   |
-| @load | (event: UniNativeViewEvent) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 短剧加载成功的回调 |
-| @error | (e:[UniDramaErrorEvent](#unidramaerrorevent)) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 短剧加载失败的回调 |
-| @click | (event: UniNativeViewEvent) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 点击短剧的回调 |
-| @close | (event: UniNativeViewEvent) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS x / HarmonyOS x（部分支持，见上） | 短剧关闭的回调 |
-
-### 事件
-#### UniDramaErrorEvent
-
-##### UniDramaErrorEvent 的属性值
-| 名称 | 类型 | 必填 | 描述 |
-| :- | :- | :- | :- |
-| detail | **IUniDramaError** | 是 |  |
-| 名称 | 类型 | 必备 | 描述 |
-| :- | :- | :- | :- |
-| errCode | number | 是 | 错误码<br/>- -5001 广告位标识adpid为空，请传入有效的adpid<br/>- -5002 无效的广告位标识adpid，请使用正确的adpid<br/>- -5003 广告位未开通广告，请在广告平台申请并确保已审核通过<br/>- -5004 无广告模块，打包时请配置要使用的广告模块<br/>- -5005 广告加载失败，请稍后重试<br/>- -5006 广告已经展示过了，请重新加载<br/>- -5007 广告不可用或已过期，请重新请求<br/>- -5008 广告不可用或已过期，请重新请求<br/>- -5009 广告类型不符，请检查后再试<br/>- -5011 打包或开通的渠道，不支持此类型广告<br/>- -5013 广告播放失败，请重新加载<br/>- -5020 短剧运行时加载异常，请使用包含短剧运行时的自定义基座 |
-| errSubject | string | 是 | 统一错误主题（模块）名称 |
-| data | any | 否 | 错误信息中包含的数据 |
-| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
-| errMsg | string | 是 |  |
-| bubbles | boolean | 是 | 是否冒泡 |
-| cancelable | boolean | 是 | 是否可以取消 |
-| type | string | 是 | 事件类型 |
-| target | UniElement | 否 | 触发事件的组件 |
-| currentTarget | UniElement | 否 | 当前组件 |
-| timeStamp | Long | 是 | 事件发生时的时间戳 |
-
-##### UniDramaErrorEvent 的方法
-| 名称 | 类型 | 必填 | 描述 |
-| :- | :- | :- | :- |
-| stopPropagation | () => void | 是 | 阻止当前事件的进一步传播 |
-| preventDefault | () => void | 是 | 阻止当前事件的默认行为 |
+| adpid | string | "" | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 短剧广告位id，在uniAD官网申请广告位 |
+| free | number | 1 | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 初始可免费观看的剧集数 |
+| lock | number | 1 | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 单次激励视频可解锁的剧集数 |
+| url-callback | DramaUrlCallback \| null | null | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 服务端回调透传参数（userId/extra），激励发放时透传服务器校验 |
+| @load | (event: UniNativeViewEvent) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 短剧加载成功的回调 |
+| @error | (event:[UniDramaErrorEvent](#unidramaerrorevent)) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 短剧加载失败的回调 |
+| @click | (event: UniNativeViewEvent) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 点击短剧的回调 |
+| @close | (event: UniNativeViewEvent) => void |   | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.32 / iOS x / HarmonyOS x（部分支持，见上） | 短剧关闭的回调 |
 
 ### 子组件 @children-tags
 不可以嵌套组件
 
-## Tips
-
-+ 短剧广告仅支持 Android 平台。
-
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=component.ad.ad-drama)
+- [插件市场](https://ext.dcloud.net.cn/plugin?id=30115)
 - [微信小程序文档](https://developers.weixin.qq.com/doc/search.html?source=enter&query=ad-drama&doc_type=miniprogram)
 - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=ad-drama&pageIndex=1&pageSize=10&source=doc_top&type=all)
 - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=ad-drama&scope=devdocs&source=docs)

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
+> 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
+> 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/button.md

@@ -1,6 +1,10 @@
 ::: sourceCode
 ## button
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/button
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/button
+
 > 组件类型：UniButtonElement 
 
  按钮
@@ -14,7 +18,7 @@
 | 名称 | 类型 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
 | disabled | boolean | false | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 是否禁用 |
-| hover-class | string(string.ClassString) | "button-hover" | Web x / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 指定按下去的样式类。当 hover-class="none" 时，没有点击态效果 |
+| hover-class | string(string.ClassString) | "button-hover" | Web √ / 微信小程序 √ / 支付宝小程序 √ / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 指定按下去的样式类。当 hover-class="none" 时，没有点击态效果 |
 | hover-stop-propagation | boolean | false | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 指定是否阻止本节点的祖先节点出现点击态 |
 | hover-start-time | number | 20 | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 按住后多久出现点击态，单位毫秒 |
 | hover-stay-time | number | 70 | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 手指松开后点击态保留时间，单位毫秒 |

package/data/uniappx/component/camera.md

@@ -1,9 +1,9 @@
 ::: sourceCode
 ## camera
 
-> GitCode: https://gitcode.com/dcloud/uni-component/tree/alpha/uni_modules/uni-camera
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-camera/components/camera
 
-> GitHub: https://github.com/dcloudio/uni-component/tree/alpha/uni_modules/uni-camera
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-camera/components/camera
 
 相机组件
 
@@ -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

@@ -29,7 +29,7 @@
 ### 属性 
 | 名称 | 类型 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| type | string |   | Web - / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 系统版本 - / Android - / iOS 系统版本 - / iOS - / HarmonyOS 系统版本 - / HarmonyOS -（部分支持，见上） | *(string)*<br/>指定 canvas 类型，支持 2d (2.9.0) 和 webgl (2.7.0) |
+| type | string |   | Web - / 微信小程序 4.41 / 支付宝小程序 5.31 / Android - / iOS - / HarmonyOS -（部分支持，见上） | *(string)*<br/>指定 canvas 类型，支持 2d (2.9.0) 和 webgl (2.7.0) |
 | canvas-id | string |   | Web - / 微信小程序 4.41 / 支付宝小程序 x / Android - / iOS - / HarmonyOS x（部分支持，见上） | *(string)*<br/>canvas 组件的唯一标识符，若指定了 type 则无需再指定该属性 |
 | disable-scroll | boolean |   | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(boolean)*<br/>当在 canvas 中移动时且有绑定手势事件时，禁止屏幕滚动以及下拉刷新 |
 | width | number | 0 | HarmonyOS(Vapor) 5.0（部分支持，见上） |   |

package/data/uniappx/component/checkbox-group.md

@@ -1,6 +1,10 @@
 ::: sourceCode
 ## checkbox-group
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/checkbox-group
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/checkbox-group
+
 > 组件类型：UniCheckboxGroupElement 
 
  多选框组

package/data/uniappx/component/checkbox.md

@@ -1,6 +1,10 @@
 ::: sourceCode
 ## checkbox
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/checkbox
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/checkbox
+
 > 组件类型：UniCheckboxElement 
 
  多选项。在1组check-group中可选择多个
@@ -20,7 +24,7 @@
 | borderColor | string(string.ColorString) | "#d1d1d1" | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | checkbox默认的边框颜色 |
 | activeBackgroundColor | string(string.ColorString) | "#ffffff" | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | checkbox选中时的背景颜色 |
 | activeBorderColor | string(string.ColorString) | "#d1d1d1" | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | checkbox选中时的边框颜色 |
-| foreColor | string(string.ColorString) | "#007aff" | Web 4.18 / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | checkbox的图标颜色，优先级大于color属性 |
+| foreColor | string(string.ColorString) | "#007aff" | Web 4.18 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 4.18 / iOS 4.18 / HarmonyOS 4.61 | checkbox的图标颜色，优先级大于color属性 |
 | icon-class | string(string.ClassString) |   | Web x / 微信小程序 x / 支付宝小程序 x / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 复选框选中图标的类名 |
 | checkbox-class | string(string.ClassString) |   | Web x / 微信小程序 x / 支付宝小程序 x / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 复选框未选中的类名 |
 | checkbox-active-class | string(string.ClassString) |   | Web x / 微信小程序 x / 支付宝小程序 x / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 复选框选中的类名 |

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平台专有属性
@@ -437,8 +484,8 @@ DOM事件主要有三个阶段：`捕获阶段`、`目标阶段`和`冒泡阶段
 ### UniEvent 的属性值 @unievent-values
 | 名称 | 类型 | 必备 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| bubbles | boolean | 是 |   | 是否冒泡 |
-| cancelable | boolean | 是 |   | 是否可以取消 |
+| bubbles | boolean | 是 | Web 4.0 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 是否冒泡<br/> |
+| cancelable | boolean | 是 | Web 4.0 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 是否可以取消<br/> |
 | type | string | 是 | Web 4.0 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 事件类型<br/> |
 | target | UniElement | 否 | Web 4.0 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 触发事件的组件<br/> |
 | currentTarget | UniElement | 否 | Web 4.0 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 当前组件<br/> |