Fara í aðalefni Farðu í skjalaleiðsögn
Check
in English

Staðfesting

Gefðu notendum þínum verðmæta og hagnýta endurgjöf með HTML5 eyðublaði, með sjálfgefna hegðun vafra eða sérsniðnum stílum og JavaScript.

Við erum meðvituð um að eins og er eru sérsniðnir sannprófunarstílar og verkfæraábendingar ekki aðgengilegir, þar sem þeir eru ekki útsettir fyrir hjálpartækni. Á meðan við vinnum að lausn mælum við með því að nota annað hvort valmöguleikann á þjóninum eða sjálfgefna vafrastaðfestingaraðferðina.

Hvernig það virkar

Svona virkar formprófun með Bootstrap:

  • Staðfesting HTML forms er beitt í gegnum tvo gerviflokka CSS :invalidog :valid. Það á við um <input>, <select>, og <textarea>þætti.
  • Bootstrap nær yfir :invalidog :validstíla í foreldraflokk .was-validated, venjulega notað á <form>. Annars birtast allir nauðsynlegir reitir án gildis sem ógildir við hleðslu síðu. Þannig geturðu valið hvenær þú vilt virkja þau (venjulega eftir að reynt er að senda inn eyðublað).
  • Til að endurstilla útlit eyðublaðsins (td þegar um er að ræða kraftmikla eyðublaðasendingar með AJAX) skaltu fjarlægja .was-validatedbekkinn <form>aftur eftir innsendingu.
  • Sem varaflokkur .is-invalidog .is-validhægt er að nota flokka í stað gerviflokka fyrir staðfestingu á netþjóni . Þeir þurfa ekki .was-validatedforeldraflokk.
  • Vegna takmarkana á því hvernig CSS virkar, getum við (sem stendur) ekki beitt stílum á a <label>sem kemur á undan formstýringu í DOM án hjálpar sérsniðins JavaScript.
  • Allir nútíma vafrar styðja þvingunarprófunar-API , röð JavaScript-aðferða til að staðfesta formstýringar.
  • Ábendingaskilaboð kunna að nota sjálfgefnar stillingar vafrans (mismunandi fyrir hvern vafra og óstílfærðar í gegnum CSS) eða sérsniðna endurgjöfarstíla okkar með viðbótar HTML og CSS.
  • Þú getur útvegað sérsniðin gildisskilaboð með setCustomValidityJavaScript.

Með það í huga skaltu íhuga eftirfarandi kynningar fyrir sérsniðna löggildingarstíla okkar, valfrjálsa flokka miðlarahliðar og sjálfgefna vafra.

Sérsniðin stíll

Fyrir sérsniðin staðfestingarskilaboð fyrir Bootstrap form þarftu að bæta novalidateboolean eigindinni við <form>. Þetta slekkur á sjálfgefnum ábendingum um endurgjöf vafrans, en veitir samt aðgang að eyðublaðaprófunarforritaskilum í JavaScript. Reyndu að senda inn eyðublaðið hér að neðan; JavaScript okkar mun stöðva sendingarhnappinn og senda endurgjöf til þín. Þegar þú reynir að senda inn, muntu sjá :invalidog :validstíll notaður á eyðublaðastýringum þínum.

Sérsniðin endurgjöfarstíll notar sérsniðna liti, ramma, fókusstíla og bakgrunnstákn til að miðla endurgjöfum betur. Bakgrunnstákn fyrir <select>s eru aðeins fáanleg með .form-select, og ekki .form-control.

Lítur vel út!
Lítur vel út!
@
Vinsamlegast veldu notendanafn.
Vinsamlegast gefðu upp gilda borg.
Vinsamlegast veldu gilt ástand.
Vinsamlegast gefðu upp gilt zip.
Þú verður að samþykkja áður en þú sendir inn.
html
<form class="row g-3 needs-validation" novalidate>
  <div class="col-md-4">
    <label for="validationCustom01" class="form-label">First name</label>
    <input type="text" class="form-control" id="validationCustom01" value="Mark" required>
    <div class="valid-feedback">
      Looks good!
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationCustom02" class="form-label">Last name</label>
    <input type="text" class="form-control" id="validationCustom02" value="Otto" required>
    <div class="valid-feedback">
      Looks good!
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationCustomUsername" class="form-label">Username</label>
    <div class="input-group has-validation">
      <span class="input-group-text" id="inputGroupPrepend">@</span>
      <input type="text" class="form-control" id="validationCustomUsername" aria-describedby="inputGroupPrepend" required>
      <div class="invalid-feedback">
        Please choose a username.
      </div>
    </div>
  </div>
  <div class="col-md-6">
    <label for="validationCustom03" class="form-label">City</label>
    <input type="text" class="form-control" id="validationCustom03" required>
    <div class="invalid-feedback">
      Please provide a valid city.
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationCustom04" class="form-label">State</label>
    <select class="form-select" id="validationCustom04" required>
      <option selected disabled value="">Choose...</option>
      <option>...</option>
    </select>
    <div class="invalid-feedback">
      Please select a valid state.
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationCustom05" class="form-label">Zip</label>
    <input type="text" class="form-control" id="validationCustom05" required>
    <div class="invalid-feedback">
      Please provide a valid zip.
    </div>
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" value="" id="invalidCheck" required>
      <label class="form-check-label" for="invalidCheck">
        Agree to terms and conditions
      </label>
      <div class="invalid-feedback">
        You must agree before submitting.
      </div>
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">Submit form</button>
  </div>
