tmui-cli 5.3.2 → 5.3.3

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

@@ -28,6 +28,9 @@
 
 <!-- UTSAPIJSON.onKeyboardHeightChange.returnValue -->
 
+**注意**
+微信小程序不支持返回值。
+
 <!-- UTSAPIJSON.onKeyboardHeightChange.example -->
 
 <!-- UTSAPIJSON.onKeyboardHeightChange.tutorial -->
@@ -42,6 +45,9 @@
 
 <!-- UTSAPIJSON.offKeyboardHeightChange.param -->
 
+**注意**
+微信小程序不支持 number 类型的参数，需传入 callback。
+
 <!-- UTSAPIJSON.offKeyboardHeightChange.returnValue -->
 
 <!-- UTSAPIJSON.offKeyboardHeightChange.example -->

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

@@ -1,4 +1,4 @@
-## uni.onMemoryWarning(UTSCallback) @onmemorywarning
+## uni.onMemoryWarning(callback) @onmemorywarning
 
 <!-- UTSAPIJSON.onMemoryWarning.description -->
 

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

@@ -0,0 +1,111 @@
+## ScrollViewContext
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.description -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.compatibility -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.extends -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.param -->
+
+
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.example -->
+
+### ScrollViewContext 的方法 @scrollviewcontext-methods
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.name -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.originName -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.description -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.compatibility -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.param -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.fileFormats -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.returnValue -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollTo.tutorial -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.name -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.originName -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.description -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.compatibility -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.param -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.fileFormats -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.returnValue -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.scrollIntoView.tutorial -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.name -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.originName -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.description -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.compatibility -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.param -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.fileFormats -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.returnValue -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerRefresh.tutorial -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.name -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.originName -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.description -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.compatibility -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.param -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.fileFormats -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.returnValue -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeRefresh.tutorial -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.name -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.originName -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.description -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.compatibility -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.param -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.fileFormats -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.returnValue -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.triggerTwoLevel.tutorial -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.name -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.originName -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.description -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.compatibility -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.param -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.fileFormats -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.returnValue -->
+
+<!-- CUSTOMTYPEJSON.ScrollViewContext.methods.closeTwoLevel.tutorial -->
+

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

@@ -26,7 +26,7 @@ uniCloud是基于serverless的云开发服务，它大幅降低开发者的开
 
 ### datacom 组件示例
 
-Vue 蒸汽模式不支持 `mixin` 语法，可使用属性展开和方法替代，详见 [datacom 组件规范](https://uniapp.dcloud.net.cn/component/datacom.html)。
+Vue 蒸汽模式不支持 `mixin`，datacom 组件改用组合式写法，选项式用法详见 [datacom 组件规范](https://uniapp.dcloud.net.cn/component/datacom.html)。
 
 ```html
 <template>

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

@@ -507,46 +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不支持：
-    + 不支持 [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
@@ -558,7 +519,7 @@ ninja: error: failed recompaction: Permission denied。
 其他还有一些差异，见文档的兼容性说明。
 
 
-## 使用uni-agent，从VDOM模式升级到蒸汽模式@vom2vapor
+## 使用uni-agent，从VDOM模式升级到蒸汽模式@vdom2vapor
 
 在uni-agent中有内置的skill，可以方便的升级vdom到蒸汽。
 

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

@@ -786,7 +786,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/uni-app-x-docs/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/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