kvex.widgets.label

 1"""Home of `XLabel` and `XLabelClick`."""
 2
 3from .. import kivy as kv
 4from ..behaviors import XThemed
 5from .widget import XWidget
 6
 7
 8class XLabel(XThemed, XWidget, kv.Label):
 9    """Label."""
10
11    def __init__(self, fixed_width: bool = False, fixed_height: bool = False, **kwargs):
12        """Initialize the class.
13
14        Args:
15            fixed_width: Adjust the height of the label while maintaining width.
16            fixed_height: Adjust the width of the label while maintaining height.
17        """
18        kwargs = {
19            "markup": True,
20            "halign": "center",
21            "valign": "center",
22        } | kwargs
23        if fixed_width and fixed_height:
24            raise RuntimeError("Must set either fixed_width or fixed_height.")
25        super().__init__(**kwargs)
26        self._trigger_fix_height = kv.Clock.create_trigger(self._fix_height)
27        self._trigger_fix_width = kv.Clock.create_trigger(self._fix_width)
28        if fixed_width:
29            self.bind(
30                size=self._trigger_fix_height,
31                text=self._trigger_fix_height,
32            )
33        elif fixed_height:
34            self.bind(
35                size=self._trigger_fix_width,
36                text=self._trigger_fix_width,
37            )
38        else:
39            self.bind(size=self._on_size)
40
41    def _fix_height(self, *a):
42        x = self.size[0]
43        hx = self.size_hint[0]
44        self.text_size = x, None
45        self.texture_update()
46        if hx is None:
47            self.set_size(x=x, y=self.texture_size[1])
48        else:
49            self.set_size(hx=hx, y=self.texture_size[1])
50
51    def _fix_width(self, *a):
52        y = self.size[1]
53        hy = self.size_hint[1]
54        self.text_size = None, y
55        self.texture_update()
56        if hy is None:
57            self.set_size(x=self.texture_size[0], y=y)
58        else:
59            self.set_size(x=self.texture_size[0], hy=hy)
60
61    def _on_size(self, *a):
62        self.text_size = self.size
63
64    def on_subtheme(self, subtheme):
65        """Apply colors."""
66        self.color = subtheme.fg.rgba
67
68
69class XLabelClick(kv.ButtonBehavior, XLabel):
70    """Label with ButtonBehavior."""
71
72    pass
73
74
75__all__ = (
76    "XLabel",
77    "XLabelClick",
78)