Esasy mazmuna geçiň Docs nawigasiýasyna geçiň
in English

Barlamak

Brauzeriň adaty hereketleri ýa-da adaty stilleri we JavaScript arkaly HTML5 formasyny tassyklamak bilen ulanyjylaryňyza gymmatly, täsirli jogap beriň.

Müşderi tarapyndan ýöriteleşdirilen tassyklama stilleriniň we gural görkezmeleriniň elýeterli däldigini bilýäris, sebäbi kömekçi tehnologiýalara sezewar bolmaýarlar. Çözüwiň üstünde işleýänimizde, ýa-da serwer tarapyny ýa-da deslapky brauzeri tassyklamak usulyny ulanmagy maslahat bereris.

Bu nähili işleýär

“Bootstrap” bilen forma tassyklamasynyň nähili işleýändigi:

  • HTML formasyny barlamak CSS-iň iki sany ýasama synpy arkaly ulanylýar :invalidwe :valid. Bu elementlere degişlidir <input>.<select><textarea>
  • “Bootstrap” , adatça ulanylýan ene-atalar synpyna :invalidwe :validstiline degişlidir . Otherwiseogsam, gymmaty bolmadyk islendik meýdan sahypa ýükünde nädogry görkezilýär. Şeýlelik bilen, haçan işjeňleşdirmelidigini saýlap bilersiňiz (adatça forma tabşyrylansoň)..was-validated<form>
  • Formanyň daşky görnüşini täzeden düzmek üçin (mysal üçin, AJAX ulanyp dinamiki forma iberen ýagdaýynda), tabşyranyňyzdan soň .was-validatedsynpy <form>täzeden aýyryň.
  • Yza gaýdyp gelmek hökmünde .is-invalidwe serwer tarapyny barlamak.is-valid üçin pseudo-synplaryň ýerine sapaklar ulanylyp bilner . Ene-atalar synpyny talap etmeýärler ..was-validated
  • CSS-iň işleýşindäki çäklendirmeler sebäpli, häzirki <label>JavaScript-iň kömegi bolmazdan, DOM-da forma gözegçilikden öň gelýän stilleri ulanyp bilmeris.
  • Modernhli döwrebap brauzerler , forma dolandyryşlaryny barlamak üçin JavaScript usullarynyň bir topary bolan çäklendirme tassyklama API -ni goldaýarlar.
  • Seslenme habarlary brauzeriň defoltlaryny (her brauzer üçin tapawutly we CSS arkaly üýtgedip bolmaýar) ýa-da goşmaça HTML we CSS bilen adaty sesleniş usullarymyzy ulanyp biler.
  • setCustomValidityJavaScript-de ýörite ygtybarlylyk habarlaryny berip bilersiňiz.

Şuny göz öňünde tutup, adaty formany tassyklamak stillerimiz, serweriň goşmaça synplary we brauzer defoltlary üçin aşakdaky demleri göz öňünde tutuň.

Omörite stiller

novalidateBoörite “Bootstrap” formasyny tassyklamak habarlary üçin size “ boolean” atributyny goşmaly bolarsyňyz <form>. Bu, brauzeriň deslapky seslenme gurallaryny öçürýär, ýöne şonda-da JavaScript-de forma tassyklama API-lerine girişi üpjün edýär. Aşakdaky formany ibermäge synanyşyň; JavaScriptimiz tabşyrmak düwmesini saklar we size jogap berer. Ibermäge synanyşanyňyzda , forma dolandyryşlaryňyza ulanylýan stilleri :invalidwe stilleri görersiňiz .:valid

Feedbackörite seslenme stilleri has gowy habarlaşmak üçin ýörite reňkleri, serhetleri, fokus stillerini we fon nyşanlaryny ulanýar. S üçin fon nyşanlary <select>diňe elýeterli .form-select, ýok .form-control.

