tmui-cli 5.3.1 → 5.3.3

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

@@ -4,6 +4,8 @@
 
 <!-- UTSCOMJSON.icon.description -->
 
+跨平台字体图标组件，推荐使用 uni-ui x 的[uni-icons组件](./uni-ui-x/uni-icons.md)
+
 <!-- UTSCOMJSON.icon.compatibility -->
 
 <!-- UTSCOMJSON.icon.attribute -->

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

@@ -67,10 +67,12 @@
 - 替代方案3：小程序平台，可以利用 filter: drop-shadow 配合 overflow: hidden，可以将原图标的形状“投影”出新的颜色，并把原图标隐藏。App平台不支持此用法。
 
 3. 鸿蒙平台部分情况会按位图渲染，失去矢量能力
+
 svg 是矢量图片，可以无极缩放而不失真。但鸿蒙平台以下情况，会把svg转成位图渲染，此时将丢失矢量能力。
 * 如果启用了 `flatten` 拍平，则会转为位图。
-* 设置部分 `mode` 属性进行图像裁剪，会转为位图进行裁剪。`mode` 设置为 `scaleToFill/aspectFit/aspectFill` 可以保持矢量能力，设置为其它值会转位图裁剪。
-* 如果 `src` 设置了 `data:image/svg+xml;base64,...` 这种形式的 url，则会转为位图。
+* 设置部分 `mode` 属性时会转为位图进行处理。`mode` 设置为 `scaleToFill/aspectFit/aspectFill/widthFix/heightFix` 可以保持矢量能力，设置为其它值会转位图处理。
+* 如果 `src` 设置了 `data:image/svg+xml;base64,...` 这种形式的 data url，则会转为位图。
+  （例外：鸿蒙系统 API ≥ 26 的时候不会转为位图；svg 图片中包含 `text` 内容的时候会被内部转换成 `path` 并本地缓存，实际使用不再是 data url 从而不会转换成位图）
 
 <!-- UTSCOMJSON.image.children -->
 

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

@@ -100,8 +100,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单位。
 
 

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

@@ -6,7 +6,7 @@
 
 <!-- UTSCOMJSON.label.compatibility -->
 
-App平台可以用view加事件来替代label。
+App平台VDOM模式可以用view加事件来替代label。
 
 <!-- UTSCOMJSON.label.attribute -->
 

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

@@ -8,14 +8,14 @@
 
 <!-- UTSCOMJSON.map.compatibility -->
 
-不同图商在不同平台的兼容性
+不同图商在不同平台的兼容性（高德为插件版本）
 |图商		|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)
@@ -78,15 +78,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/uni-app-x-docs/component/swiper.md

