跳到主要内容

获取用户信息(已废弃)

更新调整公告

小程序官方调整了后续获取「用户头像、昵称」信息的策略(相关公告:小程序用户头像昵称获取规则调整公告),在 2022 年 11 月 8 日后,微搭提供的获取用户信息组件,将不能够再获取到真实的用户头像和昵称,而仅能获取到默认灰色头像和“微信用户”文本。

微搭依据小程序的新策略,提供了相关适配方案,如有相关需求,请查阅如下实践文档进行改造适配:适配小程序用户头像昵称获取规则调整的推荐方案

适用场景#

能够在小程序运行态对用户的微信头像、微信昵称等信息进行获取。

使用说明

使用获取用户信息组件能够在小程序运行态对用户的微信头像、微信昵称等信息进行获取,使用方式如下:

1.创建应用,应用构建类型需要为小程序构建或三端构建。

2.在编辑器中添加获取用户信息组件,并且在组件的右侧配置区填写信息用途。(若不填写信息用途,将导致功能不可用,请注意)

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

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

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

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

组件使用限制

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

2.组件右侧配置区中信息用途必须进行填写,否则组件将无法正常使用。

属性

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

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

按钮组件的标题

示例:"获取用户信息"

按钮风格(小程序)typestring

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

示例:"wechat"

按钮大小(小程序)sizestring

按钮的大小

示例:"default"

信息用途(小程序)usagestring

声明获取用户个人信息的用途,不超过30个字符,若不填写将导致功能失效

示例:""

语言(小程序)languagestring

用户当前国家、省份、城市所使用的语言

示例:"zh_CN"

事件

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

事件名
事件code
事件出参 event.detail
适用情况
说明
用户信息授权成功userinfosuccessobject
  • avatarUrl: string用户头像 默认值:
  • nickName: string微信昵称 默认值:
  • language: string语言 默认值:
小程序

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

用户信息授权失败userinfofail小程序

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