微信小程序中wx.chooseAddress(OBJECT)实例详解
简介
wx.chooseAddress
是微信小程序提供的一个方法,可以在小程序中调用用户手机通讯录,用于获取用户的收货地址信息。可以方便快捷地获取用户的地址信息,减少用户在填写个人信息时的繁琐操作。
该方法需要用户授权才能调用,同时需要在 app.json
文件中声明 scope.address
权限。
接口调用格式
wx.chooseAddress(OBJECT)
OBJECT参数说明
OBJECT 是一个对象,参数有如下几个:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数 |
================================================ | |||
NAME | TYPE | DESCRIPTION | |
----------------------------------- | |||
userName | String | 收货人姓名 | |
postalCode | String | 邮政编码 | |
provinceName | String | 省份名称 | |
cityName | String | 城市名称 | |
countyName | String | 县/区名称 | |
detailInfo | String | 详细地址 | |
nationalCode | String | 国家码 | |
telNumber | String | 收货人手机号码 |
OBJECT.success(res) 参数说明
res 是一个对象,参数有如下几个:
{
userName:"收货人姓名",
postalCode:"邮编",
provinceName:"省份",
cityName:"城市",
countyName:"区县",
detailInfo:"详细地址",
nationalCode:"国家",
telNumber:"手机号码"
}
注意事项
- wx.chooseAddress() 的调用需要用户授权,若用户未授权则无法调用此接口,即使
app.json
中声明了scope.address
权限。 - 若此前已经授权,用户再次使用该功能时不会再次弹出授权窗口。
- 授权成功后,用户每次调用 wx.chooseAddress() 都不会再次出现授权窗口。
- 对于用户的地址信息,用户不想分享的可以通过小程序后台的数据运营管理系统进行删除。
示例说明
示例1:在小程序中使用wx.chooseAddress()
wx.chooseAddress({
success: function (res) {
console.log(res);
},
fail: function (res) {
console.log(res);
}
})
示例2:获取并显示用户地址信息
wx.chooseAddress({
success: function (res) {
// 将用户地址信息渲染到页面上
var userAddress = res.provinceName + res.cityName + res.countyName + res.detailInfo;
this.setData({address: userAddress});
}
})
以上是关于 wx.chooseAddress() 方法的详细介绍和示例说明,可以方便快捷地获取用户的地址信息,为用户提供便利服务。
本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:微信小程序 中wx.chooseAddress(OBJECT)实例详解 - Python技术站