tmui-cli 2.0.6 → 5.3.1

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

@@ -780,6 +780,44 @@ uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。
   ```
 
 
+### JS引擎
+蒸汽模式下 Android 平台业务逻辑代码运行在Google V8 JS 引擎中。  
+Google V8 引擎通过 Android NDK 编译为 .so 动态链接库，且需要针对多种 CPU 架构（如 armeabi-v7a、arm64-v8a 等）分别打包。为严格控制 APK 的安装包体积，构建时默认禁用了 ICU 模块（编译参数 v8_enable_i18n_support = false）。  
+
+> 后续会提供配置使用包含 ICU 功能的 V8 引擎
+
+启用该裁剪后，所有与国际化（i18n）、本地化格式化以及复杂 Unicode 字符处理相关的 API 与特性将被限制或禁用，具体影响如下：  
++ [Intl](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl) 全局对象不可用  
+  Intl 全局对象及相关 API 将完全不可用，影响的具体 API 包括：  
+  - Intl.DateTimeFormat：日期和时间的本地化格式化  
+  - Intl.NumberFormat：数字、货币、百分比的本地化格式化  
+  - Intl.Collator：基于特定语言环境的字符串排序与比较  
+  - Intl.PluralRules：复数形式的匹配与选择规则  
+  - Intl.RelativeTimeFormat：相对时间格式化（如“3 天前”）  
+  - Intl.Segmenter：文本分词、断句与断字  
+  - Intl.ListFormat：连贯列表文本格式化（如“A、B 和 C”）  
+  - Intl.DisplayNames：标准代码/标识符（如国家/地区代码、语言代码）的显示名称转换  
++ 标准 String & Date 原型链方法本地化能力退化  
+  - 字符串转换退化：  
+    String.prototype.toLocaleLowerCase()：退化为普通的 toLowerCase()  
+    String.prototype.toLocaleUpperCase()：退化为普通的 toUpperCase()  
+    String.prototype.localeCompare()：无法按指定 locale 的字典顺序排序，直接退化为基于 Unicode 码点（Code Point）的逐字符比较  
+  - 日期与数字格式化退化：  
+    以下方法无法根据传入的 locale 参数（如 'zh-CN', 'en-US', 'de-DE'）生成本地化字符串，而是统一退化为固定的 ISO 或默认英文格式输出。  
+    Date.prototype.toLocaleString()  
+    Date.prototype.toLocaleDateString()  
+    Date.prototype.toLocaleTimeString()  
+    Number.prototype.toLocaleString()  
++ 复杂文本分词、大小写折叠与 Unicode 边界识别受限  
+  - Unicode 规范化受限：String.prototype.normalize() 方法在处理带重音符号或组合字符（Combining Characters）的字符串时，可能报错或无法准确转换。
+  - 边界文本识别削弱：缺少 Unicode 字符数据库（UCD）支持，在处理非 ASCII 字符、复杂语系（如泰语、阿拉伯语、印地语）及复合 Emoji 时可能产生异常：  
+    * 字符长度统计偏离：基于 UTF-16 单元格的 .length 属性在测量复合字符（如组合 Emoji 👨‍👩‍👧‍👦）时，无法反映真实的用户视觉字符（Grapheme Cluster）数量。  
+    * 字符截断破坏字形：使用 substring()、slice() 等方法切片时，极易在组合字符中间发生错位截断，导致显示乱码或产生非法占位符。  
++ 正则表达式 Unicode 属性转义匹配受限  
+  在正则表达式开启 u 或 v 标志（Unicode Mode）时，依赖 Unicode 属性匹配（Unicode Property Escapes）的功能会受到影响：  
+  例如 \p{UnicodeProperty} 或 \p{Script=Han}（用于匹配汉字、特定语种字符集或 Emoji 属性分类）等语法，因缺乏 ICU 提供的 UCD 数据库支持，会导致引擎抛出 SyntaxError 或无法正确识别非 ASCII 字符的属性。  
+
+
 
 ## 权限配置 @permissions  
 

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

@@ -4,7 +4,7 @@
 
 > HBuilderX 4.63之前的版本鸿蒙平台不支持根据使用情况自动添加模块，HBuilderX 4.63及之后的版本鸿蒙平台支持根据使用情况自动添加模块。鸿蒙平台独立于基础库之外的模块列表和安卓iOS不一致，详情参考：[鸿蒙平台模块配置](./manifest-harmony.md#modules)
 
-uni-app x的Android基础库体积是7M，打包后的apk体积是基础库的体积加上开发者的代码及代码引用的模块的体积。有些模块涉及so库，覆盖的cpu指令越多，包体积越大。
+uni-app x 打包后的体积是基础库的体积加上开发者的代码及代码引用的模块的体积。有些模块涉及so库，覆盖的cpu指令越多，包体积越大。
 
 在uni-app js引擎版中，内置模块如video，是开发者在manifest.json中手动勾选配置的。
 
@@ -169,9 +169,13 @@ HBuilderX3.93版本起，编译器支持扫描代码，摇树treeShaking，自
 再次强调，以上模块不属于ext组件或api，是内置模块。但如果你的代码中没有使用这些组件和api，打正式包或自定义基座时会被摇掉。
 
 
-### 手动配置使用的模块  
+### 手动配置使用的模块@manual
 
-uts插件中暂不支持摇树，如果uts插件中使用了以上模块，需在使用此uts插件的 uni-app x 项目 manifest.json 文件中手动添加：  
+有些场景无法通过摇树来决定打包哪些模块，比如：
+- 为了将来热更新考虑，提前打包一些模块到安装包中
+- uts插件中通过uni.xx的api调用了内置模块，这部分也暂不支持摇树识别
+
+此时需在项目 manifest.json 文件中手动添加模块：
 
 - HBuilderX 4.71 及以上版本  
   + Android平台  
@@ -274,6 +278,7 @@ HBuilderX4.31 支持打包界面直接勾选广告渠道，参考[App打包配
 | :-		| :-					|:-	|:-		|:-		|
 | gdt		| 腾讯优量汇广告联盟		|x	|3.99	|4.22	|
 | gm		| 穿山甲GroMore			|x	|3.99	|4.22	|
+| gm-content| 穿山甲内容联盟（短剧/信息流）|x	|5.31	|x		|
 | ks		| 快手广告联盟			|x	|3.99	|4.22	|
 | bd		| 百度百青藤广告联盟		|x	|3.99	|4.22	|
 | sigmob	| Sigmob广告联盟			|x	|3.99	|4.22	|
@@ -304,6 +309,25 @@ HBuilderX4.31 支持打包界面直接勾选广告渠道，参考[App打包配
 app平台默认`启动界面`为白色（暗黑模式下为黑色），为了避免等待加载开屏广告时白屏，建议开通开屏广告后在manifest中配置`启动界面`，详情参考[splash启动界面](./manifest-splashscreen.md)
 :::
 
+#### 短剧广告
+
+配置 `gm-content` 模块后，可使用短剧广告。短剧广告来自 uni-ad 内容聚合模块（短剧/信息流场景，对应穿山甲内容生态），用户免费观看指定集数后，观看激励视频解锁后续剧集。
+
+使用短剧广告需完成以下配置：
+
+1. 在 [uni-ad 后台](https://uniad.dcloud.net.cn/) 开通短剧广告位，获取广告位标识 `adpid`；
+2. 在穿山甲后台 `内容输出 -> 接入管理` 下载应用的 SDK 参数配置文件，重命名为 `gm_SDK_Setting.json`，放到项目根目录的 `nativeResources/android/assets/` 目录下；
+3. 制作自定义基座（标准基座不包含短剧运行时，会报错 `-5020`）。
+
+代码使用方式：
+
+- API 模式（自行搭建短剧列表页，调用 `open` 打开原生播放页）：[uni.createDramaAd](../api/create-drama-ad.md)
+- 组件模式（内嵌短剧首页 Fragment）：[ad-drama 组件](../component/ad-drama.md)
+
+::: warning 注意事项
+短剧广告仅支持 Android 平台。
+:::
+
 #### 广告缓存
 
 广告SDK在运行时可能会下载apk安装文件，占用手机的存储空间。下表列举了广告SDK的apk下载路径。开发者可以按需删除指定apk文件。

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

@@ -94,6 +94,8 @@ globalStyle节点里是所有页面都生效的全局样式配置。它的配置
 
 <!-- PAGESJSON.globalStyle_mp-alipay.table -->
 
+支付宝小程序默认开启页面回弹，可能影响触摸事件；可以将 `allowsBounceVertical` 配置为 `NO` 关闭页面回弹。
+
 
 #### mp-weixin 配置项列表 @globalstyle-mp-weixin
 
@@ -180,6 +182,7 @@ pages节点里注册页面，数据格式是数组，数组每个项都是一个
 	* 小程序平台，pages.json中各个颜色的设置仅支持普通的16进制数值。App和Web支持设为transparent，即透明。
 	* 如需动态设置状态栏颜色，使用api [uni.setNavigationBarColor](../api/set-navigation-bar-color.md)
 	* 当navigationStyle设为custom时，原生导航栏不显示。此时需要注意系统状态栏背景色恒为透明。
+	* 支付宝小程序不支持完全自定义导航栏，配置 `navigationStyle: "custom"` 不生效。
 	* 注意不同手机的状态栏高度并不相同，如需获取本机的状态栏高度，使用api [uni.getWindowInfo](../api/get-window-info.md) 或 css变量 [--status-bar-height](../css/common/variable.md)
 	* 配置hideStatusBar可以隐藏状态栏
 	* 同时隐藏状态栏hideStatusBar和底部指示器hideBottomNavigationIndicator，可以实现页面全屏

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

@@ -1,6 +1,15 @@
 # 组件概述
 
-## 组件定义
+web的概念叫标签，比如div、input。
+这些标签都很重，div即用于布局、也用于文字显示、也用于滚动容器；input除了输入框，还承载了几乎所有表单组件的功能。
+
+uni-app x，和小程序采用了相同的组件规范。不叫标签，就叫组件。
+
+这套组件规范的语义更明确：view是布局组件、text是文字组件、scroll-view是滚动组件、input是输入框组件、checkbox/radio/slider/switch/也各自是独立组件。
+
+清晰的语义，也不容易让AI搞错。
+
+## 什么叫组件
 
 - 组件是视图层的基本组成单元。
 - 组件是一个单独且可复用的UI及配套功能模块的封装。
@@ -130,7 +139,7 @@ uni-app x文档规范中有一批标准组件，同时也支持扩展自定义
 即开发者自己按照vue组件规范编写的uvue文件。这种组件一般由前端工程师编写。详见[uvue组件模型介绍](../vue/component.md)
 - 2.2 原生uts组件
 这是一种App平台专用的扩展机制。
-由Android或iOS的原生开发者，按照uts插件的组件规范编写，把原生的view嵌入到uvue页面上，它在编写时贴近但不完全是vue组件开发规范。\
+由Android、iOS、鸿蒙的原生开发者，按照uts插件的组件规范编写，把原生的view嵌入到uvue页面上，它在编写时贴近但不完全是vue组件开发规范。\
 不过对于组件的使用者来讲，用法就是标准的uvue组件了。详见[uts组件开发指南](../plugin/uts-component.md)\
 uts原生组件，下载组件到项目后（或自己按规范编写），在页面template里直接引用即可。无需导入注册组件。
 
@@ -159,7 +168,6 @@ easycom组件是uni-app(x)提供的一种易用方式，它通过一个路径规
 
 组件开发完毕后可发布到插件市场，插件作者指南：[详见](https://doc.dcloud.net.cn/uni-app-x/plugin/publish.html)
 
-<!-- TODO下面这段应该挪走 -->
 ## 调用组件方法@methods
 
 需要把组件分为 内置组件、easycom组件、非easycom组件，这3种组件有不同的方法调用方式。[详情](../vue/component.md#page-call-component-method)

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

@@ -73,6 +73,7 @@
 * [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-index-bar | 索引条](./uni-ui-x/uni-index-bar.md)

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

@@ -0,0 +1,53 @@
+<!-- ## ad-drama -->
+
+<!-- UTSCOMJSON.ad-drama.name -->
+
+<!-- UTSCOMJSON.ad-drama.description -->
+
+ad-drama 组件是短剧广告的组件模式接入方式：组件挂载即自动加载短剧模块，适合快速接入短剧广告。
+
+与 API 模式（[uni.createDramaAd](../api/create-drama-ad.md)）的区别：组件模式直接使用渠道提供的短剧首页界面（含推荐、榜单等内容分发），无需自行搭建短剧列表页；API 模式则自行搭建列表页，可深度定制样式与业务。
+
+- 示例Demo介绍：[详见](https://gitcode.com/dcloud/uni-ad-drama)
+- uni-ad的业务介绍：[详见](https://uniapp.dcloud.net.cn/uni-ad/)
+
+**开通配置广告**
+
+[开通广告步骤详情](https://uniapp.dcloud.net.cn/uni-ad/ad-open.html)
+
+**Tips**
+- 标准基座不支持测试短剧功能。
+- 使用短剧组件需要先开通穿山甲广告。开通问题请咨询：[uni-ad交流群](https://im.dcloud.net.cn/#/?joinGroup=65d85fc09847e92db03ff81a)。
+- 标准基座不包含短剧运行时，需制作自定义基座后运行，否则报错 `-5020`。
+
+### 配置文件
+
+在穿山甲后台 内容输出->接入管理 找到需要接入内容SDK的应用，点击"下载SDK参数配置"，然后将SDK配置文件（例如 sdk_setting_file.json）拷贝到项目的 assets 文件夹下。
+
+![](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)。
+
+<!-- UTSCOMJSON.ad-drama.readme -->
+
+<!-- UTSCOMJSON.ad-drama.compatibility -->
+
+<!-- UTSCOMJSON.ad-drama.attribute -->
+
+<!-- UTSCOMJSON.ad-drama.fileFormates -->
+
+<!-- UTSCOMJSON.ad-drama.event -->
+
+<!-- UTSCOMJSON.ad-drama.component_type -->
+
+<!-- UTSCOMJSON.ad-drama.children -->
+
+## Tips
+
+
++ 短剧广告仅支持 Android 平台。
+
+<!-- UTSCOMJSON.ad-drama.example -->
+
+<!-- UTSCOMJSON.ad-drama.reference -->

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

@@ -20,6 +20,8 @@ camera组件的操作api为[uni.createCameraContext()](../api/create-camera-cont
 
 给camera组件设一个id属性，将id的值传入uni.createCameraContext()，即可得到camera组件的上下文对象，进一步可使用`.takePhoto()`、`.startRecord()`等方法。
 
+支付宝小程序需要在 camera 组件初始化完成、触发 `onReady` 回调后再调用 `uni.createCameraContext`，并且必须传入 camera 组件的 `id`。
+
 <!-- UTSCOMJSON.camera.example -->
 
 ### 依赖库版本

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

@@ -38,6 +38,8 @@ uni-app x 中废弃了老版方案，使用了 W3C 规范和微信小程序的
 
 注意：新版规范需要开发者根据自己的场景手动处理高清屏问题。
 
+支付宝小程序通过 `createImage` 获取图片对象时，`src` 不能设置为本地图片；必须在 `canvas` 组件的 `onReady` 回调中获取 canvas 实例和上下文。
+
 canvas相关的API较多，参考如下：
 
 - [W3C 规范](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/canvas)

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

@@ -93,8 +93,8 @@ App端手指按下后在组件区域内移动不会取消tap/click事件的触
 
 ### 冒泡事件系统
 
-> DOM事件主要有三个阶段：`捕获阶段`、`目标阶段`和`冒泡阶段`。
->
+DOM事件主要有三个阶段：`捕获阶段`、`目标阶段`和`冒泡阶段`。
+
 > App平台目前暂不支持事件的捕获阶段编程。
 
 以点击事件为例，当触发点击时，
@@ -123,6 +123,8 @@ App端手指按下后在组件区域内移动不会取消tap/click事件的触
 ### Bug & Tips
 
 - uni-app x 4.0以前，连续触发`click`或`tap`事件，可能会出现事件丢失的情况。请升级新版
+- 支付宝小程序的触摸事件参数不提供 `stopPropagation` 和 `preventDefault` 方法。
+- 支付宝小程序的 `longpress` 事件参数不提供 `touches` 信息。
 
 ::: info 调整
 

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

@@ -11,7 +11,7 @@
 <!-- UTSCOMJSON.glass-effect-view.compatibility -->
 
 - iOS26以下：组件降级为系统毛玻璃效果，"regular" 映射为系统标准毛玻璃材质，"clear" 映射为更轻、更透明的毛玻璃材质，interactive、tint-color 属性将不生效。
-- 液态玻璃（Liquid Glass）是iOS26特有效果。它和毛玻璃在显示效果、触摸效果上并不一样。如需其他平台上使用毛玻璃效果，应使用css的[backdrop-filter](../css/backdrop-filter.md)
+- 液态玻璃（Liquid Glass）是iOS26特有效果。它和毛玻璃在显示效果、触摸效果上并不一样。但多端适配时，其他平台应该和iOS26以下一样，降级为毛玻璃效果。毛玻璃/背景高斯模糊使用css的[backdrop-filter](../css/backdrop-filter.md)实现。
 
 <!-- UTSCOMJSON.glass-effect-view.attribute -->
 

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

@@ -17,20 +17,20 @@
 - 小程序平台支持的图片格式与浏览器类似。但由于不同小程序平台的webview版本不一样，需要具体查阅小程序平台的图片组件介绍。\
 	注意：webp在不同小程序平台策略不同，有的需要打开 webp 属性，有的仅支持来自服务器的webp。
 - App平台支持的图片格式如下：
-
-| 图片格式| Android							| iOS												| HarmonyOS	| 备注																					|
-| ---			| ---									| ---												| ---				| ---																					|
-| BMP			| √										| √													| √					|																							|
-| GIF			| √										| √													| √					|																							|
-| ICO			| √										| √													| √					|																							|
-| JPG			| √										| √													| √					|																							|
-| PNG			| √										| √													| √					|																							|
-| WebP		| √										| √													| √					|iOS 14+ 为硬解码，低版本为软解码（软解性能较低）	|
-| HEIC		| √ (Android10+)			| √													| √					|																							|
-| AVIF		| √ (HBuilderX5.08+)	| √ (iOS16+)								| x					|系统支持硬解才有优势，使用三方软解还不如换用其他格式	|
-| TIF			| x										| √													| x					|																							|
-| SVG			| √ (HBuilderX4.81+)	| √ (iOS13+ HBuilderX4.81+)	| ️√				|	不支持svg动画。某些场景会解成位图渲染，[详见](#svg-support)		|
-
+
+| 图片格式| Android							| iOS												| HarmonyOS	| 备注																					|
+| ---			| ---									| ---												| ---				| ---																					|
+| BMP			| √										| √													| √					|																							|
+| GIF			| √										| √													| √					|																							|
+| ICO			| √										| √													| √					|																							|
+| JPG			| √										| √													| √					|																							|
+| PNG			| √										| √													| √					|																							|
+| WebP		| √										| √													| √					|iOS 14+ 为硬解码，低版本为软解码（软解性能较低）	|
+| HEIC		| √ (Android10+)			| √													| √					|																							|
+| AVIF		| √ (HBuilder5.08+)	| √ (iOS16+)								| x					|系统支持硬解才有优势，使用三方软解还不如换用其他格式	|
+| TIF			| x										| √													| x					|																							|
+| SVG			| √ (HBuilder4.81+)	| √ (iOS13+ HBuilder4.81+)	| ️√				|	不支持svg动画。某些场景会解成位图渲染，[详见](#svg-support)		|
+
 
 如需其他图片格式，可自行开发uts组件插件或搜索插件市场，如
 - [apng插件](https://ext.dcloud.net.cn/search?q=apng&orderBy=Relevance&cat1=8&cat2=82)
@@ -55,14 +55,22 @@
 	* 鸿蒙平台 VDOM 模式 image 组件使用 arkUI 的 image 组件，缓存策略[另见](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-image?ha_source=Dcloud&ha_sourceId=89000448)
 	* 鸿蒙平台蒸汽模式image组件使用[imageknifepro](https://gitcode.com/openharmony-sig/imageknifepro)库(1.0.12)，自带缓存策略，内存缓存256张128MB，磁盘缓存512张128MB，超限采用LRU淘汰。
 
-### 关于svg格式的矢量能力@svg-support
+### svg注意事项@svg-support
+
+1. web平台以外的平台，均不支持svg动画。动画推荐改用基于lottie的[animation-view](./animation-view.md)，全平台均支持。
+
+2. svg图标换色注意事项：
 
-svg 是矢量图片，可以无极缩放而不失真。但在以下情况，会把svg转成位图渲染，此时将丢失矢量能力。
+非web平台，不管小程序还是App，均不支持内联svg标签，无法像web那样通过内联标签实现svg图标换色。
+- 替代方案1：改用字体图标（推荐）。
+- 替代方案2：准备多个svg，动态设置src。可以用独立文件，也可以使用 Data URL。但此方案无法通过css变量设置，暗黑适配时需要写脚本动态修改src。
+- 替代方案3：小程序平台，可以利用 filter: drop-shadow 配合 overflow: hidden，可以将原图标的形状“投影”出新的颜色，并把原图标隐藏。App平台不支持此用法。
 
-- 鸿蒙平台蒸汽模式
-	* 如果启用了 `flatten` 拍平，则会转为位图。
-	* 设置部分 `mode` 属性进行图像裁剪，会转为位图进行裁剪。`mode` 设置为 `scaleToFill/aspectFit/aspectFill` 可以保持矢量能力，设置为其它值会转位图裁剪。
-	* 如果 `src` 设置了 `data:image/svg+xml;base64,...` 这种形式的 url，则会转为位图。
+3. 鸿蒙平台部分情况会按位图渲染，失去矢量能力
+svg 是矢量图片，可以无极缩放而不失真。但鸿蒙平台以下情况，会把svg转成位图渲染，此时将丢失矢量能力。
+* 如果启用了 `flatten` 拍平，则会转为位图。
+* 设置部分 `mode` 属性进行图像裁剪，会转为位图进行裁剪。`mode` 设置为 `scaleToFill/aspectFit/aspectFill` 可以保持矢量能力，设置为其它值会转位图裁剪。
+* 如果 `src` 设置了 `data:image/svg+xml;base64,...` 这种形式的 url，则会转为位图。
 
 <!-- UTSCOMJSON.image.children -->
 
@@ -76,4 +84,5 @@ svg 是矢量图片，可以无极缩放而不失真。但在以下情况，会
 - 图片文件需在static目录（项目下或uni_modules下都支持static目录）下，或者import导入文件，否则文件不会被copy到最终的包中，导致无法访问
 - app-android平台由于默认启用了图片缩放（即根据组件实际宽高加载图片，以节省内存），所以可能导致load事件返回的图片尺寸并非图片原始尺寸
 - app-android平台不支持CMYK色彩的图片，[详见](https://github.com/facebook/fresco/issues/1404)
-- app-ios平台 VDOM模式的image组件不支持padding style（padding-top、padding-left、padding-right、padding-bottom）
+- app-ios平台 VDOM模式的image组件不支持padding style（padding-top、padding-left、padding-right、padding-bottom）
+- 支付宝小程序中，给 `image` 设置 `padding` 时图片仍可能占满组件区域，不能依赖 `padding` 改变图片的实际显示区域。

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

@@ -106,6 +106,8 @@ web平台的inputmode的浏览器兼容性如下： Chrome >= 66、Edge >= 79、
 
 
 ## Tips
+- 支付宝小程序二级页面设置 `focus` 为 `true` 时不会自动聚焦
+- 支付宝小程序 `type="number"` 且 `maxlength="-1"` 时不会触发 `input` 事件，也不能通过 CSS 修改光标颜色
 - html规范中input不仅是输入框，还有radio、checkbox、时间、日期、文件选择功能。但在uni-app规范中，input仅仅是输入框，其type属性代表不同的输入框。其他功能有单独的组件或API：[radio组件](radio-group.md)、[checkbox组件](checkbox-group.md)、[图片选择](../api/choose-image.md)、[视频选择](../api/choose-video.md)等。
 - input组件默认 width （宽度）为 100%。
 - 从uni-app x 4.0起，App-Android平台 input 点击输入框外的屏幕会自动收起软键盘。
@@ -118,4 +120,4 @@ web平台的inputmode的浏览器兼容性如下： Chrome >= 66、Edge >= 79、
 - 如需自定义软键盘，比如车牌键盘，在插件市场搜索[自定义键盘](https://ext.dcloud.net.cn/search?q=%E8%87%AA%E5%AE%9A%E4%B9%89%E9%94%AE%E7%9B%98&orderBy=Relevance&uni-appx=1)
 - 如需hideKeyBoard隐藏软键盘，在插件市场搜索[hideKeyBoard](https://ext.dcloud.net.cn/search?q=hideKeyBoard&orderBy=Relevance&uni-appx=1)
 - css变量的支持程度，需另见 [css变量文档](../css/common/function.md) 
-- 所有 boolean 类型的属性，只有设置为布尔类型的 false 才会关闭该属性，其他任何值（包括字符串 "false"）都会被当做 true 处理（微信小程序中空字符串会被视为 false）。
+- 所有 boolean 类型的属性，只有设置为布尔类型的 false 才会关闭该属性，其他任何值（包括字符串 "false"）都会被当做 true 处理（微信小程序中空字符串会被视为 false）。

package/data/uni-app-x-docs/component/page-container.md

@@ -29,6 +29,7 @@ page-container 的特点：
 - Web 暂不支持拦截侧滑返回和浏览器的后退按钮
 - `overlay-style` 设置 `pointer-events: none` 可以实现点击遮罩层不关闭弹窗
 - 居中弹出为全屏显示。此行为是为了对齐小程序的表现。由于遮罩层被覆盖，并不会触发 `click-overlay` 事件，可以自行调整 `custom-style` 的样式来规避此行为
+- 支付宝小程序中，当开启 `overlay` 并设置 `overlay-style` 后蒙层可能覆盖整个 `page-container` 内容区域，可以在 `overlay-style` 中补充 `z-index: 0` 规避此问题。
 
 <!-- UTSCOMJSON.page-container.children -->
 

package/data/uni-app-x-docs/component/page-meta.md

@@ -12,6 +12,10 @@
 
 <!-- UTSCOMJSON.page-meta.component_type -->
 
+### Tips
+
+更新 `scroll-top` 后，`page-font-size` 和 `root-font-size` 设置的文字大小可能丢失；可在 `page-style` 中设置 `font-size` 临时规避。
+
 <!-- UTSCOMJSON.page-meta.children -->
 
 <!-- UTSCOMJSON.page-meta.example -->

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

@@ -14,7 +14,7 @@
 
 <!-- UTSCOMJSON.picker-view.children -->
 
-### 支付宝小程序注意事项
+### Tips
 
 支付宝小程序动态设置 `picker-view` 指示器样式时可能出现偏移，建议使用静态配置，避免运行时修改指示器样式。
 

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

@@ -12,11 +12,9 @@ picker组件其实是基于[picker-view组件](picker-view.md)封装了一个弹
 
 或者使用开源组件[uni-data-picker](https://ext.dcloud.net.cn/plugin?id=3796)。这是也是基于[picker-view组件](picker-view.md)封装的云端一体组件，如果需要选择城市，那么推荐使用该组件。
 
-<!-- UTSCOMJSON.picker.attribute -->
-
-### 支付宝小程序注意事项
+支付宝小程序日期选择器的 `change` 事件返回值格式类似 `2026/10/11`，与微信小程序的 `2026-10-11` 不同。
 
-支付宝小程序不支持 `picker` 的 `mode` 属性，如需多平台兼容，需要为支付宝小程序单独处理选择能力。
+<!-- UTSCOMJSON.picker.attribute -->
 
 <!-- UTSCOMJSON.picker.event -->
 

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

@@ -104,5 +104,4 @@ App平台从蒸汽模式开始，新增了c语言实现的 rich-text。3个App
 ## Bug & Tips@tips
 - rich-text不支持video组件，如果涉及video，需拆分文本内容，在video前后各放置一个rich-text组件
 - 小程序的rich-text功能要弱一些，不支持rich-text中子内容的点击事件，如有这类需求，在小程序平台需要条件编译使用[mp-html](https://ext.dcloud.net.cn/search?q=mp-html)
-- App-Android 平台 vdom模式 且 mode=native 时，HTML String 类型的`<img/>`不支持自定义宽高，默认以 rich-text 组件宽度为基准等比缩放；节点列表类型的`<img />`支持自定义宽高。
-- App-Harmony App-iOS 平台 且 mode=native 时，暂不支持 `selectable` 属性。 
+- App-Android 平台 vdom模式 且 mode=native 时，HTML String 类型的`<img/>`不支持自定义宽高，默认以 rich-text 组件宽度为基准等比缩放；节点列表类型的`<img />`支持自定义宽高。

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

@@ -78,7 +78,7 @@ uni-ui x 提供了开源的自定义下拉刷新组件，可以体验：[uni-ref
 
 VDOM模式的scroll-view嵌套滚动需要更多手工工作。而蒸汽模式已经简化。
 
-### 蒸汽模式
+#### 蒸汽模式
 
 蒸汽模式已废弃 `type` 属性，只需要设置内层 scroll-view 的 `associative-container` 属性为 "nested-scroll-view" 即可开启嵌套模式。
 
@@ -140,11 +140,11 @@ VDOM模式的scroll-view嵌套滚动需要更多手工工作。而蒸汽模式
 下面的示例代码，在一个scroll-view中嵌套了一个list-view。在list-view上设置了custom-nested-scroll="true"。
 
 ```html
