Վավերացում
Տրամադրեք արժեքավոր, գործնական արձագանք ձեր օգտատերերին HTML5 ձևի վավերացման միջոցով՝ դիտարկիչի լռելյայն վարքագծերի կամ հատուկ ոճերի և JavaScript-ի միջոցով:
Ինչպես է դա աշխատում
Ահա, թե ինչպես է ձևի վավերացումը աշխատում Bootstrap-ի հետ.
- HTML ձևի վավերացումը կիրառվում է CSS-ի երկու կեղծ դասերի միջոցով
:invalid
և:valid
. Այն վերաբերում է<input>
,<select>
և<textarea>
տարրերին: - Bootstrap-ը ներառում է
:invalid
և:valid
ոճերը ծնող.was-validated
դասի համար, որը սովորաբար կիրառվում է<form>
. Հակառակ դեպքում, ցանկացած պահանջվող դաշտ առանց արժեքի ցուցադրվում է որպես անվավեր էջի բեռնման ժամանակ: Այսպիսով, դուք կարող եք ընտրել, թե երբ դրանք ակտիվացնեք (սովորաբար ձևը ներկայացնելուց հետո): - Ձևի տեսքը վերականգնելու համար (օրինակ, AJAX-ի օգտագործմամբ դինամիկ ձևերի ներկայացման դեպքում), ներկայացվելուց հետո նորից հեռացրեք
.was-validated
դասը :<form>
- Որպես հետադարձ,
.is-invalid
և.is-valid
դասերը կարող են օգտագործվել կեղծ դասերի փոխարեն սերվերի կողմից վավերացման համար : Նրանք չեն պահանջում.was-validated
ծնողական դասարան: - CSS-ի աշխատանքի սահմանափակումների պատճառով մենք (ներկայումս) չենք կարող ոճեր կիրառել
<label>
DOM-ում ձևի կառավարումից առաջ, առանց հատուկ JavaScript-ի օգնության: - Բոլոր ժամանակակից բրաուզերներն աջակցում են սահմանափակումների վավերացման API- ին, որը JavaScript-ի մի շարք մեթոդներ է՝ ձևերի վերահսկման վավերացման համար:
- Հետադարձ կապի հաղորդագրությունները կարող են օգտագործել զննարկիչի կանխադրված կարգավորումները (տարբեր յուրաքանչյուր դիտարկիչի համար և անկայուն CSS-ի միջոցով) կամ մեր հատուկ հետադարձ կապի ոճերը՝ լրացուցիչ HTML և CSS:
- Դուք կարող եք տրամադրել հատուկ վավերականության հաղորդագրություններ
setCustomValidity
JavaScript-ում:
Հաշվի առնելով դա՝ հաշվի առեք հետևյալ ցուցադրությունները՝ մեր հատուկ ձևերի վավերացման ոճերի, կամընտիր սերվերի կողմից դասերի և դիտարկիչի լռելյայնների համար:
Պատվերով ոճեր
Հատուկ Bootstrap ձևի վավերացման հաղորդագրությունների համար դուք պետք է ավելացնեք 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՝ ձևի վարքագիծը փոխելու համար: Ամեն ինչ լավ է, դուք կարող եք օգտագործել բրաուզերի կանխադրված կարգավորումները: Փորձեք ներկայացնել ստորև ներկայացված ձևը: Կախված ձեր դիտարկիչից և ՕՀ-ից, դուք կտեսնեք արձագանքի մի փոքր այլ ոճ:
Թեև հետադարձ կապի այս ոճերը չեն կարող ձևավորվել 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
ս
<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...);
}
Անհատականացում
Վավերացման վիճակները կարող են հարմարեցվել Sass-ի միջոցով $form-validation-states
քարտեզի հետ: Այս Sass քարտեզը, որը գտնվում է մեր _variables.scss
ֆայլում, այն է, թե ինչպես ենք մենք ստեղծում լռելյայն valid
/ invalid
վավերացման վիճակները: Ներառված է յուրաքանչյուր նահանգի գույնը, պատկերակը, գործիքի հուշման գույնը և ֆոկուսի ստվերը հարմարեցնելու համար տեղադրված քարտեզ: Թեև այլ պետություններ չեն աջակցվում բրաուզերների կողմից, նրանք, ովքեր օգտագործում են հատուկ ոճեր, կարող են հեշտությամբ ավելացնել ավելի բարդ ձևերի հետադարձ կապ:
Խնդրում ենք նկատի ունենալ, որ մենք խորհուրդ չենք տալիս հարմարեցնել $form-validation-states
արժեքները՝ առանց նաև form-validation-state
միքսինը փոփոխելու :