Dæmi og notkunarleiðbeiningar fyrir eyðublaðastýringarstíla, útlitsvalkosti og sérsniðna íhluti til að búa til fjölbreytt úrval eyðublaða.
Yfirlit
Formstýringar Bootstrap stækka við endurræst formstíla okkar með flokkum. Notaðu þessa flokka til að velja sérsniðna skjái til að fá samkvæmari birtingu á milli vafra og tækja.
Vertu viss um að nota viðeigandi typeeiginleika á öllum innsendum (td emailfyrir netfang eða numberfyrir tölulegar upplýsingar) til að nýta nýrri innsláttarstýringar eins og staðfestingu tölvupósts, númeraval og fleira.
Hér er fljótlegt dæmi til að sýna fram á formstíl Bootstrap. Haltu áfram að lesa til að fá skjöl um nauðsynlega flokka, uppsetningu eyðublaða og fleira.
Formstýringar
Textaformstýringar - eins og <input>s, <select>s og <textarea>s - eru stílaðar með .form-controlbekknum. Innifalið eru stíll fyrir almennt útlit, fókusstöðu, stærð og fleira.
Vertu viss um að skoða sérsniðin eyðublöð okkar til að auka stíl <select>s.
Fyrir skráarinntak skaltu skipta um .form-controlfyrir .form-control-file.
Stærð
Stilltu hæðir með því að nota flokka eins .form-control-lgog og .form-control-sm.
Lesið aðeins
Bættu readonlyboolean eigindinni við inntak til að koma í veg fyrir breytingar á gildi inntaksins. Lesinntak virðist léttari (alveg eins og óvirkt inntak), en heldur venjulegum bendili.
Skrifvarinn venjulegur texti
Ef þú vilt hafa <input readonly>þætti á eyðublaðinu þínu stílaða sem venjulegan texta, notaðu .form-control-plaintextflokkinn til að fjarlægja sjálfgefna formreitsnið og varðveita rétta spássíu og fyllingu.
Range-inntak
Stilltu lárétt skrunanleg sviðsinntak með því að nota .form-control-range.
Gátreitir og útvarp
Sjálfgefin gátreitir og útvarpstæki eru endurbætt með hjálp .form-checkeins flokks fyrir báðar inntakstegundir sem bætir útlit og hegðun HTML þátta þeirra . Gátreitir eru til að velja einn eða fleiri valmöguleika á lista, en útvarp eru til að velja einn valmöguleika af mörgum.
Óvirkir gátreiti og útvarp eru studd. Eigindin disabledmun beita ljósari lit til að gefa til kynna stöðu inntaksins.
Gátreitir og valhnappar styðja HTML-undirstaða löggildingu eyðublaða og veita hnitmiðaða, aðgengilega merkimiða. Sem slík eru <input>s og <label>s systkinaþættir öfugt við <input>innan <label>. Þetta er örlítið orðrétt þar sem þú verður að tilgreina idog foreiginleika til að tengja <input>og <label>.
Sjálfgefið (staflað)
Sjálfgefið er að hvaða fjölda gátreita og útvarpsstöðva sem eru strax systkini verða lóðrétt staflað og á viðeigandi bili með .form-check.
Í línu
Flokkaðu gátreiti eða útvarpstæki í sömu láréttu röðina með því að bæta .form-check-inlinevið hvaða .form-check.
Án merkimiða
Bæta .position-staticvið inntak innan .form-checksem eru ekki með neinn merkitexta. Mundu að gefa samt upp einhvers konar merki fyrir hjálpartækni (til dæmis með því að nota aria-label).
Skipulag
Þar sem Bootstrap á við display: blockog width: 100%fyrir næstum allar formstýringar okkar munu eyðublöð sjálfgefið stafla lóðrétt. Hægt er að nota fleiri flokka til að breyta þessu skipulagi eftir formi.
Myndaðu hópa
Bekkurinn .form-grouper auðveldasta leiðin til að bæta einhverri uppbyggingu við form. Það býður upp á sveigjanlegan flokk sem hvetur til réttrar flokkunar merkimiða, stýringa, valfrjáls hjálpartexta og eyðublaðsstaðfestingarskilaboða. Sjálfgefið gildir það aðeins margin-bottom, en það tekur upp viðbótarstíla .form-inlineeftir þörfum. Notaðu það með <fieldset>s, <div>s eða næstum hvaða öðrum þáttum sem er.
Myndaðu rist
Hægt er að búa til flóknari form með því að nota grid flokkana okkar. Notaðu þetta fyrir eyðublaðaútlit sem krefjast margra dálka, fjölbreyttrar breiddar og viðbótarjöfnunarvalkosta.
Myndaröð
Þú getur líka skipt út .rowfyrir .form-row, afbrigði af stöðluðu línunetslínunni okkar sem hnekkir sjálfgefnum dálkarrennum fyrir þéttari og þéttari skipulag.
Einnig er hægt að búa til flóknari skipulag með ristkerfinu.
Lárétt form
Búðu til lárétt eyðublöð með hnitanetinu með því að bæta .rowbekknum við mynda hópa og nota .col-*-*flokkana til að tilgreina breidd merkimiða og stýringa. Gakktu úr skugga um að bæta .col-form-labelvið <label>s þínum líka svo þau séu lóðrétt í miðju með tilheyrandi formstýringum.
Stundum þarftu kannski að nota spássíu- eða fyllingartæki til að búa til þá fullkomnu röðun sem þú þarft. Til dæmis höfum við fjarlægt padding-topmerkimiðann á staflaða útvarpsinntakinu okkar til að samræma grunnlínuna betur.
Lárétt stærð merkimiða
Vertu viss um að nota .col-form-label-smeða .col-form-label-lgvið <label>s eða <legend>s til að fylgja réttri stærð .form-control-lgog .form-control-sm.
Stærð súlu
Eins og sýnt er í fyrri dæmum, gerir netkerfi okkar þér kleift að setja hvaða fjölda .cols sem er innan a .roweða .form-row. Þeir munu skipta tiltækri breidd jafnt á milli sín. Þú getur líka valið hlutmengi af dálkunum þínum til að taka meira eða minna pláss, en hinir dálkarnir .colskipta jafnt afganginum, með sérstökum dálkaflokkum eins og .col-7.
Sjálfvirk stærð
Dæmið hér að neðan notar flexbox tól til að miðja innihaldið lóðrétt og breytist .colþannig .col-autoað dálkarnir þínir taka aðeins eins mikið pláss og þarf. Með öðrum hætti, dálkurinn stærðir sig sjálfan út frá innihaldi.
Þú getur síðan endurblandað það aftur með stærðarsértækum dálkaflokkum.
Notaðu .form-inlinebekkinn til að sýna röð af merkjum, eyðublaðastýringum og hnöppum á einni láréttri röð. Eyðublaðastýringar innan innbyggðra eyðublaða eru örlítið frábrugðnar sjálfgefnum stöðu þeirra.
Stýringar eru display: flex, draga saman hvaða HTML hvíta bil sem er og leyfa þér að veita jöfnunarstýringu með bili og flexbox tólum.
Stýringar og inntakshópar fá width: autotil að hnekkja sjálfgefnu Bootstrap width: 100%.
Stýringar birtast aðeins innbyggðar í útsýnisgluggum sem eru að minnsta kosti 576px á breidd til að taka tillit til þröngra útsýnisgátta í fartækjum.
Þú gætir þurft að takast á handvirkt við breidd og röðun einstakra eyðublaðastýringa með biltólum (eins og sýnt er hér að neðan). Að lokum, vertu viss um að hafa alltaf a <label>með hverri eyðublaðastýringu, jafnvel þótt þú þurfir að fela það fyrir gestum sem ekki eru skjálesarar með .sr-only.
Sérsniðnar formstýringar og val eru einnig studd.
Val við falin merki
Hjálpartækni eins og skjálesarar munu eiga í vandræðum með eyðublöðin þín ef þú hefur ekki merkimiða fyrir hvert inntak. Fyrir þessi innbyggðu eyðublöð geturðu falið merkimiðana með því að nota .sr-onlybekkinn. Það eru aðrar aðrar aðferðir til að útvega merki fyrir hjálpartækni, svo sem aria-label, aria-labelledbyeða titleeigindina. Ef ekkert af þessu er til staðar gæti hjálpartækni gripið til þess að nota placeholdereiginleikann, ef hann er til staðar, en athugaðu að placeholderekki er mælt með því að nota það í staðinn fyrir aðrar merkingaraðferðir.
Hjálpartexti
Hægt er að búa til hjálpartexta á blokkum á eyðublöðum með því að nota .form-text(áður þekkt sem .help-blockí v3). Hægt er að útfæra innbyggða hjálpartexta á sveigjanlegan hátt með því að nota hvaða innbyggða HTML frumefni og gagnsemisflokka eins og .text-muted.
Að tengja hjálpartexta við formstýringar
Hjálpartexti ætti að vera sérstaklega tengdur við formstýringuna sem hann tengist með því að nota aria-describedbyeigindina. Þetta mun tryggja að hjálpartækni – eins og skjálesarar – tilkynni þennan hjálpartexta þegar notandinn einbeitir sér eða fer inn í stýringuna.
Hægt er að stilla hjálpartexta fyrir neðan inntak með .form-text. Þessi flokkur inniheldur display: blockog bætir við nokkrum efstu framlegð til að auðvelda bilið frá inntakunum hér að ofan.
Lykilorðið þitt verður að vera 8-20 stafir að lengd, innihalda bókstafi og tölustafi og má ekki innihalda bil, sérstafi eða emoji.
Innbyggður texti getur notað hvaða dæmigerða innbyggða HTML frumefni (hvort sem það er <small>, <span>, eða eitthvað annað) með ekkert annað en gagnsemisflokk.
Óvirk eyðublöð
Bættu disabledboolean eigindinni við inntak til að koma í veg fyrir samskipti notenda og láta það virðast léttara.
Bættu disabledeigindinni við a <fieldset>til að slökkva á öllum stjórntækjum innan.
Fyrirvari með akkerum
Sjálfgefið er að vafrar meðhöndla allar innbyggðar formstýringar ( <input>, <select>og <button>þættir) inni í a <fieldset disabled>sem óvirka, sem kemur í veg fyrir samskipti bæði með lyklaborði og mús á þeim. Hins vegar, ef eyðublaðið þitt inniheldur einnig <a ... class="btn btn-*">þætti, munu þessir aðeins fá stíllinn pointer-events: none. Eins og fram kemur í hlutanum um óvirkt ástand fyrir hnappa (og sérstaklega í undirkaflanum fyrir akkerisþætti), er þessi CSS eign ekki enn staðlað og er ekki að fullu studd í Internet Explorer 10 og mun ekki koma í veg fyrir að lyklaborðsnotendur séu fær um að einbeita sér eða virkja þessa tengla. Svo til öryggis skaltu nota sérsniðið JavaScript til að slökkva á slíkum hlekkjum.
Samhæfni milli vafra
Þó að Bootstrap muni beita þessum stílum í öllum vöfrum, styðja Internet Explorer 11 og neðar ekki að fullu disabledeiginleikann á <fieldset>. Notaðu sérsniðið JavaScript til að slökkva á reitsettinu í þessum vöfrum.
Staðfesting
Gefðu notendum þínum verðmæta og hagnýta endurgjöf með HTML5 eyðublaði – fáanlegt í öllum studdum vöfrum okkar . Veldu úr sjálfgefnum staðfestingarviðbrögðum vafrans, eða settu í notkun sérsniðin skilaboð með innbyggðum flokkum okkar og byrjunar-JavaScript.
Eins og er mælum við með því að nota sérsniðna staðfestingarstíl, þar sem sjálfgefin staðfestingarskilaboð í innfæddum vafra eru ekki stöðugt útsett fyrir hjálpartækni í öllum vöfrum (einkum Chrome á skjáborði og farsímum).
Hvernig það virkar
Svona virkar formprófun með Bootstrap:
Staðfestingu HTML forms er beitt í gegnum tvo gerviflokka CSS :invalidog :valid. Það á við um <input>, <select>, og <textarea>þætti.
Bootstrap nær yfir :invalidog :validstíla í foreldraflokk .was-validated, venjulega notað á <form>. Annars birtast allir nauðsynlegir reitir án gildis sem ógildir við hleðslu síðu. Þannig geturðu valið hvenær þú vilt virkja þau (venjulega eftir að reynt er að senda inn eyðublað).
Til að endurstilla útlit eyðublaðsins (til dæmis ef um er að ræða kraftmikla innsendingar eyðublaða með AJAX), fjarlægðu .was-validatedbekkinn úr <form>aftur eftir innsendingu.
Sem varaflokkur .is-invalidog .is-validhægt er að nota flokka í stað gerviflokka fyrir staðfestingu á netþjóni . Þeir þurfa ekki .was-validatedforeldraflokk.
Vegna takmarkana á því hvernig CSS virkar, getum við (sem stendur) ekki beitt stílum á a <label>sem kemur á undan formstýringu í DOM án hjálpar sérsniðins JavaScript.
Allir nútíma vafrar styðja þvingunarprófunar-API , röð JavaScript-aðferða til að staðfesta formstýringar.
Ábendingaskilaboð kunna að nota sjálfgefnar stillingar vafrans (mismunandi fyrir hvern vafra og óstílfærðar í gegnum CSS) eða sérsniðna endurgjöfarstíla okkar með viðbótar HTML og CSS.
Þú getur útvegað sérsniðin gildisskilaboð með setCustomValidityJavaScript.
Með það í huga skaltu íhuga eftirfarandi kynningar fyrir sérsniðna löggildingarstíla okkar, valfrjálsa miðlaraflokka og sjálfgefna vafra.
Sérsniðin stíll
Fyrir sérsniðin staðfestingarskilaboð fyrir Bootstrap form þarftu að bæta novalidateboolean eigindinni við <form>. Þetta slekkur á sjálfgefnum ábendingum um endurgjöf vafrans, en veitir samt aðgang að eyðublaðaprófunarforritaskilum í JavaScript. Reyndu að senda inn eyðublaðið hér að neðan; JavaScript okkar mun stöðva sendingarhnappinn og senda endurgjöf til þín. Þegar þú reynir að senda inn, muntu sjá :invalidog :validstíll notaður á eyðublaðastýringum þínum.
Sérsniðin endurgjöfarstíll notar sérsniðna liti, ramma, fókusstíla og bakgrunnstákn til að miðla endurgjöfum betur. Bakgrunnstákn fyrir <select>s eru aðeins fáanleg með .custom-select, og ekki .form-control.
Sjálfgefnar stillingar vafra
Hefurðu ekki áhuga á sérsniðnum staðfestingarskilaboðum eða að skrifa JavaScript til að breyta hegðun eyðublaða? Allt í góðu, þú getur notað sjálfgefnar stillingar vafrans. Prófaðu að senda inn eyðublaðið hér að neðan. Það fer eftir vafranum þínum og stýrikerfi, þú munt sjá aðeins mismunandi stíl af endurgjöf.
Þó að ekki sé hægt að stíla þessa endurgjöf með CSS, geturðu samt sérsniðið endurgjöfartextann í gegnum JavaScript.
Server hlið
Við mælum með því að nota sannprófun viðskiptavinarhliðar, en ef þú þarfnast staðfestingar á netþjóni geturðu gefið til kynna ógilda og gilda eyðublaðareiti með .is-invalidog .is-valid. Athugaðu að það .invalid-feedbacker einnig stutt með þessum flokkum.
Stuðningsþættir
Staðfestingarstílar eru fáanlegir fyrir eftirfarandi formstýringar og íhluti:
<input>s og <textarea>s með .form-control(þar á meðal allt að einn .form-controlí inntakshópum)
<select>s með .form-controleða.custom-select
.form-checks
.custom-checkboxs og .custom-radios
.custom-file
Verkfæraráð
Ef útlit eyðublaðsins þíns leyfir það geturðu skipt um .{valid|invalid}-feedbackflokka fyrir .{valid|invalid}-tooltipflokka til að birta staðfestingarviðbrögð í stíluðum verkfæraleiðbeiningum. Vertu viss um að hafa foreldri með position: relativeá því til að staðsetja tól. Í dæminu hér að neðan eru dálkaflokkarnir okkar með þetta nú þegar, en verkefnið þitt gæti þurft aðra uppsetningu.
Sérsníða
Hægt er að aðlaga löggildingarstöðu í gegnum Sass með $form-validation-stateskortinu. Þetta Sass kort er staðsett í skránni okkar _variables.scssog er lykkjuð yfir til að búa til sjálfgefna valid/ invalidstaðfestingarstöðu. Innifalið er hreiður kort til að sérsníða lit og tákn hvers ríkis. Þó að engin önnur ríki séu studd af vöfrum, geta þeir sem nota sérsniðna stíl auðveldlega bætt við flóknari endurgjöf.
Vinsamlegast athugaðu að við mælum ekki með því að sérsníða þessi gildi án þess að breyta líka form-validation-stateblöndunni.
Sérsniðin eyðublöð
Til að sérsníða enn frekar og samkvæmni þvert yfir vafra skaltu nota algjörlega sérsniðna eyðublaðseiningar okkar til að skipta út sjálfgefnum vafrastillingum. Þau eru byggð ofan á merkingarfræðilegri og aðgengilegri merkingu, svo þau koma í staðin fyrir hvaða sjálfgefna formstýringu sem er.
Gátreitir og útvarp
Hver gátreitur og útvarp <input>og <label>pörun er pakkað inn í <div>til að búa til sérsniðna stjórnun okkar. Skipulega séð er þetta sama nálgun og sjálfgefið okkar .form-check.
Við notum systkinavalið ( ~) fyrir öll <input>fylki okkar - eins og :checked- til að stilla sérsniðna eyðublaðið okkar rétt. Þegar það er sameinað .custom-control-labelbekknum getum við líka stílað textann fyrir hvert atriði út frá <input>ástandinu 's.
Við felum sjálfgefið <input>með opacityog notum til .custom-control-labelað búa til nýjan sérsniðna eyðublaðsvísi í staðinn með ::beforeog ::after. Því miður getum við ekki smíðað sérsniðna af <input>því að CSS contentvirkar ekki á þeim þætti.
Í merktum ríkjum notum við base64 innbyggð SVG tákn frá Open Iconic . Þetta veitir okkur bestu stjórnina fyrir stíl og staðsetningu milli vafra og tækja.
Gátreitir
Sérsniðnir gátreitir geta einnig notað :indeterminategerviflokkinn þegar hann er stilltur handvirkt í gegnum JavaScript (engin HTML eiginleiki er tiltækur til að tilgreina hann).
Ef þú ert að nota jQuery ætti eitthvað eins og þetta að duga:
Útvarpstæki
Í línu
Öryrkjar
Einnig er hægt að slökkva á sérsniðnum gátreitum og útvörpum. Bættu disabledboolean eigindinni við <input>og sérsniðinn vísir og merkimiðalýsing verður sjálfkrafa stíluð.
Rofar
Rofi hefur merkingu sérsniðins gátreits en notar .custom-switchflokkinn til að gera skiptirofa. Rofar styðja einnig disabledeiginleikann.
Veldu valmynd
Sérsniðnar <select>valmyndir þurfa aðeins sérsniðinn flokk .custom-selecttil að kveikja á sérsniðnum stílum. Sérsniðnar stílar takmarkast við <select>upphaflegt útlit og geta ekki breytt <option>s vegna takmarkana vafra.
Þú getur líka valið úr litlum og stórum sérsniðnum valkostum til að passa við textainnslátt okkar í svipaðri stærð.
Eigindin multipleer einnig studd:
Eins er sizeeiginleiki:
Svið
Búðu til sérsniðnar <input type="range">stýringar með .custom-range. Lagið (bakgrunnurinn) og þumalfingur (gildið) eru báðir stílaðir til að birtast eins í vöfrum. Þar sem aðeins IE og Firefox styðja að „fylla“ lag sitt frá vinstri eða hægri á þumalfingri sem leið til að sýna framfarir sjónrænt styðjum við það ekki eins og er.
Sviðsinntak hafa óbein gildi fyrir minog max— 0og 100, í sömu röð. Þú getur tilgreint ný gildi fyrir þá sem nota minog maxeiginleikana.
Sjálfgefið er að sviðsinntak "smella" við heiltölugildi. Til að breyta þessu geturðu tilgreint stepgildi. Í dæminu hér að neðan tvöföldum við fjölda skrefa með því að nota step="0.5".
Skráavafri
Viðbótin sem mælt er með til að lífga sérsniðið skráarinntak: bs-custom-file-input , það er það sem við erum að nota núna hér í skjölunum okkar.
Skráarinnslátturinn er snjallastur af hópnum og krefst viðbótar JavaScript ef þú vilt tengja þau við virka Veldu skrá ... og valinn texta skráarheita.
Við felum sjálfgefna skrána <input>í gegnum opacityog stílum í staðinn <label>. Hnappurinn er búinn til og staðsettur með ::after. Að lokum lýsum við yfir a widthog heightá <input>fyrir rétt bil fyrir nærliggjandi efni.
Þýða eða sérsníða strengina með SCSS
Gerviflokkurinn :lang()er notaður til að leyfa þýðingu á „Browse“ textanum á önnur tungumál. Hneka eða bæta við færslum við $custom-file-textSass breytuna með viðeigandi tungumálamerki og staðfærðum strengjum. Ensku strengina er hægt að aðlaga á sama hátt. Til dæmis, hér er hvernig hægt er að bæta við spænskri þýðingu (tungumálakóði spænsku er es):
Hér er lang(es)í aðgerð á sérsniðnu skráarinntaki fyrir spænska þýðingu:
Þú þarft að stilla tungumál skjalsins þíns (eða undirtré þess) rétt til að réttur texti birtist. Þetta er hægt að gera með því að nota langeigindina á <html>frumefninu eða Content-LanguageHTTP hausnum , meðal annarra aðferða.
Þýða eða sérsníða strengina með HTML
Bootstrap býður einnig upp á leið til að þýða „Browse“ textann í HTML með data-browseeigindinni sem hægt er að bæta við sérsniðna inntaksmerkið (dæmi á hollensku):