Langkau ke kandungan utama Langkau ke navigasi dokumen
Check
in English

Pengesahan

Berikan maklum balas yang berharga dan boleh diambil tindakan kepada pengguna anda dengan pengesahan borang HTML5, melalui gelagat lalai penyemak imbas atau gaya tersuai dan JavaScript.

Kami sedar bahawa pada masa ini gaya pengesahan tersuai pihak pelanggan dan petua alat tidak boleh diakses, kerana ia tidak terdedah kepada teknologi bantuan. Semasa kami mengusahakan penyelesaian, kami akan mengesyorkan sama ada menggunakan pilihan sebelah pelayan atau kaedah pengesahan penyemak imbas lalai.

Bagaimana ia berfungsi

Begini cara pengesahan borang berfungsi dengan Bootstrap:

  • Pengesahan borang HTML digunakan melalui dua kelas pseudo CSS :invaliddan :valid. Ia terpakai kepada <input>, <select>, dan <textarea>elemen.
  • Bootstrap merangkumi skop :invaliddan :validgaya kepada kelas induk .was-validated, biasanya digunakan pada <form>. Jika tidak, sebarang medan yang diperlukan tanpa nilai akan dipaparkan sebagai tidak sah pada pemuatan halaman. Dengan cara ini, anda boleh memilih masa untuk mengaktifkannya (biasanya selepas penyerahan borang cuba).
  • Untuk menetapkan semula penampilan borang (contohnya, dalam kes penyerahan borang dinamik menggunakan AJAX), alih keluar .was-validatedkelas daripada <form>sekali lagi selepas penyerahan.
  • Sebagai sandaran, .is-invaliddan .is-validkelas boleh digunakan dan bukannya kelas pseudo untuk pengesahan sisi pelayan . Mereka tidak memerlukan .was-validatedkelas ibu bapa.
  • Disebabkan oleh kekangan dalam cara CSS berfungsi, kami tidak boleh (pada masa ini) menggunakan gaya pada <label>yang datang sebelum kawalan borang dalam DOM tanpa bantuan JavaScript tersuai.
  • Semua penyemak imbas moden menyokong API pengesahan kekangan , satu siri kaedah JavaScript untuk mengesahkan kawalan borang.
  • Mesej maklum balas mungkin menggunakan lalai penyemak imbas (berbeza untuk setiap penyemak imbas, dan tidak boleh digayakan melalui CSS) atau gaya maklum balas tersuai kami dengan HTML dan CSS tambahan.
  • Anda boleh memberikan mesej kesahan tersuai dengan setCustomValiditydalam JavaScript.

Dengan mengambil kira perkara itu, pertimbangkan tunjuk cara berikut untuk gaya pengesahan borang tersuai kami, kelas sebelah pelayan pilihan dan lalai penyemak imbas.

Gaya tersuai

Untuk mesej pengesahan borang Bootstrap tersuai, anda perlu menambah novalidateatribut boolean pada <form>. Ini melumpuhkan petua alat maklum balas lalai penyemak imbas, tetapi masih menyediakan akses kepada API pengesahan borang dalam JavaScript. Cuba hantar borang di bawah; JavaScript kami akan memintas butang hantar dan menyampaikan maklum balas kepada anda. Apabila cuba menyerahkan, anda akan melihat gaya :invaliddan :validdigunakan pada kawalan borang anda.

Gaya maklum balas tersuai menggunakan warna tersuai, jidar, gaya fokus dan ikon latar belakang untuk menyampaikan maklum balas dengan lebih baik. Ikon latar belakang untuk <select>s hanya tersedia dengan .form-select, dan bukan .form-control.

Nampak bagus!
Nampak bagus!
@
Sila pilih nama pengguna.
Sila berikan bandar yang sah.
Sila pilih keadaan yang sah.
Sila berikan zip yang sah.
Anda mesti bersetuju sebelum menyerahkan.
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)
  })
})()

Penyemak imbas lalai

