tmui-cli 5.3.2 → 5.3.3

package/data/uniappx/component/image.md

@@ -36,7 +36,7 @@
 | webp | boolean | true | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS(VDOM) - / HarmonyOS(Vapor) x（部分支持，见上） | 是否支持 WebP 格式，web、app平台默认支持 WebP 格式，不支持本属性，无法关闭对 WebP 格式的解析。 |
 | show-menu-by-longpress | boolean | false | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 开启长按图片显示识别小程序码菜单 |
 | draggable | boolean | false | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 鼠标长按是否能拖动图片(仅H5平台) |
-| flatten | boolean | false | 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（部分支持，见上） | 是否拍平组件 |
+| flatten | boolean | false | 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（部分支持，见上） | 是否拍平组件。拍平后存在事件、截图及 CSS 等限制，详见[拍平限制说明](https://doc.dcloud.net.cn/uni-app-x/component/common.html#flatten)。 |
 | @error | (event: [UniImageErrorEvent](#uniimageerrorevent)) => void |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 图片加载错误时触发，event.detail = { errMsg } |
 | @load | (event: [UniImageLoadEvent](#uniimageloadevent)) => void |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.9 / iOS 4.11 / HarmonyOS 4.61 | 图片加载完成时触发，event.detail = { width: '图片宽度px', height: '图片高度px' } |
 

package/data/uniappx/component/input.md

@@ -900,8 +900,8 @@ web平台的inputmode的浏览器兼容性如下： Chrome >= 66、Edge >= 79、
 同时使用 inputmode 和 comfirm-type 时，若设值冲突，键盘右下角按键类型由 comfirm-type 决定。
 
 ## 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位置取决于input的`text-align`。
+- uni-app x 4.41前，App平台(VDOM 模式)仅支持`color`、`font-size`、`font-weight`。
+- uni-app x 4.41后，App平台(VDOM 模式)新增支持`font-family`、`font-style`、`text-align`，其中`text-align`仅App-Android平台支持，App-iOS平台的placeholder位置取决于input的`text-align`。
 - placeholder-style的`font-size`样式不支持rpx单位。
 
 ## Tips

package/data/uniappx/component/label.md

@@ -12,7 +12,7 @@
 | :- | :- | :- | :- | :- | :- | :- | :- |
 | 4.0 | 4.41 | 5.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.21 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.11 | 4.71 |
 
-App平台可以用view加事件来替代label。
+App平台VDOM模式可以用view加事件来替代label。
 
 ### 属性 
 | 名称 | 类型 | 默认值 | 兼容性 | 描述 |

package/data/uniappx/component/map.md

@@ -10,14 +10,14 @@
 | :- | :- | :- | :- | :- | :- |
 | 4.0 | 4.41 | 5.31 | 4.31 | 4.31 | 4.61 |
 
-不同图商在不同平台的兼容性
+不同图商在不同平台的兼容性（高德为插件版本）
 |图商		|Web|Android|iOS	|harmony|
 |:-:		|:-:|:-:		|:-:	|:-:		|
 |腾讯		|√	|4.31+	|4.31+|4.61+	|
-|高德		|√	|√			|√		|x			|
+|高德		|√	|√		  |√	  |x			|
 |Google	|√	|x			|x		|x			|
 
-App标准基座里地图是腾讯地图，如需高德地图版本，请在插件市场单独安装，需要自定义基座运行：[官方高德地图插件](https://ext.dcloud.net.cn/plugin?id=25947)。该插件基于独立的 `<amap>` 组件实现，Android平台与内置 map 组件存在功能差异：属性、事件、上下文 API 均为内置 map 的子集；iOS平台自`1.3.0`起和内置map组件功能一致；Harmony 平台暂不支持，详见[高德地图插件功能差异](#amap)。
+App标准基座里地图是腾讯地图，如需高德地图版本，请在插件市场单独安装，需要自定义基座运行：[官方高德地图插件](https://ext.dcloud.net.cn/plugin?id=25947)。该插件基于独立的 `<amap>` 组件实现。Android平台自`1.4.0`起，本节列出的属性、事件和上下文 API 与内置 map 组件的功能对齐；iOS平台自`1.3.0`起功能对齐；Harmony 平台暂不支持。详见[高德地图插件功能差异](#amap)。
 
 除了内置支持的图商，还可以在插件市场寻找更多地图解决方案：
 1. [插件市场的三方地图插件](https://ext.dcloud.net.cn/search?q=%E5%9C%B0%E5%9B%BE&orderBy=Relevance&uni-appx=1)
@@ -331,15 +331,15 @@ App平台的高德地图由插件市场 [官方高德地图插件 uni-map-amap](
 
 | 差异项 | 内置 map 组件（腾讯地图） | 高德地图插件 |
 | :- | :-: | :-: |
-| 基础属性：longitude、latitude、scale、theme、min-scale、max-scale、layer-style、show-location、enable-satellite、enable-traffic | √ | √ |
-| markers 标记点 | √ | √ |
-| 覆盖物属性：polyline、polygons、circles、controls、include-points | √ | Android：x；iOS：1.3.0+ |
-| 手势视角属性：enable-3D、show-compass、enable-zoom、enable-scroll、enable-rotate、rotate、skew、enable-overlooking | √ | Android：x；iOS：1.3.0+ |
-| 显示控制属性：enable-poi、enable-building、enable-indoorMap | √ | Android：x；iOS：1.3.0+ |
-| 事件：@markertap、@controltap、@regionchange、@updated、@tap、@anchorpointtap、@poitap | √ | Android：x；iOS：1.3.0+ |
-| 上下文 API：`uni.createAmapContext` 及已实现的上下文方法 | √ | Android：x；iOS：1.3.0+ |
-
-其中，iOS 1.3.0 的上下文 API 支持 `getCenterLocation`、`moveToLocation`、`translateMarker`、`includePoints`、`getRegion`、`getScale`、`addMarkers`、`removeMarkers`、`moveAlong`、`addGroundOverlay`、`updateGroundOverlay`、`removeGroundOverlay`。高德插件使用 `uni.createAmapContext(mapId, component)`，与内置腾讯地图的 `uni.createMapContext(mapId)` 不同。
+| 基础属性：longitude、latitude、scale、theme、min-scale、max-scale、layer-style、show-location、enable-satellite、enable-traffic | √ | Android：1.0.0+；iOS：1.1.0+；Harmony：x |
+| markers 标记点 | √ | Android：1.0.0+；iOS：1.1.0+；Harmony：x |
+| 覆盖物属性：polyline（`<amap>` 使用 `polylines`）、polygons、circles、controls、include-points | √ | Android：1.4.0+；iOS：1.3.0+；Harmony：x |
+| 手势视角属性：enable-3D、show-compass、enable-zoom、enable-scroll、enable-rotate、rotate、skew、enable-overlooking | √ | Android：1.4.0+；iOS：1.3.0+；Harmony：x |
+| 显示控制属性：show-scale、enable-poi、enable-building、enable-indoorMap | √ | Android：1.4.0+；iOS：1.3.0+；Harmony：x |
+| 事件：@markertap、@controltap、@regionchange、@updated、@tap、@callouttap、@anchorpointtap、@poitap | √ | Android：1.4.0+；iOS：1.3.0+；Harmony：x |
+| 上下文 API：`uni.createAmapContext` 及已实现的上下文方法 | √ | Android：1.4.0+；iOS：1.3.0+；Harmony：x |
+
+高德插件通过 `uni.createAmapContext(mapId, component)` 获取上下文，与内置腾讯地图的 `uni.createMapContext(mapId)` 不同。Android 1.4.0+ 和 iOS 1.3.0+ 支持 `getCenterLocation`、`moveToLocation`、`translateMarker`、`includePoints`、`getRegion`、`getScale`、`addMarkers`、`removeMarkers`、`moveAlong`、`addGroundOverlay`、`updateGroundOverlay`、`removeGroundOverlay`。
 
 完整差异明细、插件版本支持情况及 API Key 配置说明，详见插件市场 [uni-map-amap 插件文档](https://ext.dcloud.net.cn/plugin?id=25947)。
 

package/data/uniappx/component/progress.md

@@ -31,10 +31,10 @@
 | :- |  :-: | :- |
 | backwards | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 动画从头播 |
 | forwards | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 动画从上次结束点接着播 |
-| background-color | string | "#ebebeb" | 微信小程序 x / 支付宝小程序 x / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 未选择的进度条的颜色 |
-| active-color | string | "#007aff" | 微信小程序 x / 支付宝小程序 x / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 已选择的进度条的颜色 |
+| background-color | string | "#ebebeb" | Web 4.0 / 微信小程序 x / 支付宝小程序 5.31 / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 未选择的进度条的颜色 |
+| active-color | string | "#007aff" | Web 4.0 / 微信小程序 x / 支付宝小程序 5.31 / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 已选择的进度条的颜色 |
 | @activeend | (event: [UniProgressActiveendEvent](#uniprogressactiveendevent)) => void |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 动画完成事件 |
-| ~~color~~ | string |   | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(string)*<br/>进度条颜色（请使用activeColor） |
+| ~~color~~ | string |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(string)*<br/>进度条颜色（请使用activeColor） |
 
 ### 事件
 #### UniProgressActiveendEvent

package/data/uniappx/component/radio.md

@@ -24,7 +24,7 @@
 | borderColor | string(string.ColorString) | "#d1d1d1" | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | radio默认的边框颜色 |
 | activeBackgroundColor | string(string.ColorString) | "#007AFF" | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | radio选中时的背景颜色，优先级大于color属性 |
 | activeBorderColor | string(string.ColorString) | "" | Web 4.0 / 微信小程序 x / 支付宝小程序 x / Android 3.9 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | radio选中时的边框颜色 |
-| foreColor | string(string.ColorString) | "#ffffff" | Web 4.18 / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18（部分支持，见上） | radio的图标颜色 |
+| foreColor | string(string.ColorString) | "#ffffff" | Web 4.18 / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.18（部分支持，见上） | radio的图标颜色 |
 | icon-class | string(string.ClassString) |   | Web x / 微信小程序 x / 支付宝小程序 x / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 单选框图标的类名 |
 | radio-class | string(string.ClassString) |   | Web x / 微信小程序 x / 支付宝小程序 x / Android(Vapor) 5.21 / iOS(Vapor) 5.11 / HarmonyOS(Vapor) 5.0（部分支持，见上） | 单选框的类名 |
 | radio-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/rich-text.md

@@ -53,9 +53,9 @@ uni-app x 蒸汽模式的rich-text native，应该是业内最佳的富文本呈
 | space | string |   | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | *(string)*<br/>显示连续空格 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| ensp | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 中文字符空格一半大小 |
-| emsp | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 中文字符空格大小 |
-| nbsp | Web x / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 根据字体设置的空格大小 |
+| ensp | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 中文字符空格一半大小 |
+| emsp | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 中文字符空格大小 |
+| nbsp | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 根据字体设置的空格大小 |
 | user-select | boolean | false | Web 5.25 / 微信小程序 4.41 / 支付宝小程序 x / Android(VDOM) 3.9 / Android(Vapor) 5.25 / iOS(VDOM) 4.11 / iOS(Vapor) 5.25 / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) 5.25（部分支持，见上） | 文本是否可选，该属性会使节点显示为 block |
 | selection-handle-color | string | "#4285F4FF" | 微信小程序 x / 支付宝小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.22 / HarmonyOS x（部分支持，见上） | 选择区域高亮手柄颜色 |
 | selection-background-color | string | "#33B5E566" | 微信小程序 x / 支付宝小程序 x / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.22 / HarmonyOS x（部分支持，见上） | 选择区域高亮背景颜色 |

package/data/uniappx/component/swiper.md

@@ -29,7 +29,7 @@
 | easing-function | string | "default" | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS 4.61（部分支持，见上） | 指定 swiper 切换缓动动画类型，有效值：default、linear、easeInCubic、easeOutCubic、easeInOutCubic |
 | 合法值 | 兼容性 |
 | :- |  :-: |
-| default | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） |
+| default | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 4.61 / iOS 4.61 / HarmonyOS 4.61（部分支持，见上） |
 | linear | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） |
 | easeInCubic | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS(VDOM) 4.61 / HarmonyOS(Vapor) x（部分支持，见上） |
 | easeOutCubic | Web x / 微信小程序 4.41 / 支付宝小程序 5.31 / Android x / iOS x / HarmonyOS 4.61（部分支持，见上） |

package/data/uniappx/component/switch.md

@@ -22,8 +22,8 @@
 | type | string |   | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） | 样式，有效值：switch, checkbox |
 | 合法值 | 兼容性 |
 | :- |  :-: |
-| switch | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x（部分支持，见上） |
-| checkbox | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x（部分支持，见上） |
+| switch | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
+| checkbox | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（部分支持，见上） |
 | backgroundColor | string(string.ColorString) |   | Web 4.18 / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | switch 的关闭状态背景颜色 |
 | activeBackgroundColor | string(string.ColorString) |   | Web 4.18 / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | switch 的开启状态背景颜色 |
 | foreColor | string(string.ColorString) |   | Web 4.18 / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | switch 的滑块背景颜色 |

package/data/uniappx/component/text.md

@@ -30,8 +30,8 @@
 | hover-stop-propagation | boolean | false | 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（部分支持，见上） | 指定是否阻止本节点的祖先节点出现点击态(祖先节点：指根节点到该节点路径上的所有节点都是这个节点的祖先节点) |
 | hover-start-time | number | 50 | 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（部分支持，见上） | 按住后多久出现点击态，单位毫秒 |
 | hover-stay-time | number | 400 | 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（部分支持，见上） | 手指松开后点击态保留时间，单位毫秒 |
-| max-lines | number |   | Web x / 微信小程序 x / 支付宝小程序 5.31 / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.0（部分支持，见上） | 文本的最大行数，默认不限制最大行数 |
-| flatten | boolean | false | 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（部分支持，见上） | 是否拍平组件 |
+| max-lines | number | -1 | Web x / 微信小程序 x / 支付宝小程序 5.31 / Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS(VDOM) x / HarmonyOS(Vapor) 5.0（部分支持，见上） | 文本的最大行数，默认不限制最大行数 |
+| flatten | boolean | false | 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（部分支持，见上） | 是否拍平组件。拍平后存在事件、截图及 CSS 等限制，详见[拍平限制说明](https://doc.dcloud.net.cn/uni-app-x/component/common.html#flatten)。 |
 
 ### hover-class
 App平台蒸汽模式（Vapor） `text` 组件新增支持 `hover-class` 实现点击态效果。
@@ -367,11 +367,15 @@ App 端不支持 `text` 组件中渲染多段文本，如果 `text` 组件中的
 
 多行文本设置最大行，目前在web规范中，需使用临时规范-webkit-line-clamp，并搭配display: -webkit-box。
 
-App平台在VDOM模式时使用了自定义的css属性lines，在蒸汽模式下改成了text的max-lines组件属性。
+App平台未支持`-webkit-` css，取而代之的方案是 text 组件上新增了 max-line 组件属性。
 
-使用max-lines属性时，不需要写 `display: -webkit-box;-webkit-box-orient: vertical;overflow: hidden;`。如果你需要兼容web，可以写在web的条件编译中。
+*App平台在VDOM模式时使用了自定义的css属性lines，在蒸汽模式下改成了text的max-lines组件属性。*
 
-web和小程序的text组件暂未支持max-lines组件属性，后续计划蒸汽模式的全平台text组件都将支持max-lines属性，并在web和小程序上编译为-webkit写法。
+web和小程序的text组件暂未支持max-lines组件属性。
+- 在web vdom模式和小程序中，由于text组件的外层有组件包装，所以在外层设置 `-webkit-line-clamp` 并不会生效。需要选择器向下再取。
+- 后续蒸汽模式的web平台将去除外层包装，让`-webkit-line-clamp` 直接生效。
+
+uni-ui x 提供了 [可折叠文本组件 uni-expandable-text](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/uni-expandable-text.html)，支持`全文`、`收起`等操作。
 
 ## Bug & Tips@tips
 - app平台text组件开启selectable后，仅支持全部文字复制，暂不支持自由调整光标选择文字。如需自由选择文字，请使用[rich-text组件](rich-text.md)。web平台默认就是可复制文字的，selectable无效。

package/data/uniappx/component/textarea.md

@@ -597,12 +597,8 @@ input和textarea组件都一个属性`adjust-position`，默认为true，即软
 inputmode 兼容性：Chrome >= 66、Edge >= 79、Firefox >= 95、Chrome Android >= 66、Firefox for Android >= 79、Safari on iOS >= 12.2、WebView Android >= 66
 
 ## 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`。
-
-VDOM模式注意事项：
-- `text-align`仅App-Android平台支持
-- App-iOS平台的placeholder位置取决于textarea的`text-align`。
+- uni-app x 4.41前，App平台(VDOM 模式)仅支持`color`、`font-size`、`font-weight`。
+- uni-app x 4.41后，App平台(VDOM 模式)新增支持`font-family`、`font-style`、`text-align`，其中`text-align`仅App-Android平台支持，App-iOS平台的placeholder位置取决于textarea的`text-align`。
 - App-HarmonyOS VDOM模式 `placeholder-class` 不支持 css 变量。
 
 ## Tips

package/data/uniappx/component/uni-ui-x/README.md

@@ -57,22 +57,24 @@ uni-ui x 没有写死的颜色和文字:
 
 ### uni-ui x 已支持的组件列表
 
-| 组件名 | 组件说明 |
-| --- | --- |
-| uni-badge-view | [数字角标](https://ext.dcloud.net.cn/plugin?name=uni-badge-view) |
-| uni-collapse | [折叠面板](https://ext.dcloud.net.cn/plugin?name=uni-collapse-x) |
-| uni-combox | [组合框](https://ext.dcloud.net.cn/plugin?name=uni-combox-x) |
-| uni-drag-cell | [可拖拽排序组件](https://ext.dcloud.net.cn/plugin?name=uni-drag-cell) |
-| uni-fab-button | [uni-fab-button](https://ext.dcloud.net.cn/plugin?name=uni-fab-button) |
-| uni-index-bar | [uni-index-bar](https://ext.dcloud.net.cn/plugin?name=uni-index-bar) |
-| uni-icons | [图标](https://ext.dcloud.net.cn/plugin?name=uni-icons-x) |
-| uni-link | [链接](https://ext.dcloud.net.cn/plugin?name=uni-link-x) |
-| uni-nav-bar | [uni-nav-bar](https://ext.dcloud.net.cn/plugin?name=uni-nav-bar-x) |
-| uni-number-box | [数字输入框](https://ext.dcloud.net.cn/plugin?name=uni-number-box-x) |
-| uni-rate | [评分](https://ext.dcloud.net.cn/plugin?name=uni-rate-x) |
-| uni-refresh-box | [uni-refresh-box](https://ext.dcloud.net.cn/plugin?name=uni-refresh-box) |
-| uni-tab | [选项卡](https://ext.dcloud.net.cn/plugin?name=uni-tab-bar) |
-| uni-time-format | [时间格式化](https://ext.dcloud.net.cn/plugin?name=uni-time-format) |
+| 组件名							| 组件说明																																|
+| ---									| ---																																			|
+| uni-badge-view			| [数字角标](https://ext.dcloud.net.cn/plugin?name=uni-badge-view)				|
+| uni-collapse				| [折叠面板](https://ext.dcloud.net.cn/plugin?name=uni-collapse-x)				|
+| uni-combobox				| [组合框](https://ext.dcloud.net.cn/plugin?name=uni-combobox)						|
+| uni-combox-x				| [已废弃组合框](https://ext.dcloud.net.cn/plugin?name=uni-combox-x)					|
+| uni-drag-cell				| [可拖拽排序组件](https://ext.dcloud.net.cn/plugin?name=uni-drag-cell)		|
+| uni-expandable-text	| [可折叠文本](https://ext.dcloud.net.cn/plugin?name=uni-expandable-text)													|
+| uni-fab-button			| [uni-fab-button](https://ext.dcloud.net.cn/plugin?name=uni-fab-button)	|
+| uni-index-bar				| [uni-index-bar](https://ext.dcloud.net.cn/plugin?name=uni-index-bar)		|
+| uni-icons						| [图标](https://ext.dcloud.net.cn/plugin?name=uni-icons-x)								|
+| uni-link						| [链接](https://ext.dcloud.net.cn/plugin?name=uni-link-x)								|
+| uni-nav-bar					| [uni-nav-bar](https://ext.dcloud.net.cn/plugin?name=uni-nav-bar-x)			|
+| uni-number-box			| [数字输入框](https://ext.dcloud.net.cn/plugin?name=uni-number-box-x)		|
+| uni-rate						| [评分](https://ext.dcloud.net.cn/plugin?name=uni-rate-x)								|
+| uni-refresh-box			| [uni-refresh-box](https://ext.dcloud.net.cn/plugin?name=uni-refresh-box)|
+| uni-tab							| [选项卡](https://ext.dcloud.net.cn/plugin?name=uni-tab-bar)							|
+| uni-time-format			| [时间格式化](https://ext.dcloud.net.cn/plugin?name=uni-time-format)			|
 
 ## uni-ui的升级建议@uniuiupgrade
 
@@ -92,18 +94,18 @@ uni-ui 无法直接升级 uni-ui x，组件名称、用法都有变化。
 |uni-calendar					|日历										|见hello uni-app x里的模板中的日历页面								|
 |uni-card							|卡片										|无																									|
 |uni-collapse					|折叠面板								|改用[uni-collapse](https://ext.dcloud.net.cn/plugin?name=uni-collapse-x)		|
-|uni-combox						|组合框									|改用[uni-combox](https://ext.dcloud.net.cn/plugin?name=uni-combox-x)																										|
+|uni-combox						|组合框									|改用[uni-combobox](https://ext.dcloud.net.cn/plugin?name=uni-combobox)																										|
 |uni-countdown				|倒计时									|无																									|
 |uni-data-checkbox		|数据选择器							|无																									|
 |uni-data-picker			|数据驱动的picker选择器	|组件本身支持uni-app x vdom														|
 |uni-dateformat				|日期格式化							|改用[uni-time-format](https://ext.dcloud.net.cn/plugin?name=uni-time-format)	|
 |uni-datetime-picker	|日期选择器							|内置组件picker支持mode=date													|
 |uni-drawer						|抽屉										|改用内置组件page-container													|
-|uni-easyinput				|增强输入框							|改用内置组件input																		|
+|uni-easyinput				|增强输入框							|改用[uni-easyinput](https://ext.dcloud.net.cn/plugin?name=uni-easyinput)														|
 |uni-fab							|悬浮按钮								|改用[uni-fab-button](https://ext.dcloud.net.cn/plugin?name=uni-fab-button)									|
 |uni-fav							|收藏按钮								|无																									|
 |uni-file-picker			|文件选择上传						|无																									|
-|uni-forms						|表单										|改用内置组件form																		|
+|uni-forms						|表单										|改用[uni-forms](https://ext.dcloud.net.cn/plugin?name=uni-forms)|
 |uni-goods-nav				|商品导航								|无																									|
 |uni-grid							|宫格										|无																									|
 |uni-group						|分组										|无																									|

package/data/uniappx/component/uni-ui-x/uni-collapse.md

@@ -3,6 +3,10 @@ source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-collapse-
 ::: sourceCode
 ## uni-collapse
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-collapse-x/components/uni-collapse
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-collapse-x/components/uni-collapse
+
 折叠面板组件
 
 > 本 Component 是 uni ext component，需下载插件：[uni-collapse](https://ext.dcloud.net.cn/plugin?id=27899)
@@ -526,6 +530,10 @@ uni-collapse-item的标题栏的自定义：
 ::: sourceCode
 ## uni-collapse-item
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-collapse-x/components/uni-collapse-item
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-collapse-x/components/uni-collapse-item
+
 折叠面板子项组件
 
 > 本 Component 是 uni ext component，需下载插件：[uni-collapse-item](https://ext.dcloud.net.cn/plugin?id=27899)

package/data/uniappx/component/uni-ui-x/uni-combox.md

@@ -3,10 +3,16 @@ source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-combox-x
 ::: sourceCode
 ## uni-combox
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-combox-x/components/uni-combox
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-combox-x/components/uni-combox
+
 默认是单选选择框，通过 input 具名插槽切换为可输入、可选择的组合框。
 
 > 本 Component 是 uni ext component，需下载插件：[uni-combox](https://ext.dcloud.net.cn/plugin?id=29915)
 
+> **已废弃：** uni-combox-x 仅用于兼容已有项目。新项目请安装并使用 [uni-combobox](https://ext.dcloud.net.cn/plugin?name=uni-combobox)。
+
 uni-combox 组合框组件。
 
 默认为单选模式，类似 select 组件，只能选择不能输入。通过具名插槽 `input` 传入 input 组件后，切换为可输入、可选择的组合模式。
@@ -67,9 +73,12 @@ uni-combox 组合框组件。
   :options="options"
   v-model="value"
   arrow-class="demo-arrow"
+  field-class="demo-field"
   options-view-class="demo-options-view"
+  options-content-class="demo-options-content"
   option-text-class="demo-option-text"
   option-text-highlight-class="demo-option-highlight"
+  option-row-highlight-class="demo-option-row-highlight"
   result-text-class="demo-result-text"
 />
 ```
@@ -81,6 +90,7 @@ uni-combox 组合框组件。
 <uni-combox :options="options" v-model="value" options-view-class="demo-options-view" />
 <uni-combox :options="options" v-model="value" option-text-class="demo-option-text" />
 <uni-combox :options="options" v-model="value" option-text-highlight-class="demo-option-highlight" />
+<uni-combox :options="options" v-model="value" option-row-highlight-class="demo-option-row-highlight" />
 <uni-combox :options="options" v-model="value" result-text-class="demo-result-text" />
 ```
 
@@ -106,9 +116,12 @@ uni-combox 组合框组件。
 | 类名 | 说明 |
 | --- | --- |
 | arrow-class | 右侧箭头样式 |
+| field-class | 非弹出区域样式 |
 | options-view-class | 候选浮层外层样式 |
+| options-content-class | 候选浮层内容样式 |
 | option-text-class | 候选项文字样式 |
 | option-text-highlight-class | 候选项高亮样式 |
+| option-row-highlight-class | 候选项高亮行样式 |
 | result-text-class | 单选模式结果文字样式 |
 
 ### Props
@@ -120,9 +133,12 @@ uni-combox 组合框组件。
 | placeholder | String | '' | 占位文字 |
 | disabled | Boolean | false | 是否禁用 |
 | arrowClass | String | '' | 右侧箭头自定义样式类 |
+| fieldClass | String | '' | 非弹出区域自定义样式类 |
 | optionsViewClass | String | '' | 候选浮层外层自定义样式类 |
+| optionsContentClass | String | '' | 候选浮层内容自定义样式类 |
 | optionTextClass | String | '' | 候选项文字自定义样式类 |
 | optionTextHighlightClass | String | '' | 候选项高亮自定义样式类 |
+| optionRowHighlightClass | String | '' | 候选项高亮行自定义样式类 |
 | resultTextClass | String | '' | 单选模式结果文字自定义样式类 |
 
 ### Events
@@ -153,9 +169,12 @@ uni-combox 组合框组件。
 | placeholder | string | 占位文字 |
 | disabled | boolean | 是否禁用 |
 | arrowClass | string(string.ClassString) | 右侧箭头自定义样式类 |
+| fieldClass | string(string.ClassString) | 非弹出区域自定义样式类 |
 | optionsViewClass | string(string.ClassString) | 候选浮层外层自定义样式类 |
+| optionsContentClass | string(string.ClassString) | 候选浮层内容自定义样式类 |
 | optionTextClass | string(string.ClassString) | 候选项文字自定义样式类 |
 | optionTextHighlightClass | string(string.ClassString) | 候选项高亮自定义样式类 |
+| optionRowHighlightClass | string(string.ClassString) | 候选项高亮行自定义样式类 |
 | resultTextClass | string(string.ClassString) | 单选模式结果文字自定义样式类 |
 | @selectchange | Function | 从候选项选中时触发，参数为选中的值，类型为 string |
 | @update:modelValue | Event | 值更新时触发，参数为当前值，类型为 string |

package/data/uniappx/component/uni-ui-x/uni-drag-cell.md

@@ -3,6 +3,10 @@ source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-drag-cell
 ::: sourceCode
 ## uni-drag-cell
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-drag-cell/components/uni-drag-cell
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-drag-cell/components/uni-drag-cell
+
 可拖拽单元格组件
 
 > 本 Component 是 uni ext component，需下载插件：[uni-drag-cell](https://ext.dcloud.net.cn/plugin?id=27845)

package/data/uniappx/component/uni-ui-x/uni-expandable-text.md

@@ -0,0 +1,120 @@
+::: sourceCode
+## uni-expandable-text
+
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-expandable-text/components/uni-expandable-text
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-expandable-text/components/uni-expandable-text
+
+按指定行数截断文本，并在文本溢出时显示展开/收起触发器。
+
+> 本 Component 是 uni ext component，需下载插件：[uni-expandable-text](https://ext.dcloud.net.cn/plugin?id=30267)
+
+# uni-expandable-text 折叠文本组件
+
+可以控制文字（正文）默认显示几行，然后在下一行显示切换全文的文字按钮（trigger）。
+
+可以通过externalClass来分别控制正文和trigger的样式。
+
+本组件利用的是max-line和-webkit-line-clamp技术，控制最大显示行数。
+本组件不适合处理长文内容底部的“阅读更多”，这种需求应该使用 (max-height) + 渐变遮罩 (Gradient Mask) + 平滑动画 的方案另行处理。
+
+平台支持：
+- App平台仅支持蒸汽模式，不支持App VDOM模式。
+- Web平台仅支持蒸汽模式，不支持现网的Web VDOM模式。因Web蒸汽还未发布，目前可以视为暂不支持web平台。
+- 小程序平台：支持。
+
+差异：
+- Web平台-webkit-line-clamp 在裁剪文本后会在文本后显示...省略号。
+- App平台在max-line限高后，行尾不会出现...省略号。
+
+## 示例页面路径
+项目下 /pages/uni-ui/expandable-text/expandable-text.uvue 为组件使用示例页面。
+
+## 设计
+
+本组件在App平台利用text组件的max-line属性。在Web和小程序平台利用-webkit-line-clamp实现。
+
+使用本组件后，不应再使用 CSS height 控制文本高度。应通过排版换行，利用本组件的line属性限制可视行数。
+
+需要判断是否溢出，来决定是否显示trigger。当文本内容在line指定的行数内已经全部显示，就不再显示trigger，反之亦然。
+
+但web、小程序、app，在计算正文文本是否溢出最大行数限制的逻辑不一样。
+
+- web
+
+利用 CSS 的 -webkit-line-clamp：通过 CSS 控制文字最大显示行数（如 line-clamp: 2）。
+
+当应用了 line-clamp 后，元素的 clientHeight 是受限的高度，而 scrollHeight 是不换行/完整展开时的真实高度。
+
+如果 scrollHeight > clientHeight：说明文字超出了指定的行数，确实发生了截断，此时应该显示trigger按钮。
+
+如果 scrollHeight <= clientHeight：说明文字没有超过指定行数，没有发生截断，此时隐藏trigger按钮。
+
+- 小程序
+
+额外放置一个全部内容的text组件，隐藏。使用 uni.createSelectorQuery 异步测量正文text组件，和隐藏text组件对比。
+
+小程序上无法监听组件的resizeObserver，虽然已经监听了文字变化，但组件宽度变化的需要动态显示/隐藏trigger的场景无法自动处理，
+需要组件使用者调用组件的checkOverflow()方法主动检查溢出，该方法内部会判断溢出情况动态显示/隐藏trigger。
+
+- app
+
+额外放置一个全部内容的text组件，隐藏，尽量拍平。利用Element 的 getBoundRect 同步测量正文text组件，和隐藏text组件对比。
+
+## 属性和方法
+
+### Attributes
+
+| 属性名 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| text | `string` | `''` | 要显示的正文内容。 |
+| lines | `number` | `1` | 折叠状态下最多显示的行数。 |
+| inline | `boolean` | `false` | 是否以内联方式显示trigger。暂不支持。 |
+| expand-text | `string` | 根据应用语言。中文下为"全文" | 展开状态下显示的文字。显式传入时优先使用传入值。 |
+| collapse-text | `string` | 根据应用语言。中文下为"收起" | 收起状态下显示的文字。显式传入时优先使用传入值。 |
+| text-class | `string` | `''` | 正文的 externalClass。 |
+| trigger-class | `string` | `''` | 展开/收起trigger的 externalClass。 |
+| show-collapse | `boolean` | `true` | 是否在展开状态下隐藏trigger。即不再收起 |
+
+默认文案支持以下语言：简体中文（`zh-Hans`）、繁体中文（`zh-Hant`）、英语（`en`）、法语（`fr`）和拉丁语（`la`）。语言根据 `uni.getAppBaseInfo().appLanguage` 判断。
+
+### Events
+
+| 事件名 | 说明 | 回调参数 |
+| --- | --- | --- |
+| change | 展开或收起状态发生变化时触发 | `expanded: boolean`，`true` 表示已展开，`false` 表示已收起 |
+
+### Expose
+
+| 方法名 | 说明 |
+| --- | --- |
+| toggle() | 切换当前文本的展开状态。 |
+| expand() | 展开文本。已经展开时不执行操作。 |
+| collapse() | 收起文本。已经收起时不执行操作。 |
+| checkOverflow() | 重新检查文本是否超出折叠行数。仅小程序端需要在文本容器宽度变化后主动调用。 |
+
+### TODO
+- inline尾部跟随未实现，text组件嵌套和max-line组合时目前有bug
+- 在list-view中滚动时，未监听复用和回收事件。展开后的内容被复用后会折叠。观察微信朋友圈也如此，暂不实现此功能
+
+### 兼容性 
+| 微信小程序 | 支付宝小程序 | Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
+| :- | :- | :- | :- | :- |
+| 5.33 | 5.33 | 5.31 | 5.31 | 5.31 |
+
+### 属性 
+| 名称 | 类型 | 默认值 | 描述 |
+| :- | :- | :- | :- |
+| text | string | "" | 要显示的文本内容。 |
+| lines | number | 1 | 折叠状态下最多显示的行数。 |
+| inline | boolean | false | 是否以内联方式显示触发器。 |
+| expandText | string | "根据应用语言，中文下为\"全文\"" | 展开状态下显示的文字，不传时根据应用语言使用默认文案。 |
+| collapseText | string | "根据应用语言，中文下为\"收起\"" | 收起状态下显示的文字，不传时根据应用语言使用默认文案。 |
+| textClass | string(string.ClassString) | "" | 正文的 externalClass。 |
+| triggerClass | string(string.ClassString) | "" | 展开/收起触发器的 externalClass。 |
+| showCollapse | boolean | true | 是否在展开状态下显示收起触发器。 |
+| @change | Event |   | 展开或收起状态发生变化时触发 |
+| @update:expanded | Event |   | 展开状态的双向绑定更新事件，用于 v-model:expanded |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=uni-ui-x.uni-expandable-text)

package/data/uniappx/component/uni-ui-x/uni-fab-button.md

@@ -3,6 +3,10 @@ source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-fab-butto
 ::: sourceCode
 ## uni-fab-button
 
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-fab-button/components/uni-fab-button
+
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-fab-button/components/uni-fab-button
+
 悬浮加号按钮组件
 
 > 本 Component 是 uni ext component，需下载插件：[uni-fab-button](https://ext.dcloud.net.cn/plugin?id=27846)