reflex_copy/reflex/components/chakra/forms/slider.py

"""A slider component."""
from __future__ import annotations

from typing import Any, Literal, Optional, Union

from reflex.components.chakra import ChakraComponent, LiteralChakraDirection
from reflex.components.component import Component
from reflex.constants import EventTriggers
from reflex.vars import Var

LiteralLayout = Literal["horizontal", "vertical"]


class Slider(ChakraComponent):
    """The wrapper that provides context and functionality for all children."""

    tag = "Slider"

    # State var to bind the input.
    value: Optional[Var[int]] = None

    # The color scheme.
    color_scheme: Optional[Var[str]] = None

    # The placeholder text.
    default_value: Optional[Var[int]] = None

    # The writing mode ("ltr" | "rtl")
    direction: Optional[Var[LiteralChakraDirection]] = None

    # If false, the slider handle will not capture focus when value changes.
    focus_thumb_on_change: Optional[Var[bool]] = None

    # If true, the slider will be disabled
    is_disabled: Optional[Var[bool]] = None

    # If true, the slider will be in `read-only` state.
    is_read_only: Optional[Var[bool]] = None

    # If true, the value will be incremented or decremented in reverse.
    is_reversed: Optional[Var[bool]] = None

    # The minimum value of the slider.
    min_: Optional[Var[int]] = None

    # The maximum value of the slider.
    max_: Optional[Var[int]] = None

    # The step in which increments/decrements have to be made
    step: Optional[Var[int]] = None

    # The minimum distance between slider thumbs. Useful for preventing the thumbs from being too close together.
    min_steps_between_thumbs: Optional[Var[int]] = None

    # Oreintation of the slider vertical | horizontal.
    orientation: Optional[Var[LiteralLayout]] = None

    # Minimum height of the slider.
    min_h: Optional[Var[str]] = None

    # Minimum width of the slider.
    min_w: Optional[Var[str]] = None

    # Maximum height of the slider.
    max_h: Optional[Var[str]] = None

    # Maximum width of the slider.
    max_w: Optional[Var[str]] = None

    # The name of the form field
    name: Optional[Var[str]] = None

    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
        """Get the event triggers that pass the component's value to the handler.

        Returns:
            A dict mapping the event trigger to the var that is passed to the handler.
        """
        return {
            **super().get_event_triggers(),
            EventTriggers.ON_CHANGE: lambda e0: [e0],
            EventTriggers.ON_CHANGE_END: lambda e0: [e0],
            EventTriggers.ON_CHANGE_START: lambda e0: [e0],
        }  # type: ignore

    @classmethod
    def create(cls, *children, **props) -> Component:
        """Create a slider component.

        If no children are provided, a default slider will be created.

        Args:
            *children: The children of the component.
            **props: The properties of the component.

        Returns:
            The slider component.
        """
        if len(children) == 0:
            children = [
                SliderTrack.create(
                    SliderFilledTrack.create(),
                ),
                SliderThumb.create(),
            ]
        return super().create(*children, **props)


class SliderTrack(ChakraComponent):
    """The empty part of the slider that shows the track."""

    tag = "SliderTrack"


class SliderFilledTrack(ChakraComponent):
    """The filled part of the slider."""

    tag = "SliderFilledTrack"


class SliderThumb(ChakraComponent):
    """The handle that's used to change the slider value."""

    tag = "SliderThumb"

    # The size of the thumb.
    box_size: Optional[Var[str]] = None


class SliderMark(ChakraComponent):
    """The label or mark that shows names for specific slider values."""

    tag = "SliderMark"