提交 95ef4194 编写于 作者: Q qiang

chore: docs sync

上级 dfc5f9ec
...@@ -10,9 +10,10 @@ ...@@ -10,9 +10,10 @@
- [百度小程序](https://smartprogram.baidu.com/docs/develop/tutorial/codedir/) - [百度小程序](https://smartprogram.baidu.com/docs/develop/tutorial/codedir/)
- [字节跳动小程序](https://developer.toutiao.com/dev/cn/mini-app/develop/component/introduction/basic-component) - [字节跳动小程序](https://developer.toutiao.com/dev/cn/mini-app/develop/component/introduction/basic-component)
- [QQ小程序](https://q.qq.com/wiki/develop/miniprogram/frame/) - [QQ小程序](https://q.qq.com/wiki/develop/miniprogram/frame/)
- [快手小程序](https://mp.kuaishou.com/docs/develop/frame/config/conf_appjson.html)
- [华为快应用](https://developer.huawei.com/consumer/cn/doc/development/quickApp-References/webview-component-view) - [华为快应用](https://developer.huawei.com/consumer/cn/doc/development/quickApp-References/webview-component-view)
- [360小程序](https://mp.360.cn/doc/miniprogram/dev/#/view) - [360小程序](https://mp.360.cn/doc/miniprogram/dev/#/view)
- [Weex](https://doc.weex.io/cn/guide/) - [Weex](http://doc.weex.io/zh/guide/introduction.html)
<ul class="nav-href"> <ul class="nav-href">
<li class="ext-link"><a href="//ext.dcloud.net.cn/" target="__blank">插件市场</a></li> <li class="ext-link"><a href="//ext.dcloud.net.cn/" target="__blank">插件市场</a></li>
......
### uni.getLocation(OBJECT) ### uni.getLocation(OBJECT)
获取当前的地理位置、速度。 获取当前的地理位置、速度。
在微信小程序中,当用户离开应用后,此接口无法调用,除非申请后台持续定位权限;当用户点击“显示在聊天顶部”时,此接口可继续调用。
**OBJECT 参数说明** **OBJECT 参数说明**
...@@ -69,6 +68,7 @@ uni.getLocation({ ...@@ -69,6 +68,7 @@ uni.getLocation({
- App:持续定位方案:iOS端可以申请持续定位权限,[参考](https://ask.dcloud.net.cn/article/12569)。Android如果进程被杀,代码无法执行。可以使用[unipush](https://ask.dcloud.net.cn/article/35622),通过服务器激活App,执行透传消息,让App启动然后采集位置。Android上,即使自己写原生插件做后台进程,也很容易被杀,unipush是更合适的方案 - App:持续定位方案:iOS端可以申请持续定位权限,[参考](https://ask.dcloud.net.cn/article/12569)。Android如果进程被杀,代码无法执行。可以使用[unipush](https://ask.dcloud.net.cn/article/35622),通过服务器激活App,执行透传消息,让App启动然后采集位置。Android上,即使自己写原生插件做后台进程,也很容易被杀,unipush是更合适的方案
- 小程序:api默认不返回详细地址中文描述。需要中文地址有2种方式:1、使用高德地图小程序sdk,在app和微信上都可以获得中文地址,[参考](http://ask.dcloud.net.cn/article/35070)。2、只考虑app,使用``plus.geolocation``也可以获取中文地址。manifest里的App SDK配置仅用于app,小程序无需在这里配置。 - 小程序:api默认不返回详细地址中文描述。需要中文地址有2种方式:1、使用高德地图小程序sdk,在app和微信上都可以获得中文地址,[参考](http://ask.dcloud.net.cn/article/35070)。2、只考虑app,使用``plus.geolocation``也可以获取中文地址。manifest里的App SDK配置仅用于app,小程序无需在这里配置。
- 可以通过用户授权API来判断用户是否给应用授予定位权限[https://uniapp.dcloud.io/api/other/authorize](https://uniapp.dcloud.io/api/other/authorize) - 可以通过用户授权API来判断用户是否给应用授予定位权限[https://uniapp.dcloud.io/api/other/authorize](https://uniapp.dcloud.io/api/other/authorize)
- 在微信小程序中,当用户离开应用后,此接口无法调用,需要申请[后台持续定位权限](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html),另外新版本中需要使用 [wx.onLocationChange](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.onLocationChange.html) 监听位置信息变化;当用户点击“显示在聊天顶部”时,此接口可继续调用。
### uni.chooseLocation(OBJECT) ### uni.chooseLocation(OBJECT)
打开地图选择位置。 打开地图选择位置。
......
...@@ -26,19 +26,19 @@ mapContext ...@@ -26,19 +26,19 @@ mapContext
|includePoints|OBJECT|缩放视野展示所有经纬度|app-nvue 2.1.5+|| |includePoints|OBJECT|缩放视野展示所有经纬度|app-nvue 2.1.5+||
|getRegion|OBJECT|获取当前地图的视野范围||| |getRegion|OBJECT|获取当前地图的视野范围|||
|getScale|OBJECT|获取当前地图的缩放级别||| |getScale|OBJECT|获取当前地图的缩放级别|||
|addCustomLayer|OBJECT|添加个性化图层||App暂不支持 (**SDK不支持**),微信小程序| |addCustomLayer|OBJECT|添加个性化图层||App暂不支持 (**SDK不支持**),微信小程序|
|addGroundOverlay|OBJECT|创建自定义图片图层,图片会随着地图缩放而缩放||App-nvue 3.1.0+,微信小程序| |addGroundOverlay|OBJECT|创建自定义图片图层,图片会随着地图缩放而缩放||App-nvue 3.1.0+,微信小程序|
|addMarkers |OBJECT|添加 marker||App-nvue 3.1.0+,微信小程序| |addMarkers |OBJECT|添加 marker||App-nvue 3.1.0+,微信小程序|
|fromScreenLocation|OBJECT|获取屏幕上的点对应的经纬度,坐标原点为地图左上角||App暂不支持,微信小程序| |fromScreenLocation|OBJECT|获取屏幕上的点对应的经纬度,坐标原点为地图左上角||App暂不支持,微信小程序|
|initMarkerCluster|OBJECT|初始化点聚合的配置,未调用时采用默认配置||App-nvue 3.1.0+,微信小程序| |initMarkerCluster|OBJECT|初始化点聚合的配置,未调用时采用默认配置||App-nvue 3.1.0+,微信小程序|
|moveAlong|OBJECT|沿指定路径移动 marker,用于轨迹回放等场景。动画完成时触发回调事件,若动画进行中,对同一 marker 再次调用 moveAlong 方法,前一次的动画将被打断。|支持 android 不支持autoRotate属性设置 默认ture|App-nvue 3.1.0+,微信小程序| |moveAlong|OBJECT|沿指定路径移动 marker,用于轨迹回放等场景。动画完成时触发回调事件,若动画进行中,对同一 marker 再次调用 moveAlong 方法,前一次的动画将被打断。|支持 android 不支持autoRotate属性设置 默认ture|App-nvue 3.1.0+,微信小程序|
|openMapApp|OBJECT|拉起地图APP选择导航。||App-nvue 3.1.0+,微信小程序| |openMapApp|OBJECT|拉起地图APP选择导航。||App-nvue 3.1.0+,微信小程序|
|removeCustomLayer|OBJECT|移除个性化图层 ||App暂时不支持 (**SDK不支持**),微信小程序| |removeCustomLayer|OBJECT|移除个性化图层 ||App暂时不支持 (**SDK不支持**),微信小程序|
|removeGroundOverlay|OBJECT|移除自定义图片图层||App-nvue 3.1.0+,微信小程序| |removeGroundOverlay|OBJECT|移除自定义图片图层||App-nvue 3.1.0+,微信小程序|
|removeMarkers|OBJECT|移除 marker。||App-nvue 3.1.0+,微信小程序| |removeMarkers|OBJECT|移除 marker。||App-nvue 3.1.0+,微信小程序|
|setCenterOffset|OBJECT|设置地图中心点偏移,向后向下为增长,屏幕比例范围(0.25~0.75),默认偏移为[0.5, 0.5]||App暂时不支持,微信小程序| |setCenterOffset|OBJECT|设置地图中心点偏移,向后向下为增长,屏幕比例范围(0.25~0.75),默认偏移为[0.5, 0.5]||App暂时不支持,微信小程序|
|toScreenLocation|OBJECT|获取经纬度对应的屏幕坐标,坐标原点为地图左上角。||App暂时不支持,微信小程序| |toScreenLocation|OBJECT|获取经纬度对应的屏幕坐标,坐标原点为地图左上角。||App暂时不支持,微信小程序|
|updateGroundOverlay|OBJECT|更新自定义图片图层。||App-nvue 3.1.0+,微信小程序| |updateGroundOverlay|OBJECT|更新自定义图片图层。||App-nvue 3.1.0+,微信小程序|
|on|EventHandle|监听地图事件。||App-nvue 3.1.0+,微信小程序| |on|EventHandle|监听地图事件。||App-nvue 3.1.0+,微信小程序|
|$getAppMap||获取原生地图对象 [plus.maps.Map](https://www.html5plus.org/doc/zh_cn/maps.html#plus.maps.Map)|app-vue自定义组件模式|1.9.3| |$getAppMap||获取原生地图对象 [plus.maps.Map](https://www.html5plus.org/doc/zh_cn/maps.html#plus.maps.Map)|app-vue自定义组件模式|1.9.3|
...@@ -104,100 +104,110 @@ mapContext ...@@ -104,100 +104,110 @@ mapContext
|fail|Function|否|接口调用失败的回调函数| |fail|Function|否|接口调用失败的回调函数|
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)| |complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
**addCustomLayer 的 OBJECT 参数列表** **addCustomLayer 的 OBJECT 参数列表**
|属性 |类型 |默认值 |必填 |说明 | |属性 |类型 |默认值 |必填 |说明 |
|:-|:-|:-|:-|:-| |:-|:-|:-|:-|:-|
|layerId |string | |是 |个性化图层id | |layerId |string | |是 |个性化图层id |
|success |function | |否 |接口调用成功的回调函数 | |success |function | |否 |接口调用成功的回调函数 |
|fail |function | |否 |接口调用失败的回调函数 | |fail |function | |否 |接口调用失败的回调函数 |
|complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行) | |complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行) |
**addGroundOverlay 的 OBJECT 参数列表** **addGroundOverlay 的 OBJECT 参数列表**
|属性 |类型 |默认值 |必填 |说明 | |属性 |类型 |默认值 |必填 |说明 |
|:-|:-|:-|:-|:-| |:-|:-|:-|:-|:-|
|id |String | |是 |图片图层 id | |id |String | |是 |图片图层 id |
|src |String | |是 |图片路径,支持网络图片、临时路径、代码包路径 | |src |String | |是 |图片路径,支持网络图片、临时路径、代码包路径 |
|bounds |Object | |是 |图片覆盖的经纬度范围 | |bounds |Object | |是 |图片覆盖的经纬度范围 |
|visible |Boolean |true |否 |是否可见 | |visible |Boolean |true |否 |是否可见 |
|zIndex |Number |1 |否 |图层绘制顺序 | |zIndex |Number |1 |否 |图层绘制顺序 |
|opacity |Number |1 |否 |图层透明度 | |opacity |Number |1 |否 |图层透明度 |
|success |function | |否 |接口调用成功的回调函数 | |success |function | |否 |接口调用成功的回调函数 |
|fail |function | |否 |接口调用失败的回调函数 | |fail |function | |否 |接口调用失败的回调函数 |
|complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行) | |complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行) |
`object.bounds` 的结构 `object.bounds` 的结构
|属性 |类型 |默认值 |必填 |说明 | |属性 |类型 |默认值 |必填 |说明 |
|:-|:-|:-|:-|:-| |:-|:-|:-|:-|:-|
|southwest |Object | |是 |西南角经纬度 | |southwest |Object | |是 |西南角经纬度 |
|northeast |Object | |是 |东北角经纬度 | |northeast |Object | |是 |东北角经纬度 |
`southwest` 的结构 `southwest` 的结构
|属性 |类型 |默认值 |必填 |说明 | |属性 |类型 |默认值 |必填 |说明 |
|:-|:-|:-|:-|:-| |:-|:-|:-|:-|:-|
|longitude |number | |是 |经度 | |longitude |number | |是 |经度 |
|latitude |number | |是 |纬度 | |latitude |number | |是 |纬度 |
`northeast` 的结构 `northeast` 的结构
|属性 |类型 |默认值 |必填 |说明 | |属性 |类型 |默认值 |必填 |说明 |
|:-|:-|:-|:-|:-| |:-|:-|:-|:-|:-|
|longitude |number | |是 |经度 | |longitude |number | |是 |经度 |
|latitude |number | |是 |纬度 | |latitude |number | |是 |纬度 |
**addMarkers 的 OBJECT 参数列表** **addMarkers 的 OBJECT 参数列表**
|属性 |类型 |默认值 |必填 |说明 | |属性 |类型 |默认值 |必填 |说明 |
|:-|:-|:-|:-|:-| |:-|:-|:-|:-|:-|
|markers |Array | |是 |同传入 map 组件的 marker 属性 | |markers |Array | |是 |同传入 map 组件的 marker 属性 |
|clear |boolean |false |否 |是否先清空地图上所有 marker | |clear |boolean |false |否 |是否先清空地图上所有 marker |
|success |function | |否 |接口调用成功的回调函数 | |success |function | |否 |接口调用成功的回调函数 |
|fail |function | |否 |接口调用失败的回调函数 | |fail |function | |否 |接口调用失败的回调函数 |
|complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行) | |complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行) |
**MapContext.on()** (app-nvue、微信小程序支持) **removeMarkers 的 OBJECT 参数列表**
`markerClusterCreate` |属性 |类型 |默认值 |必填 |说明 |
缩放或拖动导致新的聚合簇产生时触发,仅返回新创建的聚合簇信息。 |:-|:-|:-|:-|:-|
|markerIds |Array | |是 |要被删除的marker的id属性组成的数组 |
返回参数 |success |function | |否 |接口调用成功的回调函数 |
|fail |function | |否 |接口调用失败的回调函数 |
|参数 |类型 |说明 | |complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行) |
|:-|:-|:-|
|clusters |Array&amp;lt;ClusterInfo&amp;gt; |聚合簇数据 |
**MapContext.on()** (app-nvue、微信小程序支持)
`markerClusterClick` `markerClusterCreate`
聚合簇的点击事件。 缩放或拖动导致新的聚合簇产生时触发,仅返回新创建的聚合簇信息。
返回参数 返回参数
|参数 |类型 |说明 | |参数 |类型 |说明 |
|:-|:-|:-| |:-|:-|:-|
|cluster|ClusterInfo|聚合簇 | |clusters |Array&amp;lt;ClusterInfo&amp;gt; |聚合簇数据 |
`ClusterInfo` 结构
`markerClusterClick`
|参数 |类型 |说明 | 聚合簇的点击事件。
|:-|:-|:-|
|clusterId |Number |聚合簇的 id | 返回参数
|center |LatLng |聚合簇的坐标 |
|markerIds |Array&amp;lt;Number&amp;gt;|该聚合簇内的点标记数据数组 | |参数 |类型 |说明 |
|:-|:-|:-|
|cluster|ClusterInfo|聚合簇 |
示例代码
`ClusterInfo` 结构
```
MapContext.on('markerClusterCreate', (res) => {}) |参数 |类型 |说明 |
MapContext.on('markerClusterClick', (res) => {}) |:-|:-|:-|
``` |clusterId |Number |聚合簇的 id |
|center |LatLng |聚合簇的坐标 |
|markerIds |Array&amp;lt;Number&amp;gt;|该聚合簇内的点标记数据数组 |
示例代码
```
MapContext.on('markerClusterCreate', (res) => {})
MapContext.on('markerClusterClick', (res) => {})
```
## mapSearch 模块(仅app-nvue支持) ## mapSearch 模块(仅app-nvue支持)
......
...@@ -46,7 +46,7 @@ ...@@ -46,7 +46,7 @@
js中操作globalData的方式如下: js中操作globalData的方式如下:
`getApp().globalData.text = 'test'` `getApp().globalData.text = 'test'`
在应用onLaunch时,getApp对象还未获取,暂时可以使用this.$scope.globalData获取globalData。 在应用onLaunch时,getApp对象还未获取,暂时可以使用this.globalData获取globalData。
如果需要把globalData的数据绑定到页面上,可在页面的onShow页面生命周期里进行变量重赋值。 如果需要把globalData的数据绑定到页面上,可在页面的onShow页面生命周期里进行变量重赋值。
......
...@@ -418,6 +418,7 @@ Tips:关于摇树优化(treeShaking)原理及优化结果,参考:[http ...@@ -418,6 +418,7 @@ Tips:关于摇树优化(treeShaking)原理及优化结果,参考:[http
|enableParallelLoader |Boolean| 是否启用多进程编译,默认为false | |enableParallelLoader |Boolean| 是否启用多进程编译,默认为false |
|enableDistFileMinify |Boolean| 是否压缩编译产物(仅在真机预览/真机调试时生效),默认为false | |enableDistFileMinify |Boolean| 是否压缩编译产物(仅在真机预览/真机调试时生效),默认为false |
|uniStatistics |Object |[支付宝小程序是否开启 uni 统计,配置方法同全局配置](/collocation/manifest?id=uniStatistics) | |uniStatistics |Object |[支付宝小程序是否开启 uni 统计,配置方法同全局配置](/collocation/manifest?id=uniStatistics) |
|scopedSlotsCompiler|String|作用域插槽编译模式,HBuilderX 3.1.19+ 开始支持,可选:legacy、auto、augmented,默认:auto|
**注意** **注意**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册