Formų valdymo stilių, išdėstymo parinkčių ir pasirinktinių komponentų, skirtų įvairioms formoms kurti, pavyzdžiai ir naudojimo gairės.
Apžvalga
„Bootstrap“ formų valdikliai išplečia iš naujo paleistų formų stilius su klasėmis. Naudokite šias klases, kad pasirinktumėte tinkintus ekranus, kad naršyklėse ir įrenginiuose būtų nuoseklesnis atvaizdavimas.
Būtinai naudokite atitinkamą typeatributą visoms įvestims (pvz., emailel. pašto adresui arba numberskaitmeninei informacijai), kad galėtumėte pasinaudoti naujesniais įvesties valdikliais, pvz., el. pašto patvirtinimu, numerių pasirinkimu ir kt.
Štai trumpas pavyzdys, kaip parodyti „Bootstrap“ formų stilius. Skaitykite toliau, kad gautumėte dokumentus apie reikalingas klases, formų išdėstymą ir kt.
Formos valdikliai
Tekstiniai formų valdikliai, pvz <input>., s, <select>s ir <textarea>s, yra kuriami pagal .form-controlklasę. Įtraukti stiliai, skirti bendrajai išvaizdai, fokusavimo būsenai, dydžio nustatymui ir kt.
Būtinai ištirkite mūsų pasirinktines formas , kad papildytumėte stilių <select>.
.form-controlNorėdami įvesti failus, pakeiskite į .form-control-file.
Dydžio nustatymas
Nustatykite aukščius naudodami tokias klases kaip .form-control-lgir .form-control-sm.
Tik skaitymui
Pridėkite readonlyloginį atributą įvestyje, kad išvengtumėte įvesties vertės pakeitimo. Tik skaitomos įvestys atrodo šviesesnės (kaip ir išjungtos įvestys), tačiau išlaiko standartinį žymeklį.
Tik skaitomas paprastas tekstas
Jei norite, kad <input readonly>formos elementai būtų sukurti kaip paprastas tekstas, naudokite .form-control-plaintextklasę, kad pašalintumėte numatytąjį formos lauko stilių ir išlaikytumėte teisingą paraštę bei užpildymą.
Numatytieji žymimieji langeliai ir radijo imtuvai patobulinti naudojant vieną klasę abiem įvesties tipams .form-check, kuri pagerina jų HTML elementų išdėstymą ir elgseną . Žymieji langeliai yra skirti pasirinkti vieną ar kelias parinktis sąraše, o radijo imtuvai skirti pasirinkti vieną iš daugelio.
Palaikomi išjungti žymės langeliai ir radijo imtuvai. Atributas pritaikys šviesesnę spalvą, kad disabledbūtų lengviau nurodyti įvesties būseną.
Žymieji langeliai ir radijo mygtukai palaiko HTML pagrįstą formų patvirtinimą ir pateikia glaustas, prieinamas etiketes. Taigi mūsų <input>s ir <label>s yra brolių ir seserų elementai, o <input>ne a viduje <label>. Tai yra šiek tiek išsamesnė, nes turite nurodyti idir foratributus, kad susietumėte <input>ir <label>.
Numatytasis (sudarytas)
Pagal numatytuosius nustatymus bet koks žymimųjų laukelių ir radijo imtuvų skaičius, kurie yra tiesioginiai broliai, bus išdėstyti vertikaliai ir tinkamai išdėstyti su .form-check.
Inline
Grupuokite žymimuosius laukelius arba radijo imtuvus toje pačioje horizontalioje eilutėje pridėdami .form-check-inlineprie bet kurio .form-check.
Be etikečių
Pridėkite .position-staticprie įvesties .form-check, kuriose nėra etiketės teksto. Nepamirškite pateikti tam tikros formos pagalbinių technologijų etiketės (pvz., naudojant aria-label).
Išdėstymas
Kadangi „Bootstrap“ taikomas display: blockir width: 100%beveik visiems mūsų formų valdikliams, formos pagal numatytuosius nustatymus bus kaupiamos vertikaliai. Papildomos klasės gali būti naudojamos šiam išdėstymui keisti pagal formą.
Suformuokite grupes
.form-groupKlasė yra lengviausias būdas pridėti tam tikrą formų struktūrą . Tai suteikia lanksčią klasę, skatinančią tinkamai grupuoti etiketes, valdiklius, pasirenkamą pagalbos tekstą ir formos patvirtinimo pranešimus. Pagal numatytuosius nustatymus jis taikomas tik margin-bottom, bet prireikus paima papildomų stilių .form-inline. Naudokite jį su <fieldset>s, <div>s ar beveik bet kokiu kitu elementu.
Formos tinklelis
Naudojant mūsų tinklelio klases, galima sukurti sudėtingesnes formas. Naudokite juos formų išdėstymams, kuriems reikia kelių stulpelių, įvairaus pločio ir papildomų lygiavimo parinkčių.
Formos eilutė
Taip pat galite pakeisti .rowį .form-rowstandartinės tinklelio eilutės variantą, kuris pakeičia numatytuosius stulpelių latakus, kad būtų griežtesni ir kompaktiškesni.
Su tinklelio sistema taip pat galima sukurti sudėtingesnius maketus.
Horizontali forma
Kurkite horizontalias formas naudodami tinklelį, įtraukdami .rowklasę prie formų grupių ir naudodami .col-*-*klases nurodydami etikečių ir valdiklių plotį. Būtinai pridėkite .col-form-labelir prie savo <label>s, kad jie būtų vertikaliai centre su susijusiais formos valdikliais.
Kartais jums gali tekti naudoti paraščių arba užpildymo priemones, kad sukurtumėte reikiamą tobulą išlygiavimą. Pavyzdžiui, pašalinome padding-topsukrautų radijo įvesties etiketę, kad geriau suderintume pagrindinę teksto liniją.
Horizontalios formos etiketės dydis
Būtinai naudokite .col-form-label-smarba .col-form-label-lgprie savo <label>s arba s, kad teisingai laikytumėte ir <legend>dydį ..form-control-lg.form-control-sm
Stulpelių dydžio nustatymas
Kaip parodyta ankstesniuose pavyzdžiuose, mūsų tinklelio sistema leidžia a arba dėti bet kokį skaičių .cols . Galimą plotį jie paskirstys vienodai. Taip pat galite pasirinkti stulpelių poaibį, kuris užimtų daugiau ar mažiau vietos, o likę s vienodai padalins likusias dalis su konkrečiomis stulpelių klasėmis, pvz ., ..row.form-row.col.col-7
Automatinis dydžio nustatymas
Toliau pateiktame pavyzdyje naudojama „flexbox“ priemonė, skirta vertikaliai centruoti turinį ir pakeisti .colį .col-autotaip, kad stulpeliai užimtų tik tiek vietos, kiek reikia. Kitaip tariant, stulpelio dydis nustatomas pagal turinį.
Tada galėsite tai dar kartą permaišyti naudodami konkretaus dydžio stulpelių klases.
Naudokite .form-inlineklasę, kad vienoje horizontalioje eilutėje būtų rodoma etikečių, formų valdiklių ir mygtukų serija. Įterptųjų formų formų valdikliai šiek tiek skiriasi nuo numatytųjų būsenų.
Valdikliai yra display: flex, sutraukiantys bet kokį HTML tarpą ir leidžiantys valdyti lygiavimo valdymą naudojant tarpų ir „flexbox“ priemones.
Valdikliai ir įvesties grupės width: autoturi nepaisyti numatytosios Bootstrap width: 100%.
Valdikliai rodomi tik įterptose peržiūros srityse, kurios yra bent 576 pikselių pločio , kad būtų atsižvelgta į siauras peržiūros sritis mobiliuosiuose įrenginiuose.
Jums gali tekti rankiniu būdu nustatyti atskirų formos valdiklių plotį ir lygiavimą su tarpų programomis (kaip parodyta toliau). Galiausiai būtinai visada įtraukite a <label>prie kiekvieno formos valdiklio, net jei norite jį paslėpti nuo lankytojų, kurie neskaito ekrano naudodami .sr-only.
Taip pat palaikomi pasirinktiniai formų valdikliai ir pasirinkimai.
Paslėptų etikečių alternatyvos
Pagalbinės technologijos, pvz., ekrano skaitytuvai, turės problemų su formomis, jei neįtrauksite etiketės prie kiekvienos įvesties. Šių eilutinių formų etiketes galite paslėpti naudodami .sr-onlyklasę. Yra ir kitų alternatyvių metodų, kaip suteikti etiketę pagalbinėms technologijoms, pvz., aria-label, aria-labelledbyarba titleatributas. Jei nė vieno iš jų nėra, pagalbinės technologijos gali naudoti placeholderatributą, jei yra, tačiau atminkite, kad placeholdernepatartina naudoti kaip kitų ženklinimo metodų pakaitalo.
Pagalbos tekstas
Bloko lygio pagalbos tekstas formose gali būti sukurtas naudojant .form-text(anksčiau žinomą kaip .help-blockv3). Inline žinyno tekstas gali būti lanksčiai įdiegtas naudojant bet kurį eilutinį HTML elementą ir naudingumo klases, pvz ., .text-muted.
Pagalbos teksto susiejimas su formos valdikliais
Pagalbos tekstas turi būti aiškiai susietas su formos valdikliu, su kuriuo jis susijęs su aria-describedbyatributo naudojimu. Taip bus užtikrinta, kad pagalbinės technologijos, pvz., ekrano skaitytuvai, praneštų šį pagalbos tekstą, kai naudotojas susifokusuos arba įjungs valdiklį.
Pagalbos tekstas, esantis žemiau, gali būti stilizuotas naudojant .form-text. Ši klasė apima display: blockir prideda šiek tiek viršutinės paraštės, kad būtų lengviau atskirti pirmiau pateiktas įvestis.
Jūsų slaptažodis turi būti 8–20 simbolių ilgio, sudarytas iš raidžių ir skaičių, jame neturi būti tarpų, specialiųjų simbolių ar jaustukų.
Įterptajame tekste gali būti naudojamas bet koks įprastas eilutinis HTML elementas (ar tai būtų <small>, <span>, ar kažkas kita) be naudingumo klasės.
Neįgaliosios formos
Pridėkite disabledloginį atributą įvestyje, kad išvengtumėte naudotojo sąveikos ir ji atrodytų šviesesnė.
Pridėkite disabledatributą prie a <fieldset>, kad išjungtumėte visus valdiklius.
Įspėjimas su inkarais
<input>Pagal numatytuosius nustatymus naršyklės visus savuosius formų valdiklius ( ir elementus), esančius a viduje <select>, laikys išjungtais, užkertant kelią klaviatūros ir pelės sąveikai. Tačiau jei jūsų formoje taip pat yra elementų, jiems bus suteiktas tik stilius . Kaip pažymėta skyriuje apie išjungtą mygtukų būseną (ir ypač prieraišo elementų poskyryje), ši CSS nuosavybė dar nėra standartizuota ir nėra visiškai palaikoma „Internet Explorer 10“ ir netrukdys klaviatūros naudotojams gali sufokusuoti arba suaktyvinti šias nuorodas. Taigi, kad būtumėte saugūs, naudokite tinkintą JavaScript, kad išjungtumėte tokias nuorodas.<button><fieldset disabled><a ... class="btn btn-*">pointer-events: none
Suderinamumas tarp naršyklių
Nors „Bootstrap“ taikys šiuos stilius visose naršyklėse, „Internet Explorer 11“ ir senesnės versijos visiškai nepalaiko disabledatributo <fieldset>. Naudokite tinkintą JavaScript, kad išjungtumėte laukų rinkinį šiose naršyklėse.
Patvirtinimas
Pateikite vertingų, naudingų atsiliepimų savo naudotojams naudodami HTML5 formos patvirtinimą – pasiekiamą visose mūsų palaikomose naršyklėse . Pasirinkite iš numatytųjų naršyklės patvirtinimo atsiliepimų arba pritaikykite tinkintus pranešimus naudodami mūsų integruotas klases ir pradedančiąją „JavaScript“.
Šiuo metu rekomenduojame naudoti tinkintus patvirtinimo stilius, nes vietinės naršyklės numatytieji patvirtinimo pranešimai nėra nuosekliai veikiami pagalbinių technologijų visose naršyklėse (ypač staliniuose kompiuteriuose ir mobiliuosiuose įrenginiuose naudojamoje „Chrome“).
Kaip tai veikia
Štai kaip formos patvirtinimas veikia naudojant Bootstrap:
HTML formos patvirtinimas taikomas naudojant dvi CSS pseudoklases :invalidir :valid. Tai taikoma <input>, <select>, ir <textarea>elementams.
Bootstrap aprėpia :invalidir :validstilius pirminei .was-validatedklasei, paprastai taikomai <form>. Kitu atveju bet koks privalomas laukas be reikšmės įkeliant puslapį bus rodomas kaip negaliojantis. Tokiu būdu galite pasirinkti, kada juos suaktyvinti (paprastai po to, kai bandoma pateikti formą).
Norėdami iš naujo nustatyti formos išvaizdą (pvz., dinaminės formos pateikimo naudojant AJAX), po pateikimo dar kartą pašalinkite .was-validatedklasę iš .<form>
Kaip atsarginis variantas, .is-invalidir .is-validklasės gali būti naudojamos vietoj pseudoklasių serverio pusės patvirtinimui . Jiems nereikia .was-validatedtėvų klasės.
Dėl CSS veikimo apribojimų negalime (šiuo metu) taikyti stilių, <label>kurie yra prieš formos valdiklį DOM be tinkintos JavaScript pagalbos.
Visos šiuolaikinės naršyklės palaiko apribojimų patvirtinimo API – „JavaScript“ metodų, skirtų formos valdikliams patvirtinti, seriją.
Atsiliepimų pranešimuose gali būti naudojami numatytieji naršyklės nustatymai (skirtingi kiekvienoje naršyklėje ir nekeičiami naudojant CSS) arba mūsų pasirinktiniai atsiliepimų stiliai su papildomu HTML ir CSS.
Galite pateikti tinkintus galiojimo pranešimus naudodami setCustomValidity„JavaScript“.
Turėdami tai omenyje, apsvarstykite šias demonstracines versijas, skirtas pasirinktinių formų patvirtinimo stiliams, pasirenkamoms serverio šoninėms klasėms ir naršyklės numatytiesiems parametrams.
Individualūs stiliai
Norėdami gauti tinkintus Bootstrap formos patvirtinimo pranešimus, turėsite pridėti novalidateloginį atributą prie savo <form>. Tai išjungia numatytuosius naršyklės atsiliepimų patarimus, bet vis tiek suteikia prieigą prie „JavaScript“ formos patvirtinimo API. Pabandykite pateikti žemiau esančią formą; mūsų „JavaScript“ perims pateikimo mygtuką ir perduos jums atsiliepimą. Bandydami pateikti, matysite formos valdikliams pritaikytus stilius :invalidir .:valid
Pasirinktiniai atsiliepimų stiliai taiko pasirinktines spalvas, rėmelius, fokusavimo stilius ir fono piktogramas, kad būtų galima geriau perduoti atsiliepimus. s fono piktogramos <select>galimos tik su .custom-select, bet ne .form-control.
Numatytieji naršyklės nustatymai
Nedomina pasirinktiniai patvirtinimo grįžtamojo ryšio pranešimai arba „JavaScript“ rašymas, kad pakeistumėte formos elgseną? Viskas gerai, galite naudoti numatytuosius naršyklės nustatymus. Pabandykite pateikti žemiau esančią formą. Atsižvelgiant į naršyklę ir OS, matysite šiek tiek kitokį atsiliepimų stilių.
Nors šių atsiliepimų stilių negalima sukurti naudojant CSS, vis tiek galite tinkinti atsiliepimo tekstą naudodami „JavaScript“.
Serverio pusė
Rekomenduojame naudoti kliento pusės patvirtinimą, bet jei reikia serverio patvirtinimo, netinkamus ir galiojančius formos laukus galite nurodyti naudodami .is-invalidir .is-valid. Atminkite, kad .invalid-feedbacktai taip pat palaikoma šiose klasėse.
Palaikomi elementai
Galimi šių formų valdiklių ir komponentų patvirtinimo stiliai:
<input>s ir <textarea>s su .form-control(įskaitant iki vieno .form-controlįvesties grupėse)
<select>s su .form-controlarba.custom-select
.form-checks
.custom-checkboxs ir .custom-radios
.custom-file
Patarimai
Jei formos išdėstymas tai leidžia, galite sukeisti .{valid|invalid}-feedbackklases į .{valid|invalid}-tooltipklases, kad pateiktumėte patvirtinimo atsiliepimą stiliaus patarime. Būtinai turėkite vieną iš tėvų position: relative, kad galėtų nustatyti patarimo vietą. Toliau pateiktame pavyzdyje mūsų stulpelių klasėse tai jau yra, tačiau jūsų projektui gali prireikti kitos sąrankos.
Tinkinimas
Patvirtinimo būsenas galima tinkinti naudojant Sass su $form-validation-statesžemėlapiu. Šis mūsų _variables.scssfaile esantis Sass žemėlapis perjungiamas, kad būtų sukurtos numatytosios valid/ invalidpatvirtinimo būsenos. Pridedamas įdėtas žemėlapis, skirtas tinkinti kiekvienos būsenos spalvą ir piktogramą. Nors naršyklės nepalaiko jokių kitų būsenų, naudojantys pasirinktinius stilius gali lengvai pridėti sudėtingesnių formų atsiliepimų.
Atkreipkite dėmesį, kad nerekomenduojame tinkinti šių reikšmių nepakeitus form-validation-statemaišymo.
Individualios formos
Jei norite dar daugiau tinkinti ir nuoseklumo tarp naršyklių, naudokite visiškai tinkintus formos elementus, kad pakeistumėte numatytuosius naršyklės nustatymus. Jie sukurti remiantis semantiniu ir prieinamu žymėjimu, todėl yra tvirti bet kokio numatytojo formos valdymo pakaitalai.
Žymės langeliai ir radijo imtuvai
Kiekvienas žymimasis laukelis, radijas <input>ir <label>susiejimas yra supakuoti į a <div>, kad sukurtume pasirinktinį valdiklį. Struktūriškai tai yra toks pat metodas, kaip numatytasis .form-check.
Naudojame brolių ir seserų parinkiklį ( ~) visoms savo <input>būsenoms, pvz ., norėdami :checkedtinkamai pritaikyti tinkintos formos indikatorių. Kartu su .custom-control-labelklase taip pat galime sukurti kiekvieno elemento teksto stilių pagal <input>būseną.
Paslėpiame numatytąjį nustatymą <input>ir opacitynaudojame , .custom-control-labelkad sukurtume naują tinkintos formos indikatorių jo vietoje naudodami ::beforeir ::after. Deja, negalime sukurti tinkinto vien tik iš šio elemento, <input>nes CSS contentneveikia šio elemento.
Pažymėtose būsenose naudojame base64 įterptas SVG piktogramas iš Open Iconic . Taip galime geriausiai valdyti stilių ir padėties nustatymą naršyklėse ir įrenginiuose.
Žymės langeliai
Pasirinktiniai žymimieji laukeliai taip pat gali naudoti :indeterminatepseudo klasę, kai jie nustatomi rankiniu būdu naudojant „JavaScript“ (nėra pasiekiamo HTML atributo jai nurodyti).
Jei naudojate jQuery, turėtų pakakti tokio dalyko:
Radijas
Inline
Išjungta
Taip pat galima išjungti pasirinktinius žymimuosius laukelius ir radijo imtuvus. Pridėkite disabledloginį atributą <input>ir pasirinktinis indikatorius bei etiketės aprašymas bus automatiškai kuriami.
Jungikliai
Jungiklis turi pasirinktinio žymės langelio žymėjimą, bet naudoja .custom-switchklasę perjungimo jungikliui pateikti. Jungikliai taip pat palaiko disabledatributą.
Pasirinkite meniu
Pasirinktiniams <select>meniu reikia tik tinkintos klasės, .custom-selectkad suaktyvintų pasirinktinius stilius. Pasirinktiniai stiliai apsiriboja <select>pradine išvaizda ir negali keisti <option>s dėl naršyklės apribojimų.
Taip pat galite pasirinkti iš mažų ir didelių pasirinktinių pasirinkimų, kad atitiktų mūsų panašaus dydžio teksto įvestis.
multipleAtributas taip pat palaikomas :
Kaip ir sizeatributas:
diapazonas
Sukurkite pasirinktinius <input type="range">valdiklius naudodami .custom-range. Takelis (fonas) ir nykštis (vertė) yra sukurti taip, kad visose naršyklėse atrodytų vienodai. Kadangi tik IE ir Firefox palaiko savo takelio „užpildymą“ iš kairės arba dešinės nykščio, kaip priemonę vizualiai parodyti pažangą, šiuo metu mes to nepalaikome.
minDiapazono įvestis turi numanomas ir max— 0ir 100atitinkamai reikšmes . Galite nurodyti naujas reikšmes tiems, kurie naudoja minir maxatributus.
Pagal numatytuosius nustatymus diapazono įvestis „prisijungia“ prie sveikųjų skaičių. Norėdami tai pakeisti, galite nurodyti stepreikšmę. Toliau pateiktame pavyzdyje mes padvigubiname žingsnių skaičių naudodami step="0.5".
Failų naršyklė
Rekomenduojamas įskiepis, skirtas animuoti tinkintą failo įvestį: bs-custom-file-input , kurį šiuo metu naudojame savo dokumentuose.
Failo įvestis yra pati niūriausia ir reikalauja papildomo „JavaScript“, jei norite juos susieti su funkcine Pasirinkti failą… ir pasirinkto failo pavadinimo tekstu.
Paslėpiame numatytąjį failą <input>naudodami . Mygtukas sugeneruojamas ir nustatomas su . Galiausiai nurodome a ir , kad aplinkiniam turiniui būtų tinkami tarpai.opacity<label>::afterwidthheight<input>
Eilučių vertimas arba tinkinimas naudojant SCSS
Pseudoklasė :lang()naudojama norint išversti „Naršyti“ tekstą į kitas kalbas. Nepaisykite arba pridėkite Sass kintamojo įrašus $custom-file-textsu atitinkama kalbos žyma ir lokalizuotomis eilutėmis. Angliškas stygas galima pritaikyti taip pat. Pavyzdžiui, štai kaip galima pridėti vertimą į ispanų kalbą (ispanų kalbos kodas yra es):
Štai kaip lang(es)veikia pasirinktinė failo įvestis vertimui į ispanų kalbą:
Kad būtų rodomas teisingas tekstas, turėsite teisingai nustatyti dokumento (arba jo pomedžio) kalbą. Tai galima padaryti naudojant elemento atributą langarba<html> HTTP Content-Languageantraštę , be kitų metodų.
Eilučių vertimas arba tinkinimas naudojant HTML
„Bootstrap“ taip pat suteikia galimybę išversti „Naršyti“ tekstą HTML su data-browseatributu, kurį galima pridėti prie tinkintos įvesties etiketės (pavyzdys olandų kalba):