</form>
// Example starter JavaScript for disabling form submissions if there are invalid fields
(() => {
  'use strict'

  // Fetch all the forms we want to apply custom Bootstrap validation styles to
  const forms = document.querySelectorAll('.needs-validation')

  // Loop over them and prevent submission
  Array.from(forms).forEach(form => {
    form.addEventListener('submit', event => {
      if (!form.checkValidity()) {
        event.preventDefault()
        event.stopPropagation()
      }

      form.classList.add('was-validated')
    }, false)
  })
})()

Sjálfgefnar stillingar vafra

Hefur þú ekki áhuga á sérsniðnum staðfestingarskilaboðum eða að skrifa JavaScript til að breyta hegðun eyðublaða? Allt í lagi, þú getur notað sjálfgefnar stillingar vafrans. Prófaðu að senda inn eyðublaðið hér að neðan. Það fer eftir vafranum þínum og stýrikerfi, þú munt sjá aðeins mismunandi stíl af endurgjöf.

Þó að ekki sé hægt að stíla þessa endurgjöf með CSS, geturðu samt sérsniðið endurgjöfartextann í gegnum JavaScript.

@
html
<form class="row g-3">
  <div class="col-md-4">
    <label for="validationDefault01" class="form-label">First name</label>
    <input type="text" class="form-control" id="validationDefault01" value="Mark" required>
  </div>
  <div class="col-md-4">
    <label for="validationDefault02" class="form-label">Last name</label>
    <input type="text" class="form-control" id="validationDefault02" value="Otto" required>
  </div>
  <div class="col-md-4">
    <label for="validationDefaultUsername" class="form-label">Username</label>
    <div class="input-group">
      <span class="input-group-text" id="inputGroupPrepend2">@</span>
      <input type="text" class="form-control" id="validationDefaultUsername"  aria-describedby="inputGroupPrepend2" required>
    </div>
  </div>
  <div class="col-md-6">
    <label for="validationDefault03" class="form-label">City</label>
    <input type="text" class="form-control" id="validationDefault03" required>
  </div>
  <div class="col-md-3">
    <label for="validationDefault04" class="form-label">State</label>
    <select class="form-select" id="validationDefault04" required>
      <option selected disabled value="">Choose...</option>
      <option>...</option>
    </select>
  </div>
  <div class="col-md-3">
    <label for="validationDefault05" class="form-label">Zip</label>
    <input type="text" class="form-control" id="validationDefault05" required>
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" value="" id="invalidCheck2" required>
      <label class="form-check-label" for="invalidCheck2">
        Agree to terms and conditions
      </label>
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">Submit form</button>
  </div>
</form>

Server hlið

Við mælum með því að nota sannprófun viðskiptavinarhliðar, en ef þú þarfnast staðfestingar á miðlarahlið geturðu gefið til kynna ógilda og gilda eyðublaðareiti með .is-invalidog .is-valid. Athugaðu að það .invalid-feedbacker einnig stutt með þessum flokkum.

Fyrir ógilda reiti skaltu ganga úr skugga um að ógildu endurgjöf/villuskilaboð séu tengd við viðkomandi eyðublaðsreit með því að nota aria-describedby(athugaðu að þessi eiginleiki gerir kleift idað vísa til fleiri en einn, ef reiturinn bendir nú þegar á viðbótartexta eyðublaðs).

Til að laga vandamál með radíus á landamærum þurfa inntakshópar viðbótarflokk .has-validation.

