រំលងទៅមាតិកាសំខាន់ រំលងទៅការរុករកឯកសារ
Check
in English

សុពលភាព

ផ្តល់មតិកែលម្អដ៏មានតម្លៃ និងអាចអនុវត្តបានដល់អ្នកប្រើប្រាស់របស់អ្នកជាមួយនឹងសុពលភាពទម្រង់ HTML5 តាមរយៈឥរិយាបថលំនាំដើមរបស់កម្មវិធីរុករកតាមអ៊ីនធឺណិត ឬរចនាប័ទ្មផ្ទាល់ខ្លួន និង JavaScript ។

នៅលើទំព័រនេះ។
យើងដឹងហើយថាបច្ចុប្បន្ន រចនាប័ទ្មសុពលភាពផ្ទាល់ខ្លួន និងព័ត៌មានជំនួយរបស់ភាគីអតិថិជនមិនអាចចូលប្រើបានទេ ដោយសារពួកវាមិនត្រូវបានប៉ះពាល់នឹងបច្ចេកវិទ្យាជំនួយ។ ខណៈពេលដែលយើងធ្វើការលើដំណោះស្រាយមួយ យើងសូមណែនាំឱ្យប្រើជម្រើសខាងម៉ាស៊ីនមេ ឬវិធីសាស្ត្រផ្ទៀងផ្ទាត់កម្មវិធីរុករកលំនាំដើម។

របៀបដែលវាដំណើរការ

នេះជារបៀបដែលការផ្ទៀងផ្ទាត់ទម្រង់ដំណើរការជាមួយ Bootstrap៖

  • សុពលភាពទម្រង់ HTML ត្រូវបានអនុវត្តតាមរយៈ CSS's pseudo-classes :invalidនិង :valid. វាអនុវត្តចំពោះ <input>, <select>, និង <textarea>ធាតុ។
  • Bootstrap វិសាលភាព :invalidនិង :validរចនាប័ទ្មទៅ .was-validatedថ្នាក់មេ ដែលជាធម្មតាត្រូវបានអនុវត្តទៅ <form>. បើមិនដូច្នេះទេ វាលដែលត្រូវការណាមួយដែលគ្មានតម្លៃបង្ហាញថាមិនត្រឹមត្រូវនៅពេលផ្ទុកទំព័រ។ វិធីនេះ អ្នកអាចជ្រើសរើសពេលណាដើម្បីធ្វើឲ្យពួកវាសកម្ម (ជាធម្មតាបន្ទាប់ពីការដាក់ស្នើទម្រង់ត្រូវបានព្យាយាម)។
  • ដើម្បីកំណត់រូបរាងទម្រង់ឡើងវិញ (ឧទាហរណ៍ក្នុងករណីនៃការដាក់ស្នើទម្រង់ថាមវន្តដោយប្រើ AJAX) សូមដក .was-validatedថ្នាក់ចេញពីទម្រង់ <form>ម្តងទៀតបន្ទាប់ពីការដាក់ស្នើ។
  • ជាជម្រើសជំនួស .is-invalidហើយ .is-validថ្នាក់អាចត្រូវបានប្រើប្រាស់ជំនួសឱ្យ pseudo-classes សម្រាប់ សុពលភាពផ្នែកខាងម៉ាស៊ីនមេ ។ ពួកគេមិនត្រូវការ .was-validatedថ្នាក់មេទេ។
  • ដោយសារតែមានឧបសគ្គនៅក្នុងរបៀបដែល CSS ដំណើរការ យើងមិនអាច (នៅពេលបច្ចុប្បន្ន) អនុវត្តរចនាប័ទ្ម <label>ដែលមកមុនការគ្រប់គ្រងទម្រង់នៅក្នុង DOM ដោយគ្មានជំនួយពី JavaScript ផ្ទាល់ខ្លួនទេ។
  • កម្មវិធីរុករកតាមអ៊ីនធឺណិតទំនើបទាំងអស់គាំទ្រ API សុពលភាពកម្រិត ដែលជាស៊េរីនៃវិធីសាស្ត្រ JavaScript សម្រាប់ធ្វើឱ្យមានសុពលភាពការត្រួតពិនិត្យទម្រង់។
  • សារមតិកែលម្អអាចប្រើប្រាស់ លំនាំដើមរបស់កម្មវិធីរុករក តាមអ៊ីនធឺណិត (ខុសគ្នាសម្រាប់កម្មវិធីរុករកតាមអ៊ីនធឺណិតនីមួយៗ និងមិនមានរចនាប័ទ្មតាមរយៈ CSS) ឬរចនាប័ទ្មមតិកែលម្អផ្ទាល់ខ្លួនរបស់យើងជាមួយនឹង HTML និង CSS បន្ថែម។
  • អ្នកអាចផ្តល់សារសុពលភាពផ្ទាល់ខ្លួនជាមួយ setCustomValidityនៅក្នុង JavaScript ។

