reflex_copy/docs/library/chakra/forms/formcontrol.md

---

components:

- rx.chakra.FormControl
- rx.chakra.FormLabel
- rx.chakra.FormErrorMessage
- rx.chakra.FormHelperText

---

Form Control

Form control provides context such as filled/focused/error/required for form inputs.

import reflex as rx

rx.chakra.form_control(
    rx.chakra.form_label("First Name", html_for="email"),
    rx.chakra.checkbox("Example"),
    rx.chakra.form_helper_text("This is a help text"),
    is_required=True,
)

The example below shows a form error when then name length is 3 or less.

import reflex as rx

class FormErrorState(rx.State):
    name: str

    @rx.var
    def is_error(self) -> bool:
         return len(self.name) <= 3

def form_state_example():
    return rx.chakra.vstack(
        rx.chakra.form_control(
            rx.chakra.input(placeholder="name", on_blur=FormErrorState.set_name),
            rx.cond(
                FormErrorState.is_error,
                rx.chakra.form_error_message("Name should be more than four characters"),
                rx.chakra.form_helper_text("Enter name"),
            ),
            is_invalid=FormErrorState.is_error,
            is_required=True,
        )
    )