"""A pin input component.""" from typing import Dict from pynecone.components.component import Component from pynecone.components.libs.chakra import ChakraComponent from pynecone.event import EVENT_ARG from pynecone.vars import Var class PinInput(ChakraComponent): """The component that provides context to all the pin-input fields.""" tag = "PinInput" # State var to bind the the input. value: Var[str] # If true, the pin input receives focus on mount auto_focus: Var[bool] # The default value of the pin input default_value: Var[str] # 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] # The top-level id string that will be applied to the input fields. The index of the input will be appended to this top-level id. id_: Var[str] # The length of the number input. length: Var[int] # If true, the pin input component is put in the disabled state is_disabled: Var[bool] # If true, the pin input component is put in the invalid state is_invalid: Var[bool] # If true, focus will move automatically to the next input once filled manage_focus: Var[bool] # If true, the input's value will be masked just like `type=password` mask: Var[bool] # The placeholder for the pin input placeholder: Var[str] # The type of values the pin-input should allow ("number" | "alphanumeric"). type_: Var[str] # "outline" | "flushed" | "filled" | "unstyled" variant: Var[str] def get_controlled_triggers(self) -> 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, "on_complete": EVENT_ARG, } @classmethod def create(cls, *children, **props) -> Component: """Create a pin input component. If no children are passed in, the component will create a default pin input based on the length prop. Args: *children: The children of the component. **props: The props of the component. Returns: The pin input component. """ if not children and "length" in props: children = [PinInputField()] * props["length"] return super().create(*children, **props) class PinInputField(ChakraComponent): """The text field that user types in - must be a direct child of PinInput.""" tag = "PinInputField"