tmui-cli 2.0.3 → 2.0.4

package/data/uniappx/api/network-summarize.md

@@ -0,0 +1,40 @@
+## 网络概述
+
+uni-app x中有较多网络API，包括request请求、上传下载、socket等。
+
+uni-app x也有很多组件带有联网功能，比如image、video、web-view都支持加载联网资源。
+
+## Cookie
+
+### Cookie概念
+
+HTTP cookie，简称cookie，是浏览网站时由网络服务器创建并由网页浏览器存放在用户计算机或其他设备的小文本文件。
+
+Cookie使Web服务器能在用户的设备存储状态信息（如添加到在线商店购物车中的商品）或跟踪用户的浏览活动（如点击特定按钮、登录或记录历史）
+
+#### 语法
+
+```
+Cookie: name=value
+Cookie: name=value; name2=value2; name3=value3
+```
+
+#### Cookie共享
+
+Cookie共享是指在应用中，请求同一域名地址，Http请求头会携带相同的Cookie。这是因为Cookie是由应用存储在用户设备上的，因此所有支持Cookie共享的API和组件都可以访问到这些Cookie。
+
+uni-app x 实现Cookie共享的API和组件的情况如下
+
+- [uni.request](https://doc.dcloud.net.cn/uni-app-x/api/request.html) ：用于发起网络请求，会自动携带Cookie。
+- [uni.uploadFile](https://doc.dcloud.net.cn/uni-app-x/api/upload-file.html) ：用于上传文件，会自动携带Cookie。
+- [uni.downloadFile](https://doc.dcloud.net.cn/uni-app-x/api/download-file.html) ：用于下载文件，会自动携带Cookie。
+- [image组件](https://doc.dcloud.net.cn/uni-app-x/component/image.html) ：显示网络图片时，会自动携带Cookie（iOS端未实现Cookie共享）。
+- [video组件](https://doc.dcloud.net.cn/uni-app-x/component/video.html) ：用于播放网络视频，会自动携带Cookie（iOS、Android端未实现Cookie共享）。
+- [web-view组件](https://doc.dcloud.net.cn/uni-app-x/component/web-view.html) ：用于显示网页，会自动携带Cookie（iOS端未实现Cookie共享）。
+- [websocket](https://doc.dcloud.net.cn/uni-app-x/api/websocket.html)：未实现Cookie共享。
+
+已实现Cookie共享的组件和API，开发者无须关心Cookie的存储、删除、过期等问题，uni-app x框架已自动处理。
+
+#### Cookie共享使用场景
+
+客户端请求接口，服务端下发Cookie，此时使用web-view组件，在web-view组件里访问同域名地址，也会携带客户端请求时设置的Cookie。

package/data/uniappx/api/nodes-info.md

@@ -0,0 +1,3 @@
+layout: SimpleLayout
+
+文档已迁移，请前往[createSelectorQuery](create-selector-query.md)查看最新文档

package/data/uniappx/api/on-tab-bar-mid-button-tap.md

@@ -0,0 +1,34 @@
+::: sourceCode
+## uni.onTabBarMidButtonTap(options) @ontabbarmidbuttontap
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-tabBar
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-tabBar
+
+监听中间按钮的点击事件
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 |
+| :- | :- | :- |  :-: |
+| options | () => void | 是 | 微信小程序 x / HarmonyOS x（部分支持，见上） |
+
+### onTabBarMidButtonTap 兼容性  
+| Web | 微信小程序 | Android | iOS(VDOM) | iOS(Vapor) | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | √ | √ | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.page.onTabBarMidButtonTap)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/ui/tabbar.html#ontabbarmidbuttontap)
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |
+
+## 注意
+一般建议使用自定义tabbar来实现。[详见](../collocation/pagesjson.md#pages-tabbar)

package/data/uniappx/api/open-app-authorize-setting.md

@@ -0,0 +1,117 @@
+::: sourceCode
+## uni.openAppAuthorizeSetting(options) @openappauthorizesetting
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-openAppAuthorizeSetting
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-openAppAuthorizeSetting
+
+跳转系统授权管理页
+
+### openAppAuthorizeSetting 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 4.51 | 4.51 | 4.61 |
+
+_注：App平台其实早期版本也可以使用_
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 |
+| :- | :- | :- |  :-: |
+| options | **OpenAppAuthorizeSettingOptions** | 是 | Web x（部分支持，见上） |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| success | (result: [OpenAppAuthorizeSettingSuccess](#openappauthorizesettingsuccess-values)) => void | 否 | null | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 接口调用成功的回调函数 |
+| fail | (result: [OpenAppAuthorizeSettingFail](#openappauthorizesettingfail-values)) => void | 否 | null | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (result: [OpenAppAuthorizeSettingComplete](#openappauthorizesettingcomplete-values)) => void | 否 | null | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### OpenAppAuthorizeSettingSuccess 的属性值 @openappauthorizesettingsuccess-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errMsg | string | 是 | Web x / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 错误信息 |
+
+#### OpenAppAuthorizeSettingFail 的属性值 @openappauthorizesettingfail-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errMsg | string | 是 | Web x / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 错误信息 |
+
+#### OpenAppAuthorizeSettingComplete 的属性值 @openappauthorizesettingcomplete-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errMsg | string | 是 | Web x / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 错误信息 |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/open-app-authorize-setting/open-app-authorize-setting.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/open-app-authorize-setting/open-app-authorize-setting.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/open-app-authorize-setting/open-app-authorize-setting
+```uvue
+<template>
+  
+  <scroll-view style="flex:1">
+  
+    <button type="primary" style="margin: 20px;" @tap="go">跳转系统授权管理页</button>
+  
+  </scroll-view>
+  
+</template>
+
+<style>
+
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.openAppAuthorizeSetting)
+- [参见uni-app相关文档](http://uniapp.dcloud.io/api/system/openappauthorizesetting)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/base/system/wx.openAppAuthorizeSetting.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=openAppAuthorizeSetting&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=openAppAuthorizeSetting&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=openAppAuthorizeSetting&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=openAppAuthorizeSetting&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=openAppAuthorizeSetting)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=openAppAuthorizeSetting&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/open-app-authorize-setting/open-app-authorize-setting.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/open-app-authorize-setting/open-app-authorize-setting.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/open-app-authorize-setting/open-app-authorize-setting
+```uvue
+<template>
+  
+  <scroll-view style="flex:1">
+  
+    <button type="primary" style="margin: 20px;" @tap="go">跳转系统授权管理页</button>
+  
+  </scroll-view>
+  
+</template>
+
+<style>
+
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |

package/data/uniappx/api/open-document.md

@@ -0,0 +1,122 @@
+::: sourceCode
+## uni.openDocument(options?) @opendocument
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-openDocument
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-openDocument
+
+打开文档
+
+### openDocument 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 4.71 | 4.71 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| options | **OpenDocumentOptions** | 否 | Web x（部分支持，见上） | uni.openDocument参数定义 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| filePath | string | 是 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.61（部分支持，见上） | 文件路径，仅支持本地路径 |
+| fileType | string | 否 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.61（部分支持，见上） | 文件类型，指定文件类型打开文件，微信小程序仅支持类型：doc, xls, ppt, pdf, docx, xlsx, pptx，App端由系统打开，原则上可以打开任意文件； |
+| success | (res: OpenDocumentSuccess) => void | 否 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.61（部分支持，见上） | uni.openDocument成功回调函数定义 |
+| fail | (res: [OpenDocumentFail](#opendocumentfail-values)) => void | 否 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.61（部分支持，见上） | uni.openDocument失败回调函数定义 |
+| complete | (res: any) => void | 否 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.61（部分支持，见上） | uni.openDocument完成回调函数定义 |
+| showMenu | boolean | 否 | Web x / 微信小程序 4.41（部分支持，见上） | 需要基础库： `2.11.0`<br/><br/>是否显示右上角菜单<br/> | 
+
+#### OpenDocumentFail 的属性值 @opendocumentfail-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errCode | number | 是 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.61（部分支持，见上） | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1300601 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.71（部分支持，见上） | 路径无效 |
+| 1300602 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.71（部分支持，见上） | 文件不存在 |
+| 1300603 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.71（部分支持，见上） | 不支持该文件类型 |
+| 1300604 | Web x / 微信小程序 4.41 / Android 4.71 / iOS 4.71 / HarmonyOS 4.71（部分支持，见上） | 其他未知错误 |
+| errSubject | string | 是 | Web x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x（部分支持，见上） | 错误信息中包含的数据 |
+| cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 | Web x（部分支持，见上） |  |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/open-document/open-document.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/open-document/open-document.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/open-document/open-document
+```uvue
+<template>
+    <page-head :title="title"></page-head>
+    
+    <scroll-view direction="vertical" style="flex:1">
+    
+      <view class="uni-common-mt">
+        <button v-for="(item, index) in fileList" :key="index" @click="openDocument(item)" style="margin: 10px;">
+          打开 {{item.type}} 文件
+        </button>
+      </view>
+    
+    </scroll-view>
+    
+</template>
+
+
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.file.openDocument)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/file/file.html#opendocument)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/file/wx.openDocument.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=openDocument&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=openDocument&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=openDocument&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=openDocument&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=openDocument)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=openDocument&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/open-document/open-document.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/open-document/open-document.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/open-document/open-document
+```uvue
+<template>
+    <page-head :title="title"></page-head>
+    
+    <scroll-view direction="vertical" style="flex:1">
+    
+      <view class="uni-common-mt">
+        <button v-for="(item, index) in fileList" :key="index" @click="openDocument(item)" style="margin: 10px;">
+          打开 {{item.type}} 文件
+        </button>
+      </view>
+    
+    </scroll-view>
+    
+</template>
+
+
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |

package/data/uniappx/api/open-location.md

@@ -0,0 +1,154 @@
+## uni.openLocation(options) @openlocation
+
+::: warning 注意
+
+- `HBuilderX 5.11` 起，`openLocation` 已内置在 `uni-app x` 框架内，无需再单独导入 `uni-openlocation` 插件；
+- `HBuilderX 5.11` 之前，如需使用，请前往插件市场导入该插件：[插件地址](https://ext.dcloud.net.cn/plugin?name=uni-openLocation)
+- 无论是内置能力还是导入 `uni-openlocation` 插件，通过 `uni.openLocation` 打开的页面都会以 `dialogPage` 的形式呈现。此时执行 `getDialogPages` 方法时，由 `openLocation` 打开的页面也会包含在返回的页面数组中，这属于正常现象。
+
+- `HarmonyOS平台` 调用此 API 需要申请定位权限 `ohos.permission.APPROXIMATELY_LOCATION`、`ohos.permission.LOCATION`，需自行在项目中配置权限。
+
+使用应用内置地图查看位置
+
+### openLocation 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 5.11 | 5.11 | 5.11 | 5.11 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 描述 |
+| :- | :- | :- | :- |
+| options | **OpenLocationOptions** | 是 | uni.openLocation函数参数定义 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| latitude | number | 是 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 纬度，范围为-90~90，负数表示南纬，使用 gcj02 国测局坐标系 |
+| longitude | number | 是 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 经度，范围为-180~180，负数表示西经，使用 gcj02 国测局坐标系 |
+| scale | number | 否 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 缩放比例，范围5~18，默认为18（微信小程序） |
+| name | string | 否 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 位置名 |
+| address | string | 否 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 地址的详细说明 |
+| success | (result: [OpenLocationSuccess](#openlocationsuccess-values)) => void | 否 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 接口调用成功的回调函数 |
+| fail | (result: [OpenLocationFail](#openlocationfail-values)) => void | 否 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | Web 4.0 / 微信小程序 5.11 / Android 5.11 / iOS 5.11 / HarmonyOS 5.11 | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### OpenLocationSuccess 的属性值 @openlocationsuccess-values 
+
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+
+#### OpenLocationFail 的属性值 @openlocationfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/open-location/open-location.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/open-location/open-location.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/open-location/open-location
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/open-location/open-location
+
+>示例
+```vue
+<template>
+  <view class="open-location-page uni-theme-root">
+    <page-head :title="title"></page-head>
+    <view class="uni-common-mt">
+      <view class="uni-list">
+        <view class="uni-list-cell">
+          <view class="uni-list-cell-left">
+            <view class="uni-label">经度</view>
+          </view>
+          <view class="uni-list-cell-db">
+            <text class="readonly-text">{{ longitude }}</text>
+          </view>
+        </view>
+        <view class="uni-list-cell">
+          <view class="uni-list-cell-left">
+            <view class="uni-label">纬度</view>
+          </view>
+          <view class="uni-list-cell-db">
+            <text class="readonly-text">{{ latitude }}</text>
+          </view>
+        </view>
+        <view class="uni-list-cell">
+          <view class="uni-list-cell-left">
+            <view class="uni-label">位置名称</view>
+          </view>
+          <view class="uni-list-cell-db">
+            <text class="readonly-text">{{ name }}</text>
+          </view>
+        </view>
+        <view class="uni-list-cell">
+          <view class="uni-list-cell-left">
+            <view class="uni-label">详细位置</view>
+          </view>
+          <view class="uni-list-cell-db">
+            <text class="readonly-text">{{ address }}</text>
+          </view>
+        </view>
+      </view>
+      <view class="uni-padding-wrap">
+        <view class="tips"><text class="tips-text">注意：需要正确配置地图服务商的Key才能正常显示位置</text></view>
+        <view class="uni-btn-v uni-common-mt">
+          <button type="primary" @click="openLocation">查看位置</button>
+        </view>
+      </view>
+    </view>
+  </view>
+</template>
+
+<style>
+  .open-location-page {
+    --open-location-hint-color: #999999;
+  }
+
+  .readonly-text {
+    color: var(--open-location-hint-color, #999999);
+    font-size: 14px;
+    line-height: 22px;
+    padding-top: 10px;
+    padding-bottom: 10px;
+  }
+
+  .uni-list-cell-left {
+    padding: 0 15px;
+  }
+
+  .tips {
+    margin-top: 15px;
+    opacity: 0.8;
+  }
+
+  .tips-text {
+    font-size: 12px;
+  }
+
+  @media (prefers-color-scheme: dark) {
+    .open-location-page {
+      --open-location-hint-color: #a0a0a0;
+    }
+  }
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.openLocation)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.openLocation.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=openLocation&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=openLocation&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=openLocation&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=openLocation&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=openLocation)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=openLocation&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)

package/data/uniappx/api/page-scroll-to.md

@@ -0,0 +1,170 @@
+::: sourceCode
+## uni.pageScrollTo(options) @pagescrollto
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-pageScrollTo
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-pageScrollTo
+
+将页面滚动到目标位置
+
+可以滚动到指定的scrollTop值处，也可以滚动到指定的目标元素处（通过css选择器selector）, 仅支持一级 class。
+
+本API滚动的是栈顶的页面。
+
+app-uvue下，其实没有页面级滚动。但本API做了一定兼容，当页面的根元素为scroll-view时，本API也会滚动该scroll-view。[详见](../css/README.md#pagescroll)
+
+### pageScrollTo 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 3.91 | 4.11 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **PageScrollToOptions** | 是 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| scrollTop | number | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 滚动到页面的目标位置（单位px） |
+| selector | string | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 元素选择器，用于指定要滚动到的元素位置 |
+| offsetTop | number | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 偏移距离，可以滚动到 selector 加偏移距离的位置 |
+| duration | number | 否 | Web 4.0 / 微信小程序 4.41 / Android x / iOS x / HarmonyOS x（部分支持，见上） | 滚动动画的时长，默认300，单位 ms |
+| success | (result: [PageScrollToSuccess](#pagescrolltosuccess-values)) => void | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 接口调用成功的回调函数 |
+| fail | (result: [PageScrollToFail](#pagescrolltofail-values)) => void | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 接口调用失败的回调函数 |
+| complete | (result: [PageScrollToComplete](#pagescrolltocomplete-values)) => void | 否 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### PageScrollToSuccess 的属性值 @pagescrolltosuccess-values 
+
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+
+#### PageScrollToFail 的属性值 @pagescrolltofail-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errCode | number | 是 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 设置页面滚动错误码<br/>- 4: 框架内部异常 |
+| errSubject | string | 是 |   | 统一错误主题（模块）名称 |
+| data | any | 否 |   | 错误信息中包含的数据 |
+| cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |   |  |
+
+#### PageScrollToComplete 的属性值 @pagescrolltocomplete-values 
+
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+
+`scrollTop` 和 `selector` 必须指定其中一个属性，否者触发 `fail` 回调
+
+### 返回值 
+
+| 类型 | 必备 |
+| :- | :- |
+| Promise\<**PageScrollToSuccess**> | 否 |
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/page-scroll-to/page-scroll-to.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/page-scroll-to/page-scroll-to.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/page-scroll-to/page-scroll-to
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/page-scroll-to/page-scroll-to
+
+>示例
+```vue
+<template>
+  
+  <scroll-view class="uni-theme-root" style="flex: 1" scroll-with-animation="true">
+  
+    <view class="uni-padding-wrap uni-theme-root">
+      <page-head :title="title"></page-head>
+      <button type="default" class="btn-scrollTo" @click="scrollTo">
+        scrollTo
+      </button>
+      <button type="default" class="btn-scrollToElement" @click="scrollToElement">
+        scrollToElement
+      </button>
+      <view class="uni-list" v-for="(_, index) in 10" :key="index">
+        <view class="uni-list-cell list-item">{{ index }}</view>
+      </view>
+      <view class="custom-element">scrollTo-custom-element</view>
+      <view class="uni-list" v-for="(_, index2) in 10" :key="index2">
+        <view class="uni-list-cell list-item">{{ index2 }}</view>
+      </view>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+
+
+<style>
+  .list-item {
+    height: 100px;
+    padding-left: 30px;
+  }
+
+  .list-item,
+  .custom-element {
+    color: var(--text-color, #333333);
+  }
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.page.pageScrollTo)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/ui/scroll.html#pagescrollto)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/ui/scroll/wx.pageScrollTo.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=pageScrollTo&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=pageScrollTo&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=pageScrollTo&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=pageScrollTo&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=pageScrollTo)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=pageScrollTo&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+**selector 语法**
+
+selector类似于 CSS 的选择器，但仅支持下列语法。
+
+- ID选择器：#the-id
+- class选择器（可以连续指定多个）：`.a-class.another-class`
+- 子元素选择器：`.the-parent > .the-child`
+- 后代选择器：`.the-ancestor .the-descendant`
+- 跨自定义组件的后代选择器：`.the-ancestor >>> .the-descendant`
+- 多选择器的并集：`#a-node, .some-other-nodes`
+
+## uni-app x 注意事项
+
+1. app-uvue支持的选择器较少，不支持ID选择器，[详见](../css/common/selector.md)
+2. app-uvue的页面滚动，是由页面最外层的scroll-view模拟的，如果页面最外层不是scroll-view，无法使用本api。[详见](../css/README.md#pagescroll)
+3. app-uvue的scroll-view滚动时，如需动画，则需要在scroll-view的属性中配置 `scroll-with-animation="true"`，[详见](../component/scroll-view.md)
+4. scroll-view的滚动，设置其scrollTop即可。[详见](../component/scroll-view.md)
+
+**示例**
+
+```javascript
+uni.pageScrollTo({
+	scrollTop: 0,
+	duration: 300
+});
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |
+
+## Tips
+- 本API默认处理栈顶页面，而不是代码所在页面。[详见](./README.md#toppage)