CircularSlider API#

def __init__(
    self,
    start: float = 0.0,
    stop: float = 100.0,
    step: float = 1.0,
    value: Optional[float] = None,
    size: int = 220,
    thickness: int = 18,
    show_value: bool = True,
    color: str = "",
    label: str = "",
    **kwargs: Any,
) -> None:
    """Create a CircularSlider.

    Args:
        start: Lower bound of the mapped value range.
        stop: Upper bound of the mapped value range.
        step: Snap increment in value units (must be > 0).
        value: Initial value; defaults to ``start``. Clamped to ``[start, stop]``.
        size: Diameter in pixels.
        thickness: Ring track thickness in pixels.
        show_value: Render the current value as text below the dial.
        color: Optional CSS color (e.g. ``"#ef4444"``, ``"tomato"``) for the
            filled arc and handle border. Empty string uses the theme default.
        label: Optional text label shown above the dial. Empty string hides it.
        **kwargs: Forwarded to ``anywidget.AnyWidget``.
    """
    if start >= stop:
        raise ValueError("start must be less than stop.")
    if step <= 0:
        raise ValueError("step must be positive.")
    _validate_size(size, thickness)
    if value is None:
        value = start
    value = _clamp(float(value), start, stop)
    super().__init__(
        _mode="single",
        start=float(start),
        stop=float(stop),
        step=float(step),
        value=value,
        size=size,
        thickness=thickness,
        show_value=show_value,
        color=color,
        label=label,
        **kwargs,
    )

def __init__(
    self,
    start: float = 0.0,
    stop: float = 100.0,
    step: float = 1.0,
    value: Optional[Tuple[float, float]] = None,
    size: int = 220,
    thickness: int = 18,
    show_value: bool = True,
    color: str = "",
    label: str = "",
    **kwargs: Any,
) -> None:
    """Create a CircularRangeSlider.

    Args:
        start: Lower bound of the mapped value range.
        stop: Upper bound of the mapped value range.
        step: Snap increment in value units (must be > 0).
        value: Initial ``(low, high)`` tuple; defaults to ``(start, stop)``.
            Each end is clamped to ``[start, stop]``; if the pair is passed
            in the wrong order it is sorted. Note: at runtime, dragging the
            filled arc past the 12 o'clock seam can produce a wrap-around
            value where ``low > high`` — that's intentional and means the
            range crosses the seam (going clockwise from ``low`` through
            the ``stop``/``start`` boundary to ``high``).
        size: Diameter in pixels.
        thickness: Ring track thickness in pixels.
        show_value: Render the current ``low – high`` range as text below the dial.
        color: Optional CSS color (e.g. ``"#ef4444"``, ``"tomato"``) for the
            filled arc and handle border. Empty string uses the theme default.
        label: Optional text label shown above the dial. Empty string hides it.
        **kwargs: Forwarded to ``anywidget.AnyWidget``.
    """
    if start >= stop:
        raise ValueError("start must be less than stop.")
    if step <= 0:
        raise ValueError("step must be positive.")
    _validate_size(size, thickness)
    if value is None:
        value = (start, stop)
    if len(value) != 2:
        raise ValueError("value must be a (low, high) tuple of length 2.")
    low = _clamp(float(value[0]), start, stop)
    high = _clamp(float(value[1]), start, stop)
    if low > high:
        low, high = high, low
    super().__init__(
        _mode="range",
        start=float(start),
        stop=float(stop),
        step=float(step),
        value=(low, high),
        size=size,
        thickness=thickness,
        show_value=show_value,
        color=color,
        label=label,
        **kwargs,
    )