@@ -55,7 +55,7 @@
 	</swiper>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
 	const current = ref(0)
 
 	const handleSwiperChange = (e : UniSwiperChangeEvent) => {
@@ -76,6 +76,10 @@
 </style>
 ```
 
+**注意事项**
+
+- swiper 滑动时会视情况阻止默认行为。如需在 swiper-item 内自定义滚动效果，需在相应容器中阻止事件冒泡，此时 swiper 将不再接收该事件，从而不触发滚动。
+
 
 ## swiper-item
 

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

@@ -57,7 +57,7 @@ hi </text>
 <template>
   <text>{{text}}</text>
 </template>
-<script lang="uts" setup>
+<script setup>
   let text = ' a   bc def\tg\nhi '
 </script>
 ```
@@ -129,7 +129,7 @@ web的默认值preline，虽然支持\n换行，同时会合并\n以外的其他
 <template>
   <text decode="false">{{text}}</text>
 </template>
-<script lang="uts" setup>
+<script setup>
   let text = '5 &lt; 10'
 </script>
 ```
@@ -148,10 +148,10 @@ text组件在web浏览器渲染（含浏览器、小程序webview渲染模式、
 
 app平台 text 组件虽然支持嵌套，但注意限制：
 1. 子组件不继承父组件样式。这样使用会在编译到web渲染的平台时产生差异。
-2. 子组件设置的排版相关样式（如position、display、width、height、margin、padding等）以及部分text独有样式（如text-align、lines、white-space、text-overflow）不生效
+2. 子组件设置的排版相关样式（如display、flex、position、width、max-width、min-width、height、max-height、min-height、margin、padding、top、left、right、bottom等），渲染样式（如box-shadow、transform、transition、visibility、z-index等）以及部分text独有样式（如text-align、lines、line-height、white-space、text-overflow、world-break等）不生效
 3. 嵌套时建议将文本写在`<text></text>`标签之间，例如：`<text><text>嵌套文本1</text><text>嵌套文本2</text></text>`，避免出现预期外的效果。
 
-HBuilderX4.51版本起 text组件嵌套时，子组件支持点击事件响应。之前版本如有这方面需求，请改用 [rich-text](./rich-text.md)
+HBuilderX 4.51版本+ text组件嵌套时，子组件支持点击事件响应。
 
 <!-- UTSCOMJSON.text.example -->
 
@@ -174,7 +174,7 @@ App 端不支持 `text` 组件中渲染多段文本，如果 `text` 组件中的
   </view>
 </template>
 
-<script setup lang="uts">
+<script setup>
   const list = ref([
     {
       show: true,
@@ -199,7 +199,7 @@ App 端不支持 `text` 组件中渲染多段文本，如果 `text` 组件中的
   </view>
 </template>
 
-<script setup lang="uts">
+<script setup lang="ts">
   const list = ref([
     {
       show: true,
@@ -231,11 +231,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/uni-app-x-docs/component/textarea.md

@@ -74,12 +74,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/uni-app-x-docs/component/uni-ui-x/uni-collapse.md

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-collapse
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-collapse-x
 ---
 
 <!-- UTSCOMJSON.uni-collapse.name -->

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

@@ -1,3 +1,7 @@
+---
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-combox-x
+---
+
 <!-- UTSCOMJSON.uni-combox.name -->
 
 <!-- UTSCOMJSON.uni-combox.description -->

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

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

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

@@ -0,0 +1,25 @@
+---
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-icons-x
+---
+
+<!-- UTSCOMJSON.uni-icons.name -->
+
+<!-- UTSCOMJSON.uni-icons.description -->
+
+<!-- UTSCOMJSON.uni-icons.readme -->
+
+<!-- UTSCOMJSON.uni-icons.compatibility -->
+
+<!-- UTSCOMJSON.uni-icons.attribute -->
+
+<!-- UTSCOMJSON.uni-icons.fileFormates -->
+
+<!-- UTSCOMJSON.uni-icons.event -->
+
+<!-- UTSCOMJSON.uni-icons.component_type -->
+
+<!-- UTSCOMJSON.uni-icons.children -->
+
+<!-- UTSCOMJSON.uni-icons.example -->
+
+<!-- UTSCOMJSON.uni-icons.reference -->

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

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-link
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-link-x
 ---
 
 <!-- UTSCOMJSON.uni-link.name -->

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

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-nav-bar
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-nav-bar-x
 ---
 
 <!-- UTSCOMJSON.uni-nav-bar.name -->

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

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-number-box
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-number-box-x
 ---
 
 <!-- UTSCOMJSON.uni-number-box.name -->

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

@@ -1,5 +1,5 @@
 ---
-source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-rate
+source: https://gitcode.com/dcloud/uni-ui-x/tree/alpha/uni_modules/uni-rate-x
 ---
 
 <!-- UTSCOMJSON.uni-rate.name -->

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

@@ -102,7 +102,7 @@ video的操作api为[uni.createVideoContext()](../api/create-video-context.md)
 	</list-item>
 </list-view>
 
-<script setup lang="uts">
+<script setup lang="ts">
 //... 其他代码
 function _onRecycle(e: UniVideoRecycleEvent, index: number) {
   console.log(`onRecycle ${index}`, JSON.stringify(e.detail));
@@ -135,5 +135,5 @@ function _onReuse(e: UniVideoReuseEvent, index: number) {
 - 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。
+- app-iOS平台VDOM模式下暂不支持`(Vapor模式支持)` 在dialogPage中调用createVideoContext（）。
 - 5.07版本起，app-android、app-iOS平台不再支持codec、play-strategy属性。

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

@@ -13,7 +13,8 @@ view组件是 uni-app x 最基本的视图容器，它的作用类似于HTML中
 #### hover-class说明@hover-class
 
 - 为什么使用`hover-class`？使用 css :active伪类来实现点击态，很容易触发，并且滚动或滑动时点击态不会消失，体验较差。小程序平台均给view引入了`hover-class`，考虑到跨端兼容和体验，建议使用 `hover-class` 属性来实现点击态效果。并且App平台目前暂不支持css伪类。
-
+- ios/harmony 暂不支持透传属性 `hover-stop-propagation`、`hover-start-time`、`hover-stay-time`
+- 微信小程序/支付宝小程序 暂不支持透传
 
 <!-- UTSCOMJSON.view.event -->
 

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

@@ -12,6 +12,34 @@
 
 <!-- UTSCOMJSON.web-view.component_type -->
 
+### ios-allows-inline-media-playback 初始化说明@ios-inline-init
+
+`ios-allows-inline-media-playback` 用于设置是否允许视频在网页内播放（内联播放），仅在 App-iOS 平台生效，默认值为 `false`。
+
+**该属性只在创建 `web-view` 时生效。** 使用变量绑定时，必须在组件创建前确定值，创建后修改绑定值不会生效。
+
+例如，下面在 `script setup` 顶层同步获取设备类型，设置 iPhone 允许内联播放、iPad 不允许内联播放：
+
+```vue
+<template>
+  <web-view
+    src="/hybrid/html/local.html"
+    :ios-allows-inline-media-playback="isInline">
+  </web-view>
+</template>
+
+<script setup lang="uts">
+const isInline = ref(true)
+// #ifdef APP-IOS
+isInline.value = uni.getDeviceInfo().deviceType != 'pad'
+// #endif
+</script>
+```
+
+上述设备判断仅用于演示如何在初始化前动态赋值。业务需要在哪些设备上内联播放，就应在这些设备上设置为 `true`；如果 iPhone 和 iPad 都需要内联播放，无需区分设备，直接设置为 `true` 即可。
+
+不要等到 `onReady` 或网页 `load` 事件触发后再设置该属性。修改 `src` 或调用 `reload()` 也不能使新值生效；确需更改时，应使用新的属性值重新创建 `web-view`。
+
 
 ### 组件宽高说明
 - web和小程序平台上，web-view是全屏的，即页面只能显示一个铺满的web-view。
@@ -33,6 +61,42 @@ App平台 web-view 组件可在 scroll-view、list-view/list-item 等可滚动
 	支持http、https。
 	app平台使用系统Webview组件，由系统Webview管理缓存。
 
+### iOS 视频播放兼容说明@ios-media-playback
+
+从 HBuilderX alpha-5.08、正式版 release-5.14 起，App-iOS 平台的 `web-view` 有以下变化：
+
+- 新增 `ios-allows-inline-media-playback` 属性，默认值为 `false`，即默认不允许内联播放。
+- 不再自动向网页中的 `<video>` 添加 `playsinline` 属性。
+
+依赖旧版本默认行为的网页，升级后可能出现视频改为全屏播放，或摄像头已开启但网页内没有预览画面的情况。对于上述摄像头预览问题，可选择以下任一方式适配。
+
+**方式一：在应用页面中允许内联播放**
+
+将 `web-view` 的 `ios-allows-inline-media-playback` 设置为 `true`。该属性需在组件创建前设置，变量绑定方式见[初始化说明](#ios-inline-init)。
+
+```vue
+<web-view
+  src="/hybrid/html/local.html"
+  :ios-allows-inline-media-playback="true">
+</web-view>
+```
+
+**方式二：在 HTML 中声明视频内联播放**
+
+为需要内联播放的 `<video>` 添加 `playsinline` 和 `webkit-playsinline`。例如，摄像头预览元素可配置为：
+
+```html
+<video
+  id="videoCamera"
+  autoplay
+  muted
+  playsinline
+  webkit-playsinline>
+</video>
+```
+
+两种方式的实现机制不同：`ios-allows-inline-media-playback` 修改 WebView 的原生配置，`playsinline` 在 HTML 中声明单个视频的内联播放方式。对于上述摄像头预览问题，配置其中一项即可，但两者机制不同，建议同时实现。
+
 <!-- UTSCOMJSON.web-view.children -->
 
 <!-- UTSCOMJSON.web-view.example -->
@@ -153,6 +217,7 @@ webviewController?.setPathAllowingUniversalAccess([
 - app平台web-view组件为系统Webview组件，内核版本号不由uni-app x框架控制。
 - app-android平台，web-view版本不一定是手机默认浏览器的版本。在部分手机上系统web-view的升级需要升级rom，部分手机则可以单独升级Android System Webview包。如需x5等三方webview，需使用uts插件，[见插件市场](https://ext.dcloud.net.cn/search?q=x5)。使用三方webview可减少系统webview的碎片化问题。
 - app-ios平台，web-view的版本与iOS的版本绑定，也即是手机Safari浏览器的版本。WKWebview的限制比Android要多一些，比如无法使用跨域cookie，具体见Apple开发者文档。
+- app-ios平台，升级到 alpha-5.08、release-5.14 及之后版本时，依赖视频内联播放的网页需显式配置播放属性，详见 [iOS 视频播放兼容说明](#ios-media-playback)。`ios-allows-inline-media-playback` 只在组件创建时生效，详见[初始化说明](#ios-inline-init)。
 - app-ios平台不支持padding style（padding-top、padding-left、padding-right、padding-bottom）
 - 页面中的web-view组件数量不宜太多，每个web-view都会占用不少内存。
 - uni.postMessage已不推荐使用（将废弃），功能与uni.webView.postMessage一致，推荐使用uni.webView.postMessage。

package/data/uni-app-x-docs/css/common/at-rules.md

@@ -31,7 +31,13 @@ web中加载字体图标，有 `unicode直显` 和 `伪元素+content` 2种方
 
 有些字体图标网站导出代码时，默认使用`伪元素+content`方式，需要注意这个坑，改用 unicode直显。
 
-unicode直显方式的性能优于伪元素方式，尤其是text组件设置flatten属性拍平后性能更佳。缺点是源码阅读的直观性略差，但对于AI来说倒不是问题。
+unicode直显方式的性能优于伪元素方式，尤其是text组件设置flatten属性拍平后性能更佳。
+缺点是源码阅读的直观性略差。
+
+还有一种解决方式是封装成组件，参考[uni-icons组件](../../component/uni-ui-x/uni-icons.md)，用type来表示，这样源码的可读性更佳。比如
+```vue
+<uni-icons type="search" />
+```
 
 注意text组件直显unicode，需要用 <code v-pre>{{'\u'}}</code> 的方式包裹。
 另外注意实体字符和unicode的区别。
@@ -64,7 +70,7 @@ app平台的内置组件和API用到了一些字体，同时共享出来给开
   <text style="font-family: uni-icon;font-size: 64px;">{{uniIcon}}</text>
 </template>
 
-<script setup lang="uts">
+<script setup>
   const uniIcon = ref<string>('\ue601')
 </script>
 ```

package/data/uni-app-x-docs/css/common/selector.md

@@ -2,10 +2,10 @@
 
 App平台，支持的选择器比web少。这源于开发进度、性能、运行时体积、AI友好度等多方面考虑。
 
-支持过多的选择器，会引入复杂的css优先级问题，这会导致性能下降，AI也容易搞错css优先级。
-简单的class，可能多写几行代码，但对AI来说这不算什么，反而复杂的css权重让AI难以排查问题。\
+支持过多的选择器，会引入复杂的css优先级问题，这会导致性能下降，AI也容易搞错css优先级。\
+简单的class，可能多写几行代码，但对AI来说这不算什么，反而复杂的css权重让AI难以排查问题。
 
-uni-app x 额外引入了page选择器，该选择器是小程序规范，uni-app x 中全平台均支持。
+uni-app x 额外引入了 `page` 选择器，该选择器是小程序规范，uni-app x 中全平台均支持。
 
 <!-- CSSJSON.selector_values.compatibility -->
 

package/data/uni-app-x-docs/css/common/style-isolation.md

@@ -92,7 +92,7 @@ VDOM 模式，考虑到向下兼容问题，目前没有废弃老版样式隔离
 使用示例：
 - 组合式示例
 ```vue
-<script setup lang="uts">
+<script setup>
 	defineOptions({
 		styleIsolation: 'isolated' //表示隔离，不受外部影响
 	})
@@ -159,7 +159,7 @@ Switch组件示例源码：
     <view class="uni-switch-thumb" :class="thumbClass"></view> <!-- 这里是圆球view -->
   </view>
 </template>
-<script lang="uts" setup>
+<script lang="ts" setup>
 const props = withDefaults(defineProps<SwitchProps>(), {
   thumbClass: '' // 定义一个thumbClass属性
 })
@@ -208,6 +208,14 @@ defineOptions中配置externalClasses，从HBuilderX5.0起支持。
 - 由于全局样式是最低优先级，如果传递给组件externalClasses的class是在全局App.uvue中定义的，且期望覆盖组件内部自身class的部分样式，需要给指定的css属性增加`!important;`。
 - 为兼容小程序平台的组件规范，`externalClasses` 必须在组件定义阶段以静态字面量方式声明，且其内容需要在编译时可确定；不支持通过变量、表达式计算、函数返回值等方式动态生成。
 
+##### externalClasses 属性值的兼容性说明 @external-classes-compatibility
+
+HBuilderX 5.35+，组件使用者传入的外部样式类属性值，在组件内获取时由字符串数组调整为空格分隔的字符串。
+
+直接使用该属性值进行 class 绑定不受影响，多个类名仍可使用 `:class="xxxClass"` 绑定，也可与组件内部类名通过数组绑定，例如 `:class="['inner-class', xxxClass]"`。
+
+如果组件代码将该属性值当作数组使用，例如调用 `join()`、`map()` 等数组方法，需要改为按字符串处理。
+
 
 ##### 组件避免外部过度干扰样式
 
@@ -240,7 +248,7 @@ external-style是内联字符串，不受样式隔离策略影响，它永远生
     <view :style="thumbStyle" class="uni-switch-thumb" :class="thumbClass"></view> <!-- 这里是圆球view -->
   </view>
 </template>
-<script lang="uts" setup>
+<script lang="ts" setup>
 const props = withDefaults(defineProps<SwitchProps>(), {
   thumbClass: '' // 定义一个thumbClass属性
   thumbStyle: '' // 定义一个thumbStyle属性

package/data/uni-app-x-docs/css/visibility.md

@@ -12,6 +12,14 @@
 **注意**
 设置 visibility 为 hidden，或设置 display 为 none 都可以隐藏元素。差异是通过 visibility 隐藏元素仍然占据页面位置，通过 display 隐藏元素不占据页面位置。
 
+#### App平台差异
+App平台设置如果元素的 visibility 设置为 hidden，其子元素将不可见，即使子元素的 visibility 设置为 visible 也不可见。
+
+**蒸汽模式拍平(flatten)**  
+- app-android平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的子元素默认仍然会显示，子元素的显示状态由其自身的visibility决定
+- app-ios平台visibility支持拍平。view组件visibility设置为hidden时拍平存在缺陷，view的非拍平子元素默认仍然会显示，非拍平子元素的显示状态由其自身的visibility决定，而拍平子元素会跟随此view不可见
+- app-harmony平台visibility暂不支持拍平
+
 <!-- CSSJSON.visibility.defaultValue -->
 
 <!-- CSSJSON.visibility.unixTags -->
@@ -20,7 +28,4 @@
 
 <!-- CSSJSON.visibility.example -->
 
-#### App平台差异
-App平台设置如果元素的 visibility 设置为 hidden，其子元素将不可见，即使子元素的 visibility 设置为 visible 也不可见。
-
 <!-- CSSJSON.visibility.reference -->

package/data/uni-app-x-docs/css/word-break.md

@@ -9,6 +9,9 @@
 
 <!-- CSSJSON.word-break.values -->
 
+#### App平台差异
+App平台 word-break 为 normal 时与 web 平台存在差异：对于 non-CJK(CJK 指中文/日文/韩文) 文本中的长单词在限制宽度时会自动换行确保显示内容不会溢出，效果与 web 平台的 break-word 效果相似。
+
 <!-- CSSJSON.word-break.defaultValue -->
 
 <!-- CSSJSON.word-break.unixTags -->