Obrasci
Primjeri i smjernice za korištenje stilova kontrole obrazaca, opcija izgleda i prilagođenih komponenti za stvaranje širokog spektra obrazaca.
Bootstrapove kontrole obrazaca proširuju naše Rebooted stilove obrazaca s klasama. Upotrijebite ove klase da biste se uključili u njihove prilagođene prikaze za dosljednije prikazivanje na svim preglednicima i uređajima.
Obavezno upotrijebite odgovarajući type
atribut na svim unosima (npr. email
za adresu e-pošte ili number
za numeričke informacije) kako biste iskoristili prednosti novijih kontrola unosa kao što su potvrda e-pošte, odabir broja i više.
Evo kratkog primjera za demonstraciju stilova obrasca Bootstrapa. Nastavite čitati za dokumentaciju o potrebnim razredima, izgledu obrazaca i više.
<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>
Kontrole tekstualnog obrasca - poput <input>
s, <select>
s i <textarea>
s - stiliziraju se s .form-control
klasom. Uključeni su stilovi za opći izgled, stanje fokusa, veličinu i još mnogo toga.
Obavezno istražite naše prilagođene obrasce za daljnji stil <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>
Za unos datoteka zamijenite .form-control
za .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>
Postavite visine koristeći klase poput .form-control-lg
i .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>
Dodajte readonly
booleov atribut na unos kako biste spriječili promjenu vrijednosti unosa. Unosi samo za čitanje izgledaju svjetlije (baš kao i onemogućeni ulazi), ali zadržavaju standardni kursor.
<input class="form-control" type="text" placeholder="Readonly input here…" readonly>
Ako želite da <input readonly>
elementi u vašem obrascu budu oblikovani kao običan tekst, upotrijebite .form-control-plaintext
klasu za uklanjanje zadanog stila polja obrasca i očuvanje ispravne margine i ispune.
<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>
Zadani potvrdni okviri i radio stanice poboljšani su uz pomoć .form-check
jedne klase za obje vrste unosa koja poboljšava izgled i ponašanje njihovih HTML elemenata . Potvrdni okviri služe za odabir jedne ili više opcija na popisu, dok radiji služe za odabir jedne opcije od više njih.
Onemogućeni potvrdni okviri i radio su podržani, ali da biste osigurali not-allowed
kursor pri lebdenju iznad nadređenog <label>
, morat ćete dodati disabled
atribut u .form-check-input
. Onemogućeni atribut će primijeniti svjetliju boju kako bi lakše označio stanje unosa.
Potvrdni okviri i korištenje radija izgrađeni su da podržavaju provjeru valjanosti obrazaca temeljenu na HTML-u i pružaju sažete, dostupne oznake. Kao takvi, naši <input>
s i <label>
s su srodni elementi za razliku od <input>
unutar a <label>
. Ovo je nešto opširnije jer morate navesti atribute id
i for
za povezivanje <input>
i <label>
.
Prema zadanim postavkama, bilo koji broj potvrdnih okvira i radija koji su neposredni srodnici bit će okomito naslagani i odgovarajuće razmaknuti s .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>
Grupirajte potvrdne okvire ili radio u istom vodoravnom retku dodavanjem .form-check-inline
bilo kojem .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>
Dodajte .position-static
unosima unutar .form-check
koji nemaju tekst oznake. Ne zaboravite i dalje osigurati neki oblik oznake za pomoćne tehnologije (na primjer, korištenje 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>
Budući da se Bootstrap primjenjuje display: block
na width: 100%
gotovo sve naše kontrole obrazaca, obrasci će se prema zadanim postavkama slagati okomito. Dodatne klase mogu se koristiti za mijenjanje ovog izgleda na temelju obrasca.
Klasa .form-group
je najlakši način za dodavanje strukture obrascima. Pruža fleksibilnu klasu koja potiče pravilno grupiranje oznaka, kontrola, izbornog teksta pomoći i poruka za potvrdu valjanosti obrazaca. Prema zadanim postavkama primjenjuje se samo , ali po potrebi margin-bottom
preuzima dodatne stilove . .form-inline
Koristite ga sa <fieldset>
s, <div>
s ili gotovo bilo kojim drugim elementom.
<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>
Složenije forme mogu se izgraditi korištenjem naših mrežnih klasa. Koristite ih za rasporede obrazaca koji zahtijevaju više stupaca, različite širine i dodatne mogućnosti poravnanja.
<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>
Također možete zamijeniti .row
za .form-row
, varijantu našeg standardnog retka rešetke koji nadjačava zadane oluke stupaca za čvršće i kompaktnije rasporede.
<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>
Složeniji izgledi također se mogu stvoriti pomoću sustava rešetki.
<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>
Stvorite vodoravne forme s mrežom dodavanjem .row
klase u grupe obrazaca i korištenjem .col-*-*
klasa za određivanje širine vaših oznaka i kontrola. Obavezno dodajte .col-form-label
i svojim <label>
s tako da budu okomito centrirani s pripadajućim kontrolama obrasca.
Ponekad ćete možda trebati koristiti pomoćne programe za margine ili podstave kako biste stvorili ono savršeno poravnanje koje vam je potrebno. Na primjer, uklonili smo padding-top
oznaku s naslaganih radijskih ulaza kako bismo bolje poravnali osnovnu liniju teksta.
<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>
Obavezno koristite .col-form-label-sm
ili .col-form-label-lg
za svoje <label>
s ili <legend>
s kako biste točno pratili veličinu .form-control-lg
i .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>
Kao što je prikazano u prethodnim primjerima, naš mrežni sustav omogućuje vam postavljanje bilo kojeg broja .col
s unutar .row
ili .form-row
. Oni će ravnomjerno podijeliti dostupnu širinu. Također možete odabrati podskup svojih stupaca koji će zauzeti više ili manje prostora, dok preostali .col
podjednako dijele ostatak, s određenim klasama stupaca poput .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>
Primjer u nastavku koristi uslužni program flexbox za okomito centriranje sadržaja i promjene tako .col
da .col-auto
vaši stupci zauzimaju onoliko prostora koliko je potrebno. Drugim riječima, veličina stupca ovisi o sadržaju.
<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>
Zatim to možete ponovno pomiješati s klasama stupaca specifičnih za veličinu.
<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>
I naravno, prilagođene kontrole obrazaca su podržane.
<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>
Koristite .form-inline
klasu za prikaz niza oznaka, kontrola obrazaca i gumba u jednom horizontalnom retku. Kontrole obrazaca unutar ugrađenih obrazaca malo se razlikuju od svojih zadanih stanja.
- Kontrole su
display: flex
, sažimaju bilo koji HTML bijeli prostor i omogućuju vam da omogućite kontrolu poravnanja pomoću pomoćnih programa za razmak i flexbox . - Kontrole i ulazne grupe dobivaju
width: auto
za nadjačavanje zadane Bootstrapwidth: 100%
. - Kontrole se pojavljuju u liniji samo u okvirima za prikaz koji su široki najmanje 576 piksela kako bi se uzeli u obzir uski okviri za prikaz na mobilnim uređajima.
Možda ćete morati ručno riješiti širinu i poravnanje pojedinačnih kontrola obrasca pomoću uslužnih programa za razmake (kao što je prikazano u nastavku). Na kraju, svakako uključite <label>
uz svaku kontrolu obrasca, čak i ako je trebate sakriti od posjetitelja koji ne koriste čitač zaslona pomoću .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>
Podržane su i prilagođene kontrole obrazaca i odabiri.
<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>
Alternative skrivenim oznakama
Pomoćne tehnologije kao što su čitači zaslona imat će problema s vašim obrascima ako ne uključite oznaku za svaki unos. Za ove ugrađene obrasce možete sakriti oznake pomoću .sr-only
klase. Postoje daljnje alternativne metode davanja oznake za pomoćne tehnologije, kao što je aria-label
atribut ili aria-labelledby
. title
Ako ništa od toga nije prisutno, pomoćne tehnologije mogu pribjeći korištenju placeholder
atributa, ako je prisutan, ali imajte na umu da placeholder
se ne preporučuje korištenje kao zamjena za druge metode označavanja.
Tekst pomoći na razini bloka u obrascima može se stvoriti pomoću .form-text
(ranije poznatog kao .help-block
u v3). Umetnuti tekst pomoći može se fleksibilno implementirati korištenjem bilo kojeg umetnutog HTML elementa i uslužnih klasa kao što je .text-muted
.
Povezivanje teksta pomoći s kontrolama obrasca
Tekst pomoći treba biti eksplicitno povezan s kontrolom obrasca na koju se odnosi pomoću aria-describedby
atributa. To će osigurati da će pomoćne tehnologije—kao što su čitači zaslona—najaviti ovaj tekst pomoći kada se korisnik fokusira ili uđe u kontrolu.
Tekst pomoći ispod unosa može se stilizirati s .form-text
. Ova klasa uključuje display: block
i dodaje neku gornju marginu za jednostavno odvajanje od gornjih unosa.
<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>
Umetnuti tekst može koristiti bilo koji tipični umetnuti HTML element (bilo to <small>
, <span>
, ili nešto drugo) s ništa više od klase korisnosti.
<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>
Dodajte disabled
booleov atribut na unos kako biste spriječili interakcije korisnika i učinili da izgleda svjetlije.
Dodajte disabled
atribut u <fieldset>
da biste onemogućili sve unutarnje kontrole.
<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>
Upozorenje sa sidrima
Prema zadanim postavkama, preglednici će tretirati sve izvorne kontrole obrasca ( <input>
, <select>
i <button>
elemente) unutar <fieldset disabled>
kao onemogućene, sprječavajući interakcije tipkovnice i miša na njima. Međutim, ako vaš obrazac također uključuje <a ... class="btn btn-*">
elemente, oni će dobiti samo stil pointer-events: none
. Kao što je navedeno u odjeljku o onemogućenom stanju za gumbe (i posebno u pododjeljku za elemente sidra), ovo CSS svojstvo još nije standardizirano i nije u potpunosti podržano u Operi 18 i nižim, ili u Internet Exploreru 10, i pobijedilo je Ne sprječava korisnike tipkovnice da se mogu fokusirati ili aktivirati ove veze. Da biste bili sigurni, upotrijebite prilagođeni JavaScript da onemogućite takve veze.
Kompatibilnost s različitim preglednicima
Iako će Bootstrap primijeniti ove stilove u svim preglednicima, Internet Explorer 11 i niže verzije ne podržavaju u potpunosti disabled
atribut na <fieldset>
. Koristite prilagođeni JavaScript da onemogućite skup polja u ovim preglednicima.
Pružite vrijedne, djelotvorne povratne informacije svojim korisnicima pomoću HTML5 provjere valjanosti obrasca– dostupne u svim našim podržanim preglednicima . Odaberite iz zadane povratne informacije o provjeri valjanosti preglednika ili implementirajte prilagođene poruke s našim ugrađenim klasama i početnim JavaScriptom.
Toplo preporučujemo prilagođene stilove provjere budući da se zadane izvorne postavke preglednika ne objavljuju čitačima zaslona.
Evo kako provjera valjanosti obrazaca radi s Bootstrapom:
- Validacija HTML obrasca primjenjuje se putem CSS-ovih dviju pseudo-klasa
:invalid
i:valid
. Primjenjuje se na<input>
,<select>
, i<textarea>
elemente. - Bootstrap raspoređuje
:invalid
i:valid
stilove na roditeljsku.was-validated
klasu, obično primijenjenu na<form>
. U suprotnom, svako obavezno polje bez vrijednosti prikazuje se kao nevažeće pri učitavanju stranice. Na taj način možete odabrati kada ćete ih aktivirati (obično nakon što se pokuša predati obrazac). - Kao zamjena,
.is-invalid
i.is-valid
klase se mogu koristiti umjesto pseudo-klasa za provjeru valjanosti na strani poslužitelja . Ne zahtijevaju.was-validated
nadređenu klasu. - Zbog ograničenja u načinu na koji CSS funkcionira, ne možemo (trenutačno) primijeniti stilove na
<label>
koji dolazi prije kontrole obrasca u DOM-u bez pomoći prilagođenog JavaScripta. - Svi moderni preglednici podržavaju API za provjeru valjanosti ograničenja , niz JavaScript metoda za provjeru valjanosti kontrola obrazaca.
- Poruke s povratnim informacijama mogu koristiti zadane postavke preglednika (različite za svaki preglednik i ne mogu se oblikovati putem CSS-a) ili naše prilagođene stilove povratnih informacija s dodatnim HTML-om i CSS-om.
- Možete dati prilagođene poruke valjanosti
setCustomValidity
u JavaScriptu.
Imajući to na umu, razmotrite sljedeće demonstracije za naše prilagođene stilove provjere valjanosti obrasca, opcijske klase na strani poslužitelja i zadane postavke preglednika.
Za prilagođene poruke provjere valjanosti Bootstrap obrasca, morat ćete dodati novalidate
Boolean atribut u svoj <form>
. Ovo onemogućuje zadane opise alata preglednika za povratne informacije, ali i dalje omogućuje pristup API-jima za provjeru valjanosti obrasca u JavaScriptu. Pokušajte poslati obrazac ispod; naš JavaScript će presresti gumb za slanje i prenijeti vam povratne informacije.
Kada pokušate poslati, vidjet ćete stilove :invalid
i :valid
koji se primjenjuju na vaše kontrole obrasca.
<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>
Niste zainteresirani za prilagođene povratne poruke za provjeru valjanosti ili pisanje JavaScripta za promjenu ponašanja obrazaca? Sve je u redu, možete koristiti zadane postavke preglednika. Pokušajte poslati obrazac ispod. Ovisno o vašem pregledniku i OS-u, vidjet ćete nešto drugačiji stil povratnih informacija.
Iako se ovi stilovi povratnih informacija ne mogu oblikovati pomoću CSS-a, ipak možete prilagoditi tekst povratnih informacija putem JavaScripta.
<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>
Preporučujemo korištenje provjere valjanosti na strani klijenta, ali u slučaju da vam je potrebna strana poslužitelja, možete označiti nevažeća i važeća polja obrasca pomoću .is-invalid
i .is-valid
. Imajte na umu da .invalid-feedback
je također podržan s ovim klasama.
<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>
Naši primjeri obrazaca prikazuju izvorne tekstualne <input>
elemente iznad, ali stilovi provjere valjanosti obrazaca dostupni su i za naše prilagođene kontrole obrazaca.
<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>
Ako izgled vašeg obrasca to dopušta, možete zamijeniti .{valid|invalid}-feedback
klase .{valid|invalid}-tooltip
klasama za prikaz povratne informacije o provjeri valjanosti u stiliziranom opisu alata. Obavezno imajte roditelja s position: relative
njim za pozicioniranje opisa alata. U donjem primjeru, naše klase stupaca to već imaju, ali vaš projekt može zahtijevati alternativno postavljanje.
<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>
Za još veću prilagodbu i dosljednost među preglednicima, upotrijebite naše potpuno prilagođene elemente obrasca za zamjenu zadanih postavki preglednika. Izgrađeni su na semantičkom i pristupačnom označavanju, pa su solidna zamjena za bilo koju zadanu kontrolu obrasca.
Svaki potvrdni okvir i radio zamotan je u <div>
s bratom ili sestrom <span>
kako bismo stvorili našu prilagođenu kontrolu i a <label>
za popratni tekst. Strukturno, ovo je isti pristup kao naš zadani .form-check
.
Koristimo istorodni selektor ( ~
) za sva naša <input>
stanja—kao što je— :checked
kako bismo ispravno stilizirali naš prilagođeni indikator obrasca. U kombinaciji s .custom-control-label
klasom, također možemo stilizirati tekst za svaku stavku na temelju stanja <input>
's.
Sakrivamo zadanu postavku <input>
pomoću opacity
i koristimo .custom-control-label
za izgradnju novog prilagođenog indikatora obrasca na njenom mjestu pomoću ::before
i ::after
. Nažalost, ne možemo izraditi prilagođeni samo od <input>
jer CSS content
ne radi na tom elementu.
U označenim stanjima koristimo base64 ugrađene SVG ikone iz Open Iconica . To nam omogućuje najbolju kontrolu za stiliziranje i pozicioniranje u preglednicima i uređajima.
<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>
Prilagođeni potvrdni okviri također mogu koristiti :indeterminate
pseudo klasu kada se ručno postavljaju putem JavaScripta (ne postoji dostupan HTML atribut za njegovo određivanje).
Ako koristite jQuery, nešto poput ovoga trebalo bi biti dovoljno:
<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>
Prilagođeni potvrdni okviri i radio također se mogu onemogućiti. Dodajte disabled
booleov atribut <input>
i prilagođeni indikator i opis oznake bit će automatski oblikovani.
<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>
Prilagođeni <select>
izbornici trebaju samo prilagođenu klasu .custom-select
za pokretanje prilagođenih stilova.
<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>
Također možete birati između malih i velikih prilagođenih odabira koji odgovaraju našim unosima teksta slične veličine.
<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>
Atribut multiple
je također podržan:
<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>
Kao i size
atribut:
<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>
Datotečni unos je najkvrgaviji u nizu i zahtijeva dodatni JavaScript ako ih želite spojiti s funkcionalnim Odaberi datoteku… i odabranim tekstom naziva datoteke.
<div class="custom-file">
<input type="file" class="custom-file-input" id="customFile">
<label class="custom-file-label" for="customFile">Choose file</label>
</div>
Sakrivamo zadanu datoteku <input>
putem opacity
i umjesto toga stiliziramo <label>
. Gumb se generira i postavlja s ::after
. Na kraju, izjavljujemo width
i height
na <input>
za pravilan razmak za okolni sadržaj.
Pseudoklasa :lang()
se koristi za omogućavanje prijevoda teksta "Pregledaj" na druge jezike. Zaobiđite ili dodajte unose u $custom-file-text
Sass varijablu s relevantnom jezičnom oznakom i lokaliziranim nizovima. Engleske žice mogu se prilagoditi na isti način. Na primjer, evo kako se može dodati španjolski prijevod (kod španjolskog jezika je es
):
Evo lang(es)
na djelu prilagođenog unosa datoteke za španjolski prijevod:
<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>
Morat ćete ispravno postaviti jezik svog dokumenta (ili njegovog podstabla) kako bi se prikazao točan tekst. To se između ostalih metoda može učiniti pomoću atributalang
na <html>
elementu ili Content-Language
HTTP zaglavlja .