kvex.widgets.button

 1"""Home of `XButton` and `XToggleButton`."""
 2
 3from .. import kivy as kv
 4from .. import assets
 5from ..behaviors import XThemed
 6from .widget import XWidget
 7
 8
 9BG_NORMAL = str(assets.get_image("button"))
10BG_DOWN = str(assets.get_image("button_down"))
11
12
13class XButton(XThemed, XWidget, kv.Button):
14    """Button."""
15
16    def __init__(self, **kwargs):
17        """Initialize the class."""
18        kwargs = dict(
19            markup=True,
20            halign="center",
21            valign="center",
22            background_normal=BG_NORMAL,
23            background_down=BG_DOWN,
24            border=(2, 1, 2, 1),
25        ) | kwargs
26        super().__init__(**kwargs)
27
28    def on_touch_down(self, m):
29        """Overrides base class method to only react to left clicks."""
30        if m.button != "left":
31            return False
32        return super().on_touch_down(m)
33
34    def on_subtheme(self, subtheme):
35        """Apply colors."""
36        self.background_color = subtheme.bg.rgba
37        self.color = subtheme.fg.rgba
38
39
40class XToggleButton(kv.ToggleButtonBehavior, XButton):
41    """ToggleButton."""
42
43    active = kv.BooleanProperty(False)
44    """Behaves like an alias for the `state` property being "down"."""
45
46    def __init__(self, **kwargs):
47        """Same arguments as kivy Button."""
48        super().__init__(**kwargs)
49        self.bind(state=self._set_active)
50        self.bind(active=self._set_state)
51
52    def toggle(self, *args):
53        """Toggles the active state of the button."""
54        self.active = not self.active
55
56    def _set_state(self, *args):
57        self.state = "down" if self.active else "normal"
58
59    def _set_active(self, *args):
60        self.active = self.state == "down"
61
62
63__all__ = (
64    "XButton",
65    "XToggleButton",
66)