reflex/pynecone/components/forms/input.py
2023-02-12 13:12:57 -08:00

84 lines
2.6 KiB
Python

"""An input component."""
from typing import Dict
from pynecone.components.component import EVENT_ARG
from pynecone.components.libs.chakra import ChakraComponent
from pynecone.var 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 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[str] = "text" # type: ignore
# 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[str]
# "lg" | "md" | "sm" | "xs"
size: Var[str]
@classmethod
def get_controlled_triggers(cls) -> Dict[str, Var]:
"""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 {
"on_change": EVENT_ARG.target.value,
"on_focus": EVENT_ARG.target.value,
"on_blur": EVENT_ARG.target.value,
"on_key_down": EVENT_ARG.key,
"on_key_press": EVENT_ARG.key,
"on_key_up": EVENT_ARG.key,
}
class InputGroup(ChakraComponent):
"""The InputGroup component is a component that is used to group a set of inputs."""
tag = "InputGroup"
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"