tmui-cli 2.0.2 → 2.0.4

package/data/uni-app-x-docs/component/horizontal-drag-gesture-handler.md

@@ -0,0 +1,19 @@
+<!-- ## horizontal-drag-gesture-handler -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.name -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.description -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.compatibility -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.attribute -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.event -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.component_type -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.children -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.example -->
+
+<!-- UTSCOMJSON.horizontal-drag-gesture-handler.reference -->

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

@@ -0,0 +1,19 @@
+<!-- ## icon -->
+
+<!-- UTSCOMJSON.icon.name -->
+
+<!-- UTSCOMJSON.icon.description -->
+
+<!-- UTSCOMJSON.icon.compatibility -->
+
+<!-- UTSCOMJSON.icon.attribute -->
+
+<!-- UTSCOMJSON.icon.event -->
+
+<!-- UTSCOMJSON.icon.component_type -->
+
+<!-- UTSCOMJSON.icon.children -->
+
+<!-- UTSCOMJSON.icon.example -->
+
+<!-- UTSCOMJSON.icon.reference -->

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

@@ -0,0 +1,79 @@
+<!-- ## image -->
+
+<!-- UTSCOMJSON.image.name -->
+
+<!-- UTSCOMJSON.image.description -->
+
+<!-- UTSCOMJSON.image.compatibility -->
+
+<!-- UTSCOMJSON.image.attribute -->
+
+<!-- UTSCOMJSON.image.event -->
+
+<!-- UTSCOMJSON.image.component_type-->
+
+### 图片格式
+- web平台支持的图片格式，不同浏览器有差异，可查询caniuse。
+- 小程序平台支持的图片格式与浏览器类似。但由于不同小程序平台的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)		|
+
+
+如需其他图片格式，可自行开发uts组件插件或搜索插件市场，如
+- [apng插件](https://ext.dcloud.net.cn/search?q=apng&orderBy=Relevance&cat1=8&cat2=82)
+
+
+### src路径支持说明
+
+- 本地路径/static方式
+	由于uni-app/uni-app x编译时，只把/static目录下的静态资源copy到app中，所以src均需指向/static目录下。
+	其他目录的图片由于不会被打包进去，所以无法访问。
+	app平台文件路径会存在大小写敏感问题，为了有更好的兼容性，建议统一按大小写敏感原则处理 [详情](../api/file-system-spec.md#casesensitive)
+
+- 本地绝对路径file:///方式
+	app-android平台形如`file:///storage/emulated/0/Android/data/io.dcloud.uniappx/apps/__UNI__4517034/www/static/test-image/logo.png`。
+	访问本应用内的资源时无需使用本方式，推荐使用/static方式。上述地址受包名、appid影响。
+	file:///方式一般用于download等公共目录。使用前需确保拥有相关权限。
+
+- 支持网络路径
+	* 支持http、https。
+	* 安卓端image组件内部使用facebook的[fresco](https://github.com/facebook/fresco)库(2.5.0)，自带缓存策略，也会自动清理缓存。
+	* iOS端image组件内部使用[SDWebImage](https://github.com/SDWebImage/SDWebImage)库(5.10.0)，自带缓存策略，默认7天缓存，缓存过期后会自动清理。
+	* 鸿蒙平台 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转成位图渲染，此时将丢失矢量能力。
+
+- 鸿蒙平台蒸汽模式
+	* 如果启用了 `flatten` 拍平，则会转为位图。
+	* 设置部分 `mode` 属性进行图像裁剪，会转为位图进行裁剪。`mode` 设置为 `scaleToFill/aspectFit/aspectFill` 可以保持矢量能力，设置为其它值会转位图裁剪。
+	* 如果 `src` 设置了 `data:image/svg+xml;base64,...` 这种形式的 url，则会转为位图。
+
+<!-- UTSCOMJSON.image.children -->
+
+<!-- UTSCOMJSON.image.example -->
+
+<!-- UTSCOMJSON.image.reference -->
+
+### tips
+- image组件默认宽度为320px、高度为240px
+- 在error事件里监听报错，并重新设置image组件的src，可实现自定义错误图。[详见示例代码](https://gitcode.com/dcloud/hello-uni-app-x/blob/master/pages/component/image/image-path.uvue)
+- 图片文件需在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）

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

@@ -0,0 +1,121 @@
+<!-- ## input -->
+
+<!-- UTSCOMJSON.input.name -->
+
+<!-- UTSCOMJSON.input.description -->
+
+<!-- UTSCOMJSON.input.compatibility -->
+
+<!-- UTSCOMJSON.input.attribute -->
+
+<!-- UTSCOMJSON.input.event -->
+
+<!-- UTSCOMJSON.input.component_type-->
+
+#### 获取原生view对象
+
+为增强uni-app x组件的开放性，从 `HBuilderX 4.25` 起，UniElement对象提供了 [getAndroidView](../dom/unielement.md#getandroidview) 和 [getIOSView](../dom/unielement.md#getiosview) 方法。
+
+该方法可以获取到 input 组件对应的原生对象，即Android的`AppCompatEditText`对象、iOS的`UITextField`对象。
+
+进而可以调用原生对象提供的方法，这极大的扩展了组件的能力。
+
+**Android 平台：**
+
+获取input组件对应的UniElement对象，通过UniElement对象的[getAndroidView](../dom/unielement.md#getandroidview-2)方法获取组件原生AppCompatEditText对象
+
+```uts
+//导入安卓原生AppCompatEditText对象
+import AppCompatEditText from "androidx.appcompat.widget.AppCompatEditText"
+
+//通过input组件定义的id属性值，获取input标签的UniElement对象
+const inputElement = uni.getElementById(id)
+//UniElement.getAndroidView设置泛型为安卓底层AppCompatEditText对象，直接获取AppCompatEditText， 如果泛型不匹配会返回null
+if(inputElement != null) {
+	//editText就是input组件对应的原生view对象
+	const editText = inputElement.getAndroidView<AppCompatEditText>()
+}
+```
+
+**iOS 平台：**
+
+获取input组件对应的UniElement对象，通过UniElement对象的[getIOSView](../dom/unielement.md#getiosview)方法获取组件原生UITextField对象
+
+```uts
+//通过 input 组件定义的 id 属性值，获取 input 标签的 UniElement 对象
+const inputElement = uni.getElementById(id)
+//获取原生 view
+const view = inputElement?.getIOSView();
+//判断 view 是否存在，类型是否为 UITextField
+if (view != null && view instanceof UITextField) {
+    //将 view 转换为 UITextField 类型
+    const textField = view! as UITextField;
+}
+```
+
++ iOS平台、以及Android平台的蒸汽模式，uvue 页面中使用 js 驱动，无法处理原生类型，getIOSView 或 getAndroidView 方法需要在 uts 插件中使用。
+
+更多示例请参考 uts 插件 [uts-get-native-view](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/uni_modules/uts-get-native-view/utssdk/app-ios/index.uts)
+
+<!-- UTSCOMJSON.input.children -->
+
+<!-- UTSCOMJSON.input.example -->
+
+<!-- UTSCOMJSON.input.reference -->
+
+## 键盘上推专题@adjust-position
+
+在App平台，input和textarea组件都一个属性`adjust-position`，默认为true，即软键盘弹出时，默认上推页面以显示出输入框，避免输入框被软键盘遮挡。
+
+软键盘弹出后会挡住输入框，此时启动上推逻辑。默认的上推策略是：
+- 如果输入框在scroll-view里，会优先滚动scroll-view，以保证显示出输入框。
+- 如果没有可滚动区域，会transform上移页面，以保证显示出输入框。
+
+但是默认的上推策略无法适配所有场景，有些场景需要关闭默认上推策略，即把属性`adjust-position`设为false，然后在输入框的focus或keyboardheightchange事件中获取键盘高度，手动调整界面。
+
+默认上推策略时，如果页面使用了自定义导航栏，常见注意事项是软键盘弹出后可能把自定义导航栏推出可视范围。\
+此时注意顶部导航栏不能在滚动视图中，且需要使用css固定在顶部，然后下面放一个scroll-view，输入框放在scroll-view中，就不会把自定义导航栏顶飞。\
+如果这种方式仍然不能满足需求，那么就需要关闭默认的上推策略，手动控制。
+
+在web端平台，输入框上推逻辑是由浏览器自动完成的，属性`adjust-position`无效。
+但iOS safari软键盘弹出时，整个页面会上推而不是挤压，导致pages.json配置的导航栏会上移到屏幕之外。
+
+推荐参考代码：[hello uni-app x -> 模板 -> 输入框上推示例](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/template/keyboard-adjust/keyboard-adjust.uvue)。为了避免自定义导航栏被顶飞，有的可以自动上推，有的需手动控制，这里均有示例。
+
+## comfirm-type和inputmode说明
+
+1. comfirm-type
+Web平台弹出键盘使用的是浏览器控制的键盘，在Chrome81+、Safari13.7+之前，键盘右下角文字只能设置完成和搜索，从Chrome81+、Safari13.7+起支持设置发送、下一个。
+
+2. inputmode
+
+web平台的inputmode的浏览器兼容性如下： Chrome >= 66、Edge >= 79、Firefox >= 95、Chrome Android >= 66、Firefox for Android >= 79、Safari on iOS >= 12.2、WebView Android >= 66
+
+3. input组件有 inputmode 和 type、comfirm-type 3个相似的属性，它们的区别详解如下：
+
+- type：在 uni-app 和小程序中仅仅是输入框，定义 input 的工作方式，此值决定可输入什么值。比如 number 只能输入数字。
+- comfirm-type：定义键盘右下角按键的文字
+- inputmode：inputmode 属性是当使用某些值时会对键盘所作出的优化。从HBuilderX 5.0+，为简化概念，已废弃inputmode，推荐改用type属性。
+
+同时使用 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`。
+- placeholder-style的`font-size`样式不支持rpx单位。
+
+
+## Tips
+- 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 点击输入框外的屏幕会自动收起软键盘。
+- 从uni-app x 4.0起，App-Android平台 input 的 font-size 默认值统一为 16px。
+- `Web` 平台，iOS 自带键盘的智能标点功能会导致：在 type 为 `number`、`digit` 时，连续输入两次 `.` 后，在第三次输入 `.` 时，会触发两次 deleteContentBackward（删除） 的输入外加一次 insertText 为 `…`（三个点） 的输入。会导致表现异常，关闭智能标点功能后正常。
+- 如需输入负数，不推荐使用type=number或digit，这2个类型在不同平台表现不同，比如微信小程序上不允许输入负数，app不同rom也有差异。这类需求推荐设置type为text，自行写正则校验数据。在支持的平台，可以通过input-mode设置默认弹出键盘样式。
+- `微信小程序` 平台，如果不设置高度，在一些复杂布局的情况下会可能会出现placeholder高度不正确的问题，暂时通过手动设置样式 height 解决，示例: height: 28px
+- 小程序的input还有一些限制，比如光标颜色cursor-color，微信小程序Android版非skyline仅支持default和green，iOS版仅支持十六进制颜色值 [详见](https://developers.weixin.qq.com/miniprogram/dev/component/input.html)
+- 如需模拟输入框，比如一些验证码输入框、连续扫码，在插件市场搜索[模拟输入框](https://ext.dcloud.net.cn/search?q=%E6%A8%A1%E6%8B%9F%E8%BE%93%E5%85%A5%E6%A1%86&orderBy=Relevance&uni-appx=1)
+- 如需自定义软键盘，比如车牌键盘，在插件市场搜索[自定义键盘](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）。

package/data/uni-app-x-docs/component/keyboard-accessory.md

@@ -0,0 +1,19 @@
+<!-- ## keyboard-accessory -->
+
+<!-- UTSCOMJSON.keyboard-accessory.name -->
+
+<!-- UTSCOMJSON.keyboard-accessory.description -->
+
+<!-- UTSCOMJSON.keyboard-accessory.compatibility -->
+
+<!-- UTSCOMJSON.keyboard-accessory.attribute -->
+
+<!-- UTSCOMJSON.keyboard-accessory.event -->
+
+<!-- UTSCOMJSON.keyboard-accessory.component_type -->
+
+<!-- UTSCOMJSON.keyboard-accessory.children -->
+
+<!-- UTSCOMJSON.keyboard-accessory.example -->
+
+<!-- UTSCOMJSON.keyboard-accessory.reference -->

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

@@ -0,0 +1,21 @@
+<!-- ## label -->
+
+<!-- UTSCOMJSON.label.name -->
+
+<!-- UTSCOMJSON.label.description -->
+
+<!-- UTSCOMJSON.label.compatibility -->
+
+App平台可以用view加事件来替代label。
+
+<!-- UTSCOMJSON.label.attribute -->
+
+<!-- UTSCOMJSON.label.event -->
+
+<!-- UTSCOMJSON.label.component_type -->
+
+<!-- UTSCOMJSON.label.children -->
+
+<!-- UTSCOMJSON.label.example -->
+
+<!-- UTSCOMJSON.label.reference -->

package/data/uni-app-x-docs/component/list-builder.md

@@ -0,0 +1,19 @@
+<!-- ## list-builder -->
+
+<!-- UTSCOMJSON.list-builder.name -->
+
+<!-- UTSCOMJSON.list-builder.description -->
+
+<!-- UTSCOMJSON.list-builder.compatibility -->
+
+<!-- UTSCOMJSON.list-builder.attribute -->
+
+<!-- UTSCOMJSON.list-builder.event -->
+
+<!-- UTSCOMJSON.list-builder.component_type -->
+
+<!-- UTSCOMJSON.list-builder.children -->
+
+<!-- UTSCOMJSON.list-builder.example -->
+
+<!-- UTSCOMJSON.list-builder.reference -->

package/data/uni-app-x-docs/component/list-item.md

@@ -0,0 +1 @@
+已迁移至 [list-view](./list-view.md#list-item)

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

@@ -0,0 +1,191 @@
+<!-- ## list-view -->
+
+<!-- UTSCOMJSON.list-view.name -->
+
+<!-- UTSCOMJSON.list-view.description -->
+
+list-view和scroll-view都是滚动组件，list适用于长列表场景，其他场景适用于scroll-view。
+
+在App中，基于复用回收的list，才能实现长列表的渲染资源复用，以保障列表加载很多项目时，不会一直增加渲染内容。list-view就是基于复用回收的list组件。
+
+每个list由1个父组件list-view及若干子组件list-item构成。可接收的子组件有限制，[见下](#children-tags)
+
+<!-- UTSCOMJSON.list-view.compatibility -->
+
+<!-- UTSCOMJSON.list-view.attribute -->
+
+<!-- UTSCOMJSON.list-view.event -->
+
+<!-- UTSCOMJSON.list-view.component_type-->
+
+### 自定义下拉刷新样式
+
+list-view组件有默认的下拉刷新样式，使用方式与scroll-view的自定义下拉刷新相同。[详见](./scroll-view.md#customrefresh)
+
+1. 设置`refresher-default-style`属性为 none 不使用默认样式
+2. 设置 list-item 定义自定义下拉刷新元素并声明为 `slot="refresher"`，需要设置刷新元素宽高信息否则可能无法正常显示！
+
+uni-ui x 提供了开源的自定义下拉刷新组件，可以体验：[uni-refresh-box](https://doc.dcloud.net.cn/uni-app-x/component/uni-ui-x/uni-refresh-box.html)
+
+   ```html
+   <template>
+   	<list-view refresher-default-style="none" :refresher-enabled="true" :refresher-triggered="refresherTriggered"
+   			 @refresherpulling="onRefresherpulling" @refresherrefresh="onRefresherrefresh"
+   			 @refresherrestore="onRefresherrestore" style="flex:1" >
+
+   		<list-item v-for="i in 10" class="content-item">
+   			<text class="text">item-{{i}}</text>
+   		</list-item>
+
+   		<!-- 自定义下拉刷新元素 -->
+   		<list-item slot="refresher" class="refresh-box">
+   			<text class="tip-text">{{text[state]}}</text>
+   		</list-item>
+   	</list-view>
+   </template>
+   ```
+3. 通过组件提供的refresherpulling、refresherrefresh、refresherrestore、refresherabort下拉刷新事件调整自定义下拉刷新元素！实现预期效果
+
+** VDOM模式注意：**
++ 自定义下拉刷新元素不支持放在list-view的首个子元素位置上。可能无法正常显示
+
+### 嵌套模式
+
+scroll-view开启嵌套模式后，list-view 可作为内层滚动视图与外层 scroll-view 实现嵌套滚动
+
+设置内层 list-view 的 `associative-container` 属性为 "nested-scroll-view"，开启内层 list-view 支持与外层 scroll-view 嵌套滚动
+
+<!-- UTSCOMJSON.list-view.children -->
+
+子组件sticky-header/section用于处理吸顶的场景。
+
+<!-- UTSCOMJSON.list-view.example -->
+
+<!-- UTSCOMJSON.list-view.reference -->
+
+### 蒸汽模式list-view调整及注意事项 <Badge text="App Vapor"/>
+
+VDOM模式下，app平台list-view仅对渲染层复用，不会对vue数据层和DOM层复用。
+
+蒸汽模式下，app平台list-view，首先没有VDOM了，且内置支持对vue数据和渲染层同时复用，性能表现大幅提升。
+
+在蒸汽模式使用list-view需要注意以下几点：
+
+- list-item内部组件如果有内部状态不受绑定数据影响则需要依赖onReuse、onRecycle等生命周期函数进行状态重置，否则会出现状态错乱的问题，参考：[组件生命周期文档](../vue/component.md#component-lifecycle)
+- list-view下仅第一个在list-item上的v-for支持复用，其他list-item会被当做view对待。
+- list-item的**v-for必须要有:key属性**，否则不会复用，此时list-item也会被当做view对待
+- list-item不支持设置margin样式
+- 不支持横向滚动
+
+### 列表性能优化@performance
+
+1. 不要放大图。video组件的封面图不能太大。
+2. 尽可能减少列表item中的元素数量
+3. 没有必要监听事件的View、text、image，都设置flatten拍平属性
+4. 不要包装太多vue组件，包括native-view组件。原始的view、text、image的性能最高
+5. 减少圆角阴影的使用
+
+#### VDOM模式额外注意事项
+VDOM模式的长列表性能要弱于蒸汽模式很多。推荐升级蒸汽模式。如果暂时不能升级，需要注意以下优化方式：
+1. 不要一次性加载太多数据，而是分批加载。
+2. 对VNode、DOM进行虚拟化
+这些技巧另有专门[教程](../performance.md#长列表)
+
+另外在用法上需要注意：
+
+1. 避免对list-item组件的子元素设置event事件，复用后list-item组件部分子元素可能无法正常响应event，有相关业务需要对子元素设置event事件，可对list-item组件设置独立的type实现不复用。
+2. App-iOS平台：使用 v-for 遍历集合方式创建 list-item 时，需要绑定 :key 并要保证值唯一，最好不要使用 index，否则可能会引起 list-item 显示顺序错乱的问题；
+4. App平台list-view组件默认高度取值：
+	- list-view组件的子元素高度之和未超过list-view组件的父元素高度：
+		+ list-view组件的默认高度取值为子元素高度之和
+	- list-view组件的子元素高度之和超过list-view组件的父元素高度：
+		+ 3.9版本list-view组件默认高度取值为list-view组件父元素的高度。子元素高度之和超过list-view组件的高度，list-view组件可滚动。
+		+ 4.0版本开始list-view组件的默认高度取值为子元素高度之和。高度相同list-view组件无法滚动。开发者需要设置css属性定义list-view组件高度，让list-view组件高度小于子元素高度之和，实现滚动能力。
+
+<!-- ## list-item -->
+
+<!-- UTSCOMJSON.list-item.name -->
+
+<!-- UTSCOMJSON.list-item.description -->
+
+<!-- UTSCOMJSON.list-item.compatibility -->
+
+<!-- UTSCOMJSON.list-item.attribute -->
+
+### list-item复用机制
+
+> 仅App平台支持复用 (iOS 4.25+版本支持)。Web平台仅渲染当前屏幕及上下一定高度内的元素，没有对list-item进行复用。
+
++ 良好的复用，需要在list-item上使用v-for且配置:key。
++ type属性定义list-item组件类型。不赋值type属性默认值为0，每一个type类型都会有对应的list-item组件缓存池。
++ 鸿蒙平台在VDOM模式不支持type属性，会将一个list-view下所有list-item放在一个缓存池进行复用。蒸汽模式支持type分类复用。
++ list-view组件加载list-item组件时，会优先查询对应type缓存池是否存在可复用的list-item组件。有则复用没有则创建新的list-item组件。
++ list-item组件被滑动出屏幕则会优先添加到对应类型的list-item缓存池
+	* VDOM模式下，每个类型缓存最大5~8个（不同平台缓存最大值不固定），如果缓存池已满则进行组件销毁！
+	* 蒸汽模式下，未限制每种类型最大缓存数量，具体数量根据渲染区域可显示的条目数决定
++ 部分list-item组件存在子元素个数差异时。请尽可能的配置不同的type，可以规避获取相同type类型的list-item组件因子元素个数差异导致重新创建，增加性能消耗。
+	* 举例1：list-item里放置banner图，该list-item应该设置独立的type，不需要复用，每次从缓存池拿出即可，触发复用反而会出现滚动位置异常图片重新加载等异常情况。
+	* 举例2：list-item子元素个数存在差异应设置不同的type，type相同则会导致list-item复用时因子元素个数差异复用失败，元素重新创建增加性能消耗。具体可参考示例：
+
+```html
+	<template>
+	  <view class="content">
+		<list-view ref="listView" class="list" :scroll-y="true">
+		  <list-item v-for="(item,index) in list" :key="item" class="content-item1" type=1>
+			<text class="text">title-{{item}}</text>
+			<text class="text">content-{{item}}</text>
+		  </list-item>
+		  <list-item v-for="(item,index) in list" :key="item" class="content-item2" type=2>
+		  	<image class="image" src ="/static/test-image/logo.png"></image>
+		  </list-item>
+		  <list-item type=3>
+			<text class="loading">{{text}}</text>
+		  </list-item>
+		</list-view>
+	  </view>
+	</template>
+```
+
+示例中有三种类型的list-item组件。如果type都是默认值0，list-item组件滑动出屏幕后都归类到type=0的缓存池。当触发list-item组件重新加载时，获取type=0的缓存池的组件，获取到的list-item组件可能是两个text子组件也可能是一个image子组件或一个text子组件，底层复用判断时则认为该情况异常不复用，重新创建新的list-item组件！复用失败未能优化性能。正确的方式则是不同的类型设置不同的type。加载时则会获取对应type类型缓存池中的list-item组件实现复用。
+
+<!-- UTSCOMJSON.list-item.event -->
+
+<!-- UTSCOMJSON.list-item.component_type-->
+
+<!-- UTSCOMJSON.list-item.children -->
+
+<!-- UTSCOMJSON.list-item.example -->
+
+<!-- UTSCOMJSON.list-item.reference -->
+
+### scroll-anchoring属性
+
+> 新增于HBuilderX 5.25，仅蒸汽模式App平台支持此属性
+
+仅支持锚定到list-view下的直接子list-item，且此list-item必须在可回收复用的范围内，list-view内含sticky-section时锚定不生效。
+
+### scroll-into-view属性
+
+#### 蒸汽模式
+
+> 新增于HBuilderX 5.25
+
+蒸汽模式下由于list-item组件的复用机制，在触发滚动前可能并不能准确获取到滚动目标list-item组件的位置，因此使用scrollTop等方式滚动可能并不能得到预期的效果。使用scroll-into-view属性时list-view内部会计算预估位置，无动画时滚动到预估位置再进行渲染，有动画时会在滚动期间持续调整目标位置以使最终位置准确。iOS平台scroll-into-view不支持带动画滚动。
+
+#### Web平台
+
++ web平台仅渲染当前屏幕及上下一定距离的内容，滚动高度为空白容器占位，因此如果使用dom API获取list-item内的元素可能无法取到。
++ scroll-with-animation属性在safari 15.4以下版本不支持
++ 尽量避免在list-item上使用浏览器的[外边距折叠特性](https://developer.mozilla.org/zh-CN/docs/Web/CSS/CSS_box_model/Mastering_margin_collapsing)会导致list-view无法准确计算回收的元素的高度，进而导致滚动出现异常。即不要同时为list-item设置上边距（margin-top）和下边距（margin-bottom）。
+
+## 示例代码
+
+- 联网联表：[hello uni-app x 的 /pages/template/news-feed-list/news-feed-list.uvue](https://gitcode.com/dcloud/hello-uni-app-x/blob/master/pages/template/news-feed-list/news-feed-list.uvue)
+- 可左右滑动的多个列表：[hello uni-app x 的 /pages/template/long-list](https://gitcode.com/dcloud/hello-uni-app-x/tree/master/pages/template/long-list)
+
+### Bug & Tips@tips
+
+- 如需im那样的倒序列表，App端可给组件style配置 `transform: rotate(180deg)` 来实现。注意与下拉刷新有冲突，此时应避免启用下拉刷新。可参考[uni-ai x源码](https://ext.dcloud.net.cn/plugin?id=23902)
+- list-view组件的overflow属性不支持配置visible
+- list-view组件不适合做瀑布流，多列瀑布流另见 [waterflow组件](./waterflow.md)
+- 受限于list-item回收复用的特性，scroll-into-view可能无法准确滚动到指定位置。尤其HBuilderX 5.25之前的蒸汽模式下非渲染区域list-item对应的element都不存在，scroll-into-view更难以准确跳转。

package/data/uni-app-x-docs/component/live-player.md

@@ -0,0 +1,29 @@
+[uni直播](https://doc.dcloud.net.cn/uniCloud/uni-live/intro.html)是DCloud与七牛云合作推出的直播服务，七牛云直播依托云边一体化架构和海量节点资源，构建高效的流媒体服务。通过多维度的节点监控与弹性的节点调度管理，确保高质量服务与成本效益的完美平衡。
+
+`live-player` 组件是[uni直播](https://doc.dcloud.net.cn/uniCloud/uni-live/intro.html)服务中的拉流（播放）组件，在 Android/iOS 平台使用需要申请绑定包名/Bundle ID(AppID)，详情[咨询](https://im.dcloud.net.cn/#/?joinGroup=68622a2ba99ae56f95028db1)
+
+<!-- ## live-player -->
+
+<!-- UTSCOMJSON.live-player.name -->
+
+<!-- UTSCOMJSON.live-player.description -->
+
+<!-- UTSCOMJSON.live-player.compatibility -->
+
+<!-- UTSCOMJSON.live-player.attribute -->
+
+<!-- UTSCOMJSON.live-player.event -->
+
+<!-- UTSCOMJSON.live-player.component_type -->
+
+### 音视频协议
+- 支持 rtmp、hls 协议格式。
+
+### 上下文对象API
+[uni.createLivePlayerContext()](../api/create-live-player-context.md)
+
+<!-- UTSCOMJSON.live-player.children -->
+
+<!-- UTSCOMJSON.live-player.example -->
+
+<!-- UTSCOMJSON.live-player.reference -->

package/data/uni-app-x-docs/component/live-pusher.md

@@ -0,0 +1,31 @@
+# uni直播
+
+[uni直播](https://doc.dcloud.net.cn/uniCloud/uni-live/intro.html)是DCloud与七牛云合作推出的直播服务，七牛云直播依托云边一体化架构和海量节点资源，构建高效的流媒体服务。通过多维度的节点监控与弹性的节点调度管理，确保高质量服务与成本效益的完美平衡。
+
+`live-pusher` 组件是[uni直播](https://doc.dcloud.net.cn/uniCloud/uni-live/intro.html)服务中的推流组件，在 Android/iOS 平台使用需要申请绑定包名/Bundle ID(AppID)，详情[咨询](https://im.dcloud.net.cn/#/?joinGroup=68622a2ba99ae56f95028db1)
+
+<!-- ## live-pusher -->
+
+<!-- UTSCOMJSON.live-pusher.name -->
+
+<!-- UTSCOMJSON.live-pusher.description -->
+
+<!-- UTSCOMJSON.live-pusher.compatibility -->
+
+<!-- UTSCOMJSON.live-pusher.attribute -->
+
+<!-- UTSCOMJSON.live-pusher.event -->
+
+<!-- UTSCOMJSON.live-pusher.component_type -->
+
+### 音视频协议
+- 支持 rtmp 协议格式。
+
+### 上下文对象API
+[uni.createLivePusherContext()](../api/create-live-pusher-context.md)
+
+<!-- UTSCOMJSON.live-pusher.children -->
+
+<!-- UTSCOMJSON.live-pusher.example -->
+
+<!-- UTSCOMJSON.live-pusher.reference -->

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

@@ -0,0 +1,31 @@
+<!-- UTSCOMJSON.loading.name -->
+
+<!-- UTSCOMJSON.loading.description -->
+
+<!-- UTSCOMJSON.loading.compatibility -->
+
+<!-- UTSCOMJSON.loading.attribute -->
+
+<!-- UTSCOMJSON.loading.event -->
+
+<!-- UTSCOMJSON.loading.component_type -->
+
+<!-- UTSCOMJSON.loading.children -->
+
+## 注意事项：
+1. iOS、Android 利用渲染线程加速，完全不受主线程繁忙影响；鸿蒙因OS渲染线程开放能力不足，受主线程轻微影响，但仍可以做到一个界面放置100个loading同时转圈而不卡顿，[详见](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/template/loading-100/loading-100.uvue)。
+2. 仅支持以下css style，支持静态和动态设置：
+	* width：组件的宽度，默认值为 16px
+	* height：组件的高度，默认值为 16px
+	* border-color：加载框线条的颜色，默认值为 #000000
+	* color: 仅 ios-spinner = true 时，color的优先级大于border-color； ios-spinner = false 时， color无效；
+3. loading组件默认是旋转的，不使用时应v-if删除或设置paused。请注意勿在隐藏或被遮挡的区域让loading持续旋转。
+4. 当 ios-spinner = true 时，由于iOS系统雪花非矢量概念，该组件随着 CSS width、height 动态调整大小时会模糊，建议 CSS width、height 不超过 37px；
+5. [uni.showLoading API](https://doc.dcloud.net.cn/uni-app-x/api/loading.html#showloading) 从HBuilderX 5.0+ ，在非小程序上通过本内置loading组件实现,
+6. 不支持以下css 变量：
+	* border-color：加载框线条的颜色，默认值为 #000000；
+    * color：仅 ios-spinner = true 时，color的优先级大于border-color； ios-spinner = false 时， color无效；
+<!-- UTSCOMJSON.loading.example -->
+
+<!-- UTSCOMJSON.loading.reference -->
+

package/data/uni-app-x-docs/component/long-press-gesture-handler.md

@@ -0,0 +1,19 @@
+<!-- ## long-press-gesture-handler -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.name -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.description -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.compatibility -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.attribute -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.event -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.component_type -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.children -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.example -->
+
+<!-- UTSCOMJSON.long-press-gesture-handler.reference -->