Primjeri i smjernice za korištenje stilova kontrole obrazaca, opcija izgleda i prilagođenih komponenti za stvaranje širokog spektra obrazaca.
Pregled
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 typeatribut na svim unosima (npr. emailza adresu e-pošte ili numberza 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.
Kontrole obrazaca
Kontrole tekstualnog obrasca - poput <input>s, <select>s i <textarea>s - stiliziraju se s .form-controlklasom. Uključeni su stilovi za opći izgled, stanje fokusa, veličinu i još mnogo toga.
Za unos datoteka zamijenite .form-controlza .form-control-file.
Dimenzioniranje
Postavite visine koristeći klase poput .form-control-lgi .form-control-sm.
Samo za čitanje
Dodajte readonlybooleov 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.
Običan tekst samo za čitanje
Ako želite da <input readonly>elementi u vašem obrascu budu oblikovani kao običan tekst, upotrijebite .form-control-plaintextklasu za uklanjanje zadanog stila polja obrasca i očuvanje ispravne margine i ispune.
Unosi raspona
Postavite unose raspona vodoravnog pomicanja pomoću .form-control-range.
Polje za potvrdu i radio
Zadani potvrdni okviri i radio stanice poboljšani su uz pomoć .form-checkjedne 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. Atribut disabledće primijeniti svjetliju boju kako bi lakše označio stanje unosa.
Potvrdni okviri i radio gumbi 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 idi forza povezivanje <input>i <label>.
Zadano (složeno)
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.
U redu
Grupirajte potvrdne okvire ili radio u istom vodoravnom retku dodavanjem .form-check-inlinebilo kojem .form-check.
Bez etiketa
Dodajte .position-staticunosima unutar .form-checkkoji nemaju tekst oznake. Ne zaboravite i dalje osigurati neki oblik oznake za pomoćne tehnologije (na primjer, korištenje aria-label).
Izgled
Budući da se Bootstrap primjenjuje display: blockna 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.
Formirajte grupe
Klasa .form-groupje 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-bottompreuzima dodatne stilove . .form-inlineKoristite ga sa <fieldset>s, <div>s ili gotovo bilo kojim drugim elementom.
Mreža oblika
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.
Formirajte red
Također možete zamijeniti .rowza .form-row, varijantu našeg standardnog retka rešetke koji nadjačava zadane oluke stupaca za čvršće i kompaktnije rasporede.
Složeniji izgledi također se mogu stvoriti pomoću sustava rešetki.
Horizontalni oblik
Stvorite vodoravne forme s mrežom dodavanjem .rowklase u grupe obrazaca i korištenjem .col-*-*klasa za određivanje širine vaših oznaka i kontrola. Obavezno dodajte .col-form-labeli 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-topoznaku s naslaganih radijskih ulaza kako bismo bolje poravnali osnovnu liniju teksta.
Određivanje veličine naljepnice vodoravnog oblika
Obavezno koristite .col-form-label-smili .col-form-label-lgza svoje <label>s ili <legend>s kako biste točno pratili veličinu .form-control-lgi .form-control-sm.
Dimenzioniranje stupaca
Kao što je prikazano u prethodnim primjerima, naš mrežni sustav omogućuje vam postavljanje bilo kojeg broja .cols unutar .rowili .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 .colpodjednako dijele ostatak, s određenim klasama stupaca poput .col-7.
Automatsko određivanje veličine
Primjer u nastavku koristi uslužni program flexbox za okomito centriranje sadržaja i promjene tako .colda .col-autovaši stupci zauzimaju onoliko prostora koliko je potrebno. Drugim riječima, veličina stupca ovisi o sadržaju.
Zatim to možete ponovno pomiješati s klasama stupaca specifičnih za veličinu.
Koristite .form-inlineklasu 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: autoza nadjačavanje zadane Bootstrap width: 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.
Podržane su i prilagođene kontrole obrazaca i odabiri.
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-onlyklase. Postoje daljnje alternativne metode davanja oznake za pomoćne tehnologije, kao što je aria-labelatribut ili aria-labelledby. titleAko ništa od toga nije prisutno, pomoćne tehnologije mogu pribjeći korištenju placeholderatributa, ako je prisutan, ali imajte na umu da placeholderse ne preporučuje korištenje kao zamjena za druge metode označavanja.
Tekst pomoći
Tekst pomoći na razini bloka u obrascima može se stvoriti pomoću .form-text(ranije poznatog kao .help-blocku 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-describedbyatributa. 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: blocki dodaje neku gornju marginu za jednostavno odvajanje od gornjih unosa.
Vaša lozinka mora imati 8-20 znakova, sadržavati slova i brojke i ne smije sadržavati razmake, posebne znakove ili emojije.
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.
Onesposobljeni oblici
Dodajte disabledbooleov atribut na unos kako biste spriječili interakcije korisnika i učinili da izgleda svjetlije.
Dodajte disabledatribut u <fieldset>da biste onemogućili sve unutarnje kontrole.
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 Internet Exploreru 10 i neće spriječiti korisnike tipkovnice da moći 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 disabledatribut na <fieldset>. Koristite prilagođeni JavaScript da onemogućite skup polja u ovim preglednicima.
Validacija
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.
Trenutačno preporučujemo korištenje prilagođenih stilova provjere valjanosti jer zadane poruke provjere valjanosti izvornog preglednika nisu dosljedno izložene pomoćnim tehnologijama u svim preglednicima (prije svega u Chromeu na stolnom računalu i mobilnom uređaju).
Kako radi
Evo kako provjera valjanosti obrazaca radi s Bootstrapom:
Validacija HTML obrasca primjenjuje se putem CSS-ovih dviju pseudo-klasa :invalidi :valid. Primjenjuje se na <input>, <select>, i <textarea>elemente.
Bootstrap raspoređuje :invalidi :validstilove na roditeljsku .was-validatedklasu, 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).
Za poništavanje izgleda obrasca (na primjer, u slučaju dinamičkog slanja obrasca pomoću AJAX-a), nakon slanja ponovo uklonite .was-validatedklasu iz .<form>
Kao zamjena, .is-invalidi .is-validklase se mogu koristiti umjesto pseudo-klasa za provjeru valjanosti na strani poslužitelja . Ne zahtijevaju .was-validatednadređ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.
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 setCustomValidityu 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.
Prilagođeni stilovi
Za prilagođene poruke provjere valjanosti Bootstrap obrasca, morat ćete dodati novalidateBoolean 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 :invalidi :validkoji se primjenjuju na vaše kontrole obrasca.
Prilagođeni stilovi povratnih informacija primjenjuju prilagođene boje, obrube, stilove fokusa i pozadinske ikone za bolju komunikaciju povratnih informacija. Pozadinske ikone za <select>s dostupne su samo uz .custom-select, a ne .form-control.
Zadane postavke preglednika
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.
Strana poslužitelja
Preporučujemo korištenje provjere valjanosti na strani klijenta, ali u slučaju da trebate provjeru valjanosti na strani poslužitelja, možete naznačiti nevažeća i važeća polja obrasca pomoću .is-invalidi .is-valid. Imajte na umu da .invalid-feedbackje također podržan s ovim klasama.
Podržani elementi
Stilovi provjere valjanosti dostupni su za sljedeće kontrole obrasca i komponente:
<input>s i <textarea>s .form-control(uključujući najviše jedan .form-controlu ulaznim grupama)
<select>s .form-controlili.custom-select
.form-checks
.custom-checkboxs i .custom-radios
.custom-file
Opisi alata
Ako izgled vašeg obrasca to dopušta, možete zamijeniti .{valid|invalid}-feedbackklase .{valid|invalid}-tooltipklasama za prikaz povratne informacije o provjeri valjanosti u stiliziranom opisu alata. Obavezno imajte roditelja s position: relativenjim za pozicioniranje opisa alata. U donjem primjeru, naše klase stupaca to već imaju, ali vaš projekt može zahtijevati alternativno postavljanje.
Prilagodba
Stanja provjere mogu se prilagoditi putem Sass-a s $form-validation-stateskartom. Smještena u našoj _variables.scssdatoteci, ova Sass mapa se ponavlja radi generiranja zadanih stanja valid/ invalidstanja provjere valjanosti. Uključena je ugniježđena karta za prilagođavanje boje i ikone svake države. Iako preglednici ne podržavaju druga stanja, oni koji koriste prilagođene stilove mogu jednostavno dodati složenije povratne informacije obrasca.
Imajte na umu da ne preporučujemo prilagođavanje ovih vrijednosti bez izmjene form-validation-statemixina.
Prilagođeni obrasci
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.
Polje za potvrdu i radio
Svaki potvrdni okvir i radio <input>i <label>uparivanje omotani su u <div>kako bismo stvorili našu prilagođenu kontrolu. Strukturno, ovo je isti pristup kao naš zadani .form-check.
Koristimo istorodni selektor ( ~) za sva naša <input>stanja—kao što je— :checkedkako bismo ispravno stilizirali naš prilagođeni indikator obrasca. U kombinaciji s .custom-control-labelklasom, također možemo stilizirati tekst za svaku stavku na temelju stanja <input>'s.
Sakrivamo zadanu postavku <input>pomoću opacityi koristimo .custom-control-labelza izgradnju novog prilagođenog indikatora obrasca na njenom mjestu pomoću ::beforei ::after. Nažalost, ne možemo izraditi prilagođeni samo od <input>jer CSS contentne 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.
Potvrdni okviri
Prilagođeni potvrdni okviri također mogu koristiti :indeterminatepseudo 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:
Radio aparati
U redu
Onemogućeno
Prilagođeni potvrdni okviri i radio također se mogu onemogućiti. Dodajte disabledbooleov atribut <input>i prilagođeni indikator i opis oznake bit će automatski oblikovani.
Prekidači
Prekidač ima oznake prilagođenog potvrdnog okvira, ali koristi .custom-switchklasu za prikaz preklopnog prekidača. Prekidači također podržavaju disabledatribut.
Odaberite izbornik
Prilagođeni <select>izbornici trebaju samo prilagođenu klasu .custom-selectza pokretanje prilagođenih stilova. Prilagođeni stilovi ograničeni su na <select>početni izgled i ne mogu mijenjati <option>s zbog ograničenja preglednika.
Također možete birati između malih i velikih prilagođenih odabira koji odgovaraju našim unosima teksta slične veličine.
Atribut multipleje također podržan:
Kao i sizeatribut:
Raspon
Stvorite prilagođene <input type="range">kontrole pomoću .custom-range. Staza (pozadina) i palac (vrijednost) oblikovani su tako da izgledaju jednako u svim preglednicima. Budući da samo IE i Firefox podržavaju "ispunjavanje" svoje staze s lijeve ili desne strane palca kao sredstvo za vizualno označavanje napretka, trenutno to ne podržavamo.
Unosi raspona imaju implicitne vrijednosti za mini max— 0odnosno 100. Možete navesti nove vrijednosti za one koje koriste atribute mini .max
Prema zadanim postavkama, ulazi raspona "pričvršćuju" na cjelobrojne vrijednosti. Da biste to promijenili, možete odrediti stepvrijednost. U donjem primjeru udvostručujemo broj koraka pomoću step="0.5".
Preglednik datoteka
Preporučeni dodatak za animiranje prilagođenog unosa datoteke: bs-custom-file-input , to je ono što trenutno koristimo ovdje u našim dokumentima.
Datotečni unos je najkvrgaviji u nizu i zahtijeva dodatni JavaScript ako ih želite spojiti s funkcionalnim Odaberi datoteku… i odabranim tekstom naziva datoteke.
Sakrivamo zadanu datoteku <input>putem opacityi umjesto toga stiliziramo <label>. Gumb se generira i postavlja s ::after. Na kraju, izjavljujemo widthi heightna <input>za pravilan razmak za okolni sadržaj.
Prevođenje ili prilagodba nizova pomoću SCSS-a
Pseudoklasa :lang()se koristi za omogućavanje prijevoda teksta "Pregledaj" na druge jezike. Zaobiđite ili dodajte unose u $custom-file-textSass 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:
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-LanguageHTTP zaglavlja .
Prijevod ili prilagodba nizova pomoću HTML-a
Bootstrap također nudi način prevođenja teksta "Pregledaj" u HTML s data-browseatributom koji se može dodati prilagođenoj oznaci unosa (primjer na nizozemskom):