Inline validation
The field asks the server whether its value is acceptable as soon as the visitor leaves it. The message appears under the field, in place, without touching the rest of the form.
Try it
Live demo
Real requests to this site. What you change is kept in a cookie of your own for an hour and is invisible to every other visitor.
Type [email protected] and leave the field: that address is taken, so the server answers 422 with a message. Fix it
and leave again to see the confirmation. The form is checked again when you press Create account.
The page
<form id="signup" ypy-post="/signup" ypy-target="this" ypy-swap="outerHTML" novalidate>
<label for="signup-email">Email</label>
<input id="signup-email" type="email" name="email" aria-describedby="email-msg"
ypy-post="/signup/email" ypy-trigger="change"
ypy-target="#email-msg" ypy-swap="outerHTML"
ypy-error-target="#email-msg" ypy-error-swap="outerHTML">
<p id="email-msg">Try [email protected], which is taken.</p>
<button>Create account</button>
</form>What the server answers
POST /signup/email receives the whole form, so the field's value arrives as email=…, and answers with the message
element only:
| Case | Status | Body |
|---|---|---|
| Free and well formed | 200 |
<p id="email-msg">[email protected] is available.</p> |
| Empty | 422 |
<p id="email-msg">Enter your email address.</p> |
| Malformed | 422 |
<p id="email-msg">Use an address like [email protected].</p> |
| Taken | 422 |
<p id="email-msg">This address already has an account.</p> |
POST /signup runs the same checks. It answers 200 with the form and a confirmation, or 422 with the form, the
value kept, and the message in the same place. Both are fragments with Vary: YPY-Request.
How it works
ypy-trigger="change"on the field starts the request when the visitor leaves it with a new value.-
A
422normally goes into the form of the source element. The field is in a form, soypy-error-targetandypy-error-swapsend the error to the message element instead. - The same rule answers the field and the form, so what the field accepted is what the form accepts.
-
aria-describedbypoints the field at the message, andaria-invalid="true"on the redrawn field marks the failure for screen readers. -
novalidateturns the browser's own check off so the server's message is the one the visitor reads. Leave it out to let the browser check first.
Variations
-
The
ypy-validateextension does this from one attribute:ypy-validate="/signup/email"on the field. - Check while typing with
ypy-trigger="input changed delay:400ms".