kvex.widgets.slider

 1"""Home of `XSlider` and `XSliderText`."""
 2
 3from typing import Optional, Any
 4from .. import kivy as kv
 5from .widget import XWidget
 6from .label import XLabel
 7from .layouts import XBox
 8
 9
10class XSlider(XWidget, kv.Slider):
11    """Slider."""
12
13    pass
14
15
16class XSliderText(XBox):
17    """Slider with Label."""
18
19    def __init__(
20        self,
21        prefix: str = "",
22        rounding: int = 3,
23        box_kwargs: Optional[dict[str, Any]] = None,
24        label_kwargs: Optional[dict[str, Any]] = None,
25        **kwargs,
26    ):
27        """Initialize the class.
28
29        Args:
30            prefix: Text to prefix the value presented in the label.
31            rounding: How many decimal places to show.
32            box_kwargs: Keyword arguments for XBox.
33            label_kwargs: Keyword arguments for XLabel.
34            kwargs: Keyword arguments for XSlider.
35        """
36        box_kwargs = {} if box_kwargs is None else box_kwargs
37        label_kwargs = {} if label_kwargs is None else label_kwargs
38        label_kwargs = {"halign": "left"} | label_kwargs
39        slider_kwargs = {"cursor_size": (25, 25)} | kwargs
40        super().__init__(**box_kwargs)
41        self.rounding = rounding
42        self.prefix = prefix
43        self.label = XLabel(**label_kwargs)
44        self.label.set_size(hx=0.2)
45        self.slider = XSlider(**slider_kwargs)
46        self.add_widgets(self.label, self.slider)
47        self.slider.bind(value=self._set_text)
48        self._set_text(self, self.slider.value)
49
50    def _set_text(self, w, value):
51        if isinstance(value, float):
52            value = round(value, self.rounding)
53        if value == round(value):
54            value = int(value)
55        self.label.text = str(f"{self.prefix}{value}")
56
57
58__all__ = (
59    "XSlider",
60    "XSliderText",
61)