प्रमाणीकरण
ब्राउझर डीफॉल्ट वर्तन किंवा सानुकूल शैली आणि JavaScript द्वारे HTML5 फॉर्म प्रमाणीकरणासह आपल्या वापरकर्त्यांना मौल्यवान, कृती करण्यायोग्य अभिप्राय द्या.
हे कसे कार्य करते
बूटस्ट्रॅपसह फॉर्म प्रमाणीकरण कसे कार्य करते ते येथे आहे:
- HTML फॉर्म प्रमाणीकरण CSS च्या दोन छद्म-वर्गांद्वारे लागू केले जाते,
:invalid
आणि:valid
. हे<input>
,<select>
, आणि<textarea>
घटकांना लागू होते. - बूटस्ट्रॅप स्कोप
:invalid
आणि:valid
स्टाइल्स पॅरेंट.was-validated
क्लासमध्ये, सहसा वर लागू होते<form>
. अन्यथा, मूल्य नसलेले कोणतेही आवश्यक फील्ड पृष्ठ लोडवर अवैध म्हणून दर्शविले जाते. अशा प्रकारे, ते कधी सक्रिय करायचे ते तुम्ही निवडू शकता (सामान्यत: फॉर्म सबमिशनचा प्रयत्न केल्यानंतर). - फॉर्मचे स्वरूप रीसेट करण्यासाठी (उदाहरणार्थ, AJAX वापरून डायनॅमिक फॉर्म सबमिशनच्या बाबतीत), सबमिशननंतर पुन्हा
.was-validated
वर्ग काढून टाका.<form>
- फॉलबॅक म्हणून,
.is-invalid
आणि सर्व्हर-साइड प्रमाणीकरणासाठी.is-valid
स्यूडो-क्लासेसऐवजी वर्ग वापरले जाऊ शकतात . त्यांना पालक वर्गाची आवश्यकता नाही ..was-validated
- CSS कसे कार्य करते यातील अडथळ्यांमुळे,
<label>
सानुकूल JavaScript च्या मदतीशिवाय आम्ही DOM मध्ये फॉर्म कंट्रोलच्या आधी येणाऱ्या शैलींना (सध्या) शैली लागू करू शकत नाही. - सर्व आधुनिक ब्राउझर कंस्ट्रेंट व्हॅलिडेशन API चे समर्थन करतात , फॉर्म नियंत्रणे प्रमाणित करण्यासाठी JavaScript पद्धतींची मालिका.
- फीडबॅक मेसेज ब्राउझर डीफॉल्ट (प्रत्येक ब्राउझरसाठी वेगळे आणि CSS द्वारे अनस्टाइल केलेले) किंवा अतिरिक्त HTML आणि CSS सह आमच्या कस्टम फीडबॅक शैलींचा वापर करू शकतात.
setCustomValidity
तुम्ही JavaScript मध्ये सानुकूल वैधता संदेश देऊ शकता .
हे लक्षात घेऊन, आमच्या सानुकूल फॉर्म प्रमाणीकरण शैली, पर्यायी सर्व्हर-साइड वर्ग आणि ब्राउझर डीफॉल्टसाठी खालील डेमोचा विचार करा.
सानुकूल शैली
सानुकूल बूटस्ट्रॅप फॉर्म प्रमाणीकरण संदेशांसाठी, तुम्हाला novalidate
तुमच्या मध्ये बुलियन विशेषता जोडणे आवश्यक आहे <form>
. हे ब्राउझर डीफॉल्ट फीडबॅक टूलटिप्स अक्षम करते, परंतु तरीही JavaScript मधील फॉर्म प्रमाणीकरण API मध्ये प्रवेश प्रदान करते. खालील फॉर्म सबमिट करण्याचा प्रयत्न करा; आमची JavaScript सबमिट बटण रोखेल आणि फीडबॅक तुमच्यापर्यंत पोहोचवेल. सबमिट करण्याचा प्रयत्न करताना, तुम्हाला तुमच्या फॉर्म नियंत्रणांवर लागू केलेले :invalid
आणि शैली दिसतील.:valid
सानुकूल अभिप्राय शैली अभिप्राय अधिक चांगल्या प्रकारे संप्रेषण करण्यासाठी सानुकूल रंग, सीमा, फोकस शैली आणि पार्श्वभूमी चिन्हे लागू करतात. s साठी पार्श्वभूमी चिन्ह <select>
फक्त सोबत उपलब्ध आहेत .form-select
, आणि नाही .form-control
.
<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)
})
})()
ब्राउझर डीफॉल्ट
सानुकूल प्रमाणीकरण अभिप्राय संदेश किंवा फॉर्म वर्तन बदलण्यासाठी JavaScript लिहिण्यात स्वारस्य नाही? सर्व चांगले, आपण ब्राउझर डीफॉल्ट वापरू शकता. खालील फॉर्म सबमिट करण्याचा प्रयत्न करा. तुमचा ब्राउझर आणि OS वर अवलंबून, तुम्हाला फीडबॅकची थोडी वेगळी शैली दिसेल.
जरी या फीडबॅक शैली CSS सह शैलीबद्ध केल्या जाऊ शकत नाहीत, तरीही तुम्ही JavaScript द्वारे फीडबॅक मजकूर सानुकूलित करू शकता.
<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
वर्ग आवश्यक आहे.
<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>
सह.form-select
.form-check
s
<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>
टूलटिप्स
जर तुमचा फॉर्म लेआउट त्यास अनुमती देत असेल, तर तुम्ही स्टाइल केलेल्या टूलटिपमध्ये प्रमाणीकरण फीडबॅक प्रदर्शित .{valid|invalid}-feedback
करण्यासाठी वर्गांसाठी वर्गांची अदलाबदल करू शकता. टूलटिप पोझिशनिंगसाठी त्यावर .{valid|invalid}-tooltip
पालक असण्याची खात्री करा . position: relative
खालील उदाहरणामध्ये, आमच्या कॉलम क्लासमध्ये हे आधीच आहे, परंतु तुमच्या प्रोजेक्टला पर्यायी सेटअपची आवश्यकता असू शकते.
<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.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>");
मिक्सन्स
आमची फॉर्म व्हॅलिडेशन फीडबॅक शैली निर्माण करण्यासाठी, आमच्या लूपद्वारे , दोन मिक्सन्स एकत्र केले जातात .
@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;
}
}
}
}
नकाशा
हा वरील प्रमाणीकरण 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...);
}
सानुकूल करणे
$form-validation-states
प्रमाणीकरण स्थिती नकाशासह सास द्वारे सानुकूलित केल्या जाऊ शकतात . आमच्या _variables.scss
फाईलमध्ये स्थित, हा Sass नकाशा म्हणजे आम्ही डीफॉल्ट valid
/ invalid
प्रमाणीकरण स्थिती कशी निर्माण करतो. प्रत्येक राज्याचा रंग, चिन्ह, टूलटिप रंग आणि फोकस शॅडो सानुकूलित करण्यासाठी नेस्टेड नकाशा समाविष्ट केला आहे. इतर कोणतीही राज्ये ब्राउझरद्वारे समर्थित नसली तरी, सानुकूल शैली वापरणारे अधिक जटिल फॉर्म फीडबॅक सहज जोडू शकतात.
कृपया लक्षात घ्या की आम्ही मिक्सिनमध्ये $form-validation-states
बदल न करता मूल्येform-validation-state
सानुकूलित करण्याची शिफारस करत नाही .