-<scroll-view style="height: 100%;" scroll-y="true" rebound ="false" nested-scroll-child="listview" @startnestedscroll="onStartNestedScroll" @nestedprescroll="onNestedPreScroll"
+<scroll-view style="height: 100%;" rebound ="false" nested-scroll-child="listview" @startnestedscroll="onStartNestedScroll" @nestedprescroll="onNestedPreScroll"
 	@stopnestedscroll="onStopNestedScroll">
 		...
 		<view style="height: 100px;">停靠视图</view>
-		<list-view id="listview"  class="child-scroll" scroll-y="true" custom-nested-scroll="true">
+		<list-view id="listview"  class="child-scroll" custom-nested-scroll="true">
 			...
 		</list-view>
 </scroll-view>
@@ -185,9 +185,13 @@ onNestedPreScroll(event: NestedPreScrollEvent) {
 
 ### tips
 
+小程序的规范中，通过scroll-y和scroll-x设置可滚动方向。但作为一个布尔属性，scroll-y默认为false，导致不写scroll-y就无法滚动。
+
+在 uni-app x 中，修改了这个规范，scroll-view 默认就是可垂直滚动的，替代scroll-y和scroll-x的是新属性`direction`，
+它的值域有：none、all、horizontal、vertical，并且默认值是vertical。\
+编译到小程序时，也会用`direction`来替代scroll-y和scroll-x。
+
 #### App平台通用注意事项
-+ App-Android、App-iOS平台的滚动方向不能同时横竖，如需同时水平和垂直滚动，可以套2层，一个横一个竖，来实现2个方向能滚动。
-+ App平台scroll-view组件不支持动态切换横竖滚动方向
 + App平台scroll-view组件的overflow属性不支持配置visible
 + App平台scroll-view组件默认高度取值：
 	- scroll-view组件的子元素高度之和未超过scroll-view组件的父元素高度：
@@ -202,11 +206,9 @@ onNestedPreScroll(event: NestedPreScrollEvent) {
 		
 + 横向滚动时注意关注flex方向，子内容如需横向排布需要加`flex-direction: row`。
 
-#### App平台蒸汽模式注意事项
-
-
 #### App平台VDOM模式注意事项
-
++ App-Android、App-iOS平台 在VDOM时，滚动方向不能同时横竖，如需同时水平和垂直滚动，可以套2层，一个横一个竖，来实现2个方向能滚动。
++ App平台scroll-view组件不支持动态切换横竖滚动方向
 
 <!-- UTSCOMJSON.scroll-view.example -->
 

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

@@ -238,5 +238,7 @@ App平台在VDOM模式时使用了自定义的css属性lines，在蒸汽模式
 web和小程序的text组件暂未支持max-lines组件属性，后续计划蒸汽模式的全平台text组件都将支持max-lines属性，并在web和小程序上编译为-webkit写法。
 
 ## Bug & Tips@tips
-- app-Android平台和app-iOS VDOM平台 selectable开启后，仅支持全部文字复制，暂不支持自由调整光标选择文字。如需自由选择文字，请使用[rich-text组件](rich-text.md)。web平台默认就是可复制文字的，selectable无效。
+- app平台text组件开启selectable后，仅支持全部文字复制，暂不支持自由调整光标选择文字。如需自由选择文字，请使用[rich-text组件](rich-text.md)。web平台默认就是可复制文字的，selectable无效。
 - web平台4.86版本起text组件调整为display:block，嵌套text组件时，子text默认display为inline。此前版本无论父子均为inline。如无必要请勿覆盖text的display样式，以免出现预期外的效果。
+- 支付宝小程序中的换行规则是：文本包含 `\n` 时换行，其他换行表示不会被当作换行处理。
+- 支付宝小程序的 `text` 不触发触摸相关事件，需要承载触摸事件时请使用 `view`。

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

@@ -75,8 +75,12 @@ inputmode 兼容性：Chrome >= 66、Edge >= 79、Firefox >= 95、Chrome Android
 
 ## placeholder-style和placeholder-class说明
 - uni-app x 4.41前，App平台仅支持`color`、`font-size`、`font-weight`。
-- uni-app x 4.41后，App平台新增支持`font-family`、`font-style`、`text-align`，其中`text-align`仅App-Android平台支持，App-iOS平台的placeholder位置取决于textarea的`text-align`。
-- App-HarmonyOS `placeholder-class` 暂不支持 css 变量。
+- uni-app x 4.41后，App平台新增支持`font-family`、`font-style`、`text-align`。
+
+VDOM模式注意事项：
+- `text-align`仅App-Android平台支持
+- App-iOS平台的placeholder位置取决于textarea的`text-align`。
+- App-HarmonyOS VDOM模式 `placeholder-class` 不支持 css 变量。
 
 ## Tips
 
@@ -86,5 +90,5 @@ inputmode 兼容性：Chrome >= 66、Edge >= 79、Firefox >= 95、Chrome Android
 * 由于Android系统限制，textarea的键盘右下角按钮只能是`换行`，所以暂时不提供`confirm-type`属性。
 * 当软键盘右下角为 换行 时，confirm-hold 恒为 true，设置为false也不生效，即按下 换行 时，软键盘不会消失。
 * 在Android 9以下的系统版本，样式`line-height`点击键盘换行时行间距设置无效，此问题是Android系统的bug，后续解决。
-* App平台蒸汽模式样式设置暂不支持 css 变量。
-* 所有 boolean 类型的属性，只有设置为布尔类型的 false 才会关闭该属性，其他任何值（包括字符串 "false"）都会被当做 true 处理（微信小程序中空字符串会被视为 false）。
+* 所有 boolean 类型的属性，只有设置为布尔类型的 false 才会关闭该属性，其他任何值（包括字符串 "false"）都会被当做 true 处理（微信小程序中空字符串会被视为 false）。
+* 支付宝小程序默认开启字数显示功能，真机上外层套用 `scroll-view` 时，点击 textarea 内容可能溢出组件范围。

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

@@ -0,0 +1,21 @@
+<!-- UTSCOMJSON.uni-combox.name -->
+
+<!-- UTSCOMJSON.uni-combox.description -->
+
+<!-- UTSCOMJSON.uni-combox.readme -->
+
+<!-- UTSCOMJSON.uni-combox.compatibility -->
+
+<!-- UTSCOMJSON.uni-combox.attribute -->
+
+<!-- UTSCOMJSON.uni-combox.fileFormates -->
+
+<!-- UTSCOMJSON.uni-combox.event -->
+
+<!-- UTSCOMJSON.uni-combox.component_type -->
+
+<!-- UTSCOMJSON.uni-combox.children -->
+
+<!-- UTSCOMJSON.uni-combox.example -->
+
+<!-- UTSCOMJSON.uni-combox.reference -->

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

@@ -132,8 +132,8 @@ function _onReuse(e: UniVideoReuseEvent, index: number) {
 
 ### Bug & Tips@tips
 - 标准运行基座默认不包含intel x86 cpu的兼容so库，所以video组件在标准基座运行时无法在x86 cpu的设备上运行（常见于模拟器）。如需支持x86 cpu，请在manifest里配置`abiFilters`，打包或自定义基座后生效 [详见](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest.html#android)
-- 5.13版本以前，App平台的video默认拦截触摸事件，会导致父组件无法响应触摸事件。5.13起在非全屏时不再拦截touch，仅在全屏时拦截。
 - 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。
 - 5.07版本起，app-android、app-iOS平台不再支持codec、play-strategy属性。

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

@@ -0,0 +1,79 @@
+---
+title: tmui 3.2.0 组件库
+---
+
+<script setup>
+import webview from '../components/mobileWebview.vue'
+import headertips from '../components/headertips.vue'
+</script>
+
+<headertips></headertips>
+
+#### 展示组件
+
+# 倒计时器 TmCountdown
+
+倒计时，可以精确到秒，毫秒
+
+## :hot_pepper: 示例
+
+<webview url="https://tmui.design/h5by32/#/pages/index/countdown"></webview>
+
+::: details 示例模板
+
+<<< ../../../src/pages/index/countdown.vue{vue}
+
+:::
+
+## :hot_pepper: 兼容性
+
+平台兼容
+|H5|uniAPP|小程序|version|
+|---|---|---|---|
+|☑️|☑️|☑️|☑️|☑️|1.0.0|
+
+## :seedling: 参数
+| 参数名 | 类型 | 默认值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| time | number | 0 | - | 
+| actions | union | "" | - | 
+| format | string | "DD天HH时MM分SS秒" | - | 
+| autoStart | boolean | false | - | 
+| unit | union | "ss" | - | 
+| fontSize | string | "16" | - | 
+| color | string | "#333333" | - | 
+| captcha | boolean | false | 是否使用验证码模式启用后,整个应用不管你用了多少个此组件,倒计时都是共用的直到结束某一个结束,其它的才可以启用,这样可以保证,任何时候切换页面验证发送都能保证在60秒内的间隔,防止刷验证码. | 
+
+
+## :rose: 事件
+| 事件名 | 参数 | 返回数据 | 描述 |
+| --- | --- | --- | --- |
+| change | - | - | - | 
+| pause | - | - | - | 
+| start | - | - | - | 
+| complete | - | - | - | 
+
+
+## :corn: slot插槽
+| 插槽名 | 数据 | 描述 |
+| :--: | :--: |  :-- |
+| default | 名称：binding,status 类型：- 
+名称：binding,time 类型：- 
+名称：binding,label 类型：- 
+名称：binding,ms 类型：- 
+名称：binding,ss 类型：- 
+名称：binding,mm 类型：- 
+名称：binding,hh 类型：- 
+名称：binding,dd 类型：- 
+ | 插槽 | 
+
+
+## :green_salad: ref方法
+| 方法名 | 参数 | 返回值 | 描述 |
+| :--: | :--: | :--: | :-- |
+| start | - | - | 开始计时 | 
+| pause | - | - | 暂停计时 | 
+| reset | - | - | 重置 | 
+| getStatus | - | - | 获取当前状态 | 
+
+