tmui-cli 2.0.2 → 2.0.4

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

@@ -0,0 +1,114 @@
+<!-- ## map -->
+
+<!-- UTSCOMJSON.map.name -->
+
+<!-- UTSCOMJSON.map.description -->
+
+地图由三方专业地图厂商提供SDK。在App和Web中，使用三方SDK需在[manifest](../collocation/manifest.md)中进行配置。
+
+<!-- UTSCOMJSON.map.compatibility -->
+
+不同图商在不同平台的兼容性
+|图商		|Web|Android|iOS	|harmony|
+|:-:		|:-:|:-:		|:-:	|:-:		|
+|腾讯		|√	|4.31+	|4.31+|4.61+	|
+|高德		|√	|√			|√		|x			|
+|Google	|√	|x			|x		|x			|
+
+App标准基座里地图是腾讯地图，如需高德地图版本，请在插件市场单独安装，需要自定义基座运行：[官方高德地图插件](https://ext.dcloud.net.cn/plugin?id=25947)。该插件基于独立的 `<amap>` 组件实现，与内置 map 组件存在功能差异：属性、事件、上下文 API 均为内置 map 的子集，且暂不支持 Harmony 平台，详见[高德地图插件功能差异](#amap)。
+
+除了内置支持的图商，还可以在插件市场寻找更多地图解决方案：
+1. [插件市场的三方地图插件](https://ext.dcloud.net.cn/search?q=%E5%9C%B0%E5%9B%BE&orderBy=Relevance&uni-appx=1)
+2. 使用web-view中的地图
+
+<!-- UTSCOMJSON.map.attribute -->
+
+<!-- UTSCOMJSON.map.event -->
+
+<!-- UTSCOMJSON.map.component_type -->
+
+<!-- UTSCOMJSON.map.children -->
+
+::: warning 注意事项
+- App平台 `layer-style` 属性用于设置个性化地图样式，可用于适配实现地图的暗黑模式。使用前需在腾讯位置服务后台 “个性化样式” 的 “[我的样式](https://lbs.qq.com/dev/console/custom/mapStyle)” 中创建，并在 “[样式应用](https://lbs.qq.com/dev/console/custom/apply)” 中将相应的Key绑定样式，`layer-style` 的值为绑定样式的序号。更多信息可参考腾讯地图官方文档[Android平台个性化地图](https://lbs.qq.com/mobile/androidMapSDK/developerGuide/personalized)、[iOS平台个性化地图](https://lbs.qq.com/mobile/iOSMapSDK/mapGuide/mapStyle)。
+:::
+
+### 上下文对象API
+
+map组件的操作api为[uni.createMapContext()](../api/create-map-context.md)。
+
+给map组件设一个id属性，将id的值传入uni.createMapContext()，即可得到map组件的上下文对象，进一步可使用`.addMarkers()`等方法。
+
+
+<!-- UTSCOMJSON.map.example -->
+
+## 三方地图SDK@mapsdk
+
+### 腾讯地图
+
+#### app-android平台仓储依赖
+- com.tencent.map:tencent-map-vector-sdk:5.6.0
+- com.tencent.map:sdk-utilities:1.0.9
+- com.tencent.map.geolocation:TencentLocationSdk-openplatform:7.5.4.3
+- com.github.bumptech.glide:glide:4.16.0
+
+#### app-ios平台Cocoapods依赖
+- {"name":"Tencent-MapSDK", "version": "5.1.0"}
+- {"name": "Tencent-MapVisualPlugin", "version": "3.1.0"}
+- {"name": "Tencent-MapFoundation", "version": ">=3.3.0"}
+- {"name": "Tencent-MapUtils", "version": "1.2.3"}
+
+#### 审图号
+
+GS粤（2023）1171号
+
+#### Map Key配置
+
+app平台目前还没有可视化界面，采用摇树机制，即调用地图相关api才会把地图组件编译到基座中，Map Key配置方式如下：
+
+- iOS平台：需要在info.plist中配置对应的Key，参考[iOS平台配置腾讯地图Key](../collocation/manifest-ios.html#mapTencent)
+- Android平台：需要在AndroidManifest.xml配置Key， 参考[Android平台配置腾讯地图Key](../collocation/manifest-android.html#mapTencent)
+- Harmony平台：需要在`/harmony-configs/entry/src/main/module.json5`的metadata属性内配置Key，同时 manifest.json 内还需要配置 app.distribute.modules.uni-map 参考[Harmony平台配置腾讯地图Key](../collocation/manifest-harmony.html#uni-map-tencent)
+
+### 高德地图@amap
+
+App平台的高德地图由插件市场 [官方高德地图插件 uni-map-amap](https://ext.dcloud.net.cn/plugin?id=25947) 提供，基于独立的 `<amap>` 组件实现，需要自定义基座运行，支持 Android、iOS 平台，暂不支持 Harmony。
+
+高德地图插件与内置 map 组件（腾讯地图）的功能差异概览：
+
+| 差异项 | 内置 map 组件（腾讯地图） | 高德地图插件 |
+| :- | :-: | :-: |
+| 基础属性：longitude、latitude、scale、theme、min-scale、max-scale、layer-style、show-location、enable-satellite、enable-traffic | √ | √ |
+| markers 标记点 | √ | √ |
+| 覆盖物属性：polyline、polygons、circles、controls、include-points | √ | x |
+| 手势视角属性：enable-3D、show-compass、enable-zoom、enable-scroll、enable-rotate、rotate、skew、enable-overlooking | √ | x |
+| 显示控制属性：enable-poi、enable-building、enable-indoorMap | √ | x |
+| 事件：@markertap、@controltap、@regionchange、@updated、@tap、@anchorpointtap、@poitap | √ | x |
+| 上下文 API：uni.createMapContext 及 MapContext 全部方法 | √ | x |
+
+完整差异明细、插件版本支持情况及 API Key 配置说明，详见插件市场 [uni-map-amap 插件文档](https://ext.dcloud.net.cn/plugin?id=25947)。
+
+### 地图扩展
+
+所谓地图扩展就是可以通过获取map组件的形式扩展地图功能，暂时只有Android支持，步骤如下：
+
+1. 新建一个uts插件，配置依赖腾讯地图SDK
+2. 在uvue页面调用`uni.getElementById()`获取组件对象`UniElement`，将`UniElement`对象传入uts插件
+3. 在uts插件中通过`UniElement`的`getAndroidView`获取原生地图View，使用原生地图view与地图SDK提供的API开发扩展功能,例：
+
+```ts
+import { CameraUpdateFactory } from "com.tencent.tencentmap.mapsdk.maps"
+import { MapView } from "com.tencent.tencentmap.mapsdk.maps"
+export function setScale(element : UniElement, scale : number) : void {
+	(element?.getAndroidView() as MapView)?.map?.moveCamera(CameraUpdateFactory.zoomTo(scale.toFloat()));
+}
+```
+
+
+## Tips
+- 在App和Web平台，没有在manifest中配置好图商的sdk key信息，将无法使用地图。某些图商的sdk key，区分Web、Android、iOS，注意别配混了。有些sdk key，会绑定校验web的域名或app的包名和签名证书摘要，都要匹配准确才能使用地图。
+- 谷歌地图仅支持 `wgs84` 坐标，中国的各个地图仅支持 `gcj02` 坐标，注意使用定位API获取的位置，需与map组件的图商需求一致，把 wgs84 的坐标显示在中国地图上会导致偏移。
+- 地图是商业服务，需购买商业地图授权（5万/年）。如果没有授权，不但使用会被限频，还会被某些应用商店拒绝上架。DCloud与地图厂商谈判，给开发者提供了优惠，点此详询 [地图商业授权咨询](https://ask.dcloud.net.cn/explore/map/)。
+- 鸿蒙App蒸汽模式下仅支持鸿蒙真机运行，不支持模拟器运行
+
+<!-- UTSCOMJSON.map.reference -->

package/data/uni-app-x-docs/component/match-media.md

@@ -0,0 +1,21 @@
+<!-- ## match-media -->
+
+<!-- UTSCOMJSON.match-media.name -->
+
+<!-- UTSCOMJSON.match-media.description -->
+
+宽屏适配指南另见：[详情](../adapt.md)
+
+<!-- UTSCOMJSON.match-media.compatibility -->
+
+<!-- UTSCOMJSON.match-media.attribute -->
+
+<!-- UTSCOMJSON.match-media.event -->
+
+<!-- UTSCOMJSON.match-media.component_type -->
+
+<!-- UTSCOMJSON.match-media.children -->
+
+<!-- UTSCOMJSON.match-media.example -->
+
+<!-- UTSCOMJSON.match-media.reference -->

package/data/uni-app-x-docs/component/movable-area.md

@@ -0,0 +1,27 @@
+<!-- ## movable-area -->
+
+<!-- UTSCOMJSON.movable-area.name -->
+
+<!-- UTSCOMJSON.movable-area.description -->
+
+<!-- UTSCOMJSON.movable-area.compatibility -->
+
+之所以有movable-area和movable-view，是因为逻辑层和视图层分离，从视图层发送数据给逻辑层，处理后再传回视图层会产生损耗，导致拖动卡顿。
+
+于是通过一个框架实现好的组件，在视图层内部处理拖动，避免来回通信。
+
+在uni-app和小程序上确实存在这个问题，但在uni-app x的web和app上其实都不存在通信损耗。
+
+在hello uni-app x里有示例，可以自由的监听view的拖动并移动其位置。[详见](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/component/general-event/touch-event.uvue)
+
+<!-- UTSCOMJSON.movable-area.attribute -->
+
+<!-- UTSCOMJSON.movable-area.event -->
+
+<!-- UTSCOMJSON.movable-area.component_type -->
+
+<!-- UTSCOMJSON.movable-area.children -->
+
+<!-- UTSCOMJSON.movable-area.example -->
+
+<!-- UTSCOMJSON.movable-area.reference -->

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

@@ -0,0 +1,27 @@
+<!-- ## movable-view -->
+
+<!-- UTSCOMJSON.movable-view.name -->
+
+<!-- UTSCOMJSON.movable-view.description -->
+
+<!-- UTSCOMJSON.movable-view.compatibility -->
+
+之所以有movable-area和movable-view，是因为逻辑层和视图层分离，从视图层发送数据给逻辑层，处理后再传回视图层会产生损耗，导致拖动卡顿。
+
+于是通过一个框架实现好的组件，在视图层内部处理拖动，避免来回通信。
+
+在uni-app和小程序上确实存在这个问题，但在uni-app x的web和app上其实都不存在通信损耗。
+
+在hello uni-app x里有示例，可以自由的监听view的拖动并移动其位置。[详见](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/component/general-event/touch-event.uvue)
+
+<!-- UTSCOMJSON.movable-view.attribute -->
+
+<!-- UTSCOMJSON.movable-view.event -->
+
+<!-- UTSCOMJSON.movable-view.component_type -->
+
+<!-- UTSCOMJSON.movable-view.children -->
+
+<!-- UTSCOMJSON.movable-view.example -->
+
+<!-- UTSCOMJSON.movable-view.reference -->

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

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

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

@@ -0,0 +1,210 @@
+<!-- ## native-view -->
+
+<!-- UTSCOMJSON.native-view.name -->
+
+<!-- UTSCOMJSON.native-view.description -->
+
+`native-view`自身没有渲染内容，需要开发者监听 `@init` 事件，在此事件中创建平台原生view与 [UniNativeViewElement](../api/dom/uninativeviewelement.md) 进行绑定，`native-view`将展示该view的渲染内容。
+
+`<native-view>`组件是uni-app x下扩展原生组件（如map）的重要方式。事实上官方的camera/map/web-view/video等组件就是使用`<native-view>`开发的。详见下方的使用场景章节。
+
+<!-- UTSCOMJSON.native-view.compatibility -->
+
+<!-- UTSCOMJSON.native-view.attribute -->
+
+<!-- UTSCOMJSON.native-view.event -->
+
+<!-- UTSCOMJSON.native-view.component_type -->
+
+### 使用场景
+
+`native-view` 适用于开发[uts插件-标准模式组件](../plugin/uts-component-vue.md)
+
+### 使用教程
+
+#### 获取 UniNativeViewElement
+
+`native-view`提供 @init 监听元素初始化，通过事件[UniNativeViewInitEvent](#uninativeviewinitevent)的 detail.element 获取到 [UniNativeViewElement](../dom/uninativeviewelement.md)。
+
+#### UniNativeViewElement绑定原生view
+
+**Android 平台：**
+
+[UniNativeViewElement](../dom/uninativeviewelement.md) 提供[bindAndroidView](../dom/uninativeviewelement.md#bindandroidview)函数与`native-view`绑定android平台原生view
+
+**IOS 平台：**
+
+[UniNativeViewElement](../dom/uninativeviewelement.md) 提供[bindIOSView](../dom/uninativeviewelement.md#bindiosview)函数与`native-view`绑定ios平台原生view
+
+**Harmony 平台：**
+
+[UniNativeViewElement](../dom/uninativeviewelement.md) 提供 [bindHarmonyWrappedBuilder](../dom/uninativeviewelement.md#bindharmonywrappedbuilder) / [bindHarmonyFrameNode](../dom/uninativeviewelement.md#bindharmonyframenode) 函数与 `native-view` 绑定。
+
+#### 分发自定义事件
+
+[UniNativeViewElement](../dom/uninativeviewelement.md) 提供了dispatchEvent分发event事件API，注意：事件数据类型暂时只支持[UniNativeViewEvent](./common.md#uninativeviewevent)。
+
+具体示例请参考：[native-button](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/uni_modules/native-button/components/native-button/native-button.uvue)插件，该插件使用`native-view`封装原生button实现的native-button。
+
+### 注意事项
+
++ app平台`native-view`组件绑定原生view后自动适配[组件全局属性](common.md#组件全局属性)
++ app平台`native-view`组件绑定原生view后自动适配[组件全局事件](common.md#组件全局事件)
+	- android平台如果绑定的view设置了`setOnTouchListener`会导致touch部分全局事件失效
++ app平台`native-view`组件不支持自定义属性，使用[uts插件-标准模式组件-声明属性props](../plugin/uts-component-vue.md#组件声明属性props)实现自定义属性目的
++ app平台`native-view`组件不支持子组件
++ app平台`native-view`组件不支持渲染样式：[background](../css/background.md)、[border](../css/border.md)、[box-shadow](../css/box-shadow.md)
++ android平台`native-view`组件有以下限制
+  - android平台VDOM模式不支持[list-item复用机制](list-item.md#list-item复用机制)，list-item其他子组件不受影响正常启动复用业务  
+  - android平台verflow样式不支持visible，仅支持hidden
++ 支付宝小程序不支持 `native-view` 组件，使用时需通过条件编译排除支付宝小程序
+
+<!-- UTSCOMJSON.native-view.children -->
+
+<!-- UTSCOMJSON.native-view.example -->
+
+NativeButton原生对象代码如下：
+
+::: preview
+
+> Android
+
+```uts
+import { Button } from "android.widget"
+
+export class NativeButton {
+	$element: UniNativeViewElement;
+
+	constructor(element: UniNativeViewElement) {
+		this.$element = element;
+		this.bindView();
+	}
+
+	button: Button | null = null;
+	bindView() {
+		//通过UniElement.getAndroidActivity()获取android平台activity 用于创建view的上下文
+		this.button = new Button(this.$element.getAndroidActivity()!);  //构建原生view
+		//限制原生Button 文案描述不自动大写
+		this.button?.setAllCaps(false)
+		//监听原生Button点击事件
+		this.button?.setOnClickListener(_ => {
+			const detail = {}
+			//构建自定义UniNativeViewEvent返回对象
+			const event = new UniNativeViewEvent("customClick", detail)
+			//响应分发原生Button的点击事件
+			this.$element.dispatchEvent(event)
+		})
+		//UniNativeViewEvent 绑定 安卓原生view
+		this.$element.bindAndroidView(this.button!);
+	}
+
+	updateText(text: string) {
+		//更新原生Button 文案描述
+		this.button?.setText(text)
+	}
+
+	destroy() {
+		//数据回收
+	}
+}
+```
+
+> iOS
+
+```uts
+import { UIButton, UIControl } from "UIKit"
+
+export class NativeButton {
+
+	element : UniNativeViewElement;
+	button : UIButton | null;
+
+	constructor(element : UniNativeViewElement) {
+    // 接收组件传递过来的UniNativeViewElement
+		this.element = element;
+		super.init()
+		this.bindView();
+	}
+
+	// element 绑定原生view
+	bindView() {
+    // 初始化原生 UIButton
+    this.button = new UIButton(type=UIButton.ButtonType.system)
+    // 构建方法选择器
+    const method = Selector("buttonClickAction")
+    // button 绑定点击回调方法
+    button?.addTarget(this, action = method, for = UIControl.Event.touchUpInside)
+    // UniNativeViewElement 绑定原生 view
+		this.element.bindIOSView(this.button!);
+	}
+
+	updateText(text : string) {
+    // 更新 button 显示文字
+		this.button?.setTitle(text, for = UIControl.State.normal)
+	}
+
+	/**
+	 * 按钮点击回调方法
+	 * 在 swift 中，所有target-action (例如按钮的点击事件，NotificationCenter 的通知事件等)对应的 action 函数前面都要使用 @objc 进行标记。
+	 */
+	@objc buttonClickAction() {
+    //构建自定义 UniNativeViewEvent 对象
+		let event = new UniNativeViewEvent("customClick")
+    //触发自定义事件
+		this.element.dispatchEvent(event)
+	}
+
+	destroy() {
+    // 释放 UTS 实例对象，避免内存泄露
+		UTSiOS.destroyInstance(this)
+	}
+}
+
+```
+
+> Harmony
+
+```uts
+import { BuilderNode } from "@kit.ArkUI"
+// 导入混编实现的声明式UI构建函数
+// 完整代码可参考 https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/uni_modules/native-button/utssdk/app-harmony
+import { buildButton } from "./builder.ets"
+
+import { INativeButtonContext } from "../interface.uts"
+// 定义 buildButton 的参数类型
+interface NativeButtonOptions {
+    text : string
+    onClick : () => void
+}
+
+export class NativeButton {
+    private $element : UniNativeViewElement;
+    private builder : BuilderNode<[NativeButtonOptions]> | null = null
+    // 初始化 buildButton 默认参数
+    private params : NativeButtonOptions = {
+        text: '',
+        onClick: () => {
+            this.$element.dispatchEvent(new UniNativeViewEvent("customClick", {}))
+        }
+    }
+
+    constructor(element : UniNativeViewElement) {
+        // 绑定 wrapBuilder 函数
+        this.builder = element.bindHarmonyWrappedBuilder(wrapBuilder<[NativeButtonOptions]>(buildButton), this.params)
+    }
+
+    updateText(text : string) {
+        this.params.text = text
+        // 调用 builder update 函数来更新 UI
+        this.builder?.update(this.params)
+    }
+}
+
+```
+
+:::
+
+具体示例请参考：[native-button](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/uni_modules/native-button/components/native-button/native-button.uvue)插件
+
+
+<!-- UTSCOMJSON.native-view.reference -->

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

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

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

@@ -0,0 +1,22 @@
+<!-- ## navigator -->
+
+<!-- UTSCOMJSON.navigator.name -->
+
+<!-- UTSCOMJSON.navigator.description -->
+
+<!-- UTSCOMJSON.navigator.compatibility -->
+
+<!-- UTSCOMJSON.navigator.attribute -->
+
+<!-- UTSCOMJSON.navigator.event -->
+
+<!-- UTSCOMJSON.navigator.component_type-->
+
+<!-- UTSCOMJSON.navigator.children -->
+
+<!-- UTSCOMJSON.navigator.example -->
+
+<!-- UTSCOMJSON.navigator.reference -->
+
+## Tips
+navigator组件是对uni.navigateTo API的易用性封装，无需编写method方法，直接跳转页面。跳转后的新页面在onload生命周期中接收参数，详见[页面onLoad生命周期](../page.md#onload)

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

@@ -0,0 +1,32 @@
+<!-- ## nested-scroll-body -->
+
+<!-- UTSCOMJSON.nested-scroll-body.name -->
+
+<!-- UTSCOMJSON.nested-scroll-body.description -->
+
+<!-- UTSCOMJSON.nested-scroll-body.compatibility -->
+
+<!-- UTSCOMJSON.nested-scroll-body.attribute -->
+
+<!-- UTSCOMJSON.nested-scroll-body.event -->
+
+<!-- UTSCOMJSON.nested-scroll-body.component_type-->
+
+### 使用场景  
+
+scroll-view 嵌套场景中。内层 scroll-view 滚动时无法与外层 scroll-view 滚动衔接，无法实现嵌套滚动连贯效果。因此提供`nested-scroll-body`节点，存放内层 scroll-view 节点。`nested-scroll-body`会与外层`nested-scroll-header`衔接滚动逻辑实现连贯滚动。开发者只需将内层滚动节点放置`nested-scroll-body`节点内即可。具体用法请参考[scroll-view嵌套模式](https://doc.dcloud.net.cn/uni-app-x/component/scroll-view.html#nested-scroll-view)
+
+#### 注意事项  
+
++ `nested-scroll-body` 组件的父节点必须是 scroll-view，并且 scroll-view 下最多只能存在一个 `nested-scroll-body` 组件  
++ `nested-scroll-body` 组件不支持设置css样式，不要通过 class 和 style 设置样式  
++ `nested-scroll-body` 组件应该放在 `nested-scroll-header` 组件后面（下面）  
++ `nested-scroll-body` 组件不支持复数子节点，渲染时会取其第一个子节点来渲染  
+
+> 蒸汽模式下此组件已无实际意义，仅为向下兼容而支持，用于约束其内容高度为 `100%`。  
+
+<!-- UTSCOMJSON.nested-scroll-body.children -->
+
+<!-- UTSCOMJSON.nested-scroll-body.example -->
+
+<!-- UTSCOMJSON.nested-scroll-body.reference -->

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

@@ -0,0 +1,32 @@
+<!-- ## nested-scroll-header -->
+
+<!-- UTSCOMJSON.nested-scroll-header.name -->
+
+<!-- UTSCOMJSON.nested-scroll-header.description -->
+
+<!-- UTSCOMJSON.nested-scroll-header.compatibility -->
+
+<!-- UTSCOMJSON.nested-scroll-header.attribute -->
+
+<!-- UTSCOMJSON.nested-scroll-header.event -->
+
+<!-- UTSCOMJSON.nested-scroll-header.component_type-->
+
+### 使用场景  
+
+scroll-view 嵌套场景中。外层 scroll-view 滚动时无法与内层 scroll-view 滚动衔接连贯滚动，因此提供`nested-scroll-header`节点，存放除内层 scroll-view 以外的内容节点。`nested-scroll-body`内部 scroll-view 滚动时会检测`nested-scroll-header`节点滚动位置，约束内层 scroll-view 滚动逻辑，实现嵌套模式下衔接连贯滚动。开发者只需将外层要显示内容节点放置`nested-scroll-header`节点内即可。具体用法请参考[scroll-view嵌套模式](https://doc.dcloud.net.cn/uni-app-x/component/scroll-view.html#nested-scroll-view)
+
+#### 注意事项  
+
++ `nested-scroll-header` 组件不支持设置css样式，不要通过 class 和 style 设置样式  
++ `nested-scroll-header` 组件应该放在 `nested-scroll-body` 组件前面（上面）  
++ `nested-scroll-header` 组件不支持多个子节点，渲染时只会取第一个子节点来渲染  
+
+> 蒸汽模式下此组件已无实际意义，仅为向下兼容而支持。  
+
+
+<!-- UTSCOMJSON.nested-scroll-header.children -->
+
+<!-- UTSCOMJSON.nested-scroll-header.example -->
+
+<!-- UTSCOMJSON.nested-scroll-header.reference -->

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

@@ -0,0 +1,8 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移至：
+
+- [nested-scroll-header](nested-scroll-header.md)
+- [nested-scroll-body](nested-scroll-body.md)

package/data/uni-app-x-docs/component/official-account.md

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

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

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

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

@@ -0,0 +1,37 @@
+<!-- ## page-container -->
+
+<!-- UTSCOMJSON.page-container.name -->
+
+<!-- UTSCOMJSON.page-container.description -->
+
+page-container 的特点：
+- 与普通前端popup类组件相比，page-container组件能响应返回操作。返回操作具体指：右滑手势、安卓物理返回键、和调用 `navigateBack` 接口三种返回情形。小程序未提供监听返回的API，想实现返回操作关闭弹层而不是页面，只能使用page-container组件。
+- 与[dialogPage](../api/dialog-page.md)相比，`page-container` 是组件而不是页面；`page-container` 跨端，而 dialogPage 不支持小程序；dialogPage 支持覆盖pages.json中定义的顶部导航栏和tabbar，而 `page-container`不支持。
+
+<!-- UTSCOMJSON.page-container.compatibility -->
+
+<!-- UTSCOMJSON.page-container.attribute -->
+
+<!-- UTSCOMJSON.page-container.event -->
+
+<!-- UTSCOMJSON.page-container.component_type -->
+
+### Tips
+- uni ui组件库中曾广泛使用的uni-popup组件，在uni-app x中推荐改用 page-container 组件替代
+- 组件支持拦截用户的返回操作，包括右滑手势、安卓物理返回键和调用 navigateBack API
+- iOS从屏幕左边滑入默认是关闭当前页面，如需改成关闭弹层，需在 pages.json 中配置`swipeBackAsBackPress`为true，把左滑关闭页面功能转为 `onBackPress`，才能关闭弹层。此功能需 5.21+ iOS平台 蒸汽模式 [文档](https://doc.dcloud.net.cn/uni-app-x/collocation/pagesjson.html#pagesoptionspage-style)
+- Web 设置 `overlay: true` 时，组件会禁止背景页面滚动，避免滚动穿透
+- 小程序 `uni.navigateBack` 无法在页面栈顶调用，此时没有上一级页面
+- 小程序不支持 `左侧弹出`，App 和 Web 支持
+- 小程序 `enter` 和 `leave` 相关事件的回调函数有参数 `event`，App 和 Web 平台没有
+- 开启 `closeOnSlideDown` 后，小程序需要快速下滑才生效，而 App 和 Web 会跟着手指拖动滑动
+- 小程序页面最多只有1个 `page-container`，已存在 `page-container` 时无法再弹出新的 `page-container`。支付宝小程序同一页面存在多个 `page-container` 时，第二个及后续打开的 `page-container` 可能无法弹出。App 和 Web 支持弹出多个 `page-container` 组件，后弹覆盖先弹。
+- Web 暂不支持拦截侧滑返回和浏览器的后退按钮
+- `overlay-style` 设置 `pointer-events: none` 可以实现点击遮罩层不关闭弹窗
+- 居中弹出为全屏显示。此行为是为了对齐小程序的表现。由于遮罩层被覆盖，并不会触发 `click-overlay` 事件，可以自行调整 `custom-style` 的样式来规避此行为
+
+<!-- UTSCOMJSON.page-container.children -->
+
+<!-- UTSCOMJSON.page-container.example -->
+
+<!-- UTSCOMJSON.page-container.reference -->

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

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

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

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

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

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+已迁移至 [picker-view](picker-view.md#picker-view-column)