Validation·续
<div class="form-group"> <label class="form-label">Shipping method</label> <div class="form-field mb-1"> <input type="radio" id="validationServerRadio1" class="radio is-invalid" name="shippingServer"><!-- [!code highlight] --> <div class="form-field-content"> <label for="validationServerRadio1">Standard</label> <small class="form-text">Arrives in 5-7 business days.</small> </div> </div> <div class="form-field"> <input type="radio" id="validationServerRadio2" class="radio is-invalid" name="shippingServer"><!-- [!code highlight] --> <div class="form-field-content"> <label for="validationServerRadio2">Express</label> <small class="form-text">Arrives in 2-3 business days.</small> </div> </div> </div>
<div class="form-field"> <div class="switch"> <input type="checkbox" id="validationServerSwitch" role="switch" switch> </div> <label for="validationServerSwitch">Subscribe to newsletter</label> </div>
<button class="btn-solid theme-primary justify-self-start" type="submit">Submit form</button> </form>`} />
Supported elements
Validation styles are available for the following form controls and components:
<input>s and<textarea>s with.form-control<select>s with.form-control.checkcheckboxes.radioradios.switchswitches.form-range-inputrange inputs.form-floatingfloating labels.form-adornadorned inputs.chip-inputchip inputs.combobox-togglecomboboxes (class-based only)- Input groups (with feedback in a parent
.form-field)
<div class="form-field"> <label for="validationTextarea" class="form-label">Textarea</label> <textarea class="form-control is-invalid" id="validationTextarea" placeholder="Required example textarea" required aria-describedby="validationTextareaFeedback"></textarea> <div id="validationTextareaFeedback" class="invalid-feedback"> Please enter a message in the textarea. </div> </div>
<div class="form-group"> <label class="form-label">Checkbox</label> <div class="form-field"> <input type="checkbox" class="check is-invalid" id="validationFormCheck1" required aria-describedby="validationFormCheck1Feedback"> <div class="form-field-content"> <label for="validationFormCheck1">Check this checkbox</label> <div id="validationFormCheck1Feedback" class="invalid-feedback">Example invalid feedback text</div> </div> </div> </div>
<div class="form-group"> <label class="form-label">Radio</label> <div class="form-field"> <input type="radio" class="radio is-invalid" id="validationFormCheck2" name="radio-stacked" required aria-describedby="validationFormRadioFeedback"> <label for="validationFormCheck2">Toggle this radio</label> </div> <div class="form-field"> <input type="radio" class="radio is-invalid" id="validationFormCheck3" name="radio-stacked" required aria-describedby="validationFormRadioFeedback"> <div class="form-field-content"> <label for="validationFormCheck3">Or toggle this other radio</label> <div id="validationFormRadioFeedback" class="invalid-feedback">More example invalid feedback text</div> </div> </div> </div>
<div class="form-group"> <label class="form-label">Switch</label> <div class="form-field"> <div class="switch"> <input type="checkbox" id="validationFormSwitch" role="switch" switch class="is-invalid" aria-describedby="validationFormSwitchFeedback"> </div> <div class="form-field-content"> <label for="validationFormSwitch">Toggle this switch</label> <div id="validationFormSwitchFeedback" class="invalid-feedback">Example invalid switch feedback</div> </div> </div> </div>
<div class="form-field"> <label for="validationSelect" class="form-label">Select</label> <select class="form-control is-invalid" id="validationSelect" required aria-describedby="validationSelectFeedback"> <option value="">Open this select menu</option> <option value="1">One</option> <option value="2">Two</option> <option value="3">Three</option> </select> <div id="validationSelectFeedback" class="invalid-feedback">Example invalid select feedback</div> </div>
<div class="form-field"> <label for="validationFile" class="form-label">File input</label> <input type="file" class="form-control is-invalid" id="validationFile" required aria-describedby="validationFileFeedback"> <div id="validationFileFeedback" class="invalid-feedback">Example invalid form file feedback</div> </div>
<div class="form-field"> <label for="validationRange" class="form-label">Range</label> <div class="form-range"> <input type="range" class="form-range-input is-invalid" id="validationRange" min="0" max="5" required aria-describedby="validationRangeFeedback"> </div> <div id="validationRangeFeedback" class="invalid-feedback">Example invalid range feedback</div> </div>
<div class="form-field"> <div class="form-floating"> <label for="validationFloating">Email address</label> <input type="email" class="form-control is-invalid" id="validationFloating" placeholder="name@example.com" value="test@example.com" aria-describedby="validationFloatingFeedback"> </div> <div id="validationFloatingFeedback" class="invalid-feedback d-block">Example invalid floating label feedback</div> </div>
<div class="form-field"> <label for="validationAdorn" class="form-label">Adorned input</label> <label class="form-control form-adorn is-invalid"> <div class="form-adorn-icon" aria-hidden="true"> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16"><path d="M11.742 10.344a6.5 6.5 0 1 0-1.397 1.398h-.001q.044.06.098.115l3.85 3.85a1 1 0 0 0 1.415-1.414l-3.85-3.85a1 1 0 0 0-.115-.1zM12 6.5a5.5 5.5 0 1 1-11 0 5.5 5.5 0 0 1 11 0"/></svg> </div> <input type="text" class="form-ghost" id="validationAdorn" placeholder="Search..." aria-describedby="validationAdornFeedback"> </label> <div id="validationAdornFeedback" class="invalid-feedback">Example invalid adorned input feedback</div> </div>
<div class="form-field"> <label for="validationInputGroup" class="form-label">Input group</label> <div class="input-group"> <span class="input-group-text">@</span> <input type="text" class="form-control is-invalid" id="validationInputGroup" placeholder="Username" aria-describedby="validationInputGroupFeedback"> </div> <div id="validationInputGroupFeedback" class="invalid-feedback">Please choose a username</div> </div>
<div class="form-field"> <label class="form-label" for="validationChipInput">Tags</label> <div class="chip-input"> <span class="chip">Example</span> <input type="text" class="form-ghost is-invalid" id="validationChipInput" placeholder="Add tag..." aria-describedby="validationChipInputFeedback"> </div> <div id="validationChipInputFeedback" class="invalid-feedback">Please add at least one tag</div> </div> </form>`} />
Tooltips
If your form layout allows it, you can swap the .{valid|invalid}-feedback classes for .{valid|invalid}-tooltip classes to display validation feedback in a styled tooltip. These tooltips build on the base .tooltip styles, so you’ll need to have those included in your compiled CSS as well.
We don’t recommend using tooltips for checkboxes, radios, and switches because their placement is not reliable or consistent in most cases. You can also use a combination of feedback text and tooltips in your forms.
This example functions the same as the custom styles example. Click the submit button to see the validation tooltips.
<Example code={`<form class="grid grid-cols-1 gap-5" data-bs-validate novalidate><!-- [!code highlight] --> <div class="grid gap-5"> <div class="form-field md:g-col-6"> <label for="validationTooltip01" class="form-label">Name</label> <input type="text" class="form-control" id="validationTooltip01" value="Mark Otto" required aria-describedby="validationTooltip01Feedback"> <div id="validationTooltip01Feedback" class="tooltip invalid-tooltip">Full name is required</div><!-- [!code highlight] --> </div> <div class="form-field md:g-col-6"> <label for="validationTooltipDonation" class="form-label">Donation amount</label> <div class="input-group"> <span class="input-group-text" id="inputGroupTooltipPrepend">$</span> <input type="number" class="form-control" value="100" id="validationTooltipDonation" aria-describedby="inputGroupTooltipPrepend validationTooltipDonationFeedback" required> </div> <div id="validationTooltipDonationFeedback" class="tooltip invalid-tooltip">Please enter a donation amount</div><!-- [!code highlight] --> </div> </div>
<div class="form-field"> <label for="validationTooltipAddress" class="form-label">Address</label> <input type="text" class="form-control" id="validationTooltipAddress" value="1234 Main St" required aria-describedby="validationTooltipAddressFeedback"> <div id="validationTooltipAddressFeedback" class="tooltip invalid-tooltip">Please enter a mailing address</div><!-- [!code highlight] --> </div>
<div class="grid gap-5"> <div class="form-field md:g-col-6"> <label for="validationTooltip03" class="form-label">City</label> <input type="text" class="form-control" id="validationTooltip03" required aria-describedby="validationTooltip03Feedback"> <div id="validationTooltip03Feedback" class="tooltip invalid-tooltip">Please provide a city</div><!-- [!code highlight] --> </div> <div class="form-field md:g-col-4"> <label for="validationTooltip04" class="form-label">State</label> <select class="form-control" id="validationTooltip04" required aria-describedby="validationTooltip04Feedback"> <option selected disabled value="">Choose…</option> <option>...</option> </select> <div id="validationTooltip04Feedback" class="tooltip invalid-tooltip">Please select a state</div><!-- [!code highlight] --> </div> <div class="form-field md:g-col-2"> <label for="validationTooltip05" class="form-label">Zip</label> <input type="text" class="form-control" id="validationTooltip05" required aria-describedby="validationTooltip05Feedback"> <div id="validationTooltip05Feedback" class="tooltip invalid-tooltip">Required</div><!-- [!code highlight] --> </div> </div>
<div class="form-group"> <label class="form-label">Shipping method</label> <div class="form-field mb-1"> <input type="radio" id="validationTooltipRadio1" class="radio" name="shippingTooltip" required> <div class="form-field-content"> <label for="validationTooltipRadio1">Standard</label> <small class="form-text">Arrives in 5-7 business days.</small> <div class="invalid-feedback">Please select a shipping method</div><!-- [!code highlight] --> </div> </div> <div class="form-field"> <input type="radio" id="validationTooltipRadio2" class="radio" name="shippingTooltip" required> <div class="form-field-content"> <label for="validationTooltipRadio2">Express</label> <small class="form-text">Arrives in 2-3 business days.</small> </div> </div> </div>
<div class="form-field"> <div class="switch"> <input type="checkbox" id="validationTooltipSwitch" role="switch" switch> </div> <label for="validationTooltipSwitch">Subscribe to newsletter</label> </div>
<button class="btn-solid theme-primary justify-self-start" type="submit">Submit form</button> </form>`} />
CSS
Sass mixins
We use one large mixin, form-validation-state, to generate all validation feedback styles from a state name and theme color. This mixin is called through a Sass loop to compile the CSS.
The form-validation-state-selector mixin handles selector generation for both .is-* classes and :user-* pseudo-classes.
Sass maps
This is the validation Sass map from forms/_validation.scss. Override or extend this to generate different or additional states.
Each key in the map is a validation state name (e.g., "valid") and the value is a theme color name (e.g., "success"). All styling is derived from the theme color’s CSS custom properties.
Sass loops
Used to iterate over $validation-states map values to generate our validation styles. Any modifications to the above Sass map will be reflected in your compiled CSS via this loop.
Customizing
Validation states can be customized via Sass with the $validation-states map. Located in our forms/_validation.scss file, this Sass map pairs each state name to a theme color name. All styling is derived from the theme color’s existing CSS custom properties (--{theme}-fg, --{theme}-border, --{theme}-bg, etc.). While no other states are supported by browsers, those using custom styles can easily add more complex form feedback.
