swan.setBackgroundColor

基础库 3.10.4 版本开始支持。

解释:设置窗口的背景颜色。

# 方法参数

Object object

# object参数说明

属性名 类型 必填 默认值 说明
backgroundColor String 需设置的背景窗口颜色,支持十六进制颜色值。11.3
低版本请做兼容性处理
backgroundColorTop String - 需设置的顶部背景窗口颜色,支持十六进制颜色值,仅 ios 有效。 11.3
低版本请做兼容性处理
backgroundColorBottom String - 需设置的底部背景窗口颜色,支持十六进制颜色值,仅 ios 有效。11.3
低版本请做兼容性处理
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

# 示例

扫码体验
重新加载
请使用百度APP扫码

# 图片示例

# 代码示例 1 - backgroundColor:#000000 :

    <view class="container">
        <view class="card-area">
            <view class="top-description border-bottom">
                <view>设置窗口的背景颜色</view>
                <view>色值为: #000000</view>
            </view>
                <button type="primary" bindtap="setBackgroundColor">setBackgroundColor</button>
        </view>
        <view class="page-title">
            <view class="page-title-line"></view>
            <view class="page-title-text">setBackgroundColor</view>
        </view>
    </view>
    
    Page({
        setBackgroundColor() {
            swan.setBackgroundColor({
                backgroundColor: '#000000',
                success: function () {
                    console.log('setBackgroundColor success');
                },
                fail: function (err) {
                    console.log('setBackgroundColor fail', err);
                }
            });
        }
    });
    

    # 图片示例

    # 代码示例 2 - backgroundColorTop:#FFC0CB :

      Page({
          setBackgroundColor() {
              swan.setBackgroundColor({
                  backgroundColorTop: '#FFC0CB',
                  success: function () {
                      console.log('setBackgroundColor success');
                  },
                  fail: function (err) {
                      console.log('setBackgroundColor fail', err);
                  }
              });
          }
      });
      

      # 图片示例

      # 代码示例 3 - backgroundColorBottom:#7B68EE :

        Page({
            setBackgroundColor() {
                swan.setBackgroundColor({
                    backgroundColorBottom: '#7B68EE',
                    success: function () {
                        console.log('setBackgroundColor success');
                    },
                    fail: function (err) {
                        console.log('setBackgroundColor fail', err);
                    }
                });
            }
        });
        

        # 错误码

        # Android

        错误码 说明
        202 解析失败,请检查参数是否正确
        1001 执行失败

        # iOS

        错误码 说明
        202 解析失败,请检查参数是否正确