Primjeri i smjernice za korištenje stilova kontrole obrazaca, opcija izgleda i prilagođenih komponenti za kreiranje širokog spektra obrazaca.
Pregled
Bootstrap-ove kontrole obrasca proširuju naše Rebooted stilove obrasca sa klasama. Koristite ove klase da biste se uključili u njihove prilagođene prikaze za konzistentnije prikazivanje na svim pretraživačima i uređajima.
Obavezno koristite odgovarajući typeatribut na svim ulazima (npr. emailza adresu e-pošte ili numberza numeričke informacije) da biste iskoristili prednosti novijih kontrola unosa kao što su verifikacija e-pošte, odabir broja i još mnogo toga.
Evo kratkog primjera za demonstriranje stilova obrasca Bootstrapa. Nastavite čitati za dokumentaciju o potrebnim klasama, izgledu obrasca i još mnogo toga.
Kontrole obrasca
Kontrole tekstualnog oblika – poput <input>s, <select>s i <textarea>s – stilizovane su sa .form-controlklasom. Uključeni su stilovi za opći izgled, stanje fokusa, veličine i još mnogo toga.
Obavezno istražite naše prilagođene forme kako biste dodatno stilizirali <select>.
Za unose datoteka, zamijenite .form-controlza .form-control-file.
Određivanje veličine
Postavite visine koristeći klase kao što su .form-control-lgi .form-control-sm.
Samo za čitanje
Dodajte readonlyboolean atribut na ulaz da biste spriječili promjenu vrijednosti ulaza. Unosi samo za čitanje izgledaju lakši (baš kao i onemogućeni ulazi), ali zadržavaju standardni kursor.
Običan tekst samo za čitanje
Ako želite da <input readonly>elementi u obrascu budu stilizovani kao običan tekst, koristite .form-control-plaintextklasu da biste uklonili podrazumevani stil polja obrasca i sačuvali ispravnu marginu i dopunu.
Ulazi za opseg
Postavite horizontalno pomične ulaze za raspon pomoću .form-control-range.
Polje za potvrdu i radio
Zadani potvrdni okviri i radio uređaji su poboljšani uz pomoć .form-check, jedne klase za oba tipa unosa koja poboljšava izgled i ponašanje njihovih HTML elemenata . Potvrdni okviri služe za odabir jedne ili više opcija na listi, dok radio uređaji služe za odabir jedne od više opcija.
Podržani su onemogućeni okviri za potvrdu i radio. Atribut disabledće primijeniti svjetliju boju kako bi se naznačilo stanje ulaza.
Polje za potvrdu i radio dugmad podržavaju provjeru valjanosti obrasca zasnovanu na HTML-u i pružaju sažete, pristupačne oznake. Kao takvi, naši <input>s i <label>s su srodni elementi za razliku od <input>unutar a <label>. Ovo je malo opširnije jer morate specificirati idi foratribute da biste povezali <input>i <label>.
Zadano (naslagano)
Prema zadanim postavkama, bilo koji broj okvira za potvrdu i radija koji su neposredni brat ili sestra bit će okomito naslagani i na odgovarajući način razmaknuti sa .form-check.
U redu
Grupirajte potvrdne okvire ili radio stanice u istom horizontalnom redu dodavanjem .form-check-inlineu bilo koji .form-check.
Bez etiketa
Dodaj .position-staticna ulaze .form-checkkoji nemaju tekst oznake. Ne zaboravite još uvijek osigurati neki oblik oznake za pomoćne tehnologije (na primjer, korištenje aria-label).
Layout
Budući da se Bootstrap primjenjuje display: blocki width: 100%na gotovo sve naše kontrole obrasca, obrasci će se po defaultu slagati okomito. Dodatne klase se mogu koristiti za variranje ovog rasporeda na osnovu oblika.
Formirajte grupe
Klasa .form-groupje najlakši način za dodavanje strukture obrascima. Pruža fleksibilnu klasu koja podstiče pravilno grupisanje oznaka, kontrola, opcionalnog teksta pomoći i poruka o validaciji obrazaca. Podrazumevano se primjenjuje samo margin-bottom, ali .form-inlinepo potrebi preuzima dodatne stilove. Koristite ga sa <fieldset>s, <div>s ili gotovo bilo kojim drugim elementom.
Mreža obrazaca
Složenije forme se mogu izgraditi pomoću naših mrežnih klasa. Koristite ih za izglede obrazaca koji zahtijevaju više kolona, različite širine i dodatne opcije poravnanja.
Forma red
Također možete zamijeniti .rowza .form-row, varijaciju našeg standardnog reda mreže koja nadjačava zadane oluke stupaca za čvršće i kompaktnije rasporede.
Složeniji rasporedi se takođe mogu kreirati pomoću sistema mreže.
Horizontalna forma
Kreirajte horizontalne forme pomoću mreže dodavanjem .rowklase u grupe obrazaca i korištenjem .col-*-*klasa da odredite širinu vaših oznaka i kontrola. Obavezno dodajte .col-form-labeli svoje <label>s tako da budu okomito centrirani s pripadajućim kontrolama obrasca.
Ponekad ćete možda morati da koristite pomoćne programe za margine ili padding da biste kreirali savršeno poravnanje koje vam je potrebno. Na primjer, uklonili smo oznaku padding-topna našim naslaganim radio ulazima kako bismo bolje poravnali osnovnu liniju teksta.
Dimenzioniranje etikete horizontalnog oblika
Obavezno koristite .col-form-label-smili .col-form-label-lgna svoje <label>s ili <legend>s kako biste pravilno pratili veličinu .form-control-lgi .form-control-sm.
Dimenzioniranje kolone
Kao što je prikazano u prethodnim primjerima, naš sistem mreže vam omogućava da postavite bilo koji broj .cols unutar .rowili .form-row. Oni će ravnomjerno podijeliti dostupnu širinu između sebe. Također možete odabrati podskup svojih stupaca koji će zauzimati više ili manje prostora, dok preostali .cols jednako dijele ostatak, sa specifičnim klasama stupaca kao što je .col-7.
Automatsko određivanje veličine
Primjer u nastavku koristi uslužni program flexbox za vertikalno centriranje sadržaja i mijenja .colse .col-autotako da vaši stupci zauzimaju samo onoliko prostora koliko je potrebno. Drugim riječima, kolona sama određuje veličinu na osnovu sadržaja.
Zatim možete to još jednom remiksovati sa klasama stupaca specifičnih za veličinu.
Koristite .form-inlineklasu da prikažete niz oznaka, kontrola obrasca i dugmadi u jednom horizontalnom redu. Kontrole obrasca unutar inline obrazaca neznatno se razlikuju od njihovih zadanih stanja.
Kontrole su display: flex, sažimaju bilo koji HTML bijeli prostor i omogućavaju vam da pružite kontrolu poravnanja pomoću uslužnih programa za razmak i flexbox .
Kontrole i ulazne grupe primaju width: autoda nadjačaju Bootstrap default width: 100%.
Kontrole se pojavljuju samo u okvirima za prikaz koji su široki najmanje 576 piksela kako bi se u obzir uzeli 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 razmak (kao što je prikazano ispod). Na kraju, budite sigurni da ste uvijek uključili a <label>uz svaku kontrolu obrasca, čak i ako ga trebate sakriti od posjetitelja koji ne čitaju ekrane pomoću .sr-only.
Prilagođene kontrole obrasca i odabiri su također podržani.
Alternative skrivenim oznakama
Pomoćne tehnologije kao što su čitači ekrana će imati problema s vašim obrascima ako ne uključite oznaku za svaki unos. Za ove inline obrasce možete sakriti oznake pomoću .sr-onlyklase. Postoje dodatne alternativne metode pružanja oznake za pomoćne tehnologije, kao što je aria-label, aria-labelledbyili titleatribut. Ako ništa od toga nije prisutno, pomoćne tehnologije mogu pribjeći korištenju placeholderatributa, ako postoji, ali imajte na umu da se ne preporučuje korištenje placeholderkao zamjene za druge metode označavanja.
Tekst pomoći
Tekst pomoći na nivou bloka u obrascima se može kreirati pomoću .form-text(prethodno poznatog kao .help-blocku v3). Inline tekst pomoći može se fleksibilno implementirati korištenjem bilo kojeg inline HTML elementa i uslužnih klasa kao što je .text-muted.
Povezivanje teksta pomoći s kontrolama obrasca
Tekst pomoći bi trebao biti eksplicitno povezan s kontrolom obrasca na koju se odnosi korištenjem aria-describedbyatributa. Ovo će osigurati da će pomoćne tehnologije – kao što su čitači ekrana – objaviti ovaj tekst pomoći kada se korisnik fokusira ili uđe u kontrolu.
Tekst pomoći ispod unosa može biti stilizovan sa .form-text. Ova klasa uključuje display: blocki dodaje gornju marginu za lakši razmak od gornjih unosa.
Vaša lozinka mora imati 8-20 znakova, sadržavati slova i brojeve i ne smije sadržavati razmake, specijalne znakove ili emotikone.
Umetnuti tekst može koristiti bilo koji tipičan inline HTML element (bilo da se radi o <small>, <span>, ili nešto treće) s ništa više od uslužne klase.
Onemogućene forme
Dodajte disabledlogički atribut na ulaz kako biste spriječili korisničke interakcije i učinili da izgleda lakše.
Dodajte disabledatribut a <fieldset>da biste onemogućili sve kontrole unutar.
Upozorenje sa sidrima
Prema zadanim postavkama, pretraživači će tretirati sve izvorne kontrole obrasca ( <input>i elemente) unutar a kao onemogućene, sprečavajući interakcije <select>i tastature i miša na njima. Međutim, ako vaš obrazac također uključuje elemente, njima će biti dodijeljen samo stil . Kao što je navedeno u odjeljku o onemogućenom stanju za dugmad (i posebno u pododjeljku za elemente sidra), ovo CSS svojstvo još nije standardizirano i nije u potpunosti podržano u Internet Exploreru 10, te neće spriječiti korisnike tastature da budu mogu fokusirati ili aktivirati ove veze. Da biste bili sigurni, koristite prilagođeni JavaScript da onemogućite takve veze.<button><fieldset disabled><a ... class="btn btn-*">pointer-events: none
Kompatibilnost među pretraživačima
Dok će Bootstrap primijeniti ove stilove u svim pretraživačima, Internet Explorer 11 i stariji ne podržavaju u potpunosti disabledatribut na <fieldset>. Koristite prilagođeni JavaScript da onemogućite skup polja u ovim pretraživačima.
Validacija
Pružite vrijedne povratne informacije svojim korisnicima uz HTML5 provjeru obrasca – dostupnu u svim našim podržanim pretraživačima . Odaberite neku od zadanih povratnih informacija o validaciji pretraživača ili implementirajte prilagođene poruke s našim ugrađenim klasama i početnim JavaScriptom.
Trenutno preporučujemo korištenje prilagođenih stilova provjere valjanosti, jer standardne poruke za provjeru valjanosti izvornog pretraživača nisu dosljedno izložene pomoćnim tehnologijama u svim pretraživačima (najčešće Chrome na desktopu i mobilnom uređaju).
Kako radi
Evo kako funkcionira validacija obrasca s Bootstrapom:
Provjera valjanosti HTML obrasca se primjenjuje preko CSS-ove dvije pseudo-klase :invalidi :valid. Primjenjuje se na <input>, <select>, i <textarea>elemente.
Bootstrap obuhvata :invalidi :validstilove na roditeljsku .was-validatedklasu, obično se primjenjuje na <form>. U suprotnom, svako obavezno polje bez vrijednosti prikazuje se kao nevažeće pri učitavanju stranice. Na ovaj način možete odabrati kada ćete ih aktivirati (obično nakon pokušaja podnošenja obrasca).
Da biste resetirali izgled obrasca (na primjer, u slučaju dinamičkog podnošenja obrasca pomoću AJAX-a), uklonite .was-validatedklasu iz <form>ponovo nakon slanja.
Kao rezervni, .is-invalidklase .is-validse mogu koristiti umjesto pseudo-klasa za provjeru valjanosti na strani servera . Ne zahtijevaju .was-validatedroditeljsku klasu.
Zbog ograničenja u načinu na koji CSS radi, ne možemo (trenutno) primijeniti stilove na a <label>koji dolazi prije kontrole obrasca u DOM-u bez pomoći prilagođenog JavaScripta.
Svi moderni pretraživači podržavaju API za validaciju ograničenja , seriju JavaScript metoda za provjeru valjanosti kontrola obrasca.
Poruke sa povratnim informacijama mogu koristiti zadane postavke pretraživača (različite za svaki pretraživač i nestilizirane 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 sa setCustomValidityu JavaScriptu.
Imajući to na umu, razmotrite sljedeće demonstracije za naše prilagođene stilove validacije obrasca, opcione klase na strani servera i zadane postavke pretraživača.
Prilagođeni stilovi
Za prilagođene poruke provjere valjanosti Bootstrap obrasca, morat ćete dodati novalidateboolean atribut u svoj <form>. Ovo onemogućava zadane savjete za povratne informacije preglednika, ali i dalje pruža pristup API-jima za provjeru valjanosti obrazaca u JavaScript-u. Pokušajte poslati obrazac ispod; naš JavaScript će presresti dugme za slanje i prenijeti vam povratne informacije. Kada pokušate da pošaljete, vidjet ćete :invalidi :validstilove primijenjene na vaše kontrole obrasca.
Prilagođeni stilovi povratnih informacija primjenjuju prilagođene boje, ivice, stilove fokusa i pozadinske ikone da bolje komuniciraju povratne informacije. Pozadinske ikone za <select>s dostupne su samo sa .custom-select, ali ne i sa .form-control.
Zadane postavke pretraživača
Niste zainteresirani za prilagođene povratne informacije o validaciji ili pisanje JavaScripta za promjenu ponašanja obrasca? Sve u redu, možete koristiti zadane postavke pretraživača. Pokušajte poslati obrazac ispod. Ovisno o vašem pretraživaču i OS-u, vidjet ćete malo drugačiji stil povratnih informacija.
Iako se ovi stilovi povratnih informacija ne mogu stilizirati pomoću CSS-a, i dalje možete prilagoditi tekst povratnih informacija putem JavaScripta.
Server side
Preporučujemo da koristite provjeru valjanosti na strani klijenta, ali u slučaju da vam je potrebna provjera valjanosti na strani servera, možete naznačiti nevažeća i važeća polja obrasca sa .is-invalidi .is-valid. Imajte na umu da .invalid-feedbackje također podržano sa ovim klasama.
Podržani elementi
Stilovi validacije dostupni su za sljedeće kontrole i komponente obrasca:
<input>s i <textarea>s sa .form-control(uključujući najviše jedan .form-controlu ulaznim grupama)
<select>s sa .form-controlili.custom-select
.form-checks
.custom-checkboxs i .custom-radios
.custom-file
Alati
Ako vaš izgled obrasca to dozvoljava, možete zamijeniti .{valid|invalid}-feedbackklase za .{valid|invalid}-tooltipklase kako biste prikazali povratne informacije o validaciji u stiliziranom opisu alata. Pobrinite se da imate roditelja s position: relativenjim za pozicioniranje u opisu alata. U primjeru ispod, naše klase stupaca to već imaju, ali vaš projekt može zahtijevati alternativno podešavanje.
Prilagođavanje
Stanja validacije mogu se prilagoditi putem Sass-a sa $form-validation-statesmapom. Smještena u našoj _variables.scssdatoteci, ova Sass mapa je u petlji radi generiranja zadanih valid/ invalidpotvrđenih stanja. Uključena je ugniježđena mapa za prilagođavanje boje i ikone svake države. Iako pretraživači ne podržavaju nijedno drugo stanje, oni koji koriste prilagođene stilove mogu lako dodati složenije povratne informacije obrascu.
Imajte na umu da ne preporučujemo prilagođavanje ovih vrijednosti bez modifikacije form-validation-statemixina.
Prilagođeni obrasci
Za još veću prilagodbu i konzistentnost među pretraživačima, koristite naše potpuno prilagođene elemente obrasca da zamijenite zadane postavke preglednika. Izgrađeni su na vrhu semantičke i pristupačne oznake, tako da su solidna zamjena za svaku zadanu kontrolu obrasca.
Polje za potvrdu i radio
Svaki potvrdni okvir i radio <input>i <label>uparivanje su umotani u a <div>da bi se stvorila naša prilagođena kontrola. Strukturno, ovo je isti pristup kao i naš default .form-check.
Koristimo selektor brata i sestra ( ~) za sva naša <input>stanja – na primjer :checked– da pravilno stiliziramo naš prilagođeni indikator obrasca. Kada se kombinuje sa .custom-control-labelklasom, takođe možemo da stilizujemo tekst za svaku stavku na osnovu stanja <input>'.
Sakrivamo zadanu vrijednost <input>pomoću opacityi koristimo .custom-control-labelza izgradnju novog prilagođenog indikatora obrasca umjesto njega sa ::beforei ::after. Nažalost, ne možemo da napravimo prilagođeni samo iz <input>jer CSS contentne radi na tom elementu.
U označenim stanjima koristimo base64 ugrađene SVG ikone iz Open Iconic . Ovo nam pruža najbolju kontrolu za stilizovanje i pozicioniranje u svim pretraživačima i uređajima.
Potvrdni okviri
Prilagođeni potvrdni okviri također mogu koristiti :indeterminatepseudo klasu kada se ručno podese putem JavaScripta (nema dostupnog HTML atributa za njegovo navođenje).
Ako koristite jQuery, nešto poput ovoga bi trebalo biti dovoljno:
Radio
U redu
Onemogućeno
Prilagođeni potvrdni okviri i radio također se mogu onemogućiti. Dodajte disabledlogički atribut na <input>i prilagođeni indikator i opis oznake će biti automatski stilizovani.
Prekidači
Prekidač ima oznaku prilagođenog okvira za potvrdu, ali koristi .custom-switchklasu za prikazivanje prekidača. Prekidači također podržavaju disabledatribut.
Odaberite meni
Prilagođenim <select>izbornicima je potrebna samo prilagođena klasa, .custom-selectda bi pokrenuli prilagođene stilove. Prilagođeni stilovi su ograničeni na <select>početni izgled i ne mogu mijenjati <option>s zbog ograničenja pretraživača.
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:
Domet
Kreirajte prilagođene <input type="range">kontrole sa .custom-range. Traka (pozadina) i palac (vrijednost) su oboje stilizovani tako da se pojavljuju isto u svim pretraživačima. Kako samo IE i Firefox podržavaju „ispunjavanje“ svoje staze s lijeve ili desne strane palca kao sredstvo za vizualno ukazivanje na napredak, mi to trenutno ne podržavamo.
Unosi opsega imaju implicitne vrijednosti za mini max— 0i 100, respektivno. Možete specificirati nove vrijednosti za one koji koriste atribute mini .max
Prema zadanim postavkama, ulazi u raspon se „priključuju“ na vrijednosti cjelobrojnih. Da biste to promijenili, možete odrediti stepvrijednost. U donjem primjeru udvostručujemo broj koraka pomoću step="0.5".
Pregledač 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.
Unos fajla je najgrublji od gomile i zahteva dodatni JavaScript ako želite da ih povežete sa funkcionalnim Odaberi datoteku... i tekstom imena izabranog fajla.
Sakrivamo zadanu datoteku <input>putem opacityi umjesto toga stiliziramo <label>. Dugme se generiše i pozicionira sa ::after. Na kraju, proglašavamo a widthi heighton <input>za pravilan razmak za okolni sadržaj.
Prevođenje ili prilagođavanje stringova pomoću SCSS-a
:lang()Pseudo-klasa se koristi za omogućavanje prijevoda teksta "Pretraži" na druge jezike. Poništite ili dodajte unose u $custom-file-textSass varijablu s relevantnom jezičnom oznakom i lokaliziranim stringovima. Engleske žice se mogu prilagoditi na isti način. Na primjer, evo kako se može dodati španski prijevod (šifra španskog jezika je es):
Evo lang(es)u akciji na prilagođenom unosu datoteke za španski prijevod:
Morate ispravno postaviti jezik vašeg dokumenta (ili njegovog podstabla) kako bi se prikazao ispravan tekst. Ovo se može učiniti pomoću atributa langna elementu <html>ili Content-LanguageHTTP zaglavlja , između ostalih metoda.
Prevođenje ili prilagođavanje stringova pomoću HTML-a
Bootstrap također pruža način za prevođenje teksta "Pregledaj" u HTML sa data-browseatributom koji se može dodati prilagođenoj oznaci unosa (primjer na holandskom):