ដោយគិតក្នុងចិត្តនោះ សូមពិចារណាការបង្ហាញខាងក្រោមសម្រាប់រចនាប័ទ្មសុពលភាពទម្រង់ផ្ទាល់ខ្លួនរបស់យើង ថ្នាក់ផ្នែកខាងម៉ាស៊ីនមេស្រេចចិត្ត និងលំនាំដើមនៃកម្មវិធីរុករកតាមអ៊ីនធឺណិត។

រចនាប័ទ្មផ្ទាល់ខ្លួន

សម្រាប់សារសុពលភាពទម្រង់ Bootstrap ផ្ទាល់ខ្លួន អ្នកនឹងត្រូវបន្ថែម novalidateគុណលក្ខណៈប៊ូលីនទៅ <form>. នេះបិទដំណើរការការណែនាំឧបករណ៍មតិកែលម្អលំនាំដើមរបស់កម្មវិធីរុករក ប៉ុន្តែនៅតែផ្តល់នូវការចូលប្រើ APIs សុពលភាពទម្រង់នៅក្នុង JavaScript។ ព្យាយាមដាក់ទម្រង់ខាងក្រោម; JavaScript របស់យើងនឹងស្ទាក់ចាប់ប៊ូតុងបញ្ជូន និងបញ្ជូនមតិត្រឡប់ទៅកាន់អ្នក។ នៅពេលព្យាយាមដាក់ស្នើ អ្នកនឹងឃើញ រចនាប័ទ្ម :invalidនិង :validរចនាប័ទ្មដែលបានអនុវត្តចំពោះការគ្រប់គ្រងទម្រង់របស់អ្នក។

រចនាប័ទ្មមតិកែលម្អផ្ទាល់ខ្លួនអនុវត្តពណ៌ផ្ទាល់ខ្លួន ស៊ុម រចនាប័ទ្មផ្ដោត និងរូបតំណាងផ្ទៃខាងក្រោយ ដើម្បីទំនាក់ទំនងមតិកែលម្អកាន់តែប្រសើរឡើង។ រូបតំណាងផ្ទៃខាងក្រោយសម្រាប់ <select>s គឺអាចប្រើបានតែជាមួយ .form-select, និងមិនមែន .form-control.

មើល​ទៅ​ល្អ!
មើល​ទៅ​ល្អ!
@
សូមជ្រើសរើសឈ្មោះអ្នកប្រើប្រាស់។
សូមផ្តល់ទីក្រុងត្រឹមត្រូវ។
សូមជ្រើសរើសរដ្ឋត្រឹមត្រូវ។
សូមផ្តល់ zip ត្រឹមត្រូវ។
អ្នកត្រូវតែយល់ព្រមមុនពេលដាក់ស្នើ។
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)
  })
})()

កម្មវិធីរុករកតាមអ៊ីនធឺណិតលំនាំដើម

