Skip to main content Skip to docs navigation
مشاهدة على الـ GitHub

التحقق من المدخلات (Validation)

قدم ملاحظات قيمة وقابلة للتنفيذ لمستخدميك من خلال التحقق من صحة نماذج HTML5، عبر سلوكيات المتصفح الافتراضية أو الأنماط المخصصة والـ JavaScript.

في هذه الصفحة

نحن على دراية بأن أنماط التحقق المخصصة وتلميحات الأدوات (tooltips) من جهة العميل غير متاحة حالياً لتقنيات المساعدة، حيث أنها غير مكشوفة لها. بينما نعمل على حل هذه المشكلة، نوصي إما باستخدام خيار جهة الخادم (server-side) أو طريقة التحقق الافتراضية للمتصفح، بإختصار: لا يتم "الإعلان" عنها لمقارئ الشاشة (Screen Readers) التي يستخدمها المكفوفون أو ضعاف البصر.

كيف يعمل ؟

إليك كيف يعمل التحقق من صحة النماذج مع الـ Bootstrap:

  • يتم تطبيق التحقق من صحة نماذج HTML عبر فئتين وهميتين (pseudo-classes) في CSS، وهما :invalid و :valid. وهي تنطبق على عناصر <input> و <select> و <textarea>.
  • يقوم الـ Bootstrap بحصر أنماط :invalid و :valid ضمن الفئة الأب .was-validated والتي تُطبق عادةً على الـ <form>. بخلاف ذلك، فإن أي حقل مطلوب بدون قيمة سيظهر كحقل غير صالح عند تحميل الصفحة. وبهذه الطريقة، يمكنك اختيار وقت تفعيلها (عادةً بعد محاولة إرسال النموذج).
  • لإعادة ضبط مظهر النموذج (على سبيل المثال، في حالة عمليات إرسال النماذج الديناميكية باستخدام Ajax)، قم بإزالة الفئة .was-validated من الـ <form> مرة أخرى بعد الإرسال.
  • كحل بديل، يمكن استخدام الفئات .is-invalid و .is-valid بدلاً من الفئات الوهمية لـ التحقق من جهة الخادم (server-side validation). وهي لا تتطلب فئة أب .was-validated.
  • بسبب القيود في كيفية عمل CSS، لا يمكننا (في الوقت الحالي) تطبيق أنماط على <label> يأتي قبل عنصر تحكم في النموذج في الـ DOM دون المساعدة من JavaScript مخصص.
  • تدعم جميع المتصفحات الحديثة واجهة برمجة تطبيقات التحقق من القيود (constraint validation API)، وهي سلسلة من طرق JavaScript للتحقق من صحة عناصر التحكم في النماذج.
  • قد تستخدم رسائل الملاحظات إعدادات المتصفح الافتراضية (تختلف من متصفح لآخر، ولا يمكن تنسيقها عبر CSS) أو أنماط الملاحظات المخصصة لدينا مع HTML و CSS إضافيين.
  • يمكنك تقديم رسائل صلاحية مخصصة باستخدام setCustomValidity في JavaScript.

مع وضع ذلك في الاعتبار، اطلع على العروض التوضيحية التالية لأنماط التحقق المخصصة من النماذج، وفئات جهة الخادم الاختيارية، وإعدادات المتصفح الافتراضية.

أنماط مخصصة (Custom styles)

بالنسبة لرسائل التحقق المخصصة من نماذج الـ Bootstrap، ستحتاج إلى إضافة السمة المنطقية novalidate إلى الـ <form>. يؤدي هذا إلى تعطيل تلميحات الأدوات (tooltips) الافتراضية للمتصفح، ولكنه لا يزال يوفر الوصول إلى الـ APIs الخاصة بالتحقق من صحة النماذج في الـ JavaScript. حاول إرسال النموذج أدناه؛ سيقوم الـ JavaScript الخاص بنا باعتراض زر الإرسال ونقل الملاحظات إليك. عند محاولة الإرسال، سترى أنماط :invalid و :valid مطبقة على عناصر التحكم في النموذج الخاصة بك.

تطبق أنماط الملاحظات المخصصة ألواناً وحدوداً وأنماط تركيز وأيقونات خلفية مخصصة لتحسين نقل الملاحظات. أيقونات الخلفية لعناصر <select> متاحة فقط مع .form-select وليس .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.
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)
  })
})()

إعدادات المتصفح الافتراضية (Browser defaults)

غير مهتم برسائل ملاحظات التحقق المخصصة أو كتابة الـ 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>

من جهة السيرفر (Server-side)

نوصي باستخدام التحقق من جهة العميل، ولكن في حال كنت بحاجة إلى التحقق من جهة الخادم، يمكنك الإشارة إلى حقول النموذج غير الصالحة والصالحة باستخدام .is-invalid و .is-valid لاحظ أن .invalid-feedback مدعومة أيضاً مع هذه الفئات.

بالنسبة للحقول غير الصالحة، تأكد من ربط الملاحظات غير الصالحة/رسالة الخطأ بحقل النموذج ذي الصلة باستخدام aria-describedby (مع ملاحظة أن هذه السمة تسمح بالإشارة إلى أكثر من id واحد، في حال كان الحقل يشير بالفعل إلى نص إضافي في النموذج).

لإصلاح مذكرات ملاحظات تدوير الحواف، تتطلب مجموعات الإدخال فئة إضافية هي .has-validation.

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.
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> و <textarea> مع .form-control (بما في ذلك عنصر .form-control واحد بحد أقصى في مجموعات الإدخال)
  • عناصر <select> مع .form-select
  • عناصر .form-check