Lítur vel út!
Lítur vel út!
@
Vinsamlegast veldu notendanafn.
Vinsamlegast gefðu upp gilda borg.
Vinsamlegast veldu gilt ástand.
Vinsamlegast gefðu upp gilt zip.
Þú verður að samþykkja áður en þú sendir inn.
html
<form class="row g-3">
  <div class="col-md-4">
    <label for="validationServer01" class="form-label">First name</label>
    <input type="text" class="form-control is-valid" id="validationServer01" value="Mark" required>
    <div class="valid-feedback">
      Looks good!
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationServer02" class="form-label">Last name</label>
    <input type="text" class="form-control is-valid" id="validationServer02" value="Otto" required>
    <div class="valid-feedback">
      Looks good!
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationServerUsername" class="form-label">Username</label>
    <div class="input-group has-validation">
      <span class="input-group-text" id="inputGroupPrepend3">@</span>
      <input type="text" class="form-control is-invalid" id="validationServerUsername" aria-describedby="inputGroupPrepend3 validationServerUsernameFeedback" required>
      <div id="validationServerUsernameFeedback" class="invalid-feedback">
        Please choose a username.
      </div>
    </div>
  </div>
  <div class="col-md-6">
    <label for="validationServer03" class="form-label">City</label>
    <input type="text" class="form-control is-invalid" id="validationServer03" aria-describedby="validationServer03Feedback" required>
    <div id="validationServer03Feedback" class="invalid-feedback">
      Please provide a valid city.
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationServer04" class="form-label">State</label>
    <select class="form-select is-invalid" id="validationServer04" aria-describedby="validationServer04Feedback" required>
      <option selected disabled value="">Choose...</option>
      <option>...</option>
    </select>
    <div id="validationServer04Feedback" class="invalid-feedback">
      Please select a valid state.
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationServer05" class="form-label">Zip</label>
    <input type="text" class="form-control is-invalid" id="validationServer05" aria-describedby="validationServer05Feedback" required>
    <div id="validationServer05Feedback" class="invalid-feedback">
      Please provide a valid zip.
    </div>
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input is-invalid" type="checkbox" value="" id="invalidCheck3" aria-describedby="invalidCheck3Feedback" required>
      <label class="form-check-label" for="invalidCheck3">
        Agree to terms and conditions
      </label>
      <div id="invalidCheck3Feedback" class="invalid-feedback">
        You must agree before submitting.
      </div>
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">Submit form</button>
  </div>
</form>

Stuðningsþættir

Staðfestingarstílar eru fáanlegir fyrir eftirfarandi formstýringar og íhluti:

  • <input>s og <textarea>s með .form-control(þar á meðal allt að einn .form-controlí inntakshópum)
  • <select>s með.form-select
  • .form-checks
Vinsamlega sláðu inn skilaboð í textasvæðið.
Dæmi um ógildan endurgjöfartexta
Meira dæmi um ógildan endurgjöfartexta
Dæmi um ógilt val endurgjöf
Dæmi um ógild endurgjöf á eyðublaði
html
<form class="was-validated">
  <div class="mb-3">
    <label for="validationTextarea" class="form-label">Textarea</label>
    <textarea class="form-control" id="validationTextarea" placeholder="Required example textarea" required></textarea>
    <div class="invalid-feedback">
      Please enter a message in the textarea.
    </div>
  </div>

  <div class="form-check mb-3">
    <input type="checkbox" class="form-check-input" id="validationFormCheck1" required>
    <label class="form-check-label" for="validationFormCheck1">Check this checkbox</label>
    <div class="invalid-feedback">Example invalid feedback text</div>
  </div>

  <div class="form-check">
    <input type="radio" class="form-check-input" id="validationFormCheck2" name="radio-stacked" required>
    <label class="form-check-label" for="validationFormCheck2">Toggle this radio</label>
  </div>
  <div class="form-check mb-3">
    <input type="radio" class="form-check-input" id="validationFormCheck3" name="radio-stacked" required>
    <label class="form-check-label" for="validationFormCheck3">Or toggle this other radio</label>
    <div class="invalid-feedback">More example invalid feedback text</div>
  </div>

  <div class="mb-3">
    <select class="form-select" required aria-label="select example">
      <option value="">Open this select menu</option>
      <option value="1">One</option>
      <option value="2">Two</option>
      <option value="3">Three</option>
    </select>
    <div class="invalid-feedback">Example invalid select feedback</div>
  </div>

  <div class="mb-3">
    <input type="file" class="form-control" aria-label="file example" required>
    <div class="invalid-feedback">Example invalid form file feedback</div>
  </div>

  <div class="mb-3">
    <button class="btn btn-primary" type="submit" disabled>Submit form</button>
  </div>
</form>

