Veidlapas
Piemēri un lietošanas vadlīnijas veidlapu vadības stiliem, izkārtojuma opcijām un pielāgotiem komponentiem dažādu veidlapu izveidei.
Bootstrap veidlapu vadīklas paplašina mūsu Rebooted formu stilus ar klasēm. Izmantojiet šīs klases, lai izvēlētos to pielāgotos displejus konsekventākai atveidei visās pārlūkprogrammās un ierīcēs.
Noteikti izmantojiet atbilstošu type
atribūtu visās ievadēs (piemēram, email
e-pasta adresei vai number
skaitliskai informācijai), lai izmantotu jaunākas ievades vadīklas, piemēram, e-pasta verifikāciju, numura atlasi un citus.
Šeit ir īss piemērs Bootstrap veidlapu stilu demonstrēšanai. Turpiniet lasīt, lai iegūtu dokumentāciju par nepieciešamajām klasēm, veidlapu izkārtojumu un daudz ko citu.
<form>
<div class="form-group">
<label for="exampleInputEmail1">Email address</label>
<input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp" placeholder="Enter email">
<small id="emailHelp" class="form-text text-muted">We'll never share your email with anyone else.</small>
</div>
<div class="form-group">
<label for="exampleInputPassword1">Password</label>
<input type="password" class="form-control" id="exampleInputPassword1" placeholder="Password">
</div>
<div class="form-check">
<input type="checkbox" class="form-check-input" id="exampleCheck1">
<label class="form-check-label" for="exampleCheck1">Check me out</label>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</form>
Teksta formas vadīklas, piemēram <input>
, s, <select>
s un <textarea>
s, ir veidotas atbilstoši .form-control
klasei. Iekļauti stili vispārējam izskatam, fokusa stāvoklim, izmēram un citiem.
Noteikti izpētiet mūsu pielāgotās veidlapas , lai uzlabotu stilus <select>
.
<form>
<div class="form-group">
<label for="exampleFormControlInput1">Email address</label>
<input type="email" class="form-control" id="exampleFormControlInput1" placeholder="[email protected]">
</div>
<div class="form-group">
<label for="exampleFormControlSelect1">Example select</label>
<select class="form-control" id="exampleFormControlSelect1">
<option>1</option>
<option>2</option>
<option>3</option>
<option>4</option>
<option>5</option>
</select>
</div>
<div class="form-group">
<label for="exampleFormControlSelect2">Example multiple select</label>
<select multiple class="form-control" id="exampleFormControlSelect2">
<option>1</option>
<option>2</option>
<option>3</option>
<option>4</option>
<option>5</option>
</select>
</div>
<div class="form-group">
<label for="exampleFormControlTextarea1">Example textarea</label>
<textarea class="form-control" id="exampleFormControlTextarea1" rows="3"></textarea>
</div>
</form>
Failu ievadei nomainiet vērtību .form-control
pret .form-control-file
.
<form>
<div class="form-group">
<label for="exampleFormControlFile1">Example file input</label>
<input type="file" class="form-control-file" id="exampleFormControlFile1">
</div>
</form>
Iestatiet augstumus, izmantojot tādas klases kā .form-control-lg
un .form-control-sm
.
<input class="form-control form-control-lg" type="text" placeholder=".form-control-lg">
<input class="form-control" type="text" placeholder="Default input">
<input class="form-control form-control-sm" type="text" placeholder=".form-control-sm">
<select class="form-control form-control-lg">
<option>Large select</option>
</select>
<select class="form-control">
<option>Default select</option>
</select>
<select class="form-control form-control-sm">
<option>Small select</option>
</select>
Pievienojiet readonly
ievadei Būla atribūtu, lai novērstu ievades vērtības izmaiņas. Tikai lasāmās ievades šķiet gaišākas (tāpat kā atspējotas ievades), bet saglabā standarta kursoru.
<input class="form-control" type="text" placeholder="Readonly input here…" readonly>
Ja vēlaties, lai <input readonly>
elementi veidlapā tiktu veidoti kā vienkāršs teksts, izmantojiet .form-control-plaintext
klasi, lai noņemtu noklusējuma veidlapas lauka stilu un saglabātu pareizo piemaļu un polsterējumu.
<form>
<div class="form-group row">
<label for="staticEmail" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="text" readonly class="form-control-plaintext" id="staticEmail" value="[email protected]">
</div>
</div>
<div class="form-group row">
<label for="inputPassword" class="col-sm-2 col-form-label">Password</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword" placeholder="Password">
</div>
</div>
</form>
<form class="form-inline">
<div class="form-group mb-2">
<label for="staticEmail2" class="sr-only">Email</label>
<input type="text" readonly class="form-control-plaintext" id="staticEmail2" value="[email protected]">
</div>
<div class="form-group mx-sm-3 mb-2">
<label for="inputPassword2" class="sr-only">Password</label>
<input type="password" class="form-control" id="inputPassword2" placeholder="Password">
</div>
<button type="submit" class="btn btn-primary mb-2">Confirm identity</button>
</form>
Noklusējuma izvēles rūtiņas un radiouztvērēji tiek uzlaboti .form-check
, izmantojot vienu klasi abiem ievades veidiem, kas uzlabo to HTML elementu izkārtojumu un darbību . Izvēles rūtiņas ir paredzētas, lai sarakstā atlasītu vienu vai vairākas opcijas, savukārt radio ir paredzētas vienas opcijas atlasei no daudzām.
Atspējotās izvēles rūtiņas un radioaparāti tiek atbalstīti, taču, lai nodrošinātu not-allowed
kursoru virs vecākvirsmas <label>
, jums ir jāpievieno disabled
atribūts atribūtam .form-check-input
. Atspējotajam atribūtam tiks lietota gaišāka krāsa, lai palīdzētu norādīt ievades stāvokli.
Izvēles rūtiņas un radioaparāti ir izveidoti, lai atbalstītu uz HTML balstītu veidlapu validāciju un nodrošinātu kodolīgas, pieejamas etiķetes. Tādējādi mūsu <input>
s un s ir brāļu un māsu elementi , <label>
nevis iekšējie elementi . Tas ir nedaudz detalizētāks, jo jums ir jānorāda un atribūti, lai saistītu ar un .<input>
<label>
id
for
<input>
<label>
Pēc noklusējuma jebkurš izvēles rūtiņu un radioaparātu skaits, kas ir tiešās brālis, tiks novietoti vertikāli un atbilstoši izvietoti ar .form-check
.
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="defaultCheck1">
<label class="form-check-label" for="defaultCheck1">
Default checkbox
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="defaultCheck2" disabled>
<label class="form-check-label" for="defaultCheck2">
Disabled checkbox
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios1" value="option1" checked>
<label class="form-check-label" for="exampleRadios1">
Default radio
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios2" value="option2">
<label class="form-check-label" for="exampleRadios2">
Second default radio
</label>
</div>
<div class="form-check disabled">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios3" value="option3" disabled>
<label class="form-check-label" for="exampleRadios3">
Disabled radio
</label>
</div>
Grupējiet izvēles rūtiņas vai radio vienā un tajā pašā horizontālajā rindā, pievienojot .form-check-inline
jebkurai .form-check
.
<div class="form-check form-check-inline">
<input class="form-check-input" type="checkbox" id="inlineCheckbox1" value="option1">
<label class="form-check-label" for="inlineCheckbox1">1</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="checkbox" id="inlineCheckbox2" value="option2">
<label class="form-check-label" for="inlineCheckbox2">2</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="checkbox" id="inlineCheckbox3" value="option3" disabled>
<label class="form-check-label" for="inlineCheckbox3">3 (disabled)</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio1" value="option1">
<label class="form-check-label" for="inlineRadio1">1</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio2" value="option2">
<label class="form-check-label" for="inlineRadio2">2</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio3" value="option3" disabled>
<label class="form-check-label" for="inlineRadio3">3 (disabled)</label>
</div>
Pievienot .position-static
ievadēm, .form-check
kurām nav etiķetes teksta. Atcerieties nodrošināt kādu palīgtehnoloģiju etiķeti (piemēram, izmantojot aria-label
).
<div class="form-check">
<input class="form-check-input position-static" type="checkbox" id="blankCheckbox" value="option1" aria-label="...">
</div>
<div class="form-check">
<input class="form-check-input position-static" type="radio" name="blankRadio" id="blankRadio1" value="option1" aria-label="...">
</div>
Tā kā Bootstrap tiek lietots display: block
un width: 100%
gandrīz visām mūsu veidlapu vadīklām, veidlapas pēc noklusējuma tiks krautas vertikāli. Papildu klases var izmantot, lai mainītu šo izkārtojumu atkarībā no veidlapas.
Klase .form-group
ir vienkāršākais veids, kā veidlapām pievienot kādu struktūru. Tā nodrošina elastīgu klasi, kas mudina pareizi grupēt etiķetes, vadīklas, izvēles palīdzības tekstu un veidlapas validācijas ziņojumus. Pēc noklusējuma tas attiecas tikai uz margin-bottom
, taču pēc .form-inline
vajadzības tiek atlasīti papildu stili. Izmantojiet to ar <fieldset>
s, <div>
s vai gandrīz jebkuru citu elementu.
<form>
<div class="form-group">
<label for="formGroupExampleInput">Example label</label>
<input type="text" class="form-control" id="formGroupExampleInput" placeholder="Example input">
</div>
<div class="form-group">
<label for="formGroupExampleInput2">Another label</label>
<input type="text" class="form-control" id="formGroupExampleInput2" placeholder="Another input">
</div>
</form>
Sarežģītākas formas var izveidot, izmantojot mūsu režģa klases. Izmantojiet tos veidlapu izkārtojumiem, kuriem nepieciešamas vairākas kolonnas, dažādi platumi un papildu līdzināšanas opcijas.
<form>
<div class="row">
<div class="col">
<input type="text" class="form-control" placeholder="First name">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="Last name">
</div>
</div>
</form>
Varat arī apmainīt .row
pret .form-row
, mūsu standarta režģa rindas variantu, kas ignorē noklusējuma kolonnu notekas, lai iegūtu stingrākus un kompaktākus izkārtojumus.
<form>
<div class="form-row">
<div class="col">
<input type="text" class="form-control" placeholder="First name">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="Last name">
</div>
</div>
</form>
Ar režģa sistēmu var izveidot arī sarežģītākus izkārtojumus.
<form>
<div class="form-row">
<div class="form-group col-md-6">
<label for="inputEmail4">Email</label>
<input type="email" class="form-control" id="inputEmail4" placeholder="Email">
</div>
<div class="form-group col-md-6">
<label for="inputPassword4">Password</label>
<input type="password" class="form-control" id="inputPassword4" placeholder="Password">
</div>
</div>
<div class="form-group">
<label for="inputAddress">Address</label>
<input type="text" class="form-control" id="inputAddress" placeholder="1234 Main St">
</div>
<div class="form-group">
<label for="inputAddress2">Address 2</label>
<input type="text" class="form-control" id="inputAddress2" placeholder="Apartment, studio, or floor">
</div>
<div class="form-row">
<div class="form-group col-md-6">
<label for="inputCity">City</label>
<input type="text" class="form-control" id="inputCity">
</div>
<div class="form-group col-md-4">
<label for="inputState">State</label>
<select id="inputState" class="form-control">
<option selected>Choose...</option>
<option>...</option>
</select>
</div>
<div class="form-group col-md-2">
<label for="inputZip">Zip</label>
<input type="text" class="form-control" id="inputZip">
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="gridCheck">
<label class="form-check-label" for="gridCheck">
Check me out
</label>
</div>
</div>
<button type="submit" class="btn btn-primary">Sign in</button>
</form>
Izveidojiet horizontālas veidlapas ar režģi, pievienojot .row
klasi grupām un izmantojot .col-*-*
klases, lai norādītu iezīmju un vadīklu platumu. Noteikti pievienojiet .col-form-label
arī savas <label>
s, lai tās būtu vertikāli centrētas ar tām saistītajām veidlapu vadīklām.
Reizēm jums, iespējams, ir jāizmanto piemaļu vai polsterējuma utilītas, lai izveidotu vajadzīgo perfekto līdzinājumu. Piemēram, mēs esam noņēmuši padding-top
no mūsu salikto radio ievades etiķetes, lai labāk saskaņotu teksta bāzes līniju.
<form>
<div class="form-group row">
<label for="inputEmail3" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control" id="inputEmail3" placeholder="Email">
</div>
</div>
<div class="form-group row">
<label for="inputPassword3" class="col-sm-2 col-form-label">Password</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword3" placeholder="Password">
</div>
</div>
<fieldset class="form-group">
<div class="row">
<legend class="col-form-label col-sm-2 pt-0">Radios</legend>
<div class="col-sm-10">
<div class="form-check">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios1" value="option1" checked>
<label class="form-check-label" for="gridRadios1">
First radio
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios2" value="option2">
<label class="form-check-label" for="gridRadios2">
Second radio
</label>
</div>
<div class="form-check disabled">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios3" value="option3" disabled>
<label class="form-check-label" for="gridRadios3">
Third disabled radio
</label>
</div>
</div>
</div>
</fieldset>
<div class="form-group row">
<div class="col-sm-2">Checkbox</div>
<div class="col-sm-10">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="gridCheck1">
<label class="form-check-label" for="gridCheck1">
Example checkbox
</label>
</div>
</div>
</div>
<div class="form-group row">
<div class="col-sm-10">
<button type="submit" class="btn btn-primary">Sign in</button>
</div>
</div>
</form>
Noteikti izmantojiet .col-form-label-sm
vai .col-form-label-lg
savam <label>
s vai s, lai pareizi ievērotu un <legend>
izmēru ..form-control-lg
.form-control-sm
<form>
<div class="form-group row">
<label for="colFormLabelSm" class="col-sm-2 col-form-label col-form-label-sm">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control form-control-sm" id="colFormLabelSm" placeholder="col-form-label-sm">
</div>
</div>
<div class="form-group row">
<label for="colFormLabel" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control" id="colFormLabel" placeholder="col-form-label">
</div>
</div>
<div class="form-group row">
<label for="colFormLabelLg" class="col-sm-2 col-form-label col-form-label-lg">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control form-control-lg" id="colFormLabelLg" placeholder="col-form-label-lg">
</div>
</div>
</form>
Kā parādīts iepriekšējos piemēros, mūsu režģa sistēma ļauj ievietot jebkuru .col
s skaitu a .row
vai .form-row
. Viņi sadalīs pieejamo platumu vienādi. Varat arī izvēlēties sleju apakškopu, lai tā aizņemtu vairāk vai mazāk vietas, bet atlikušās .col
s vienādi sadala pārējās, izmantojot noteiktas kolonnu klases, piemēram, .col-7
.
<form>
<div class="form-row">
<div class="col-7">
<input type="text" class="form-control" placeholder="City">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="State">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="Zip">
</div>
</div>
</form>
Tālāk sniegtajā piemērā tiek izmantota flexbox utilīta, lai vertikāli centrētu saturu un mainītu tā, .col
lai .col-auto
kolonnas aizņemtu tikai tik daudz vietas, cik nepieciešams. Citiem vārdiem sakot, kolonnas izmērs tiek noteikts atkarībā no satura.
<form>
<div class="form-row align-items-center">
<div class="col-auto">
<label class="sr-only" for="inlineFormInput">Name</label>
<input type="text" class="form-control mb-2" id="inlineFormInput" placeholder="Jane Doe">
</div>
<div class="col-auto">
<label class="sr-only" for="inlineFormInputGroup">Username</label>
<div class="input-group mb-2">
<div class="input-group-prepend">
<div class="input-group-text">@</div>
</div>
<input type="text" class="form-control" id="inlineFormInputGroup" placeholder="Username">
</div>
</div>
<div class="col-auto">
<div class="form-check mb-2">
<input class="form-check-input" type="checkbox" id="autoSizingCheck">
<label class="form-check-label" for="autoSizingCheck">
Remember me
</label>
</div>
</div>
<div class="col-auto">
<button type="submit" class="btn btn-primary mb-2">Submit</button>
</div>
</div>
</form>
Pēc tam varat to vēlreiz sajaukt ar lieluma kolonnu klasēm.
<form>
<div class="form-row align-items-center">
<div class="col-sm-3 my-1">
<label class="sr-only" for="inlineFormInputName">Name</label>
<input type="text" class="form-control" id="inlineFormInputName" placeholder="Jane Doe">
</div>
<div class="col-sm-3 my-1">
<label class="sr-only" for="inlineFormInputGroupUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<div class="input-group-text">@</div>
</div>
<input type="text" class="form-control" id="inlineFormInputGroupUsername" placeholder="Username">
</div>
</div>
<div class="col-auto my-1">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="autoSizingCheck2">
<label class="form-check-label" for="autoSizingCheck2">
Remember me
</label>
</div>
</div>
<div class="col-auto my-1">
<button type="submit" class="btn btn-primary">Submit</button>
</div>
</div>
</form>
Un, protams, tiek atbalstītas pielāgotas veidlapas vadīklas .
<form>
<div class="form-row align-items-center">
<div class="col-auto my-1">
<label class="mr-sm-2" for="inlineFormCustomSelect">Preference</label>
<select class="custom-select mr-sm-2" id="inlineFormCustomSelect">
<option selected>Choose...</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
</div>
<div class="col-auto my-1">
<div class="custom-control custom-checkbox mr-sm-2">
<input type="checkbox" class="custom-control-input" id="customControlAutosizing">
<label class="custom-control-label" for="customControlAutosizing">Remember my preference</label>
</div>
</div>
<div class="col-auto my-1">
<button type="submit" class="btn btn-primary">Submit</button>
</div>
</div>
</form>
Izmantojiet .form-inline
klasi, lai vienā horizontālā rindā parādītu vairākas etiķetes, veidlapas vadīklas un pogas. Veidlapu vadīklas iekļautajās veidlapās nedaudz atšķiras no to noklusējuma stāvokļiem.
- Vadīklas ir
display: flex
, sakļaujot jebkuru HTML balto atstarpi un ļaujot nodrošināt līdzinājuma kontroli ar atstarpēm un flexbox utilītiem. - Vadīklas un ievades grupas saņem
width: auto
, lai ignorētu Bootstrap noklusējuma iestatījumuswidth: 100%
. - Vadības elementi tiek rādīti iekļauti tikai tajos skatu laukos, kuru platums ir vismaz 576 pikseļi , lai ņemtu vērā šauros skatu logus mobilajās ierīcēs.
Iespējams, jums būs manuāli jārisina atsevišķu veidlapu vadīklu platums un līdzinājums, izmantojot atstarpju utilītus (kā parādīts tālāk). Visbeidzot, katrā veidlapas vadīklā vienmēr iekļaujiet <label>
simbolu, pat ja vēlaties to paslēpt no apmeklētājiem, kuri nav ekrāna lasītāji, izmantojot .sr-only
.
<form class="form-inline">
<label class="sr-only" for="inlineFormInputName2">Name</label>
<input type="text" class="form-control mb-2 mr-sm-2" id="inlineFormInputName2" placeholder="Jane Doe">
<label class="sr-only" for="inlineFormInputGroupUsername2">Username</label>
<div class="input-group mb-2 mr-sm-2">
<div class="input-group-prepend">
<div class="input-group-text">@</div>
</div>
<input type="text" class="form-control" id="inlineFormInputGroupUsername2" placeholder="Username">
</div>
<div class="form-check mb-2 mr-sm-2">
<input class="form-check-input" type="checkbox" id="inlineFormCheck">
<label class="form-check-label" for="inlineFormCheck">
Remember me
</label>
</div>
<button type="submit" class="btn btn-primary mb-2">Submit</button>
</form>
Tiek atbalstītas arī pielāgotas veidlapas vadīklas un atlases.
<form class="form-inline">
<label class="my-1 mr-2" for="inlineFormCustomSelectPref">Preference</label>
<select class="custom-select my-1 mr-sm-2" id="inlineFormCustomSelectPref">
<option selected>Choose...</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<div class="custom-control custom-checkbox my-1 mr-sm-2">
<input type="checkbox" class="custom-control-input" id="customControlInline">
<label class="custom-control-label" for="customControlInline">Remember my preference</label>
</div>
<button type="submit" class="btn btn-primary my-1">Submit</button>
</form>
Alternatīvas slēptajām etiķetēm
Palīgtehnoloģijām, piemēram, ekrāna lasītājiem, būs problēmas ar jūsu veidlapām, ja katrai ievadei neiekļausiet etiķeti. Šo iekļauto veidlapu etiķetes varat paslēpt, izmantojot .sr-only
klasi. Ir arī citas alternatīvas metodes, kā nodrošināt marķējumu palīgtehnoloģijām, piemēram, aria-label
, aria-labelledby
vai title
atribūts. Ja neviena no tām nav, palīgtehnoloģijas var izmantot placeholder
atribūtu, ja tāds ir, taču ņemiet vērā, ka placeholder
nav ieteicams to izmantot kā citu marķēšanas metožu aizstājēju.
Bloka līmeņa palīdzības tekstu veidlapās var izveidot, izmantojot .form-text
(iepriekš zināms kā .help-block
v3). Iekļauto palīdzības tekstu var elastīgi ieviest, izmantojot jebkuru iekļauto HTML elementu un utilītu klases, piemēram, .text-muted
.
Palīdzības teksta saistīšana ar veidlapas vadīklām
Palīdzības tekstam jābūt skaidri saistītam ar formas vadīklu, kas ir saistīta ar aria-describedby
atribūta lietošanu. Tas nodrošinās, ka palīgtehnoloģijas, piemēram, ekrāna lasītāji, paziņos šo palīdzības tekstu, kad lietotājs fokusēsies vai ievadīs vadīklu.
Palīdzības tekstu zem ievades var veidot ar .form-text
. Šī klase ietver display: block
un pievieno dažas augšējās piemales, lai atvieglotu atstarpi no iepriekš norādītajām ievadēm.
<label for="inputPassword5">Password</label>
<input type="password" id="inputPassword5" class="form-control" aria-describedby="passwordHelpBlock">
<small id="passwordHelpBlock" class="form-text text-muted">
Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
</small>
Iekļautajā tekstā var izmantot jebkuru tipisku iekļauto HTML elementu (vai tas būtu <small>
, <span>
, vai kaut kas cits) ar lietderības klasi.
<form class="form-inline">
<div class="form-group">
<label for="inputPassword6">Password</label>
<input type="password" id="inputPassword6" class="form-control mx-sm-3" aria-describedby="passwordHelpInline">
<small id="passwordHelpInline" class="text-muted">
Must be 8-20 characters long.
</small>
</div>
</form>
Pievienojiet disabled
ievadei Būla atribūtu, lai novērstu lietotāja mijiedarbību un padarītu to gaišāku.
Pievienojiet disabled
atribūtu a <fieldset>
, lai atspējotu visas vadīklas.
<form>
<fieldset disabled>
<div class="form-group">
<label for="disabledTextInput">Disabled input</label>
<input type="text" id="disabledTextInput" class="form-control" placeholder="Disabled input">
</div>
<div class="form-group">
<label for="disabledSelect">Disabled select menu</label>
<select id="disabledSelect" class="form-control">
<option>Disabled select</option>
</select>
</div>
<div class="form-check">
<input class="form-check-input" type="checkbox" id="disabledFieldsetCheck" disabled>
<label class="form-check-label" for="disabledFieldsetCheck">
Can't check this
</label>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</fieldset>
</form>
Brīdinājums ar enkuriem
<input>
Pēc noklusējuma pārlūkprogrammas visas vietējās veidlapas vadīklas ( un elementus) apstrādās <select>
kā atspējotas, novēršot gan tastatūras, gan peles mijiedarbību. Tomēr, ja jūsu veidlapā ir iekļauti arī elementi, tiem tiks piešķirts tikai stils . Kā norādīts sadaļā par pogu atspējošanas stāvokli (un īpaši enkura elementu apakšsadaļā), šis CSS rekvizīts vēl nav standartizēts un netiek pilnībā atbalstīts operētājsistēmā Opera 18 un jaunākās versijās, kā arī pārlūkprogrammā Internet Explorer 10, un ieguva. neliedz tastatūras lietotājiem fokusēt vai aktivizēt šīs saites. Tāpēc drošības labad izmantojiet pielāgotu JavaScript, lai atspējotu šādas saites.<button>
<fieldset disabled>
<a ... class="btn btn-*">
pointer-events: none
Saderība starp pārlūkprogrammām
Lai gan Bootstrap lietos šos stilus visās pārlūkprogrammās, pārlūkprogramma Internet Explorer 11 un vecākas versijas pilnībā neatbalsta disabled
atribūtu <fieldset>
. Izmantojiet pielāgotu JavaScript, lai atspējotu lauku kopu šajās pārlūkprogrammās.
Sniedziet lietotājiem vērtīgas, praktiskas atsauksmes, izmantojot HTML5 veidlapu validāciju — tā ir pieejama visās mūsu atbalstītajās pārlūkprogrammās . Izvēlieties kādu no pārlūkprogrammas noklusējuma validācijas atsauksmēm vai ieviesiet pielāgotus ziņojumus, izmantojot mūsu iebūvētās klases un iesācēju JavaScript.
Mēs ļoti iesakām pielāgotus validācijas stilus, jo sākotnējās pārlūkprogrammas noklusējuma iestatījumi netiek paziņoti ekrāna lasītājiem.
Lūk, kā veidlapu validācija darbojas ar Bootstrap:
- HTML veidlapas validācija tiek lietota, izmantojot divas CSS pseidoklases
:invalid
un:valid
. Tas attiecas uz<input>
,<select>
un<textarea>
elementiem. - Bootstrap aptver
:invalid
un:valid
stilus uz vecāku.was-validated
klasi, kas parasti tiek lietots<form>
. Pretējā gadījumā jebkurš obligātais lauks bez vērtības lapas ielādes laikā tiek rādīts kā nederīgs. Tādā veidā jūs varat izvēlēties, kad tās aktivizēt (parasti pēc veidlapas iesniegšanas mēģinājuma). - Kā rezerves,
.is-invalid
un.is-valid
klases var izmantot pseidoklases vietā servera puses validācijai . Viņiem nav nepieciešama.was-validated
vecāku klase. - CSS darbības ierobežojumu dēļ mēs (pašlaik) nevaram lietot stilus,
<label>
kas atrodas pirms veidlapas vadīklas DOM, neizmantojot pielāgotu JavaScript. - Visas mūsdienu pārlūkprogrammas atbalsta ierobežojumu validācijas API — JavaScript metožu sēriju veidlapu vadīklu apstiprināšanai.
- Atsauksmju ziņojumos var tikt izmantoti pārlūkprogrammas noklusējuma iestatījumi (atšķirīgi katrā pārlūkprogrammā un nav stilizēti, izmantojot CSS) vai mūsu pielāgotie atsauksmju stili ar papildu HTML un CSS.
- Varat nodrošināt pielāgotus derīguma ziņojumus ar
setCustomValidity
JavaScript.
Paturot to prātā, apsveriet tālāk norādītās demonstrācijas par mūsu pielāgotajiem veidlapu validācijas stiliem, papildu servera sānu klasēm un pārlūkprogrammas noklusējuma iestatījumiem.
Pielāgotiem Bootstrap veidlapas validācijas ziņojumiem jums būs jāpievieno novalidate
Būla atribūts savam <form>
. Tādējādi tiek atspējoti pārlūkprogrammas noklusējuma atsauksmju rīka padomi, taču joprojām tiek nodrošināta piekļuve veidlapu validācijas API JavaScript. Mēģiniet iesniegt zemāk esošo veidlapu; mūsu JavaScript pārtvers iesniegšanas pogu un nosūtīs jums atsauksmes.
Mēģinot iesniegt, jūs redzēsit veidlapas vadīklām piemērotos stilus :invalid
un .:valid
<form class="needs-validation" novalidate>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationCustom01">First name</label>
<input type="text" class="form-control" id="validationCustom01" placeholder="First name" value="Mark" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationCustom02">Last name</label>
<input type="text" class="form-control" id="validationCustom02" placeholder="Last name" value="Otto" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationCustomUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend">@</span>
</div>
<input type="text" class="form-control" id="validationCustomUsername" placeholder="Username" aria-describedby="inputGroupPrepend" required>
<div class="invalid-feedback">
Please choose a username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationCustom03">City</label>
<input type="text" class="form-control" id="validationCustom03" placeholder="City" required>
<div class="invalid-feedback">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationCustom04">State</label>
<input type="text" class="form-control" id="validationCustom04" placeholder="State" required>
<div class="invalid-feedback">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationCustom05">Zip</label>
<input type="text" class="form-control" id="validationCustom05" placeholder="Zip" required>
<div class="invalid-feedback">
Please provide a valid zip.
</div>
</div>
</div>
<div class="form-group">
<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>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
<script>
// Example starter JavaScript for disabling form submissions if there are invalid fields
(function() {
'use strict';
window.addEventListener('load', function() {
// Fetch all the forms we want to apply custom Bootstrap validation styles to
var forms = document.getElementsByClassName('needs-validation');
// Loop over them and prevent submission
var validation = Array.prototype.filter.call(forms, function(form) {
form.addEventListener('submit', function(event) {
if (form.checkValidity() === false) {
event.preventDefault();
event.stopPropagation();
}
form.classList.add('was-validated');
}, false);
});
}, false);
})();
</script>
Vai neinteresē pielāgotas validācijas atgriezeniskās saites ziņojumi vai JavaScript rakstīšana, lai mainītu veidlapas darbību? Viss kārtībā, varat izmantot pārlūkprogrammas noklusējuma iestatījumus. Mēģiniet iesniegt zemāk esošo veidlapu. Atkarībā no pārlūkprogrammas un operētājsistēmas jūs redzēsit nedaudz atšķirīgu atsauksmju stilu.
Lai gan šos atsauksmju stilus nevar veidot ar CSS, jūs joprojām varat pielāgot atsauksmju tekstu, izmantojot JavaScript.
<form>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationDefault01">First name</label>
<input type="text" class="form-control" id="validationDefault01" placeholder="First name" value="Mark" required>
</div>
<div class="col-md-4 mb-3">
<label for="validationDefault02">Last name</label>
<input type="text" class="form-control" id="validationDefault02" placeholder="Last name" value="Otto" required>
</div>
<div class="col-md-4 mb-3">
<label for="validationDefaultUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend2">@</span>
</div>
<input type="text" class="form-control" id="validationDefaultUsername" placeholder="Username" aria-describedby="inputGroupPrepend2" required>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationDefault03">City</label>
<input type="text" class="form-control" id="validationDefault03" placeholder="City" required>
</div>
<div class="col-md-3 mb-3">
<label for="validationDefault04">State</label>
<input type="text" class="form-control" id="validationDefault04" placeholder="State" required>
</div>
<div class="col-md-3 mb-3">
<label for="validationDefault05">Zip</label>
<input type="text" class="form-control" id="validationDefault05" placeholder="Zip" required>
</div>
</div>
<div class="form-group">
<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>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Mēs iesakām izmantot klienta puses validāciju, taču, ja jums ir nepieciešama servera puse, varat norādīt nederīgus un derīgus veidlapas laukus ar .is-invalid
un .is-valid
. Ņemiet vērā, ka .invalid-feedback
tas tiek atbalstīts arī šajās klasēs.
<form>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationServer01">First name</label>
<input type="text" class="form-control is-valid" id="validationServer01" placeholder="First name" value="Mark" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationServer02">Last name</label>
<input type="text" class="form-control is-valid" id="validationServer02" placeholder="Last name" value="Otto" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationServerUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend3">@</span>
</div>
<input type="text" class="form-control is-invalid" id="validationServerUsername" placeholder="Username" aria-describedby="inputGroupPrepend3" required>
<div class="invalid-feedback">
Please choose a username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationServer03">City</label>
<input type="text" class="form-control is-invalid" id="validationServer03" placeholder="City" required>
<div class="invalid-feedback">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationServer04">State</label>
<input type="text" class="form-control is-invalid" id="validationServer04" placeholder="State" required>
<div class="invalid-feedback">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationServer05">Zip</label>
<input type="text" class="form-control is-invalid" id="validationServer05" placeholder="Zip" required>
<div class="invalid-feedback">
Please provide a valid zip.
</div>
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input is-invalid" type="checkbox" value="" id="invalidCheck3" required>
<label class="form-check-label" for="invalidCheck3">
Agree to terms and conditions
</label>
<div class="invalid-feedback">
You must agree before submitting.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Mūsu veidlapu piemēros ir redzamas iepriekš minētās vietējās teksta formas <input>
, taču veidlapu validācijas stili ir pieejami arī mūsu pielāgotajām veidlapu vadīklām.
<form class="was-validated">
<div class="custom-control custom-checkbox mb-3">
<input type="checkbox" class="custom-control-input" id="customControlValidation1" required>
<label class="custom-control-label" for="customControlValidation1">Check this custom checkbox</label>
<div class="invalid-feedback">Example invalid feedback text</div>
</div>
<div class="custom-control custom-radio">
<input type="radio" class="custom-control-input" id="customControlValidation2" name="radio-stacked" required>
<label class="custom-control-label" for="customControlValidation2">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio mb-3">
<input type="radio" class="custom-control-input" id="customControlValidation3" name="radio-stacked" required>
<label class="custom-control-label" for="customControlValidation3">Or toggle this other custom radio</label>
<div class="invalid-feedback">More example invalid feedback text</div>
</div>
<div class="form-group">
<select class="custom-select" required>
<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 custom select feedback</div>
</div>
<div class="custom-file">
<input type="file" class="custom-file-input" id="validatedCustomFile" required>
<label class="custom-file-label" for="validatedCustomFile">Choose file...</label>
<div class="invalid-feedback">Example invalid custom file feedback</div>
</div>
</form>
Ja jūsu veidlapas izkārtojums to atļauj, varat apmainīt .{valid|invalid}-feedback
klases pret .{valid|invalid}-tooltip
klasēm, lai parādītu validācijas atsauksmes stila rīka padomos. position: relative
Rīka padoma pozicionēšanai noteikti ir jābūt kādam no vecākiem . Tālāk esošajā piemērā mūsu kolonnu klasēs tas jau ir, taču jūsu projektam var būt nepieciešama alternatīva iestatīšana.
<form class="needs-validation" novalidate>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationTooltip01">First name</label>
<input type="text" class="form-control" id="validationTooltip01" placeholder="First name" value="Mark" required>
<div class="valid-tooltip">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationTooltip02">Last name</label>
<input type="text" class="form-control" id="validationTooltip02" placeholder="Last name" value="Otto" required>
<div class="valid-tooltip">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationTooltipUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="validationTooltipUsernamePrepend">@</span>
</div>
<input type="text" class="form-control" id="validationTooltipUsername" placeholder="Username" aria-describedby="validationTooltipUsernamePrepend" required>
<div class="invalid-tooltip">
Please choose a unique and valid username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationTooltip03">City</label>
<input type="text" class="form-control" id="validationTooltip03" placeholder="City" required>
<div class="invalid-tooltip">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationTooltip04">State</label>
<input type="text" class="form-control" id="validationTooltip04" placeholder="State" required>
<div class="invalid-tooltip">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationTooltip05">Zip</label>
<input type="text" class="form-control" id="validationTooltip05" placeholder="Zip" required>
<div class="invalid-tooltip">
Please provide a valid zip.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Lai nodrošinātu vēl lielāku pielāgošanu un vairāku pārlūkprogrammu konsekvenci, izmantojiet mūsu pilnībā pielāgotos veidlapas elementus, lai aizstātu pārlūkprogrammas noklusējuma iestatījumus. Tie ir veidoti, pamatojoties uz semantisku un pieejamu marķējumu, tāpēc tie lieliski aizstāj jebkuru noklusējuma veidlapu vadīklu.
Katra izvēles rūtiņa un radio ir iesaiņoti a <div>
ar brāli <span>
, lai izveidotu mūsu pielāgoto vadīklu un a <label>
pavadošajam tekstam. Strukturāli šī ir tāda pati pieeja kā mūsu noklusējuma pieeja .form-check
.
Mēs izmantojam brāļa atlasītāju ( ~
) visiem mūsu <input>
stāvokļiem, piemēram, :checked
lai pareizi izveidotu pielāgotās veidlapas indikatoru. Apvienojot ar .custom-control-label
klasi, mēs varam arī veidot katra vienuma teksta stilu, pamatojoties uz statusu <input>
.
Mēs slēpjam noklusējuma vērtību <input>
ar opacity
un izmantojam, .custom-control-label
lai tā vietā izveidotu jaunu pielāgotas formas indikatoru ar ::before
un ::after
. Diemžēl mēs nevaram izveidot pielāgotu elementu tikai no šī elementa, <input>
jo CSS content
nedarbojas ar šo elementu.
Atzīmētajos stāvokļos mēs izmantojam base64 iegultās SVG ikonas no Open Iconic . Tādējādi mēs varam vislabāk kontrolēt stilu un pozicionēšanu dažādās pārlūkprogrammās un ierīcēs.
<div class="custom-control custom-checkbox">
<input type="checkbox" class="custom-control-input" id="customCheck1">
<label class="custom-control-label" for="customCheck1">Check this custom checkbox</label>
</div>
Pielāgotās izvēles rūtiņas var izmantot arī :indeterminate
pseidoklasi, ja tās ir manuāli iestatītas, izmantojot JavaScript (nav pieejams HTML atribūts, lai to norādītu).
Ja izmantojat jQuery, vajadzētu pietikt ar kaut ko līdzīgu:
<div class="custom-control custom-radio">
<input type="radio" id="customRadio1" name="customRadio" class="custom-control-input">
<label class="custom-control-label" for="customRadio1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio">
<input type="radio" id="customRadio2" name="customRadio" class="custom-control-input">
<label class="custom-control-label" for="customRadio2">Or toggle this other custom radio</label>
</div>
<div class="custom-control custom-radio custom-control-inline">
<input type="radio" id="customRadioInline1" name="customRadioInline1" class="custom-control-input">
<label class="custom-control-label" for="customRadioInline1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio custom-control-inline">
<input type="radio" id="customRadioInline2" name="customRadioInline1" class="custom-control-input">
<label class="custom-control-label" for="customRadioInline2">Or toggle this other custom radio</label>
</div>
Var atspējot arī pielāgotās izvēles rūtiņas un radio. Pievienojiet disabled
Būla atribūtu, <input>
un pielāgotais indikators un etiķetes apraksts tiks automātiski veidoti.
<div class="custom-control custom-checkbox">
<input type="checkbox" class="custom-control-input" id="customCheckDisabled" disabled>
<label class="custom-control-label" for="customCheckDisabled">Check this custom checkbox</label>
</div>
<div class="custom-control custom-radio">
<input type="radio" id="radio3" name="radioDisabled" id="customRadioDisabled" class="custom-control-input" disabled>
<label class="custom-control-label" for="customRadioDisabled">Toggle this custom radio</label>
</div>
Pielāgotajām <select>
izvēlnēm ir nepieciešama tikai pielāgota klase, .custom-select
lai aktivizētu pielāgotos stilus.
<select class="custom-select">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
Varat arī izvēlēties no maziem un lieliem pielāgotajiem atlases veidiem, lai tie atbilstu mūsu līdzīgā izmēra teksta ievadei.
<select class="custom-select custom-select-lg mb-3">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<select class="custom-select custom-select-sm">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
Tiek multiple
atbalstīts arī atribūts:
<select class="custom-select" multiple>
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
Tāpat kā size
atribūts:
<select class="custom-select" size="3">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
Faila ievade ir visizplatītākā, un tai ir nepieciešams papildu JavaScript, ja vēlaties tos saistīt ar funkcionālu Izvēlēties failu… un atlasītā faila nosaukuma tekstu.
<div class="custom-file">
<input type="file" class="custom-file-input" id="customFile">
<label class="custom-file-label" for="customFile">Choose file</label>
</div>
Mēs slēpjam noklusējuma failu <input>
, izmantojot opacity
un tā vietā veidojam <label>
. Poga tiek ģenerēta un novietota ar ::after
. Visbeidzot, mēs paziņojam width
par height
pareizu <input>
atstarpi apkārtējam saturam.
Pseidoklase :lang()
tiek izmantota, lai “Pārlūkot” tekstu varētu tulkot citās valodās. Ignorēt vai pievienot $custom-file-text
Sass mainīgā ierakstus ar atbilstošo valodas tagu un lokalizētām virknēm. Angļu valodas stīgas var pielāgot tādā pašā veidā. Piemēram, šādi var pievienot tulkojumu spāņu valodā (spāņu valodas kods ir es
):
Lūk lang(es)
, kā pielāgotā faila ievade spāņu valodas tulkojumam:
<div class="custom-file">
<input type="file" class="custom-file-input" id="customFileLang" lang="es">
<label class="custom-file-label" for="customFileLang">Seleccionar Archivo</label>
</div>
Lai tiktu parādīts pareizais teksts, jums ir pareizi jāiestata sava dokumenta (vai tā apakškoka) valoda. To var izdarīt, izmantojot elementa atribūtu lang
vai<html>
HTTP Content-Language
galveni , kā arī citas metodes.