Tidak berminat dengan mesej maklum balas pengesahan tersuai atau menulis JavaScript untuk menukar tingkah laku borang? Semua baik, anda boleh menggunakan lalai penyemak imbas. Cuba hantar borang di bawah. Bergantung pada penyemak imbas dan OS anda, anda akan melihat gaya maklum balas yang sedikit berbeza.

Walaupun gaya maklum balas ini tidak boleh digayakan dengan CSS, anda masih boleh menyesuaikan teks maklum balas melalui 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>

Bahagian pelayan

Kami mengesyorkan menggunakan pengesahan pihak klien, tetapi sekiranya anda memerlukan pengesahan pihak pelayan, anda boleh menunjukkan medan borang yang tidak sah dan sah dengan .is-invaliddan .is-valid. Ambil perhatian bahawa .invalid-feedbackjuga disokong dengan kelas ini.

Untuk medan yang tidak sah, pastikan maklum balas/mesej ralat yang tidak sah dikaitkan dengan medan borang yang berkaitan menggunakan aria-describedby(dengan mengambil perhatian bahawa atribut ini membenarkan lebih daripada satu iduntuk dirujuk, sekiranya medan itu sudah menunjuk kepada teks borang tambahan).

Untuk menyelesaikan isu dengan jejari sempadan , kumpulan input memerlukan .has-validationkelas tambahan.

Nampak bagus!
Nampak bagus!
@
Sila pilih nama pengguna.
Sila berikan bandar yang sah.
Sila pilih keadaan yang sah.
Sila berikan zip yang sah.
Anda mesti bersetuju sebelum menyerahkan.
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>

Elemen yang disokong

Gaya pengesahan tersedia untuk kawalan dan komponen borang berikut:

  • <input>s dan <textarea>s dengan .form-control(termasuk sehingga satu .form-controldalam kumpulan input)
  • <select>s dengan.form-select
  • .form-checks
Sila masukkan mesej dalam kawasan teks.
Contoh teks maklum balas tidak sah
Lagi contoh teks maklum balas tidak sah
Contoh maklum balas pilihan tidak sah
Contoh maklum balas fail borang tidak sah
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>

Petua alat

Jika reka letak borang anda membenarkannya, anda boleh menukar .{valid|invalid}-feedbackkelas untuk .{valid|invalid}-tooltipkelas untuk memaparkan maklum balas pengesahan dalam petua alat gaya. Pastikan anda mempunyai ibu bapa position: relativedengannya untuk kedudukan petua alat. Dalam contoh di bawah, kelas lajur kami sudah pun mempunyai ini, tetapi projek anda mungkin memerlukan persediaan alternatif.

Nampak bagus!
Nampak bagus!
@
Sila pilih nama pengguna yang unik dan sah.
Sila berikan bandar yang sah.
Sila pilih keadaan yang sah.
Sila berikan zip yang sah.
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

Pembolehubah

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

Campuran

Dua campuran digabungkan bersama, melalui gelung kami , untuk menjana gaya maklum balas pengesahan borang kami.

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

Peta

Ini ialah peta Sass pengesahan daripada _variables.scss. Ganti atau lanjutkan ini untuk menjana keadaan berbeza atau tambahan.

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

Peta $form-validation-statesboleh mengandungi tiga parameter pilihan untuk mengatasi petua alat dan gaya fokus.

gelung

Digunakan untuk mengulang $form-validation-statesnilai peta untuk menjana gaya pengesahan kami. Sebarang pengubahsuaian pada peta Sass di atas akan ditunjukkan dalam CSS terkumpul anda melalui gelung ini.

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

Menyesuaikan

Keadaan pengesahan boleh disesuaikan melalui Sass dengan $form-validation-statespeta. Terletak dalam _variables.scssfail kami, peta Sass ini ialah cara kami menjana keadaan lalai valid/ invalidpengesahan. Termasuk ialah peta bersarang untuk menyesuaikan warna, ikon, warna petua alat dan bayang fokus setiap negeri. Walaupun tiada negeri lain disokong oleh penyemak imbas, mereka yang menggunakan gaya tersuai boleh menambah maklum balas bentuk yang lebih kompleks dengan mudah.