Background Color#

Note

The following classes are intended for in-house use of the library.

API - `kivymd.uix.behaviors.backgroundcolor_behavior`#

class kivymd.uix.behaviors.backgroundcolor_behavior.BackgroundColorBehavior(**kwarg)#

background#

Background image path.

radius#

Canvas radius.

# Top left corner slice.
MDBoxLayout:
    md_bg_color: app.theme_cls.primary_color
    radius: [25, 0, 0, 0]

radius is an VariableListProperty and defaults to [0, 0, 0, 0].

md_bg_color#

The background color of the widget (Widget) that will be inherited from the BackgroundColorBehavior class.

For example:

Widget:
    canvas:
        Color:
            rgba: 0, 1, 1, 1
        Rectangle:
            size: self.size
            pos: self.pos

similar to code:

<MyWidget@BackgroundColorBehavior>
    md_bg_color: 0, 1, 1, 1

md_bg_color is an ColorProperty and defaults to [1, 1, 1, 0].

line_color#

If a custom value is specified for the line_color parameter, the border of the specified color will be used to border the widget:

MDBoxLayout:
    size_hint: .5, .2
    md_bg_color: 0, 1, 1, .5
    line_color: 0, 0, 1, 1
    radius: [24, ]

New in version 0.104.2.

line_color is an ColorProperty and defaults to [0, 0, 0, 0].

line_width#

Border of the specified width will be used to border the widget.

New in version 1.0.0.

restore_color_origin(self, instance_md_widget, value: bool)#: Called when the values of disabled change.

on_line_color(self, instance_md_widget, value: list | str)#: Called when the values of line_color change.

on_md_bg_color(self, instance_md_widget, color: list | str)#: Called when the values of md_bg_color change.

update_background_origin(self, instance_md_widget, pos: list)#: Called when the values of pos change.

class kivymd.uix.behaviors.backgroundcolor_behavior.SpecificBackgroundColorBehavior(**kwargs)#

background_palette#

See kivymd.color_definitions.palette.

background_palette is an OptionProperty and defaults to ‘Primary’.

background_hue#

See kivymd.color_definitions.hue.

background_hue is an OptionProperty and defaults to ‘500’.

specific_text_color#: specific_text_color is an ColorProperty and defaults to [0, 0, 0, 0.87].

specific_secondary_text_color#: specific_secondary_text_color`is an :class:`~kivy.properties.ColorProperty and defaults to [0, 0, 0, 0.87].