Verkfæraráð

Ef útlit eyðublaðsins þíns leyfir það geturðu skipt um .{valid|invalid}-feedbackflokka fyrir .{valid|invalid}-tooltipflokka til að sýna staðfestingarviðbrögð í stíluðum verkfæraleiðbeiningum. Vertu viss um að hafa foreldri með position: relativeá því til að staðsetja tól. Í dæminu hér að neðan eru dálkaflokkarnir okkar með þetta nú þegar, en verkefnið þitt gæti þurft aðra uppsetningu.

Lítur vel út!
Lítur vel út!
@
Vinsamlegast veldu einstakt og gilt notendanafn.
Vinsamlegast gefðu upp gilda borg.
Vinsamlegast veldu gilt ástand.
Vinsamlegast gefðu upp gilt zip.
html
<form class="row g-3 needs-validation" novalidate>
  <div class="col-md-4 position-relative">
    <label for="validationTooltip01" class="form-label">First name</label>
    <input type="text" class="form-control" id="validationTooltip01" value="Mark" required>
    <div class="valid-tooltip">
      Looks good!
    </div>
  </div>
  <div class="col-md-4 position-relative">
    <label for="validationTooltip02" class="form-label">Last name</label>
    <input type="text" class="form-control" id="validationTooltip02" value="Otto" required>
    <div class="valid-tooltip">
      Looks good!
    </div>
  </div>
  <div class="col-md-4 position-relative">
    <label for="validationTooltipUsername" class="form-label">Username</label>
    <div class="input-group has-validation">
      <span class="input-group-text" id="validationTooltipUsernamePrepend">@</span>
      <input type="text" class="form-control" id="validationTooltipUsername" aria-describedby="validationTooltipUsernamePrepend" required>
      <div class="invalid-tooltip">
        Please choose a unique and valid username.
      </div>
    </div>
  </div>
  <div class="col-md-6 position-relative">
    <label for="validationTooltip03" class="form-label">City</label>
    <input type="text" class="form-control" id="validationTooltip03" required>
    <div class="invalid-tooltip">
      Please provide a valid city.
    </div>
  </div>
  <div class="col-md-3 position-relative">
    <label for="validationTooltip04" class="form-label">State</label>
    <select class="form-select" id="validationTooltip04" required>
      <option selected disabled value="">Choose...</option>
      <option>...</option>
    </select>
    <div class="invalid-tooltip">
      Please select a valid state.
    </div>
  </div>
  <div class="col-md-3 position-relative">
    <label for="validationTooltip05" class="form-label">Zip</label>
    <input type="text" class="form-control" id="validationTooltip05" required>
    <div class="invalid-tooltip">
      Please provide a valid zip.
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">Submit form</button>
  </div>
</form>

Sass

Breytur

$form-feedback-margin-top:          $form-text-margin-top;
$form-feedback-font-size:           $form-text-font-size;
$form-feedback-font-style:          $form-text-font-style;
$form-feedback-valid-color:         $success;
$form-feedback-invalid-color:       $danger;

$form-feedback-icon-valid-color:    $form-feedback-valid-color;
$form-feedback-icon-valid:          url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'><path fill='#{$form-feedback-icon-valid-color}' d='M2.3 6.73.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/></svg>");
$form-feedback-icon-invalid-color:  $form-feedback-invalid-color;
$form-feedback-icon-invalid:        url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='#{$form-feedback-icon-invalid-color}'><circle cx='6' cy='6' r='4.5'/><path stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/><circle cx='6' cy='8.2' r='.6' fill='#{$form-feedback-icon-invalid-color}' stroke='none'/></svg>");

Mixins

Tvær blöndur eru sameinaðar saman, í gegnum lykkjuna okkar , til að búa til formstaðfestingarstíla okkar.

@mixin form-validation-state-selector($state) {
  @if ($state == "valid" or $state == "invalid") {
    .was-validated #{if(&, "&", "")}:#{$state},
    #{if(&, "&", "")}.is-#{$state} {
      @content;
    }
  } @else {
    #{if(&, "&", "")}.is-#{$state} {
      @content;
    }
  }
}

