swan.setBackgroundColor

基础库 3.10.4 版本开始支持。

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

方法参数

Object object

object参数说明 :

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

示例

扫码体验

swan.setBackgroundColor - 图1请使用百度APP扫码

图片示例

swan.setBackgroundColor - 图2

swan.setBackgroundColor - 图3

swan.setBackgroundColor - 图4

代码示例1 - backgroundColor:#000000 :

在开发者工具中预览效果

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

图片示例

swan.setBackgroundColor - 图5

swan.setBackgroundColor - 图6

swan.setBackgroundColor - 图7

代码示例2 - backgroundColorTop:#FFC0CB :

在开发者工具中预览效果

  1. Page({
  2. setBackgroundColor() {
  3. swan.setBackgroundColor({
  4. backgroundColorTop: '#FFC0CB',
  5. success: function () {
  6. console.log('setBackgroundColor success');
  7. },
  8. fail: function (err) {
  9. console.log('setBackgroundColor fail', err);
  10. }
  11. });
  12. }
  13. });

图片示例

swan.setBackgroundColor - 图8

swan.setBackgroundColor - 图9

swan.setBackgroundColor - 图10

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

在开发者工具中预览效果

  1. Page({
  2. setBackgroundColor() {
  3. swan.setBackgroundColor({
  4. backgroundColorBottom: '#7B68EE',
  5. success: function () {
  6. console.log('setBackgroundColor success');
  7. },
  8. fail: function (err) {
  9. console.log('setBackgroundColor fail', err);
  10. }
  11. });
  12. }
  13. });

错误码

Android

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

iOS

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