Forms

Forms, or AirForms in Air parlance, are powered by pydantic. That includes both their display and validation of data. If you have any experience with pydantic, that will go a long way towards helping your understanding of Air Forms.

A Sample Contact Form

from pydantic import BaseModel, Field
from air import AirForm

class ContactModel(BaseModel):
    name: str
    email: str = Field(json_schema_extra={'email': True
    })

class ContactForm(AirForm):
    model = ContactModel


contact_form = ContactForm()

Displaying a form

contact_form.render()

<fieldset>
    <label>name
        <input name="name" type="text" id="name"></input>
    </label>
    <label>email
        <input name="email" type="email" id="email"></input>
    </label>
</fieldset>

Validation using forms

# This empty dict represents a user who submitted without adding data
empty_form = {}
contact_form.validate(empty_form)

Displaying a failed form

contact_form.render()

<fieldset>
    <label>
        name
        <input name="name" type="text" id="name" aria-invalid="true"></input>
        <small id="name-error">Please correct this error.</small>
    </label>
    <label>
        email
        <input name="email" type="email" id="email" aria-invalid="true"></input>
        <small id="email-error">Please correct this error.</small>
    </label>
</fieldset>