跳到主要内容

获取用户手机号

Phone

使用说明

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

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

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

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

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

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

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

组件使用限制

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

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

3.确保小程序已经完成微信认证。去认证

属性

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

属性名
属性标识
类型
说明
按钮标题(小程序)textstring

按钮组件的标题

示例:"获取用户手机号"

按钮风格(小程序)typestring

按钮组件的风格,相对于普通按钮组件,新增“微信”按钮风格

示例:"wechat"

按钮大小(小程序)sizestring

按钮的大小

示例:"default"

事件

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

事件名
事件code
事件出参 event.detail
适用情况
说明
手机号授权成功phonesuccessobject
  • phoneNumber: string区号+手机号
  • purePhoneNumber: string无区号手机号
  • countryCode: string区号
  • timestamp: string授权时间
小程序

弹窗中点击了允许按钮后触发的事件

手机号授权失败phonefail小程序

弹窗中点击了拒绝按钮后触发的事件