kvex.widgets.container

 1"""Home of `XContainer` and `XPlaceholder`."""
 2
 3from typing import Callable, Optional
 4from .. import kivy as kv
 5from .layouts import XAnchor, XBox
 6from .label import XLabel
 7from .button import XButton
 8
 9
10class XPlaceholder(XBox):
11    """A simple label and button widget for `XContainer`."""
12
13    def __init__(
14        self,
15        label_text: str = "",
16        button_text: str = "Return",
17        callback: Optional[Callable] = None,
18    ):
19        """Initialize the class.
20
21        Args:
22            label_text: Label text.
23            button_text: Button text.
24            callback: Function to call when button is pressed. Required to show button.
25        """
26        super().__init__(orientation="vertical")
27        if label_text:
28            label = XLabel(text=label_text)
29            label.set_size(hy=4)
30            self.add_widget(label)
31        if callback:
32            button = XButton(text=button_text, on_release=lambda *a: callback())
33            button.set_size(x="300dp", y="70dp")
34            self.add_widget(XAnchor.wrap(button))
35
36
37class XContainer(XAnchor):
38    """A frame with an optional `content` widget and an XPlaceholder fallback."""
39
40    content = kv.ObjectProperty(None, allownone=True)
41    """Content widget. Setting None will show the placeholder fallback."""
42
43    def __init__(self, placeholder: Optional[XPlaceholder] = None):
44        """Initialize the class with an `XPlaceholder`."""
45        super().__init__()
46        self._placeholder = placeholder or XPlaceholder()
47        self.bind(content=self._on_content)
48        self._on_content(self, self.content)
49
50    def _on_content(self, w, content):
51        self.clear_widgets()
52        if content:
53            self.add_widget(content)
54        else:
55            self.add_widget(self._placeholder)
56
57
58__all__ = (
59    "XContainer",
60    "XPlaceholder",
61)