មិនចាប់អារម្មណ៍នឹងសារមតិកែលម្អដែលមានសុពលភាពផ្ទាល់ខ្លួន ឬការសរសេរ JavaScript ដើម្បីផ្លាស់ប្តូរឥរិយាបថទម្រង់មែនទេ? ល្អទាំងអស់ អ្នកអាចប្រើលំនាំដើមរបស់កម្មវិធីរុករកតាមអ៊ីនធឺណិត។ សាកល្បងដាក់ទម្រង់ខាងក្រោម។ អាស្រ័យលើកម្មវិធីរុករកតាមអ៊ីនធឺណិត និងប្រព័ន្ធប្រតិបត្តិការរបស់អ្នក អ្នកនឹងឃើញរចនាប័ទ្មមតិកែលម្អខុសគ្នាបន្តិចបន្តួច។

ខណៈពេលដែលរចនាប័ទ្មមតិកែលម្អទាំងនេះមិនអាចត្រូវបានកំណត់រចនាប័ទ្មជាមួយ CSS អ្នកនៅតែអាចប្ដូរតាមបំណងអត្ថបទមតិកែលម្អតាមរយៈ 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>

ផ្នែកខាងម៉ាស៊ីនមេ

យើងសូមណែនាំឱ្យប្រើការបញ្ជាក់ផ្នែកខាងអតិថិជន ប៉ុន្តែក្នុងករណីដែលអ្នកទាមទារឱ្យមានសុពលភាពផ្នែកខាងម៉ាស៊ីនមេ អ្នកអាចបង្ហាញទម្រង់មិនត្រឹមត្រូវ និងត្រឹមត្រូវជាមួយ .is-invalidនិង .is-valid. ចំណាំថា .invalid-feedbackត្រូវបានគាំទ្រជាមួយថ្នាក់ទាំងនេះផងដែរ។

សម្រាប់វាលមិនត្រឹមត្រូវ សូមប្រាកដថា មតិកែលម្អ/សារកំហុសមិនត្រឹមត្រូវត្រូវបានភ្ជាប់ជាមួយប្រអប់ទម្រង់ដែលពាក់ព័ន្ធដោយប្រើ aria-describedby(ចំណាំថាគុណលក្ខណៈនេះអនុញ្ញាតឱ្យ idមានឯកសារយោងច្រើនជាងមួយ ក្នុងករណីដែលវាលចង្អុលទៅអត្ថបទទម្រង់បន្ថែមរួចហើយ)។

ដើម្បីដោះស្រាយបញ្ហា ជាមួយកាំព្រំដែន ក្រុមបញ្ចូលត្រូវការ .has-validationថ្នាក់បន្ថែម។

មើល​ទៅ​ល្អ!
មើល​ទៅ​ល្អ!
@
សូមជ្រើសរើសឈ្មោះអ្នកប្រើប្រាស់។
សូមផ្តល់ទីក្រុងត្រឹមត្រូវ។
សូមជ្រើសរើសរដ្ឋត្រឹមត្រូវ។
សូមផ្តល់ zip ត្រឹមត្រូវ។
អ្នកត្រូវតែយល់ព្រមមុនពេលដាក់ស្នើ។
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>

ធាតុដែលបានគាំទ្រ

រចនាប័ទ្ម​សុពលភាព​មាន​សម្រាប់​ការគ្រប់គ្រង​ទម្រង់​និង​សមាសធាតុ​ខាងក្រោម៖

  • <input>s និង <textarea>s ជាមួយ .form-control(រួមទាំងរហូតដល់មួយ .form-controlក្នុងក្រុមបញ្ចូល)
  • <select>s ជាមួយ.form-select
  • .form-checkស
សូមបញ្ចូលសារនៅក្នុងអត្ថបទ។
ឧទាហរណ៍អត្ថបទមតិកែលម្អមិនត្រឹមត្រូវ
ឧទាហរណ៍ច្រើនទៀត អត្ថបទមតិកែលម្អមិនត្រឹមត្រូវ
ឧទាហរណ៍​ការ​ជ្រើសរើស​មតិ​កែលម្អ​មិន​ត្រឹមត្រូវ។
ឧទាហរណ៍ មតិកែលម្អឯកសារទម្រង់មិនត្រឹមត្រូវ
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>

