"""Form components.""" from __future__ import annotations from typing import Any, Callable, Dict, List from reflex.components.component import Component from reflex.components.libs.chakra import ChakraComponent from reflex.constants import EventTriggers from reflex.event import EventChain, EventHandler, EventSpec from reflex.vars import Var class Form(ChakraComponent): """A form component.""" tag = "Box" # What the form renders to. as_: Var[str] = "form" # type: ignore def _create_event_chain( self, event_trigger: str, value: Var | EventHandler | EventSpec | List[EventHandler | EventSpec] | Callable[..., Any], ) -> EventChain | Var: """Override the event chain creation to preventDefault for on_submit. Args: event_trigger: The event trigger. value: The value of the event trigger. Returns: The event chain. """ chain = super()._create_event_chain(event_trigger, value) if event_trigger == EventTriggers.ON_SUBMIT and isinstance(chain, EventChain): return chain.prevent_default return chain 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. """ # Send all the input refs to the handler. form_refs = {} for ref in self.get_refs(): # when ref start with refs_ it's an array of refs, so we need different method # to collect data if ref.startswith("refs_"): form_refs[ref[5:-3]] = Var.create( f"getRefValues({ref[:-3]})", _var_is_local=False ) else: form_refs[ref[4:]] = Var.create( f"getRefValue({ref})", _var_is_local=False ) return { **super().get_event_triggers(), EventTriggers.ON_SUBMIT: lambda e0: [form_refs], } class FormControl(ChakraComponent): """Provide context to form components.""" tag = "FormControl" # If true, the form control will be disabled. is_disabled: Var[bool] # If true, the form control will be invalid. 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. is_required: Var[bool] # The label text used to inform users as to what information is requested for a text field. label: Var[str] @classmethod def create( cls, *children, label=None, input=None, help_text=None, error_message=None, **props, ) -> Component: """Create a form control component. Args: *children: The children of the form control. label: The label of the form control. input: The input of the form control. help_text: The help text of the form control. error_message: The error message of the form control. **props: The properties of the form control. Raises: AttributeError: raise an error if missing required kwargs. Returns: The form control component. """ if len(children) == 0: children = [] if label: children.append(FormLabel.create(*label)) if not input: raise AttributeError("input keyword argument is required") children.append(input) if help_text: children.append(FormHelperText.create(*help_text)) if error_message: children.append(FormErrorMessage.create(*error_message)) return super().create(*children, **props) class FormHelperText(ChakraComponent): """A form helper text component.""" tag = "FormHelperText" class FormLabel(ChakraComponent): """A form label component.""" tag = "FormLabel" # Link html_for: Var[str] class FormErrorMessage(ChakraComponent): """A form error message component.""" tag = "FormErrorMessage"