7ec4b3f8fe
* Update component docstrings * Remove transitions libs * Add span component * Add lock files
101 lines
2.7 KiB
Python
101 lines
2.7 KiB
Python
"""A range slider component."""
|
|
|
|
from typing import List, Set
|
|
|
|
from pynecone.components.component import Component
|
|
from pynecone.components.libs.chakra import ChakraComponent
|
|
from pynecone.var import Var
|
|
|
|
|
|
class RangeSlider(ChakraComponent):
|
|
"""The RangeSlider is a multi thumb slider used to select a range of related values. A common use-case of this component is a price range picker that allows a user to set the minimum and maximum price."""
|
|
|
|
tag = "RangeSlider"
|
|
|
|
# State var to bind the the input.
|
|
value: Var[List[int]]
|
|
|
|
# The default values.
|
|
default_value: Var[List[int]]
|
|
|
|
# The writing mode ("ltr" | "rtl")
|
|
direction: Var[str]
|
|
|
|
# If false, the slider handle will not capture focus when value changes.
|
|
focus_thumb_on_change: Var[bool]
|
|
|
|
# If true, the slider will be disabled
|
|
is_disabled: Var[bool]
|
|
|
|
# If true, the slider will be in `read-only` state.
|
|
is_read_only: Var[bool]
|
|
|
|
# If true, the value will be incremented or decremented in reverse.
|
|
is_reversed: Var[bool]
|
|
|
|
# The minimum value of the slider.
|
|
min_: Var[int]
|
|
|
|
# The maximum value of the slider.
|
|
max_: Var[int]
|
|
|
|
# The minimum distance between slider thumbs. Useful for preventing the thumbs from being too close together.
|
|
min_steps_between_thumbs: Var[int]
|
|
|
|
@classmethod
|
|
def get_controlled_triggers(cls) -> Set[str]:
|
|
"""Get the event triggers that pass the component's value to the handler.
|
|
|
|
Returns:
|
|
The controlled event triggers.
|
|
"""
|
|
return {
|
|
"on_change",
|
|
"on_change_end",
|
|
"on_change_start",
|
|
}
|
|
|
|
@classmethod
|
|
def create(cls, *children, **props) -> Component:
|
|
"""Create a RangeSlider component.
|
|
|
|
If no children are provided, a default RangeSlider will be created.
|
|
|
|
Args:
|
|
children: The children of the component.
|
|
props: The properties of the component.
|
|
|
|
Returns:
|
|
The RangeSlider component.
|
|
"""
|
|
if len(children) == 0:
|
|
children = [
|
|
RangeSliderTrack.create(
|
|
RangeSliderFilledTrack.create(),
|
|
),
|
|
RangeSliderThumb.create(index=0),
|
|
RangeSliderThumb.create(index=1),
|
|
]
|
|
return super().create(*children, **props)
|
|
|
|
|
|
class RangeSliderTrack(ChakraComponent):
|
|
"""A range slider track."""
|
|
|
|
tag = "RangeSliderTrack"
|
|
|
|
|
|
class RangeSliderFilledTrack(ChakraComponent):
|
|
"""A filled range slider track."""
|
|
|
|
tag = "RangeSliderFilledTrack"
|
|
|
|
|
|
class RangeSliderThumb(ChakraComponent):
|
|
"""A range slider thumb."""
|
|
|
|
tag = "RangeSliderThumb"
|
|
|
|
# The position of the thumb.
|
|
index: Var[int]
|