Voorbeelden en gebruiksrichtlijnen voor formulierbesturingsstijlen, lay-outopties en aangepaste componenten voor het maken van een grote verscheidenheid aan formulieren.
Overzicht
De formulierbesturingselementen van Bootstrap breiden onze opnieuw opgestarte formulierstijlen uit met klassen. Gebruik deze klassen om u aan te melden voor hun aangepaste weergaven voor een consistentere weergave op verschillende browsers en apparaten.
Zorg ervoor dat u een geschikt typekenmerk gebruikt voor alle invoer (bijvoorbeeld emailvoor e-mailadres of numbervoor numerieke informatie) om te profiteren van nieuwere invoeropties zoals e-mailverificatie, nummerselectie en meer.
Hier is een snel voorbeeld om de formulierstijlen van Bootstrap te demonstreren. Blijf lezen voor documentatie over vereiste klassen, formulierlay-out en meer.
Formulierbesturingselementen
Tekstvormbesturingselementen, zoals <input>s, <select>s en <textarea>s, worden gestileerd met de .form-controlklasse. Inbegrepen zijn stijlen voor algemeen uiterlijk, focusstatus, maatvoering en meer.
Voor bestandsinvoer, verwissel de .form-controlvoor .form-control-file.
Maatvoering
Stel hoogten in met klassen zoals .form-control-lgen .form-control-sm.
Alleen lezen
Voeg het readonlybooleaanse kenmerk toe aan een invoer om wijziging van de invoerwaarde te voorkomen. Alleen-lezen ingangen lijken lichter (net als uitgeschakelde ingangen), maar behouden de standaardcursor.
Alleen-lezen platte tekst
Als u <input readonly>elementen in uw formulier als platte tekst wilt opmaken, gebruikt u de .form-control-plaintextklasse om de standaardopmaak van formuliervelden te verwijderen en de juiste marge en opvulling te behouden.
Bereik ingangen
Stel horizontaal verschuifbare bereikingangen in met .form-control-range.
Selectievakjes en radio's
Standaard selectievakjes en radio's zijn verbeterd met behulp van .form-checkeen enkele klasse voor beide invoertypes die de lay-out en het gedrag van hun HTML-elementen verbetert . Selectievakjes zijn voor het selecteren van een of meerdere opties in een lijst, terwijl radio's zijn voor het selecteren van één optie uit vele.
Uitgeschakelde selectievakjes en radio's worden ondersteund. Het disabledattribuut past een lichtere kleur toe om de status van de invoer aan te geven.
Selectievakjes en keuzerondjes ondersteunen op HTML gebaseerde formuliervalidatie en bieden beknopte, toegankelijke labels. Als zodanig zijn onze <input>s en <label>s broers en zussen, in tegenstelling tot een <input>binnen een <label>. Dit is iets uitgebreider omdat u iden attributen moet specificeren om de en forte relateren .<input><label>
Standaard (gestapeld)
Standaard wordt een willekeurig aantal selectievakjes en radio's die direct broer of zus zijn, verticaal gestapeld en op de juiste afstand geplaatst met .form-check.
In lijn
Groepeer selectievakjes of radio's op dezelfde horizontale rij door .form-check-inlineaan een willekeurig .form-check.
Zonder labels
Voeg toe .position-staticaan ingangen binnen .form-checkdie geen labeltekst hebben. Vergeet niet om nog steeds een of ander label op te geven voor ondersteunende technologieën (bijvoorbeeld het gebruik van aria-label).
Lay-out
Omdat Bootstrap van toepassing is display: blockop width: 100%bijna al onze formulierbesturingselementen, worden formulieren standaard verticaal gestapeld. Extra klassen kunnen worden gebruikt om deze lay-out per formulier te variëren.
Groepen vormen
De .form-groupklasse is de gemakkelijkste manier om wat structuur aan formulieren toe te voegen. Het biedt een flexibele klasse die de juiste groepering van labels, besturingselementen, optionele helptekst en formuliervalidatieberichten stimuleert. Standaard is het alleen van toepassing margin-bottom, maar het pikt .form-inlineindien nodig extra stijlen op. Gebruik het met <fieldset>s, <div>s of bijna elk ander element.
Formulierraster
Meer complexe vormen kunnen worden gebouwd met behulp van onze rasterklassen. Gebruik deze voor formulierlay-outs waarvoor meerdere kolommen, verschillende breedtes en aanvullende uitlijningsopties nodig zijn.
Formulierrij
U kunt ook ruilen .rowvoor .form-row, een variant van onze standaard rasterrij die de standaard kolomgoten overschrijft voor strakkere en compactere lay-outs.
Met het rastersysteem kunnen ook complexere lay-outs worden gemaakt.
Horizontale vorm
Maak horizontale formulieren met het raster door de .rowklasse toe te voegen aan formuliergroepen en de .col-*-*klassen te gebruiken om de breedte van uw labels en besturingselementen op te geven. Zorg ervoor dat u ook .col-form-labelaan uw <label>s toevoegt, zodat ze verticaal gecentreerd zijn met de bijbehorende formulierbesturingselementen.
Soms moet u misschien marge- of opvulhulpprogramma's gebruiken om de perfecte uitlijning te creëren die u nodig hebt. We hebben bijvoorbeeld het padding-toplabel op onze gestapelde radio-ingangen verwijderd om de tekstbasislijn beter uit te lijnen.
Horizontale formaatetiketten
Zorg ervoor dat u .col-form-label-smof .col-form-label-lgnaar uw <label>s of s gebruikt om de grootte van en <legend>correct te volgen ..form-control-lg.form-control-sm
Kolomgrootte
Zoals in de vorige voorbeelden te zien is, kunt u met ons rastersysteem een willekeurig aantal .cols binnen a .rowof plaatsen .form-row. Ze verdelen de beschikbare breedte gelijkelijk tussen hen. U kunt ook een subset van uw kolommen kiezen om meer of minder ruimte in te nemen, terwijl de resterende .cols de rest gelijkelijk verdelen, met specifieke kolomklassen zoals .col-7.
Auto-sizing
Het onderstaande voorbeeld gebruikt een flexbox-hulpprogramma om de inhoud verticaal te centreren en verandert .colin .col-autozodat uw kolommen slechts zoveel ruimte innemen als nodig is. Anders gezegd, de kolomgrootte zelf op basis van de inhoud.
U kunt dat vervolgens opnieuw mixen met maatspecifieke kolomklassen.
Gebruik de .form-inlineklasse om een reeks labels, formulierbesturingselementen en knoppen op een enkele horizontale rij weer te geven. Formulierbesturingselementen binnen inline formulieren wijken enigszins af van hun standaardstatussen.
Besturingselementen zijn display: flex, het samenvouwen van elke HTML-spatie en u in staat stellen om uitlijningscontrole te bieden met spatiëring en flexbox - hulpprogramma's.
Besturingselementen en invoergroepen ontvangen width: autoom de Bootstrap-standaard te overschrijven width: 100%.
Bedieningselementen verschijnen alleen inline in kijkvensters die ten minste 576 px breed zijn om rekening te houden met smalle kijkvensters op mobiele apparaten.
Mogelijk moet u de breedte en uitlijning van afzonderlijke formulierbesturingselementen handmatig aanpassen met hulpprogramma's voor spatiëring (zoals hieronder weergegeven). Zorg er ten slotte voor dat u altijd een a <label>toevoegt aan elk formulierbesturingselement, zelfs als u het moet verbergen voor bezoekers zonder schermlezer met .sr-only.
Aangepaste formulierbesturingselementen en selecties worden ook ondersteund.
Alternatieven voor verborgen labels
Hulptechnologieën zoals schermlezers zullen problemen hebben met uw formulieren als u niet voor elke invoer een label opneemt. Voor deze inline-formulieren kunt u de labels verbergen met behulp van de .sr-onlyklasse. Er zijn nog meer alternatieve methoden om een label te geven voor ondersteunende technologieën, zoals het attribuut aria-label, aria-labelledbyof . titleAls geen van deze aanwezig is, kunnen ondersteunende technologieën hun toevlucht nemen tot het gebruik van het placeholderattribuut, indien aanwezig, maar houd er rekening mee dat het gebruik van placeholderals vervanging voor andere etiketteringsmethoden niet wordt aanbevolen.
Hulp tekst
Help-tekst op blokniveau in formulieren kan worden gemaakt met .form-text(voorheen bekend als .help-blockin v3). Inline Help-tekst kan flexibel worden geïmplementeerd met behulp van elk inline HTML-element en hulpprogrammaklassen zoals .text-muted.
Help-tekst koppelen aan formulierbesturingselementen
Help-tekst moet expliciet worden geassocieerd met het formulierbesturingselement waarop het betrekking heeft met behulp van het aria-describedbyattribuut. Dit zorgt ervoor dat ondersteunende technologieën, zoals schermlezers, deze helptekst aankondigen wanneer de gebruiker zich concentreert of de besturing betreedt.
Help-tekst onder invoer kan worden gestyled met .form-text. Deze klasse bevat display: blocken voegt wat bovenmarge toe voor gemakkelijke afstand van de bovenstaande invoer.
Uw wachtwoord moet 8-20 tekens lang zijn, letters en cijfers bevatten en mag geen spaties, speciale tekens of emoji bevatten.
Inline-tekst kan elk typisch inline HTML-element gebruiken (of het nu een <small>, <span>, of iets anders is) met niets meer dan een utility-klasse.
Uitgeschakelde formulieren
Voeg het disabledbooleaanse kenmerk toe aan een invoer om gebruikersinteracties te voorkomen en deze lichter te laten lijken.
Voeg het disabledkenmerk toe aan a <fieldset>om alle besturingselementen binnen uit te schakelen.
Waarschuwing met ankers
Standaard behandelen browsers alle native formulierbesturingselementen ( <input>, <select>en <button>elementen) binnen a <fieldset disabled>als uitgeschakeld, waardoor zowel toetsenbord- als muisinteracties worden voorkomen. Als uw formulier echter ook <a ... class="btn btn-*">elementen bevat, krijgen deze alleen de stijl pointer-events: none. Zoals opgemerkt in de sectie over uitgeschakelde status voor knoppen (en specifiek in de subsectie voor ankerelementen), is deze CSS-eigenschap nog niet gestandaardiseerd en niet volledig ondersteund in Internet Explorer 10, en zal niet voorkomen dat toetsenbordgebruikers in staat om deze links te focussen of te activeren. Gebruik dus voor de zekerheid aangepast JavaScript om dergelijke links uit te schakelen.
Compatibiliteit tussen verschillende browsers
Hoewel Bootstrap deze stijlen in alle browsers zal toepassen, ondersteunen Internet Explorer 11 en lager het disabledkenmerk op een <fieldset>. Gebruik aangepast JavaScript om de veldset in deze browsers uit te schakelen.
Geldigmaking
Geef waardevolle, bruikbare feedback aan uw gebruikers met HTML5-formuliervalidatie, beschikbaar in al onze ondersteunde browsers . Kies uit de standaard validatiefeedback van de browser of implementeer aangepaste berichten met onze ingebouwde klassen en JavaScript voor starters.
We raden momenteel aan om aangepaste validatiestijlen te gebruiken, omdat standaard validatieberichten van de browser niet consistent worden blootgesteld aan ondersteunende technologieën in alle browsers (met name Chrome op desktop en mobiel).
Hoe het werkt
Zo werkt formuliervalidatie met Bootstrap:
HTML-formuliervalidatie wordt toegepast via de twee pseudo-klassen van CSS, :invaliden :valid. Het is van toepassing op <input>, <select>, en <textarea>elementen.
Bootstrap dekt de :invaliden :validstijlen naar bovenliggende .was-validatedklasse, meestal toegepast op de <form>. Anders wordt elk verplicht veld zonder waarde als ongeldig weergegeven bij het laden van de pagina. Op deze manier kunt u kiezen wanneer u ze wilt activeren (meestal nadat het formulier is ingediend).
Om het uiterlijk van het formulier opnieuw in te stellen (bijvoorbeeld in het geval van dynamische formulierinzendingen met AJAX), verwijdert u de .was-validatedklas <form>opnieuw uit het formulier na het indienen.
Als fallback kunnen .is-invalidklassen .is-validworden gebruikt in plaats van de pseudo-klassen voor validatie aan de serverzijde . Ze hebben geen ouderklas nodig .was-validated.
Vanwege beperkingen in de manier waarop CSS werkt, kunnen we (momenteel) geen stijlen toepassen op een <label>die vóór een formulierbesturingselement in de DOM komt zonder de hulp van aangepast JavaScript.
Alle moderne browsers ondersteunen de beperkingsvalidatie-API , een reeks JavaScript-methoden voor het valideren van formulierbesturingselementen.
Feedbackberichten kunnen gebruikmaken van de standaardinstellingen van de browser (verschillend voor elke browser en niet-styleerbaar via CSS) of onze aangepaste feedbackstijlen met aanvullende HTML en CSS.
U kunt aangepaste geldigheidsberichten verstrekken setCustomValidityin JavaScript.
Overweeg met dat in gedachten de volgende demo's voor onze aangepaste formuliervalidatiestijlen, optionele serverside-klassen en browserstandaarden.
Aangepaste stijlen
Voor aangepaste Bootstrap-formuliervalidatieberichten moet u het novalidateboolean-kenmerk toevoegen aan uw <form>. Dit schakelt de standaard feedbacktooltips van de browser uit, maar biedt nog steeds toegang tot de formuliervalidatie-API's in JavaScript. Probeer het onderstaande formulier in te dienen; onze JavaScript zal de verzendknop onderscheppen en feedback aan u doorgeven. Wanneer u probeert in te dienen, ziet u de stijlen :invaliden :validtoegepast op uw formulierbesturingselementen.
Aangepaste feedbackstijlen passen aangepaste kleuren, randen, focusstijlen en achtergrondpictogrammen toe om feedback beter te communiceren. Achtergrondpictogrammen voor <select>s zijn alleen beschikbaar met .custom-select, en niet .form-control.
Standaardinstellingen van de browser
Niet geïnteresseerd in aangepaste validatiefeedbackberichten of het schrijven van JavaScript om formuliergedrag te veranderen? Allemaal goed, u kunt de standaardinstellingen van de browser gebruiken. Probeer het onderstaande formulier in te dienen. Afhankelijk van uw browser en besturingssysteem ziet u een iets andere stijl van feedback.
Hoewel deze feedbackstijlen niet kunnen worden gestileerd met CSS, kunt u de feedbacktekst nog steeds aanpassen via JavaScript.
Serverkant
We raden u aan validatie aan de clientzijde te gebruiken, maar als u validatie aan de serverzijde nodig hebt, kunt u ongeldige en geldige formuliervelden aangeven met .is-invaliden .is-valid. Merk op dat .invalid-feedbackdit ook wordt ondersteund met deze klassen.
Ondersteunde elementen
Er zijn validatiestijlen beschikbaar voor de volgende formulierbesturingselementen en componenten:
<input>s en <textarea>s met .form-control(inclusief maximaal één .form-controlin invoergroepen)
<select>s met .form-controlof.custom-select
.form-checks
.custom-checkboxs en .custom-radios
.custom-file
Knopinfo
Als uw formulierlay-out dit toelaat, kunt u de .{valid|invalid}-feedbackklassen omwisselen voor .{valid|invalid}-tooltipklassen om validatiefeedback weer te geven in een gestileerde knopinfo. Zorg ervoor dat je een ouder hebt met position: relativeerop voor de positionering van de tooltip. In het onderstaande voorbeeld hebben onze kolomklassen dit al, maar voor uw project is mogelijk een alternatieve opstelling vereist.
Aanpassen
Validatiestatussen kunnen via Sass met de $form-validation-stateskaart worden aangepast. Deze Sass-kaart bevindt zich in ons _variables.scssbestand en wordt doorgelust om de standaard- valid/ invalidvalidatiestatussen te genereren. Inbegrepen is een geneste kaart voor het aanpassen van de kleur en het pictogram van elke staat. Hoewel er geen andere statussen worden ondersteund door browsers, kunnen degenen die aangepaste stijlen gebruiken eenvoudig meer complexe formulierfeedback toevoegen.
Houd er rekening mee dat we niet aanbevelen om deze waarden aan te passen zonder ook de form-validation-statemixin te wijzigen.
Aangepaste formulieren
Voor nog meer maatwerk en consistentie tussen verschillende browsers, gebruikt u onze volledig aangepaste formulierelementen om de standaardinstellingen van de browser te vervangen. Ze zijn gebouwd op semantische en toegankelijke markeringen, dus ze zijn solide vervangingen voor elk standaard formulierbesturingselement.
Selectievakjes en radio's
Elk selectievakje en elke radio <input>en <label>koppeling is verpakt in een <div>om onze aangepaste bediening te creëren. Structureel is dit dezelfde benadering als onze standaard .form-check.
We gebruiken de broer of zus-selector ( ~) voor al onze <input>statussen, zoals :checked- om onze aangepaste formulierindicator op de juiste manier te stylen. In combinatie met de .custom-control-labelklasse kunnen we de tekst voor elk item ook opmaken op basis van de <input>'status.
We verbergen de standaard <input>met opacityen gebruiken de .custom-control-labelom een nieuwe aangepaste formulierindicator op zijn plaats te maken met ::beforeen ::after. Helaas kunnen we geen aangepaste maken van alleen de <input>omdat CSS'en contentniet werken op dat element.
In de aangevinkte statussen gebruiken we base64 embedded SVG-pictogrammen van Open Iconic . Dit biedt ons de beste controle voor styling en positionering op verschillende browsers en apparaten.
Selectievakjes
Aangepaste selectievakjes kunnen ook gebruikmaken van de :indeterminatepseudo-klasse wanneer ze handmatig worden ingesteld via JavaScript (er is geen HTML-kenmerk beschikbaar om het te specificeren).
Als je jQuery gebruikt, zou zoiets als dit moeten volstaan:
Radio's
In lijn
Gehandicapt
Aangepaste selectievakjes en radio's kunnen ook worden uitgeschakeld. Voeg het disabledbooleaanse attribuut toe aan de <input>en de aangepaste indicator en labelbeschrijving worden automatisch opgemaakt.
Schakelaars
Een schakelaar heeft de opmaak van een aangepast selectievakje, maar gebruikt de .custom-switchklasse om een tuimelschakelaar weer te geven. Switches ondersteunen ook het disabledattribuut.
Selecteer menu
Aangepaste <select>menu's hebben alleen een aangepaste klasse .custom-selectnodig om de aangepaste stijlen te activeren. Aangepaste stijlen zijn beperkt tot het <select>oorspronkelijke uiterlijk en kunnen de stijlen niet wijzigen <option>vanwege browserbeperkingen.
U kunt ook kiezen uit kleine en grote aangepaste selecties die passen bij onze tekstinvoer van vergelijkbare grootte.
Het multipleattribuut wordt ook ondersteund:
Zoals het sizeattribuut:
Bereik
Maak aangepaste <input type="range">besturingselementen met .custom-range. De track (de achtergrond) en thumb (de waarde) zijn beide zo gestileerd dat ze er in alle browsers hetzelfde uitzien. Omdat alleen IE en Firefox het "vullen" van hun track vanaf de linker- of rechterkant van de duim ondersteunen als een middel om de voortgang visueel aan te geven, ondersteunen we dit momenteel niet.
Bereikingangen hebben impliciete waarden voor respectievelijk minen max— 0en 100. U kunt nieuwe waarden specificeren voor degenen die de minen maxattributen gebruiken.
Standaard wordt bij bereikinvoer "geklikt" op gehele waarden. Om dit te wijzigen, kunt u een stepwaarde opgeven. In het onderstaande voorbeeld verdubbelen we het aantal stappen door te gebruiken step="0.5".
Bestandsverkenner
De aanbevolen plug-in om aangepaste bestandsinvoer te animeren: bs-custom-file-input , dat is wat we momenteel hier in onze documenten gebruiken.
De bestandsinvoer is de meest lastige van het stel en vereist extra JavaScript als je ze wilt koppelen aan functioneel Kies bestand... en geselecteerde bestandsnaamtekst.
We verbergen het standaardbestand <input>via opacityen in plaats daarvan stylen we de <label>. De knop wordt gegenereerd en gepositioneerd met ::after. Ten slotte verklaren we een widthen heightop de <input>voor de juiste spatiëring voor de omliggende inhoud.
De strings vertalen of aanpassen met SCSS
De :lang()pseudo-klasse wordt gebruikt om de "Bladeren"-tekst in andere talen te kunnen vertalen. Overschrijf of voeg items toe aan de $custom-file-textSass-variabele met de relevante taaltag en gelokaliseerde tekenreeksen. De Engelse snaren kunnen op dezelfde manier worden aangepast. Zo kunt u bijvoorbeeld een Spaanse vertaling toevoegen (de Spaanse taalcode is es):
Hier is lang(es)in actie op de aangepaste bestandsinvoer voor een Spaanse vertaling:
U moet de taal van uw document (of substructuur daarvan) correct instellen om de juiste tekst te laten zien. Dit kan onder andere worden gedaan met behulp van het langattribuut op het <html>element of de Content-LanguageHTTP-header .
De strings vertalen of aanpassen met HTML
Bootstrap biedt ook een manier om de "Bladeren"-tekst in HTML te vertalen met het data-browseattribuut dat kan worden toegevoegd aan het aangepaste invoerlabel (voorbeeld in het Nederlands):