@mixin form-validation-state(
  $state,
  $color,
  $icon,
  $tooltip-color: color-contrast($color),
  $tooltip-bg-color: rgba($color, $form-feedback-tooltip-opacity),
  $focus-box-shadow: 0 0 $input-btn-focus-blur $input-focus-width rgba($color, $input-btn-focus-color-opacity)
) {
  .#{$state}-feedback {
    display: none;
    width: 100%;
    margin-top: $form-feedback-margin-top;
    @include font-size($form-feedback-font-size);
    font-style: $form-feedback-font-style;
    color: $color;
  }

  .#{$state}-tooltip {
    position: absolute;
    top: 100%;
    z-index: 5;
    display: none;
    max-width: 100%; // Contain to parent when possible
    padding: $form-feedback-tooltip-padding-y $form-feedback-tooltip-padding-x;
    margin-top: .1rem;
    @include font-size($form-feedback-tooltip-font-size);
    line-height: $form-feedback-tooltip-line-height;
    color: $tooltip-color;
    background-color: $tooltip-bg-color;
    @include border-radius($form-feedback-tooltip-border-radius);
  }

  @include form-validation-state-selector($state) {
    ~ .#{$state}-feedback,
    ~ .#{$state}-tooltip {
      display: block;
    }
  }

  .form-control {
    @include form-validation-state-selector($state) {
      border-color: $color;

      @if $enable-validation-icons {
        padding-right: $input-height-inner;
        background-image: escape-svg($icon);
        background-repeat: no-repeat;
        background-position: right $input-height-inner-quarter center;
        background-size: $input-height-inner-half $input-height-inner-half;
      }

      &:focus {
        border-color: $color;
        box-shadow: $focus-box-shadow;
      }
    }
  }

  // stylelint-disable-next-line selector-no-qualifying-type
  textarea.form-control {
    @include form-validation-state-selector($state) {
      @if $enable-validation-icons {
        padding-right: $input-height-inner;
        background-position: top $input-height-inner-quarter right $input-height-inner-quarter;
      }
    }
  }

  .form-select {
    @include form-validation-state-selector($state) {
      border-color: $color;

      @if $enable-validation-icons {
        &:not([multiple]):not([size]),
        &:not([multiple])[size="1"] {
          padding-right: $form-select-feedback-icon-padding-end;
          background-image: escape-svg($form-select-indicator), escape-svg($icon);
          background-position: $form-select-bg-position, $form-select-feedback-icon-position;
          background-size: $form-select-bg-size, $form-select-feedback-icon-size;
        }
      }

      &:focus {
        border-color: $color;
        box-shadow: $focus-box-shadow;
      }
    }
  }

  .form-control-color {
    @include form-validation-state-selector($state) {
      @if $enable-validation-icons {
        width: add($form-color-width, $input-height-inner);
      }
    }
  }

  .form-check-input {
    @include form-validation-state-selector($state) {
      border-color: $color;

      &:checked {
        background-color: $color;
      }

      &:focus {
        box-shadow: $focus-box-shadow;
      }

      ~ .form-check-label {
        color: $color;
      }
    }
  }
  .form-check-inline .form-check-input {
    ~ .#{$state}-feedback {
      margin-left: .5em;
    }
  }

  .input-group {
    > .form-control:not(:focus),
    > .form-select:not(:focus),
    > .form-floating:not(:focus-within) {
      @include form-validation-state-selector($state) {
        @if $state == "valid" {
          z-index: 3;
        } @else if $state == "invalid" {
          z-index: 4;
        }
      }
    }
  }
}

Kort

Þetta er staðfestingar Sass kortið frá _variables.scss. Hneka eða framlengja þetta til að búa til önnur eða fleiri stöður.

$form-validation-states: (
  "valid": (
    "color": $form-feedback-valid-color,
    "icon": $form-feedback-icon-valid
  ),
  "invalid": (
    "color": $form-feedback-invalid-color,
    "icon": $form-feedback-icon-invalid
  )
);

Kort af $form-validation-statesgeta innihaldið þrjár valfrjálsar færibreytur til að hnekkja verkfæraábendingum og fókusstílum.

Lykkju

Notað til að endurtaka yfir $form-validation-stateskortagildi til að búa til staðfestingarstíla okkar. Allar breytingar á ofangreindu Sass kortinu munu endurspeglast í samsettum CSS þínum í gegnum þessa lykkju.

@each $state, $data in $form-validation-states {
  @include form-validation-state($state, $data...);
}

Sérsníða

Hægt er að aðlaga löggildingarstöðu í gegnum Sass með $form-validation-stateskortinu. Þetta Sass kort er staðsett í skránni okkar _variables.scssog er hvernig við búum til sjálfgefna valid/ invalidstaðfestingarstöðu. Innifalið er hreiður kort til að sérsníða lit hvers ríkis, táknmynd, lit á tól og fókusskugga. Þó að engin önnur ríki séu studd af vöfrum, geta þeir sem nota sérsniðna stíl auðveldlega bætt við flóknari endurgjöf.