获取用户手机号
适用场景#
在小程序运行态对用户的手机号进行获取。
使用说明#
使用获取手机号组件能够在小程序运行态对用户的手机号进行获取，使用方式如下:
1.请确认所选应用支持小程序端构建，具体操作可参考创建应用指引
2.在编辑器中添加获取手机号组件。
3.为应用创建一个字符串类型的普通变量，用于接收获取到的手机号信息。
4.为获取手机号组件配置变量赋值事件，实现当用户授权成功后将返回的手机号信息赋值给步骤 3 中的普通变量。
5.该组件仅在小程序真实运行状态下生效，因此我们在编辑器中添加一个文本组件并与普通变量进行绑定，当用户在小程序中点击获取手机号按钮并授权成功时，文本组件便会展示对应的手机号信息。
6.将应用发布到小程序，可以看到当点击获取手机号按钮并授权时，文本组件便会对获取到的手机号码信息进行展示。
组件使用限制#
1.该组件仅支持在小程序端使用，并且小程序必须为企业主体。
2.该组件必须在小程序真实环境使用才能够看到实际效果。
属性#
组件接收的外部传入的属性
属性名 | 属性标识 | 类型 | 属性分组 | 默认值 | 说明 |
|---|
| 按钮标题(小程序) | text | string | 基础属性 | "获取用户手机号" | 按钮组件的标题 |
| 按钮风格(小程序) | type | "default"|"wechat"|"primary"|"warn" | 基础属性 | "wechat" | 按钮组件的风格，相对于普通按钮组件，新增“微信”按钮风格 |
| 按钮大小(小程序) | size | "default"|"mini"|"large" | 基础属性 | "default" | 按钮的大小 |
事件#
组件暴露的事件，可以监听组件的事件来触发一些外部的动作
事件名 | 事件code | 事件出参 event.detail | 适用情况 | 说明 |
|---|
| 手机号授权成功 | phonesuccess |
| 小程序 | 弹窗中点击了允许按钮后触发的事件 |
| 手机号授权失败 | phonefail | 小程序 | 弹窗中点击了拒绝按钮后触发的事件 |