my.setbackgroundcolor(object object)
支小宝客户端 支持
安诊儿客户端 支持
主体： 企业支付宝小程序 、 个人支付宝小程序
设置窗口的背景色。
效果示例
下拉或上滑操作时出现的区域呈现的窗口背景色。
下拉出现顶部窗口背景色
上划出现底部窗口背景色（仅 ios）
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| backgroundcolor | string | - | 否 | 窗口的背景色，值为 6 位十六进制颜色码；ios端未设置时，默认值：#f7f7f7 。 |
| backgroundcolortop | string | - | 否 | 顶部窗口的背景色，仅 ios 支持。值为 6 位十六进制颜色码，会覆盖 backgroundcolor |
| backgroundcolorbottom | string | - | 否 | 底部窗口的背景色，仅 ios 支持。值为 6 位十六进制颜色码 |
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 2 | 接口参数无效 |
请检查入参，参考类型、描述。 |
my.setbackgroundcolor(object object)
my.setbackgroundcolor({
backgroundcolor: '#ffffff',
backgroundcolortop: '#00ff00', // 仅对在 ios 生效。
backgroundcolorbottom: '#ff00ff', // 仅对在 ios 生效。
success: function (res) {
console.log(res);
},
fail: function (err) {
console.log(err);
}
});
-
tip调用 my.setsetbackgroundcolor ，ios 只对下拉区域生效，安卓对下拉区域和页面后窗口背景色都生效。 1. 下拉区域需要 app.json 中
allowsbouncevertical的值为yes时，下滑屏幕出现；也可以调用 my.startpulldownrefresh 下拉刷新时出现。 2. 页面后窗口背景色在 app.acss 未设置 page 的背景色或页面没有背景色时可以看到。 -
tipmy.setsetbackgroundcolor 会覆盖 app.json 的 window 中的 backgroundcolor，以及页面的 .json 文件中配置的 backgroundcolor。