微信小程序API 调起客户端小程序设置界面

OStack程序员社区-中国程序员成长平台 › 门户 › 编程› 移动开发›微信小程序开发文档

原作者: [db:作者] 来自: [db:来源] 收藏邀请

wx.openSetting(OBJECT)

基础库版本 1.1.0 开始支持，低版本需做兼容处理

调起客户端小程序设置界面，返回用户设置的操作结果

Object 参数说明：

参数	类型	必填	说明
success	Function	否	接口调用成功的回调函数，返回内容详见返回参数说明。
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数	类型	说明
authSetting	Object	用户授权结果，其中 key 为 scope 值，value 为 Bool 值，表示用户是否允许授权，详见 scope 列表

示例代码：

wx.openSetting({
  success: (res) => {
    /*
     * res.authSetting = {
     *   "scope.userInfo": true,
     *   "scope.userLocation": true
     * }
     */
  }
})

OpenSettingButton wx.createOpenSettingButton(string type, string text, string image, Object style)

支持版本 >= 2.0.7

创建打开设置页面的按钮。

参数

string type

按钮的类型

type 的合法值：

值	说明
text	可以设置背景色和文本的按钮
image	只能设置背景贴图的按钮，背景贴图会直接拉伸到按钮的宽高

string text

按钮上的文本，仅当 type 为 text 时有效

string image

按钮的背景图片，仅当 type 为 image 时有效

Object style

按钮的样式

属性	类型	是否必填	说明
left	number	是	左上角横坐标
top	number	是	左上角纵坐标
width	number	是	宽度
height	number	是	高度
backgroundColor	string	是	背景颜色
borderColor	string	是	边框颜色
borderWidth	number	是	边框宽度
borderRadius	number	是	边框圆角
textAlign	string	是	文本的水平居中方式
fontSize	number	是	字号
lineHeight	number	是	文本的行高

style.textAlign 的合法值：

值	说明
left	居左
center	居中
right	居右

返回值

OpenSettingButton

示例代码

let button = wx.createOpenSettingButton({
    type: 'text',
    text: '打开设置页面',
    style: {
        left: 10,
        top: 76,
        width: 200,
        height: 40,
        lineHeight: 40,
        backgroundColor: '#ff0000',
        color: '#ffffff',
        textAlign: 'center',
        fontSize: 16,
        borderRadius: 4
    }
})

wx.getSetting(OBJECT)

基础库 1.2.0 开始支持，低版本需做兼容处理

获取用户的当前设置

Object 参数说明：

参数	类型	必填	说明
success	Function	否	接口调用成功的回调函数，返回内容详见返回参数说明。
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数	类型	说明
authSetting	Object	用户授权结果，其中 key 为 scope 值，value 为 Bool 值，表示用户是否允许授权，详见 scope 列表

示例代码：

wx.getSetting({
  success: (res) => {
    /*
     * res.authSetting = {
     *   "scope.userInfo": true,
     *   "scope.userLocation": true
     * }
     */
  }
})