Please enter a message in the textarea.
Example invalid feedback text
More example invalid feedback text
Example invalid select feedback
Example invalid form file feedback
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>

تلميحات الأدوات (Tooltips)

إذا كان تخطيط النموذج الخاص بك يسمح بذلك، يمكنك استبدال الفئات .{valid|invalid}-feedback بالفئات .{valid|invalid}-tooltip لعرض ملاحظات التحقق في تلميح أداة (tooltip) منسق. تأكد من وجود عنصر أب يحتوي على position: relative لتحديد موضع تلميح الأداة. في المثال أدناه، تحتوي فئات الأعمدة لدينا على هذا بالفعل، ولكن قد يتطلب مشروعك إعداداً بديلاً.

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

الـ (CSS)

المتغيرات (Variables)

تمت الإضافة في الإصدار v5.3.0

كجزء من نهج الـ CSS variables المتطور في الـ Bootstrap، تستخدم النماذج الآن متغيرات CSS محلية للتحقق من الصحة لتعزيز التخصيص في الوقت الفعلي. يتم تعيين قيم متغيرات CSS عبر الـ Sass، لذا لا يزال تخصيص الـ Sass مدعوماً أيضاً.

scss/_root.scss 
--#{$prefix}form-valid-color: #{$form-valid-color};
--#{$prefix}form-valid-border-color: #{$form-valid-border-color};
--#{$prefix}form-invalid-color: #{$form-invalid-color};
--#{$prefix}form-invalid-border-color: #{$form-invalid-border-color};

هذه المتغيرات متكيفة أيضاً مع وضع الألوان، مما يعني أنها تغير لونها عند استخدام الوضع الداكن.

متغيرات الـ (Sass)

scss/_variables.scss 
$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.1'/></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>");
scss/_variables.scss 
$form-valid-color:                  $form-feedback-valid-color;
$form-valid-border-color:           $form-feedback-valid-color;
$form-invalid-color:                $form-feedback-invalid-color;
$form-invalid-border-color:         $form-feedback-invalid-color;
scss/_variables-dark.scss 
$form-valid-color-dark:             $green-300;
$form-valid-border-color-dark:      $green-300;
$form-invalid-color-dark:           $red-300;
$form-invalid-border-color-dark:    $red-300;

دمج/مزج الـ (Sass mixins)

يتم دمج اثنين من المزجات (mixins)، من خلال الحلقة (loop) الخاصة بنا، لإنشاء أنماط ملاحظات التحقق من صحة النموذج.

scss/mixins/_forms.scss 
@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),
  $border-color: $color
) {
  .#{$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: $border-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: $border-color;
        @if $enable-shadows {
          @include box-shadow($input-box-shadow, $focus-box-shadow);
        } @else {
          // Avoid using mixin so we can pass custom focus shadow properly
          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: $border-color;

      @if $enable-validation-icons {
        &:not([multiple]):not([size]),
        &:not([multiple])[size="1"] {
          --#{$prefix}form-select-bg-icon: #{escape-svg($icon)};
          padding-right: $form-select-feedback-icon-padding-end;
          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: $border-color;
        @if $enable-shadows {
          @include box-shadow($form-select-box-shadow, $focus-box-shadow);
        } @else {
          // Avoid using mixin so we can pass custom focus shadow properly
          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: $border-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 maps)

هذه هي خريطة (map) الـ Sass الخاصة بالتحقق من الصحة من ملف _variables.scss. قم بتجاوز هذه الخريطة أو توسيعها لإنشاء حالات مختلفة أو إضافية.

scss/_variables.scss 
$form-validation-states: (
  "valid": (
    "color": var(--#{$prefix}form-valid-color),
    "icon": $form-feedback-icon-valid,
    "tooltip-color": #fff,
    "tooltip-bg-color": var(--#{$prefix}success),
    "focus-box-shadow": 0 0 $input-btn-focus-blur $input-focus-width rgba(var(--#{$prefix}success-rgb), $input-btn-focus-color-opacity),
    "border-color": var(--#{$prefix}form-valid-border-color),
  ),
  "invalid": (
    "color": var(--#{$prefix}form-invalid-color),
    "icon": $form-feedback-icon-invalid,
    "tooltip-color": #fff,
    "tooltip-bg-color": var(--#{$prefix}danger),
    "focus-box-shadow": 0 0 $input-btn-focus-blur $input-focus-width rgba(var(--#{$prefix}danger-rgb), $input-btn-focus-color-opacity),
    "border-color": var(--#{$prefix}form-invalid-border-color),
  )
);

يمكن أن تحتوي خرائط $form-validation-states على ثلاثة معاملات اختيارية لتجاوز أنماط تلميحات الأدوات (tooltips) وأنماط التركيز.

حلقات الـ (Sass loops)

تُستخدم للتكرار عبر قيم خريطة $form-validation-states لإنشاء أنماط التحقق من الصحة الخاصة بنا. أي تعديلات على خريطة Sass المذكورة أعلاه ستنعكس في ملف CSS المجمّع عبر هذه الحلقة.

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

التخصيص

يمكن تخصيص حالات التحقق من الصحة عبر الـ Sass باستخدام خريطة $form-validation-states. تقع هذه الخريطة في ملف _variables.scss، وهي الطريقة التي ننشئ بها حالات التحقق الافتراضية valid و invalid. تتضمن الخريطة خريطة متداخلة لتخصيص لون كل حالة، وأيقونتها، ولون تلميح الأداة، وظل التركيز. وبينما لا تدعم المتصفحات أي حالات أخرى، يمكن للمستخدمين الذين يستخدمون أنماطاً مخصصة إضافة ملاحظات نموذج أكثر تعقيداً بسهولة.