Kivy中ModalView背景颜色设置报错，求正确实现方法

错误原因 #

ModalView类本身没有background_normal属性，这个属性属于Button、Label等自带背景的控件，直接将其作为初始化参数传入会触发TypeError。

解决方法 #

方法1：通过Canvas绘制白色背景

直接在ModalView的画布上绘制白色矩形作为背景，同时绑定尺寸和位置变化，确保背景始终匹配ModalView的大小：

from kivy.uix.modalview import ModalView
from kivy.uix.boxlayout import BoxLayout
from kivy.graphics import Color, Rectangle

class Content(BoxLayout):
    pass  # 自定义内容控件

# 创建ModalView实例
view = ModalView(size_hint=(.9, .9))

# 在ModalView的前置画布中添加白色背景
with view.canvas.before:
    Color(1, 1, 1, 1)  # RGBA值，对应纯白色
    view.bg_rect = Rectangle(size=view.size, pos=view.pos)

# 绑定尺寸和位置更新，确保背景跟随ModalView变化
def update_background(instance, _):
    instance.bg_rect.size = instance.size
    instance.bg_rect.pos = instance.pos

view.bind(size=update_background, pos=update_background)

# 添加内容并打开弹窗
view.add_widget(Content())
view.open()

方法2：设置与应用主题一致的背景

如果要匹配应用主主题的背景色，可以获取应用的默认背景色（比如窗口的清除色），用容器控件包裹内容并设置对应背景：

from kivy.uix.modalview import ModalView
from kivy.uix.boxlayout import BoxLayout
from kivy.core.window import Window
from kivy.graphics import Color, Rectangle

class Content(BoxLayout):
    pass  # 自定义内容控件

view = ModalView(size_hint=(.9, .9))

# 创建容器控件，用于承载内容和主题背景
container = BoxLayout(size_hint=(1, 1), padding=10)

# 设置容器的背景为应用主题色
with container.canvas.before:
    Color(*Window.clearcolor)  # 取应用窗口的背景色
    container.bg_rect = Rectangle(size=container.size, pos=container.pos)

# 绑定容器的尺寸和位置更新
container.bind(
    size=lambda _, __: setattr(container.bg_rect, 'size', container.size),
    pos=lambda _, __: setattr(container.bg_rect, 'pos', container.pos)
)

# 添加内容到容器，再将容器加入ModalView
container.add_widget(Content())
view.add_widget(container)
view.open()

补充说明 #

官方文档提到的background_normal属性是针对具备该属性的控件（如Button），ModalView的背景需要通过Canvas自定义绘制来实现纯色或主题匹配效果。

内容的提问来源于stack exchange，提问作者Семёнов Егор