Eżempji u linji gwida għall-użu għal stili ta 'kontroll tal-formoli, għażliet ta' tqassim, u komponenti tad-dwana għall-ħolqien ta 'varjetà wiesgħa ta' formoli.
Ħarsa ġenerali
Il-kontrolli tal-formoli tal-Bootstrap jespandu fuq l-istili tal-forma Rebooted tagħna bil-klassijiet. Uża dawn il-klassijiet biex tagħżel id-displejs personalizzati tagħhom għal rendering aktar konsistenti fil-browsers u l-apparati.
Kun żgur li tuża typeattribut xieraq fuq l-inputs kollha (eż., emailgħall-indirizz tal-email jew numbergħal informazzjoni numerika) biex tieħu vantaġġ minn kontrolli tal-input aktar ġodda bħall-verifika tal-email, l-għażla tan-numri, u aktar.
Hawn eżempju ta 'malajr biex turi l-istili tal-forma ta' Bootstrap. Kompli aqra għad-dokumentazzjoni dwar il-klassijiet meħtieġa, it-tqassim tal-formoli, u aktar.
Kontrolli tal-formola
Kontrolli tal-forma testwali—bħal <input>s, <select>s, u <textarea>s—huma stilati mal- .form-controlklassi. Inklużi huma stili għad-dehra ġenerali, l-istat tal-fokus, id-daqs, u aktar.
Kun żgur li tesplora l- formoli tad-dwana tagħna biex aktar stil <select>s.
Issettja l-għoli billi tuża klassijiet bħal .form-control-lgu .form-control-sm.
Aqra biss
Żid l- readonlyattribut boolean fuq input biex tevita l-modifika tal-valur tal-input. Inputs li jinqraw biss jidhru eħfef (bħal inputs b'diżabilità), iżda jżommu l-cursor standard.
Test sempliċi biss
Jekk trid li jkollok <input readonly>elementi fil-forma tiegħek stilati bħala test sempliċi, uża l- .form-control-plaintextklassi biex tneħħi l-istil tal-qasam tal-formola default u tippreserva l-marġni u l-ikkuttunar korretti.
Inputs tal-Medda
Issettja l-inputs tal-firxa li jistgħu jiskrollaw orizzontalment billi tuża .form-control-range.
Checkboxes u radjijiet
Checkboxes default u radjijiet huma mtejba bl-għajnuna ta ' .form-check, klassi waħda għaż-żewġ tipi ta' input li ttejjeb it-tqassim u l-imġieba tal-elementi HTML tagħhom . Il-kaxxi ta' kontroll huma biex tagħżel għażla waħda jew diversi f'lista, filwaqt li r-radjijiet huma biex tagħżel għażla waħda minn ħafna.
Il-kaxxi ta' kontroll u r-radjijiet b'diżabbiltà huma appoġġjati, iżda biex tipprovdi not-allowedcursor fuq id-daqq tal-ġenitur <label>, ikollok bżonn iżżid l- disabledattribut mal- .form-check-input. L-attribut b'diżabilità se japplika kulur eħfef biex jgħin jindika l-istat tal-input.
Il-kaxxi ta' kontroll u l-użu tar-radjijiet huma mibnija biex jappoġġjaw il-validazzjoni tal-formoli bbażati fuq HTML u jipprovdu tikketti konċiżi u aċċessibbli. Bħala tali, <input>s u s tagħna <label>huma elementi aħwa għall-kuntrarju ta ' <input>fi ħdan a <label>. Dan huwa kemmxejn aktar verbose peress li trid tispeċifika idu forattributi biex tirrelata l- <input>u <label>.
Default (munzelli)
B'mod awtomatiku, kwalunkwe numru ta' kaxxi ta' kontroll u radjijiet li huma aħwa immedjati se jkunu f'munzelli vertikalment u spazjati b'mod xieraq bi .form-check.
F'konformità
Aggruppa kaxxi ta' kontroll jew radjijiet fuq l-istess ringiela orizzontali billi żżid .form-check-inlinema' kwalunkwe .form-check.
Mingħajr tikketti
Żid .position-staticmal-inputs fi ħdan .form-checkli m'għandhom l-ebda test tat-tikketta. Ftakar li xorta tipprovdi xi forma ta' tikketta għal teknoloġiji ta' assistenza (pereżempju, billi tuża aria-label).
Tqassim
Peress li Bootstrap japplika display: blocku width: 100%għal kważi l-kontrolli kollha tal-formoli tagħna, il-formoli awtomatikament jintivaw vertikalment. Klassijiet addizzjonali jistgħu jintużaw biex ivarjaw dan it-tqassim fuq bażi ta' kull forma.
Forma gruppi
Il- .form-groupklassi hija l-eħfef mod biex iżżid xi struttura mal-formoli. Jipprovdi klassi flessibbli li tinkoraġġixxi grupp xieraq ta 'tikketti, kontrolli, test ta' għajnuna fakultattiv, u messaġġi ta 'validazzjoni tal-formoli. B'mod awtomatiku japplika biss margin-bottom, iżda jiġbor stili addizzjonali .form-inlinekif meħtieġ. Użaha ma ' <fieldset>s, <div>s, jew kważi kull element ieħor.
Forma grilja
Forom aktar kumplessi jistgħu jinbnew bl-użu tal-klassijiet tal-grilja tagħna. Uża dawn għal taqsim tal-formoli li jeħtieġu kolonni multipli, wisgħat varjati, u għażliet ta 'allinjament addizzjonali.
Formola ringiela
Tista 'wkoll tiskambja .rowgħal .form-row, varjazzjoni tar-ringiela standard tal-grilja tagħna li tegħleb il-kanal tal-kolonna default għal layouts aktar stretti u kompatti.
Jistgħu jinħolqu wkoll layouts aktar kumplessi bis-sistema tal-grilja.
Forma orizzontali
Oħloq forom orizzontali mal-grilja billi żżid il- .rowklassi biex tifforma gruppi u tuża l- .col-*-*klassijiet biex tispeċifika l-wisa 'ta' tikketti u kontrolli tiegħek. Kun żgur li żżid .col-form-labelmal- <label>i tiegħek ukoll sabiex ikunu ċċentrata vertikalment mal-kontrolli tal-forma assoċjati tagħhom.
Xi drabi, forsi jkollok bżonn tuża utilitajiet tal-marġni jew tal-ikkuttunar biex toħloq dak l-allinjament perfett li għandek bżonn. Pereżempju, padding-topneħħejna t-tikketta tal-inputs tar-radju stacked tagħna biex tallinja aħjar il-linja bażi tat-test.
Daqs tat-tikketta tal-forma orizzontali
Kun żgur li tuża .col-form-label-smjew .col-form-label-lglill- <label>s jew <legend>s tiegħek biex issegwi b'mod korrett id-daqs ta ' .form-control-lgu .form-control-sm.
Daqs tal-kolonna
Kif muri fl-eżempji preċedenti, is-sistema tal-grilja tagħna tippermettilek tpoġġi kwalunkwe numru ta ' .cols fi ħdan a .rowjew .form-row. Huma ser jaqsmu l-wisa 'disponibbli b'mod ugwali bejniethom. Tista 'wkoll tagħżel subsett tal-kolonni tiegħek biex tieħu aktar jew inqas spazju, filwaqt li l- .coli li jifdal jaqsmu ugwalment il-bqija, bi klassijiet ta' kolonni speċifiċi bħal .col-7.
Auto-sizing
L-eżempju hawn taħt juża utilità flexbox biex iċċentra vertikalment il-kontenut u jibdel .colbiex .col-autoil-kolonni tiegħek jieħdu biss spazju kemm meħtieġ. Fi kliem ieħor, id-daqsijiet tal-kolonna innifsu bbażati fuq il-kontenut.
Tista 'mbagħad remix li għal darb'oħra bi klassijiet ta' kolonni speċifiċi għad-daqs.
Uża l- .form-inlineklassi biex turi serje ta’ tikketti, kontrolli tal-formoli u buttuni fuq ringiela orizzontali waħda. Il-kontrolli tal-formoli fi ħdan il-formoli inline jvarjaw xi ftit mill-istati awtomatiċi tagħhom.
Il-kontrolli huma display: flex, jiġġarrfu kwalunkwe spazju abjad HTML u jippermettulek tipprovdi kontroll tal-allinjament bi spazjar u utilitajiet tal- flexbox .
Il-kontrolli u l-gruppi ta' input jirċievu width: autobiex jegħlbu l-bootstrap default width: 100%.
Il- kontrolli jidhru inline biss f'viewports li huma wiesgħa mill-inqas 576px biex jagħtu kont ta' viewports dojoq fuq apparat mobbli.
Jista 'jkollok bżonn tindirizza manwalment il-wisa' u l-allinjament tal-kontrolli tal-forma individwali b'utilitajiet ta ' spazjar (kif muri hawn taħt). Fl-aħħar nett, kun żgur li dejjem tinkludi <label>ma' kull kontroll tal-formola, anki jekk ikollok bżonn taħbiha minn viżitaturi li ma jaqrawx l-iskrin b' .sr-only.
Il-kontrolli u l-għażla tal-formola tad-dwana huma appoġġjati wkoll.
Alternattivi għal tikketti moħbija
Teknoloġiji ta' assistenza bħal screen readers se jkollhom problemi bil-formoli tiegħek jekk ma tinkludix tikketta għal kull input. Għal dawn il-formoli inline, tista 'taħbi t-tikketti billi tuża l- .sr-onlyklassi. Hemm metodi alternattivi oħra biex tiġi pprovduta tikketta għal teknoloġiji ta' assistenza, bħall- aria-label, aria-labelledbyjew l- titleattribut. Jekk l-ebda waħda minn dawn ma tkun preżenti, it-teknoloġiji ta' assistenza jistgħu jirrikorru għall-użu tal- placeholderattribut, jekk ikun preżenti, iżda innota li l-użu ta' placeholderbħala sostitut għal metodi oħra ta' tikkettjar mhuwiex rakkomandat.
Test ta' għajnuna
Test ta 'għajnuna fil-livell ta' blokk fil-formoli jista 'jinħoloq bl-użu .form-text(magħruf qabel bħala .help-blockfil-v3). It-test ta' għajnuna inline jista' jiġi implimentat b'mod flessibbli bl-użu ta' kwalunkwe element HTML inline u klassijiet ta' utilità bħal .text-muted.
Assoċja test ta' għajnuna mal-kontrolli tal-formoli
It-test tal-għajnuna għandu jkun assoċjat b'mod espliċitu mal-kontroll tal-forma li jirrelata mal-użu tal- aria-describedbyattribut. Dan se jiżgura li t-teknoloġiji ta' assistenza—bħal screen readers—se jħabbru dan it-test ta' għajnuna meta l-utent jiffoka jew jidħol fil-kontroll.
It-test ta' għajnuna hawn taħt l-inputs jista' jiġi stilat bi .form-text. Din il-klassi tinkludi display: blocku żżid xi marġni ta 'fuq għal spazjar faċli mill-inputs ta' hawn fuq.
Il-password tiegħek għandu jkun twil 8-20 karattru, ikun fih ittri u numri, u m'għandux ikun fih spazji, karattri speċjali, jew emoji.
It-test inline jista 'juża kwalunkwe element HTML inline tipiku (kemm jekk ikun <small>, <span>, jew xi ħaġa oħra) b'xejn aktar minn klassi ta' utilità.
Formoli b'diżabilità
Żid l- disabledattribut boolean fuq input biex tevita l-interazzjonijiet tal-utent u tagħmilha tidher eħfef.
Żid l- disabledattribut ma 'a <fieldset>biex tiddiżattiva l-kontrolli kollha ġewwa.
Avviż bl-ankri
B'mod awtomatiku, il-browsers se jittrattaw il-kontrolli tal-forma nattiva kollha ( <input>, <select>u l- <button>elementi) ġewwa <fieldset disabled>bħala diżattivati, u jipprevjenu kemm it-tastiera kif ukoll l-interazzjonijiet tal-maws fuqhom. Madankollu, jekk il-formola tiegħek tinkludi wkoll <a ... class="btn btn-*">elementi, dawn jingħataw biss stil ta' pointer-events: none. Kif innutat fit-taqsima dwar l-istat diżattivat għall-buttuni (u speċifikament fis-subsezzjoni għall-elementi tal-ankra), din il-proprjetà CSS għadha mhix standardizzata u mhix appoġġjata bis-sħiħ f'Internet Explorer 10, u mhux se tipprevjeni lill-utenti tat-tastiera milli jkunu kapaċi jiffokaw jew jattivaw dawn ir-rabtiet. Allura biex tkun sigura, uża JavaScript personalizzat biex tiddiżattiva links bħal dawn.
Kompatibilità bejn il-browser
Filwaqt li Bootstrap se japplika dawn l-istili fil-brawżers kollha, l-Internet Explorer 11 u inqas ma jappoġġjawx bis-sħiħ l- disabledattribut fuq <fieldset>. Uża JavaScript personalizzat biex tiddiżattiva l-fieldset f'dawn il-browsers.
Validazzjoni
Ipprovdi feedback siewi u azzjonabbli lill-utenti tiegħek b'validazzjoni tal-formola HTML5 – disponibbli fil-browsers kollha appoġġjati tagħna . Agħżel mill-feedback tal-validazzjoni default tal-browser, jew implimenta messaġġi personalizzati bil-klassijiet inkorporati tagħna u bil-JavaScript starter.
Bħalissa nirrakkomandaw li tuża stili ta' validazzjoni personalizzati, peress li l-messaġġi ta' validazzjoni default tal-brawżer nattiv mhumiex esposti b'mod konsistenti għal teknoloġiji ta' assistenza fil-brawżers kollha (l-aktar, Chrome fuq id-desktop u l-mowbajl).
Kif taħdem
Hawn kif taħdem il-validazzjoni tal-formola ma Bootstrap:
Il-validazzjoni tal-formola HTML hija applikata permezz taż-żewġ psewdo-klassijiet tas-CSS, :invalidu :valid. Japplika għal <input>, <select>, u <textarea>elementi.
Bootstrap ikopri l- :invalidu stili għall- klassi :validġenitur , normalment applikati għall- . Inkella, kwalunkwe qasam meħtieġ mingħajr valur jidher bħala invalidu fit-tagħbija tal-paġna. B'dan il-mod, tista' tagħżel meta tattivahom (tipikament wara li tiġi ppruvata s-sottomissjoni tal-formola)..was-validated<form>
Biex terġa' tissettja d-dehra tal-formola (pereżempju, fil-każ ta' sottomissjonijiet dinamiċi ta' formola bl-użu ta' AJAX), neħħi l- .was-validatedklassi mill- <form>ġdid wara s-sottomissjoni.
Bħala riżerva, .is-invalidu l- .is-validklassijiet jistgħu jintużaw minflok il-psewdo-klassijiet għall -validazzjoni tan-naħa tas-server . Ma jeħtiġux .was-validatedklassi ġenitur.
Minħabba restrizzjonijiet fil-mod kif jaħdem is-CSS, ma nistgħux (fil-preżent) napplikaw stili għal <label>li jiġi qabel kontroll tal-formola fid-DOM mingħajr l-għajnuna ta 'JavaScript personalizzat.
Il-browsers moderni kollha jappoġġjaw l- API tal-validazzjoni tar-restrizzjoni , serje ta' metodi JavaScript għall-validazzjoni tal-kontrolli tal-formoli.
Messaġġi ta 'feedback jistgħu jutilizzaw in- nuqqasijiet tal-browser (differenti għal kull browser, u mhux stilabbli permezz ta' CSS) jew l-istili ta 'feedback personalizzati tagħna b'HTML u CSS addizzjonali.
Tista' tipprovdi messaġġi ta' validità personalizzati setCustomValidityf'JavaScript.
B'dan f'moħħu, ikkunsidra d-demos li ġejjin għall-istili ta 'validazzjoni tal-formoli tad-dwana tagħna, klassijiet fakultattivi tan-naħa tas-server, u defaults tal-browser.
Stili tad-dwana
Għal messaġġi ta' validazzjoni tal-formola Bootstrap tad-dwana, ikollok bżonn iżżid l- novalidateattribut boolean ma' <form>. Dan iwaqqaf it-tooltips ta' feedback default tal-browser, iżda xorta jipprovdi aċċess għall-APIs tal-validazzjoni tal-formoli f'JavaScript. Ipprova tissottometti l-formola hawn taħt; JavaScript tagħna se jinterċetta l-buttuna tissottometti u jibgħat feedback lilek.
Mhux interessat f'messaġġi ta' feedback ta' validazzjoni tad-dwana jew tikteb JavaScript biex tibdel l-imgieba tal-formoli? Kollox tajjeb, tista 'tuża l-inadempjenzi tal-browser. Ipprova ibgħat il-formola hawn taħt. Skont il-browser u l-OS tiegħek, tara stil ta' feedback kemmxejn differenti.
Filwaqt li dawn l-istili ta 'feedback ma jistgħux jiġu stilati b'CSS, xorta tista' tippersonalizza t-test tal-feedback permezz ta' JavaScript.
In-naħa tas-server
Nirrakkomandaw li tuża validazzjoni tan-naħa tal-klijent, iżda f'każ li teħtieġ in-naħa tas-server, tista' tindika oqsma tal-formola invalidi u validi bi .is-invalidu .is-valid. Innota li .invalid-feedbackhija wkoll appoġġjata b'dawn il-klassijiet.
Elementi appoġġjati
Il-formoli ta’ eżempju tagħna juru s testwali indiġeni <input>hawn fuq, iżda stili ta’ validazzjoni tal-formoli huma disponibbli wkoll għall-kontrolli tal-formoli tad-dwana tagħna.
Tooltips
Jekk it-tqassim tal-formola tiegħek jippermetti dan, tista' tbiddel il- .{valid|invalid}-feedbackklassijiet għal .{valid|invalid}-tooltipklassijiet biex turi feedback ta' validazzjoni f'tooltip stilat. Kun żgur li jkollok ġenitur position: relativefuqha għall-ippożizzjonar tal-għodda. Fl-eżempju hawn taħt, il-klassijiet tal-kolonni tagħna diġà għandhom dan, iżda l-proġett tiegħek jista 'jeħtieġ setup alternattiv.
Formoli tad-dwana
Għal aktar customization u konsistenza cross browser, uża l-elementi tal-forma kompletament personalizzati tagħna biex tissostitwixxi l-inadempjenzi tal-browser. Huma mibnija fuq il-markup semantiku u aċċessibbli, għalhekk huma sostituti sodi għal kwalunkwe kontroll tal-forma default.
Checkboxes u radjijiet
Kull checkbox u radju huma mgeżwra <div>b'aħwa <span>biex jinħoloq il-kontroll tad-dwana tagħna u <label>għat-test li jakkumpanja. Strutturalment, dan huwa l-istess approċċ bħall-inadempjenza tagħna .form-check.
Aħna nużaw is-selettur tal-aħwa ( ~) għall- <input>istati kollha tagħna—bħal— :checkedbiex nistiljaw sew l-indikatur tal-forma personalizzat tagħna. Meta kkombinat mal- .custom-control-labelklassi, nistgħu wkoll stil tat-test għal kull oġġett ibbażat fuq l- <input>istat ta '.
Aħna naħbu l-inadempjenza <input>bi opacityu nużaw il- .custom-control-labelbiex nibnu indikatur ġdid tal-forma tad-dwana minfloku bi ::beforeu ::after. Sfortunatament ma nistgħux nibnu waħda tad-dwana minn sempliċement <input>minħabba li s-CSS contentma jaħdimx fuq dak l-element.
Fl-istati kkontrollati, nużaw ikoni SVG inkorporati base64 minn Open Iconic . Dan jagħtina l-aħjar kontroll għall-istil u l-ippożizzjonar fil-browsers u l-apparati.
Kaxxi ta' kontroll
Il-kaxxi ta' kontroll tad-dwana jistgħu wkoll jużaw il- :indeterminatepsewdo klassi meta ssettjati manwalment permezz ta' JavaScript (m'hemm l-ebda attribut HTML disponibbli biex jiġi speċifikat).
Jekk qed tuża jQuery, xi ħaġa bħal din għandha tkun biżżejjed:
Radjijiet
F'konformità
B'diżabilità
Kaxxi ta' kontroll u radjijiet personalizzati jistgħu wkoll jiġu diżattivati. Żid l- disabledattribut boolean mal- <input>u l-indikatur tad-dwana u d-deskrizzjoni tat-tikketta se jiġu stilizzati awtomatikament.
Agħżel menu
Il-menus tad- dwana <select>jeħtieġu biss klassi tad-dwana, .custom-selectbiex tiskatta l-istili tad-dwana. L-istili tad-dwana huma limitati għad- <select>dehra inizjali tal-'s u ma jistgħux jimmodifikaw is- <option>s minħabba limitazzjonijiet tal-browser.
Tista' wkoll tagħżel minn selezzjonijiet tad-dwana żgħar u kbar biex jaqblu ma' l-inputs tat-test tagħna ta' daqs simili.
L- multipleattribut huwa appoġġjat ukoll:
Kif inhu l- sizeattribut:
Firxa
Oħloq <input type="range">kontrolli tad-dwana b' .custom-range. Il-binarju (l-isfond) u l-kbir (il-valur) huma t-tnejn stilati biex jidhru l-istess madwar il-browsers. Peress li l-IE u l-Firefox biss jappoġġjaw il-"mili" tal-binarji tagħhom mix-xellug jew il-lemin tal-kbir bħala mezz biex jindikaw viżwalment il-progress, bħalissa ma nappoġġjawhx.
L-inputs tal-firxa għandhom valuri impliċiti għal minu max— 0u 100, rispettivament. Tista' tispeċifika valuri ġodda għal dawk li jużaw l- attributi minu .max
B'mod awtomatiku, firxa inputs "snap" għal valuri interi. Biex tibdel dan, tista 'tispeċifika stepvalur. Fl-eżempju hawn taħt, aħna nirduppjaw in-numru ta 'passi billi nużaw step="0.5".
Browser tal-fajl
L-input tal-fajl huwa l-aktar gnarly tal-mazz u jeħtieġ JavaScript addizzjonali jekk tixtieq tgħaqqadhom b'Agħżel fajl funzjonali... u test tal-isem tal-fajl magħżul.
Aħna naħbu l-fajl default <input>permezz opacityu minflok stil l- <label>. Il-buttuna hija ġġenerata u pożizzjonata b' ::after. Fl-aħħar nett, niddikjaraw a widthu heightfuq il- <input>għal spazjar xieraq għall-kontenut tal-madwar.
It-traduzzjoni jew l-adattament tal-kordi
Il :lang()-psewdo-klassi tintuża biex tippermetti traduzzjoni tat-test "Ibbrawżja" f'lingwi oħra. Iċċekkja jew żid l-entrati mal- $custom-file-textvarjabbli Sass bit- tikketta tal-lingwa rilevanti u strings lokalizzati. Il-kordi Ingliżi jistgħu jiġu personalizzati bl-istess mod. Per eżempju, hawn kif wieħed jista 'jżid traduzzjoni Spanjola (il-kodiċi tal-lingwa Spanjola huwa es):
Hawn lang(es)fl-azzjoni dwar l-input tal-fajl personalizzat għal traduzzjoni Spanjola:
Ikollok bżonn issettja l-lingwa tad-dokument tiegħek (jew is-subsiġra tiegħu) b'mod korrett sabiex jintwera t-test korrett. Dan jista 'jsir billi tuża l- langattribut fuq l- <html>element jew l- Content-Languageheader HTTP , fost metodi oħra.