Looks good!
Looks good!
@
Please choose a username.
Please provide a valid city.
Please select a valid state.
Please provide a valid zip.
You must agree before submitting.
<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
(function () {
  'use strict'

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

  // Loop over them and prevent submission
  Array.prototype.slice.call(forms)
    .forEach(function (form) {
      form.addEventListener('submit', function (event) {
        if (!form.checkValidity()) {
          event.preventDefault()
          event.stopPropagation()
        }

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

Brauzer deslapky

Customörite tassyklama jogap habarlary ýa-da forma häsiýetini üýtgetmek üçin JavaScript ýazmak bilen gyzyklanmaýarsyňyzmy? Gowy, brauzeriň başlangyçlaryny ulanyp bilersiňiz. Aşakdaky formany iberip görüň. Brauzeriňize we OS-a baglylykda birneme üýtgeşik sesleniş stilini görersiňiz.

Bu seslenme stillerini CSS bilen düzüp bolmaýandygyna garamazdan, seslenme tekstini JavaScript arkaly düzüp bilersiňiz.

@
<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>

Serwer tarapy

Müşderi tarapyndan tassyklamany ulanmagy maslahat berýäris, ýöne serwer tarapyndan tassyklanylmagyny talap edýän bolsaňyz, nädogry we dogry forma meýdanlaryny görkezip .is-invalidbilersiňiz .is-valid. Bu synplar .invalid-feedbackbilen hem goldanýandygyny belläň.

Nädogry meýdanlar üçin nädogry seslenme / säwlik habarynyň degişli forma meýdançasy bilen baglanyşyklydygyna göz ýetiriň (bu meýdan eýýäm goşmaça forma tekstini görkezýän bolsa, aria-describedbybu atributyň birden köp salgylanmagyna mümkinçilik berýär ).id

Serhet radiosy bilen baglanyşykly meseleleri çözmek üçin giriş toparlary goşmaça .has-validationsynp talap edýär.

Gowy görünýär!
Gowy görünýär!
@
Ulanyjy adyny saýlaň.
Dogry şäher bilen üpjün etmegiňizi haýyş edýäris.
Dogry ýagdaýy saýlaň.
Dogry poçta bilen üpjün etmegiňizi haýyş edýäris.
Ibermezden ozal razy bolmaly.
<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>

Goldaw elementleri

Barlamak stilleri aşakdaky forma gözegçilikleri we komponentleri üçin elýeterlidir:

  • <input>s we <textarea>s bilen .form-control( .form-controlgiriş toparlarynda birine çenli)
  • <select>bilen.form-select
  • .form-checks
Tekstere habar ýazmagyňyzy haýyş edýäris.
Nädogry seslenme tekstine mysal
Nädogry seslenme teksti
Mysal nädogry seslenme
Nädogry forma faýl seslenmesine mysal
<form class="was-validated">
  <div class="mb-3">
    <label for="validationTextarea" class="form-label">Textarea</label>
    <textarea class="form-control is-invalid" 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>

Gurallar

Forma düzülişiňiz muňa mümkinçilik berýän bolsa, stilleşdirilen gurallar maslahatynda tassyklama seslenmesini görkezmek .{valid|invalid}-feedbacküçin sapaklary çalşyp bilersiňiz. Gurallaryň ýerleşdirilmegi üçin .{valid|invalid}-tooltipene-atanyň bolmalydygyna göz ýetiriň . position: relativeAşakdaky mysalda, sütün synplarymyzda eýýäm bar, ýöne taslamaňyz alternatiw gurnama talap edip biler.

Looks good!
Looks good!
@
Please choose a unique and valid username.
Please provide a valid city.
Please select a valid state.
Please provide a valid zip.
<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

Üýtgeýjiler

$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.73L.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

Iki sany garyndy, aýlawymyzyň üsti bilen birleşdirilip, formamyzy tassyklamagyň sesleniş usullaryny döretmek üçin.

@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-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,
  .input-group .form-select {
    @include form-validation-state-selector($state) {
      @if $state == "valid" {
        z-index: 1;
      } @else if $state == "invalid" {
        z-index: 2;
      }
      &:focus {
        z-index: 3;
      }
    }
  }
}

Karta

Bu Sass kartasynyň tassyklamasy _variables.scss. Dürli ýa-da goşmaça ýagdaýlary döretmek üçin muny ýok ediň ýa-da uzadyň.

$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
  )
);

Kartalarda $form-validation-statesgurallar we fokus stillerini ýok etmek üçin üç sany goşmaça parametr bolup biler.

Aýlaw

$form-validation-statesBarlag stillerimizi döretmek üçin karta bahalarynyň üstünden gaýtalamak üçin ulanylýar . Aboveokardaky Sass kartasyndaky islendik üýtgetmeler, bu aýlaw arkaly düzülen CSS-de görkeziler.

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

Düzeltmek

$form-validation-statesBarlag ýagdaýlary karta bilen Sass arkaly düzülip bilner . Faýlymyzda ýerleşýän bu Sass kartasy, başlangyç / tassyklama ýagdaýlaryny _variables.scssnädip döredýändigimizdir . Her ştatyň reňkini, nyşanyny, gurallaryň reňkini we fokus kölegesini sazlamak üçin ýerleşdirilen karta bar. Beýleki ştatlar brauzerler tarapyndan goldanylmasa-da, adaty stilleri ulanýanlar has çylşyrymly forma seslenmelerini aňsatlyk bilen goşup bilerler.validinvalid

Garyndyny üýtgetmän bahalary özleşdirmegi maslahat bermeýäris$form-validation-statesform-validation-state .