123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129 |
- """An input component."""
- from typing import Any, Dict
- from reflex.components.chakra import (
- ChakraComponent,
- LiteralButtonSize,
- LiteralInputVariant,
- )
- from reflex.components.component import Component
- from reflex.components.core.debounce import DebounceInput
- from reflex.components.literals import LiteralInputType
- from reflex.constants import EventTriggers, MemoizationMode
- from reflex.utils import imports
- from reflex.vars import Var
- class Input(ChakraComponent):
- """The Input component is a component that is used to get user input in a text field."""
- tag = "Input"
- # State var to bind the input.
- value: Var[str]
- # The default value of the input.
- default_value: Var[str]
- # The placeholder text.
- placeholder: Var[str]
- # The type of input.
- type_: Var[LiteralInputType]
- # The border color when the input is invalid.
- error_border_color: Var[str]
- # The border color when the input is focused.
- focus_border_color: Var[str]
- # If true, the form control will be disabled. This has 2 side effects - The FormLabel will have `data-disabled` attribute - The form element (e.g, Input) will be disabled
- is_disabled: Var[bool]
- # If true, the form control will be invalid. This has 2 side effects - The FormLabel and FormErrorIcon will have `data-invalid` set to true - The form element (e.g, Input) will have `aria-invalid` set to true
- is_invalid: Var[bool]
- # If true, the form control will be readonly.
- is_read_only: Var[bool]
- # If true, the form control will be required. This has 2 side effects - The FormLabel will show a required indicator - The form element (e.g, Input) will have `aria-required` set to true
- is_required: Var[bool]
- # "outline" | "filled" | "flushed" | "unstyled"
- variant: Var[LiteralInputVariant]
- # "lg" | "md" | "sm" | "xs"
- size: Var[LiteralButtonSize]
- # The name of the form field
- name: Var[str]
- def _get_imports(self) -> imports.ImportDict:
- return imports.merge_imports(
- super()._get_imports(),
- {"/utils/state": {imports.ImportVar(tag="set_val")}},
- )
- def get_event_triggers(self) -> Dict[str, 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.target.value],
- EventTriggers.ON_FOCUS: lambda e0: [e0.target.value],
- EventTriggers.ON_BLUR: lambda e0: [e0.target.value],
- EventTriggers.ON_KEY_DOWN: lambda e0: [e0.key],
- EventTriggers.ON_KEY_UP: lambda e0: [e0.key],
- }
- @classmethod
- def create(cls, *children, **props) -> Component:
- """Create an Input component.
- Args:
- *children: The children of the component.
- **props: The properties of the component.
- Returns:
- The component.
- """
- if props.get("value") is not None and props.get("on_change"):
- # create a debounced input if the user requests full control to avoid typing jank
- return DebounceInput.create(super().create(*children, **props))
- return super().create(*children, **props)
- class InputGroup(ChakraComponent):
- """The InputGroup component is a component that is used to group a set of inputs."""
- tag = "InputGroup"
- _memoization_mode = MemoizationMode(recursive=False)
- class InputLeftAddon(ChakraComponent):
- """The InputLeftAddon component is a component that is used to add an addon to the left of an input."""
- tag = "InputLeftAddon"
- class InputRightAddon(ChakraComponent):
- """The InputRightAddon component is a component that is used to add an addon to the right of an input."""
- tag = "InputRightAddon"
- class InputLeftElement(ChakraComponent):
- """The InputLeftElement component is a component that is used to add an element to the left of an input."""
- tag = "InputLeftElement"
- class InputRightElement(ChakraComponent):
- """The InputRightElement component is a component that is used to add an element to the right of an input."""
- tag = "InputRightElement"
|