wx.setBackgroundColor(Object object)

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

Promise 风格 调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:支持,需要小程序基础库版本不低于 2.4.0 在小程序插件中使用时,只能在当前插件的页面中调用

动态设置窗口的背景色

参数

Object object

属性 类型 默认值 必填 说明
backgroundColor string 窗口的背景色,必须为十六进制颜色值
backgroundColorTop string 顶部窗口的背景色,必须为十六进制颜色值,仅 iOS 支持
backgroundColorBottom string 底部窗口的背景色,必须为十六进制颜色值,仅 iOS 支持
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

wx.setBackgroundColor({
  backgroundColor: '#ffffff', // 窗口的背景色为白色
})

wx.setBackgroundColor({
  backgroundColorTop: '#ffffff', // 顶部窗口的背景色为白色
  backgroundColorBottom: '#ffffff', // 底部窗口的背景色为白色
})