ព័ត៌មានជំនួយ

ប្រសិនបើប្លង់ទម្រង់របស់អ្នកអនុញ្ញាត អ្នកអាចប្តូរ .{valid|invalid}-feedbackថ្នាក់សម្រាប់ .{valid|invalid}-tooltipថ្នាក់ ដើម្បីបង្ហាញមតិកែលម្អសុពលភាពនៅក្នុងព័ត៌មានជំនួយដែលមានរចនាប័ទ្ម។ ត្រូវ​ប្រាកដ​ថា​មាន​មាតាបិតា position: relative​នៅ​ជាមួយ​វា​សម្រាប់​ការ​កំណត់​ទីតាំង​ព័ត៌មានជំនួយ។ ក្នុងឧទាហរណ៍ខាងក្រោម ថ្នាក់ជួរឈររបស់យើងមានវារួចហើយ ប៉ុន្តែគម្រោងរបស់អ្នកអាចទាមទារការដំឡើងជំនួស។

មើល​ទៅ​ល្អ!
មើល​ទៅ​ល្អ!
@
សូមជ្រើសរើសឈ្មោះអ្នកប្រើប្រាស់តែមួយគត់ និងត្រឹមត្រូវ។
សូមផ្តល់ទីក្រុងត្រឹមត្រូវ។
សូមជ្រើសរើសរដ្ឋត្រឹមត្រូវ។
សូមផ្តល់ 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>

សាស

អថេរ

$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 ពីរត្រូវបានបញ្ចូលគ្នាជាមួយគ្នាតាមរយៈ រង្វិលជុំ របស់យើង ដើម្បីបង្កើតទម្រង់បែបបទមតិកែលម្អដែលមានសុពលភាពរបស់យើង។

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

ផែនទី

នេះគឺជាផែនទី Sass ដែលមានសុពលភាពពី _variables.scss. បដិសេធ ឬពង្រីកវាដើម្បីបង្កើតស្ថានភាពផ្សេងគ្នា ឬបន្ថែម។

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

ផែនទីនៃ $form-validation-statesអាចមានប៉ារ៉ាម៉ែត្រស្រេចចិត្តចំនួនបី ដើម្បីបដិសេធព័ត៌មានជំនួយ និងរចនាប័ទ្មផ្ដោត។

រង្វិលជុំ

ប្រើដើម្បីធ្វើឡើងវិញលើ $form-validation-statesតម្លៃផែនទីដើម្បីបង្កើតរចនាប័ទ្មសុពលភាពរបស់យើង។ ការកែប្រែណាមួយចំពោះផែនទី Sass ខាងលើនឹងត្រូវបានឆ្លុះបញ្ចាំងនៅក្នុង CSS ដែលបានចងក្រងរបស់អ្នកតាមរយៈរង្វិលជុំនេះ។

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

ការប្ដូរតាមបំណង

ស្ថានភាពសុពលភាពអាចត្រូវបានប្ដូរតាមបំណងតាមរយៈ Sass ជាមួយនឹង $form-validation-statesផែនទី។ មានទីតាំងនៅក្នុង _variables.scssឯកសាររបស់យើង ផែនទី Sass នេះគឺជារបៀបដែលយើងបង្កើត default valid/ invalidvalidation states។ រួមបញ្ចូលគឺជាផែនទីដែលភ្ជាប់មកជាមួយសម្រាប់ប្ដូរតាមបំណងនូវពណ៌ រូបតំណាង ពណ៌ព័ត៌មានជំនួយ និងស្រមោលផ្តោតអារម្មណ៍របស់រដ្ឋនីមួយៗ។ ទោះបីជាមិនមានរដ្ឋផ្សេងទៀតត្រូវបានគាំទ្រដោយកម្មវិធីរុករកក៏ដោយ អ្នកដែលប្រើរចនាប័ទ្មផ្ទាល់ខ្លួនអាចបន្ថែមមតិកែលម្អទម្រង់ស្មុគស្មាញបន្ថែមទៀតបានយ៉ាងងាយស្រួល។