Eksempler og brugsretningslinjer for formularkontroltypografier, layoutindstillinger og brugerdefinerede komponenter til oprettelse af en bred vifte af formularer.
Oversigt
Bootstraps formularkontrolelementer udvider vores genstartede formularstile med klasser. Brug disse klasser til at tilvælge deres tilpassede skærme for en mere ensartet gengivelse på tværs af browsere og enheder.
Sørg for at bruge en passende typeattribut på alle input (f.eks. emailtil e-mailadresse eller numbertil numerisk information) for at drage fordel af nyere inputkontroller som e-mailbekræftelse, nummervalg og mere.
Her er et hurtigt eksempel for at demonstrere Bootstraps formstile. Fortsæt med at læse for dokumentation om obligatoriske klasser, formularlayout og mere.
Form kontrolelementer
Tekstformularkontrolelementer - som <input>s, <select>s og <textarea>s - er stylet med .form-controlklassen. Inkluderet er stilarter til generelt udseende, fokustilstand, størrelse og mere.
For filinput, skift .form-controltil .form-control-file.
Dimensionering
Indstil højder ved hjælp af klasser som .form-control-lgog .form-control-sm.
Læs kun
Tilføj den readonlybooleske attribut på et input for at forhindre ændring af inputs værdi. Skrivebeskyttede input ser lysere ud (ligesom deaktiverede input), men bevarer standardmarkøren.
Skrivebeskyttet almindelig tekst
Hvis du vil have <input readonly>elementer i din formular stilet som almindelig tekst, skal du bruge .form-control-plaintextklassen til at fjerne standardformatet for formularfelter og bevare den korrekte margen og udfyldning.
Range input
Indstil vandret rulbare områdeindgange ved hjælp af .form-control-range.
Afkrydsningsfelter og radioer
Standard afkrydsningsfelter og radioer forbedres ved hjælp af .form-checken enkelt klasse for begge inputtyper, der forbedrer layoutet og adfærden af deres HTML-elementer . Afkrydsningsfelter er til at vælge en eller flere muligheder på en liste, mens radioer er til at vælge en mulighed blandt mange.
Deaktiverede afkrydsningsfelter og radioer understøttes. Attributten disabledvil anvende en lysere farve for at hjælpe med at angive inputs tilstand.
Afkrydsningsfelter og alternativknapper understøtter HTML-baseret formularvalidering og giver kortfattede, tilgængelige etiketter. Som sådan er vores <input>s og <label>s søskendeelementer i modsætning til et <input>inden for et <label>. Dette er lidt mere udførligt, da du skal specificere idog forattributter for at relatere <input>og <label>.
Standard (stablet)
Som standard vil et hvilket som helst antal afkrydsningsfelter og radioer, der er umiddelbare søskende, være lodret stablet og passende fordelt med .form-check.
Inline
Grupper afkrydsningsfelter eller radioer i den samme vandrette række ved at tilføje .form-check-inlinetil en hvilken som helst .form-check.
Uden etiketter
Føj .position-statictil input inden for .form-check, der ikke har nogen etikettekst. Husk stadig at give en form for etiket til hjælpeteknologier (f.eks. ved at bruge aria-label).
Layout
Da Bootstrap gælder display: blockog width: 100%for næsten alle vores formularkontrolelementer, vil formularer som standard stables lodret. Yderligere klasser kan bruges til at variere dette layout på en per-form basis.
Form grupper
Klassen .form-grouper den nemmeste måde at tilføje noget struktur til formularer. Det giver en fleksibel klasse, der tilskynder til korrekt gruppering af etiketter, kontroller, valgfri hjælpetekst og formularvalideringsmeddelelser. Som standard gælder det kun margin-bottom, men det henter yderligere stilarter .form-inlineefter behov. Brug det med <fieldset>s, <div>s eller næsten ethvert andet element.
Form gitter
Mere komplekse formularer kan bygges ved hjælp af vores gitterklasser. Brug disse til formularlayout, der kræver flere kolonner, varierede bredder og yderligere justeringsmuligheder.
Form række
Du kan også bytte .rowtil .form-row, en variant af vores standard gitterrække, der tilsidesætter standard søjlerrender for strammere og mere kompakte layouts.
Mere komplekse layouts kan også oprettes med gittersystemet.
Vandret form
Opret vandrette formularer med gitteret ved at tilføje .rowklassen til formgrupper og bruge .col-*-*klasserne til at angive bredden af dine etiketter og kontrolelementer. Sørg også for at tilføje .col-form-labeltil dine <label>s, så de er lodret centreret med deres tilknyttede formularkontrolelementer.
Til tider skal du måske bruge margen- eller polstringsværktøjer for at skabe den perfekte justering, du har brug for. For eksempel har vi fjernet padding-topetiketten på vores stablede radioindgange for bedre at justere tekstens grundlinje.
Vandret formlabelstørrelse
Sørg for at bruge .col-form-label-smeller .col-form-label-lgtil dine <label>s eller <legend>s for korrekt at følge størrelsen på .form-control-lgog .form-control-sm.
Søjlestørrelse
Som vist i de foregående eksempler giver vores gittersystem dig mulighed for at placere et vilkårligt antal .cols inden for et .roweller .form-row. De deler den tilgængelige bredde ligeligt mellem sig. Du kan også vælge en delmængde af dine kolonner for at optage mere eller mindre plads, mens de resterende .cols lige deler resten, med specifikke kolonneklasser som .col-7.
Automatisk dimensionering
Eksemplet nedenfor bruger et flexbox-værktøj til lodret at centrere indholdet og ændringer .coltil .col-auto, så dine kolonner kun fylder så meget som nødvendigt. Sagt på en anden måde, størrelsen af kolonnen selv baseret på indholdet.
Du kan derefter remixe det igen med størrelsesspecifikke kolonneklasser.
Brug .form-inlineklassen til at vise en række etiketter, formularkontrolelementer og knapper på en enkelt vandret række. Formularkontrolelementer i indlejrede formularer varierer lidt fra deres standardtilstande.
Kontrolelementer er display: flex, kollapser ethvert HTML-mellemrum og giver dig mulighed for at give justeringskontrol med mellemrum og flexbox- værktøjer.
Kontrolelementer og inputgrupper modtager width: autofor at tilsidesætte Bootstrap-standarden width: 100%.
Kontrolelementer vises kun inline i viewporte, der er mindst 576px brede for at tage højde for smalle viewports på mobile enheder.
Du skal muligvis manuelt adressere bredden og justeringen af individuelle formularkontrolelementer med mellemrumsfunktioner (som vist nedenfor). Til sidst skal du sørge for altid at inkludere en <label>med hver formularkontrol, selvom du har brug for at skjule den for besøgende, der ikke er skærmlæser med .sr-only.
Brugerdefinerede formularkontroller og valg understøttes også.
Alternativer til skjulte etiketter
Hjælpeteknologier såsom skærmlæsere vil have problemer med dine formularer, hvis du ikke inkluderer en etiket for hver input. For disse indlejrede formularer kan du skjule etiketterne ved hjælp af .sr-onlyklassen. Der er yderligere alternative metoder til at give en etiket for hjælpeteknologier, såsom aria-label, aria-labelledbyeller titleattributten. Hvis ingen af disse er til stede, kan hjælpeteknologier ty til at bruge placeholderattributten, hvis den findes, men bemærk, at brug af placeholdersom erstatning for andre mærkningsmetoder ikke tilrådes.
Hjælpetekst
Hjælpetekst på blokniveau i formularer kan oprettes ved hjælp af .form-text(tidligere kendt som .help-blocki v3). Inline hjælpetekst kan implementeres fleksibelt ved hjælp af ethvert inline HTML-element og hjælpeklasser som .text-muted.
Tilknytning af hjælpetekst med formularkontrolelementer
Hjælpeteksten skal være eksplicit forbundet med den formularkontrol, den relaterer til ved brug af aria-describedbyattributten. Dette vil sikre, at hjælpeteknologier – såsom skærmlæsere – annoncerer denne hjælpetekst, når brugeren fokuserer eller går ind i kontrollen.
Hjælpeteksten under input kan styles med .form-text. Denne klasse inkluderer display: blockog tilføjer en vis topmargin for nem afstand fra inputs ovenfor.
Dit kodeord skal være 8-20 tegn langt, indeholde bogstaver og tal og må ikke indeholde mellemrum, specialtegn eller emoji.
Inline-tekst kan bruge et hvilket som helst typisk inline HTML-element (det være sig et <small>, <span>, eller noget andet) med intet andet end en hjælpeklasse.
Deaktiverede formularer
Tilføj den disabledbooleske attribut på et input for at forhindre brugerinteraktioner og få det til at virke lettere.
Føj disabledattributten til a <fieldset>for at deaktivere alle kontrolelementerne indeni.
Forbehold med ankre
Som standard vil browsere behandle alle indbyggede formularkontrolelementer ( <input>, <select>og <button>elementer) inde i en <fieldset disabled>som deaktiveret, hvilket forhindrer både tastatur- og muse-interaktioner på dem. Men hvis din formular også indeholder <a ... class="btn btn-*">elementer, vil disse kun få en stil på pointer-events: none. Som nævnt i afsnittet om deaktiveret tilstand for knapper (og specifikt i underafsnittet for ankerelementer), er denne CSS-egenskab endnu ikke standardiseret og understøttes ikke fuldt ud i Internet Explorer 10 og forhindrer ikke tastaturbrugere i at blive i stand til at fokusere eller aktivere disse links. Så for at være sikker, brug tilpasset JavaScript til at deaktivere sådanne links.
Cross-browser kompatibilitet
Mens Bootstrap vil anvende disse stilarter i alle browsere, understøtter Internet Explorer 11 og derunder ikke fuldt ud disabledattributten på en <fieldset>. Brug tilpasset JavaScript til at deaktivere feltsættet i disse browsere.
Validering
Giv værdifuld, handlingsorienteret feedback til dine brugere med HTML5-formularvalidering – tilgængelig i alle vores understøttede browsere . Vælg fra browserens standardvalideringsfeedback, eller implementer tilpassede meddelelser med vores indbyggede klasser og start-JavaScript.
Vi anbefaler i øjeblikket at bruge tilpassede valideringsstile, da native browser-standardvalideringsmeddelelser ikke konsekvent eksponeres for hjælpeteknologier i alle browsere (især Chrome på desktop og mobil).
Hvordan det virker
Sådan fungerer formularvalidering med Bootstrap:
HTML-formularvalidering anvendes via CSS's to pseudo-klasser :invalidog :valid. Det gælder for <input>, <select>, og <textarea>elementer.
Bootstrap omfavner :invalidog - :validstilene til overordnet .was-validatedklasse, normalt anvendt på <form>. Ellers vises ethvert påkrævet felt uden en værdi som ugyldigt ved sideindlæsning. På denne måde kan du vælge, hvornår du vil aktivere dem (typisk efter at formularindsendelse er forsøgt).
For at nulstille udseendet af formularen (for eksempel i tilfælde af dynamiske formularafsendelser ved hjælp af AJAX), skal du fjerne .was-validatedklassen fra <form>igen efter indsendelse.
Som en fallback, .is-invalidog .is-validklasser kan bruges i stedet for pseudo-klasserne til serversidevalidering . De kræver ikke en .was-validatedforældreklasse.
På grund af begrænsninger i, hvordan CSS fungerer, kan vi (på nuværende tidspunkt) ikke anvende stilarter på en <label>, der kommer før en formularkontrol i DOM uden hjælp af tilpasset JavaScript.
Alle moderne browsere understøtter constraint validation API , en række JavaScript-metoder til validering af formularkontrolelementer.
Feedbackmeddelelser kan bruge browserens standardindstillinger (forskellige for hver browser og ikke-stilbar via CSS) eller vores tilpassede feedback-stile med ekstra HTML og CSS.
Du kan levere tilpassede gyldighedsmeddelelser setCustomValidityi JavaScript.
Med det i tankerne kan du overveje følgende demoer for vores tilpassede formularvalideringsstile, valgfri serversideklasser og browserstandarder.
Brugerdefinerede stilarter
For brugerdefinerede Bootstrap-formularvalideringsmeddelelser skal du tilføje den novalidatebooleske attribut til din <form>. Dette deaktiverer browserens standardfeedback-værktøjstip, men giver stadig adgang til formularvaliderings-API'erne i JavaScript. Prøv at indsende formularen nedenfor; vores JavaScript opsnapper indsend-knappen og videresender feedback til dig. Når du forsøger at indsende, vil du se typografierne :invalidog :validanvendt på dine formularkontrolelementer.
Tilpassede feedbackstile anvender tilpassede farver, rammer, fokusstile og baggrundsikoner for bedre at kommunikere feedback. Baggrundsikoner for <select>s er kun tilgængelige med .custom-selectog ikke .form-control.
Browser standardindstillinger
Er du ikke interesseret i tilpassede valideringsfeedbackbeskeder eller at skrive JavaScript for at ændre formularadfærd? Alt godt, du kan bruge browserens standardindstillinger. Prøv at indsende formularen nedenfor. Afhængigt af din browser og OS, vil du se en lidt anderledes stil af feedback.
Selvom disse feedbackstile ikke kan styles med CSS, kan du stadig tilpasse feedbackteksten gennem JavaScript.
Server side
Vi anbefaler at bruge validering på klientsiden, men hvis du har brug for validering på serversiden, kan du angive ugyldige og gyldige formularfelter med .is-invalidog .is-valid. Bemærk, at .invalid-feedbackdet også understøttes med disse klasser.
Understøttede elementer
Valideringsstile er tilgængelige for følgende formularkontrolelementer og komponenter:
<input>s og <textarea>s med .form-control(inklusive op til én .form-controli inputgrupper)
<select>s med .form-controleller.custom-select
.form-checks
.custom-checkboxs og .custom-radios
.custom-file
Værktøjstip
Hvis dit formularlayout tillader det, kan du udskifte .{valid|invalid}-feedbackklasserne med .{valid|invalid}-tooltipklasser for at vise valideringsfeedback i et stylet værktøjstip. Sørg for at have en forælder med position: relativepå den til placering af værktøjstip. I eksemplet nedenfor har vores kolonneklasser dette allerede, men dit projekt kræver muligvis en alternativ opsætning.
Tilpasning
Valideringstilstande kan tilpasses via Sass med $form-validation-stateskortet. Dette Sass-kort, som er placeret i vores _variables.scssfil, er sløjfet for at generere standard- valid/ invalidvalideringstilstandene. Inkluderet er et indlejret kort til at tilpasse hver stats farve og ikon. Selvom ingen andre tilstande understøttes af browsere, kan dem, der bruger brugerdefinerede stilarter, nemt tilføje mere kompleks formularfeedback.
Bemærk venligst, at vi ikke anbefaler at tilpasse disse værdier uden også at ændre form-validation-statemixin.
Brugerdefinerede formularer
For endnu mere tilpasning og ensartethed på tværs af browsere skal du bruge vores helt tilpassede formularelementer til at erstatte browserens standardindstillinger. De er bygget oven på semantisk og tilgængelig markup, så de er solide erstatninger for enhver standard formularkontrol.
Afkrydsningsfelter og radioer
Hvert afkrydsningsfelt og radio <input>og <label>parring er pakket ind i en <div>for at skabe vores brugerdefinerede kontrol. Strukturelt er dette den samme tilgang som vores standard .form-check.
Vi bruger søskendevælgeren ( ~) for alle vores <input>stater – f.eks . – for :checkedat style vores brugerdefinerede formularindikator korrekt. Når det kombineres med .custom-control-labelklassen, kan vi også style teksten for hvert element baseret på <input>'s-tilstanden.
Vi skjuler standarden <input>med opacityog bruger til .custom-control-labelat bygge en ny brugerdefineret formularindikator i stedet for ::beforeog ::after. Desværre kan vi ikke bygge en brugerdefineret en ud fra bare, <input>fordi CSS'er contentikke virker på det element.
I de afkrydsede tilstande bruger vi base64 indlejrede SVG-ikoner fra Open Iconic . Dette giver os den bedste kontrol til styling og positionering på tværs af browsere og enheder.
Afkrydsningsfelter
Brugerdefinerede afkrydsningsfelter kan også bruge :indeterminatepseudoklassen, når de indstilles manuelt via JavaScript (der er ingen tilgængelig HTML-attribut til at angive den).
Hvis du bruger jQuery, burde noget som dette være tilstrækkeligt:
Radioer
Inline
handicappet
Brugerdefinerede afkrydsningsfelter og radioer kan også deaktiveres. Tilføj den disabledbooleske attribut til <input>og den brugerdefinerede indikator og etiketbeskrivelse vil automatisk blive stylet.
Afbrydere
En switch har markeringen af et brugerdefineret afkrydsningsfelt, men bruger .custom-switchklassen til at gengive en skiftekontakt. Switche understøtter også disabledattributten.
Vælg menu
Brugerdefinerede <select>menuer behøver kun en brugerdefineret klasse .custom-selectfor at udløse de brugerdefinerede stilarter. Brugerdefinerede stilarter er begrænset til <select>'s oprindelige udseende og kan ikke ændres på <option>grund af browserbegrænsninger.
Du kan også vælge mellem små og store brugerdefinerede markeringer for at matche vores tekstinput af samme størrelse.
Attributten multipleunderstøttes også:
Som er sizeattributten:
Rækkevidde
Opret brugerdefinerede <input type="range">kontroller med .custom-range. Sporet (baggrunden) og tommelfingeren (værdien) er begge stylet til at se ens ud på tværs af browsere. Da kun IE og Firefox understøtter at "fylde" deres spor fra venstre eller højre for tommelfingeren som et middel til visuelt at indikere fremskridt, understøtter vi det ikke i øjeblikket.
Områdeinput har implicitte værdier for henholdsvis minog max— 0og 100. Du kan angive nye værdier for dem, der bruger attributterne minog .max
Som standard "snap" interval-input til heltalsværdier. For at ændre dette kan du angive en stepværdi. I eksemplet nedenfor fordobler vi antallet af trin ved at bruge step="0.5".
Filbrowser
Det anbefalede plugin til at animere brugerdefineret filinput: bs-custom-file-input , det er det, vi i øjeblikket bruger her i vores dokumenter.
Filinputtet er det mest knudrede af bunken og kræver yderligere JavaScript, hvis du gerne vil tilslutte dem med funktionel Vælg fil... og valgt filnavntekst.
Vi skjuler standardfilen <input>via opacityog styles i stedet for <label>. Knappen genereres og placeres med ::after. Til sidst erklærer vi en widthog heightpå <input>for korrekt afstand til omgivende indhold.
Oversættelse eller tilpasning af strengene med SCSS
Pseudoklassen bruges til at give mulighed for oversættelse af "Gennemse"-teksten til andre sprog :lang(). Tilsidesæt eller tilføj indgange til $custom-file-textSass-variablen med det relevante sprogtag og lokaliserede strenge. De engelske strenge kan tilpasses på samme måde. For eksempel, her er, hvordan man kan tilføje en spansk oversættelse (spansks sprogkode er es):
Her er lang(es)i aktion på den brugerdefinerede filinput til en spansk oversættelse:
Du skal indstille sproget for dit dokument (eller undertræet deraf) korrekt, for at den korrekte tekst kan vises. Dette kan gøres ved at bruge langattributten på <html>elementet eller Content-LanguageHTTP-headeren , blandt andre metoder.
Oversættelse eller tilpasning af strenge med HTML
Bootstrap giver også en måde at oversætte "Gennemse"-teksten i HTML med den data-browseattribut, som kan tilføjes til den brugerdefinerede input-etiket (eksempel på hollandsk):