跳到主要内容

获取用户手机号

适用场景#

在小程序运行态对用户的手机号进行获取。

使用说明#

使用获取手机号组件能够在小程序运行态对用户的手机号进行获取,使用方式如下:

1.请确认所选应用支持小程序端构建,具体操作可参考创建应用指引

2.在编辑器中添加获取手机号组件。

3.为应用创建一个字符串类型的普通变量,用于接收获取到的手机号信息。

4.为获取手机号组件配置变量赋值事件,实现当用户授权成功后将返回的手机号信息赋值给步骤 3 中的普通变量。

5.该组件仅在小程序真实运行状态下生效,因此我们在编辑器中添加一个文本组件并与普通变量进行绑定,当用户在小程序中点击获取手机号按钮并授权成功时,文本组件便会展示对应的手机号信息。

6.将应用发布到小程序,可以看到当点击获取手机号按钮并授权时,文本组件便会对获取到的手机号码信息进行展示。

组件使用限制#

1.该组件仅支持在小程序端使用,并且小程序必须为企业主体

2.该组件必须在小程序真实环境使用才能够看到实际效果。

属性#

组件接收的外部传入的属性

属性名
属性标识
类型
属性分组
默认值
说明
按钮标题(小程序)textstring基础属性"获取用户手机号"按钮组件的标题
按钮风格(小程序)type"default"|"wechat"|"primary"|"warn"基础属性"wechat"按钮组件的风格,相对于普通按钮组件,新增“微信”按钮风格
按钮大小(小程序)size"default"|"mini"|"large"基础属性"default"按钮的大小

事件#

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
手机号授权成功phonesuccess
  • phoneNumber:string
  • purePhoneNumber:string
  • countryCode:string
  • timestamp:string
小程序弹窗中点击了允许按钮后触发的事件
手机号授权失败phonefail小程序弹窗中点击了拒绝按钮后触发的事件