प्रमाणीकरणम्
HTML5 प्रपत्रसत्यापनेन सह स्वप्रयोक्तृभ्यः बहुमूल्यं, कार्ययोग्यं प्रतिक्रियां प्रदातव्यं, ब्राउजर् पूर्वनिर्धारितव्यवहारैः अथवा इष्टशैल्याः जावास्क्रिप्ट् च माध्यमेन।
कथं कार्यं करोति
अत्र Bootstrap इत्यनेन सह form validation कथं कार्यं करोति इति दर्शितम् अस्ति:
- HTML रूपस्य प्रमाणीकरणं CSS इत्यस्य छद्मवर्गद्वयस्य माध्यमेन प्रयुक्तं भवति,
:invalid
तथा च:valid
.<input>
,<select>
,<textarea>
तत्त्वेषु च प्रवर्तते । - Bootstrap the
:invalid
and:valid
styles to parent.was-validated
class को व्याप्त करता है, सामान्यतः<form>
. अन्यथा, मूल्यं विना किमपि आवश्यकं क्षेत्रं पृष्ठभारस्य समये अमान्यरूपेण दर्शयति । एवं प्रकारेण, भवान् तान् कदा सक्रियीकरणीयः इति चयनं कर्तुं शक्नोति (सामान्यतया प्रपत्रं प्रस्तूयितुं प्रयत्नस्य अनन्तरं) । - प्रपत्रस्य स्वरूपं पुनः सेट् कर्तुं (उदाहरणार्थं, AJAX इत्यस्य उपयोगेन गतिशीलरूपप्रस्तोतानां सन्दर्भे), प्रस्तुतीकरणानन्तरं पुनः
.was-validated
वर्गं निष्कासयन्तु<form>
- एकः fallback इति रूपेण,
.is-invalid
तथा च सर्वर-पक्षस्य प्रमाणीकरणार्थं.is-valid
छद्म-वर्गाणां स्थाने वर्गाः उपयोक्तुं शक्यन्ते . तेषां मातापितृवर्गस्य आवश्यकता नास्ति ।.was-validated
<label>
CSS कथं कार्यं करोति इति बाधानां कारणात्, वयं (वर्तमानकाले) custom JavaScript इत्यस्य साहाय्येन विना DOM मध्ये form control इत्यस्मात् पूर्वं आगच्छति इति styles प्रयोक्तुं न शक्नुमः ।- सर्वे आधुनिकब्राउजराः constraint validation API , रूपनियन्त्रणानां प्रमाणीकरणार्थं जावास्क्रिप्ट्-विधिनाम् एकां श्रृङ्खलां समर्थयन्ति ।
- प्रतिक्रियासन्देशाः ब्राउजर् पूर्वनिर्धारितं (प्रत्येकं ब्राउजर् कृते भिन्नं, तथा च CSS मार्गेण अशैली) अथवा अतिरिक्त HTML तथा CSS सह अस्माकं अनुकूलितप्रतिक्रियाशैल्याः उपयोगं कर्तुं शक्नुवन्ति।
setCustomValidity
भवान् जावास्क्रिप्ट् मध्ये सह इष्टवैधतासन्देशान् प्रदातुं शक्नोति ।
तत् मनसि कृत्वा, अस्माकं इष्टप्रपत्रसत्यापनशैल्याः, वैकल्पिकसर्वर-पक्षवर्गाणां, ब्राउजर्-पूर्वनिर्धारितानां च कृते निम्नलिखित-प्रदर्शनानि विचारयन्तु ।
कस्टम शैलियाँ
कस्टम् Bootstrap form validation messages कृते, भवद्भिः novalidate
स्वस्य <form>
. एतेन ब्राउजर् पूर्वनिर्धारितप्रतिक्रियासाधनसूचनानि अक्षमानि भवन्ति, परन्तु तदपि जावास्क्रिप्ट् मध्ये रूपसत्यापन एपिआइ - मध्ये प्रवेशः प्राप्यते । अधोलिखितं प्रपत्रं प्रस्तूयितुं प्रयतध्वम्; अस्माकं जावास्क्रिप्ट् submit बटनं अवरुद्ध्य भवद्भ्यः प्रतिक्रियां प्रसारयिष्यति। प्रस्तूयितुं प्रयतमाने, भवन्तः स्वस्य प्रपत्रनियन्त्रणेषु प्रयुक्तानि :invalid
and शैल्यानि पश्यन्ति ।: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
(() => {
'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)
})
})()
ब्राउज़र पूर्वनिर्धारित होता है
कस्टम् सत्यापनप्रतिक्रियासन्देशेषु अथवा रूपव्यवहारं परिवर्तयितुं जावास्क्रिप्ट् लिखितुं रुचिः नास्ति? सर्वं उत्तमम्, भवान् ब्राउजर् पूर्वनिर्धारितस्य उपयोगं कर्तुं शक्नोति। अधोलिखितं प्रपत्रं प्रस्तूयितुं प्रयतध्वम्। भवतः ब्राउजर् तथा OS इत्येतयोः आधारेण भवन्तः किञ्चित् भिन्नं प्रतिक्रियाशैलीं पश्यन्ति ।
यद्यपि एताः प्रतिक्रियाशैल्याः CSS इत्यनेन शैलीं कर्तुं न शक्यन्ते तथापि भवान् जावास्क्रिप्ट् मार्गेण प्रतिक्रियापाठं अनुकूलितुं शक्नोति ।
<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>
सर्वर पक्षः
वयं क्लायण्ट्-साइड्-सत्यापनस्य उपयोगं अनुशंसयामः, परन्तु यदि भवान् सर्वर-साइड्-सत्यापनस्य आवश्यकतां अनुभवति, तर्हि भवान् and इत्यनेन सह अमान्यं वैधं च प्रपत्रक्षेत्रं सूचयितुं .is-invalid
शक्नोति .is-valid
। ध्यानं कुर्वन्तु यत् .invalid-feedback
एतैः वर्गैः सह अपि समर्थितम् अस्ति ।
अमान्यक्षेत्राणां कृते, सुनिश्चितं कुर्वन्तु यत् अमान्यप्रतिक्रिया/त्रुटिसन्देशः उपयोगेन प्रासंगिकरूपक्षेत्रेण सह सम्बद्धः अस्ति aria-describedby
(अवलोकयतु यत् एतत् विशेषता एकादशाधिकं id
सन्दर्भयितुं शक्नोति, यद्यपि क्षेत्रं पूर्वमेव अतिरिक्तरूपपाठं दर्शयति)
border radius इत्यनेन सह समस्यां निवारयितुं , इनपुट् समूहानां कृते अतिरिक्तवर्गस्य आवश्यकता भवति .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 and<textarea>
s with.form-control
(निवेशसमूहेषु एकं यावत् सहितम्.form-control
)<select>
s सह.form-select
.form-check
स
<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
। अधोलिखिते उदाहरणे अस्माकं स्तम्भवर्गेषु एतत् पूर्वमेव अस्ति, परन्तु भवतः परियोजनायाः वैकल्पिकस्थापनस्य आवश्यकता भवितुम् अर्हति ।
<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 एकत्र संयोजिताः सन्ति, अस्माकं loop मार्गेण , अस्माकं form validation feedback styles जनयितुं ।
@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 map from _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
)
);
Maps of इत्यस्य $form-validation-states
टूल्टिप्स तथा फोकस शैल्याः अधिलिखितुं त्रीणि वैकल्पिकमापदण्डानि समाविष्टानि भवितुम् अर्हन्ति ।
परिक्रम
$form-validation-states
अस्माकं सत्यापनशैल्याः जनयितुं नक्शामूल्यानां उपरि पुनरावृत्तिं कर्तुं प्रयुक्तम् । उपर्युक्ते Sass मानचित्रे यत्किमपि परिवर्तनं भवति तत् अस्य लूप् मार्गेण भवतः संकलिते CSS मध्ये प्रतिबिम्बितम् भविष्यति ।
@each $state, $data in $form-validation-states {
@include form-validation-state($state, $data...);
}
अनुकूलित करना
$form-validation-states
मानचित्रणेन सह Sass मार्गेण प्रमाणीकरणस्थितयः अनुकूलितुं शक्यन्ते । अस्माकं सञ्चिकायां स्थितम् इदं Sass map अस्ति यत् वयं कथं default / validation states _variables.scss
जनयामः । प्रत्येकस्य राज्यस्य वर्णं, चिह्नं, टूलटिप् वर्णं, फोकस छाया च अनुकूलितुं नेस्टेड् मानचित्रं समाविष्टम् अस्ति । यद्यपि अन्ये कोऽपि राज्यः ब्राउजर् द्वारा समर्थितः नास्ति तथापि ये इष्टशैल्याः उपयोगं कुर्वन्ति ते सहजतया अधिकं जटिलं रूपप्रतिक्रियाम् योजयितुं शक्नुवन्ति ।valid
invalid