2023年微信小程序API 背景

微信小程序API背景介绍了两个常用的API功能：wx.setBackgroundTextStyle和wx.setBackgroundColor。其中，wx.setBackgroundTextStyle可以设置下拉背景字体和loading图的样式，而wx.setBackgroundColor则可以动态设置窗口的背景色。这些API功能在小程序开发中非常有用，可以通过简单的代码实现高级外观和用户体验效果。以下是对这两个API功能的详细介绍。

1. wx.setBackgroundTextStyle(Object object)

该API函数从基础库 2.1.0 开始支持，可用于动态设置下拉背景字体、loading 图的样式。在使用时，需要注意低版本兼容处理。

参数

Object object

在使用wx.setBackgroundTextStyle时，你需要传递一个参数对象object，该对象包含以下属性：

属性	类型	默认值	必填	说明
textStyle	string		是	下拉背景字体、loading 图的样式。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

对于object.textStyle属性，合法值如下：

值	说明	最低版本
dark	dark 样式
light	light 样式

示例代码

wx.setBackgroundTextStyle({
  textStyle: 'dark' // 下拉背景字体、loading 图的样式为dark
})

2. wx.setBackgroundColor(Object object)

该API函数从基础库 2.1.0 开始支持，可用于动态设置窗口的背景色。在使用时，也需要注意低版本兼容处理。

参数

Object object

在使用wx.setBackgroundColor时，你需要传递一个参数对象object，该对象包含以下属性： <

属性	类型	默认值	必填	说明
backgroundColor	string		否	窗口的背景色，必须为十六进制颜色值
backgroundColorTop	string