formuláře
Příklady a pokyny pro použití stylů ovládání formuláře, možností rozvržení a vlastních komponent pro vytváření široké škály formulářů.
Ovládací prvky formuláře Bootstrap rozšiřují naše styly formuláře Rebooted o třídy. Pomocí těchto tříd se můžete přihlásit k jejich přizpůsobeným zobrazením pro konzistentnější vykreslování napříč prohlížeči a zařízeními.
Ujistěte se, že používáte vhodný type
atribut u všech vstupů (např. email
pro e-mailovou adresu nebo number
pro číselné informace), abyste využili výhod novějších ovládacích prvků zadávání, jako je ověření e-mailu, výběr čísla a další.
Zde je rychlý příklad demonstrující styly formulářů Bootstrapu. Pokračujte ve čtení dokumentace k požadovaným třídám, rozvržení formuláře a dalším.
<form>
<div class="form-group">
<label for="exampleInputEmail1">Email address</label>
<input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp" placeholder="Enter email">
<small id="emailHelp" class="form-text text-muted">We'll never share your email with anyone else.</small>
</div>
<div class="form-group">
<label for="exampleInputPassword1">Password</label>
<input type="password" class="form-control" id="exampleInputPassword1" placeholder="Password">
</div>
<div class="form-group form-check">
<input type="checkbox" class="form-check-input" id="exampleCheck1">
<label class="form-check-label" for="exampleCheck1">Check me out</label>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</form>
Ovládací prvky textového formuláře – jako <input>
s, <select>
s a <textarea>
s – jsou stylizovány podle .form-control
třídy. Zahrnuty jsou styly pro celkový vzhled, stav zaostření, velikost a další.
Nezapomeňte prozkoumat naše vlastní formuláře pro další styly <select>
.
<form>
<div class="form-group">
<label for="exampleFormControlInput1">Email address</label>
<input type="email" class="form-control" id="exampleFormControlInput1" placeholder="[email protected]">
</div>
<div class="form-group">
<label for="exampleFormControlSelect1">Example select</label>
<select class="form-control" id="exampleFormControlSelect1">
<option>1</option>
<option>2</option>
<option>3</option>
<option>4</option>
<option>5</option>
</select>
</div>
<div class="form-group">
<label for="exampleFormControlSelect2">Example multiple select</label>
<select multiple class="form-control" id="exampleFormControlSelect2">
<option>1</option>
<option>2</option>
<option>3</option>
<option>4</option>
<option>5</option>
</select>
</div>
<div class="form-group">
<label for="exampleFormControlTextarea1">Example textarea</label>
<textarea class="form-control" id="exampleFormControlTextarea1" rows="3"></textarea>
</div>
</form>
Pro vstupy souborů vyměňte .form-control
za .form-control-file
.
<form>
<div class="form-group">
<label for="exampleFormControlFile1">Example file input</label>
<input type="file" class="form-control-file" id="exampleFormControlFile1">
</div>
</form>
Nastavte výšky pomocí tříd jako .form-control-lg
a .form-control-sm
.
<input class="form-control form-control-lg" type="text" placeholder=".form-control-lg">
<input class="form-control" type="text" placeholder="Default input">
<input class="form-control form-control-sm" type="text" placeholder=".form-control-sm">
<select class="form-control form-control-lg">
<option>Large select</option>
</select>
<select class="form-control">
<option>Default select</option>
</select>
<select class="form-control form-control-sm">
<option>Small select</option>
</select>
Přidejte readonly
na vstup booleovský atribut, abyste zabránili změně hodnoty vstupu. Vstupy pouze pro čtení se zdají světlejší (stejně jako zakázané vstupy), ale zachovají si standardní kurzor.
<input class="form-control" type="text" placeholder="Readonly input here…" readonly>
Pokud chcete mít <input readonly>
prvky ve formuláři stylizované jako prostý text, použijte tuto .form-control-plaintext
třídu k odstranění výchozího stylu pole formuláře a zachování správného okraje a odsazení.
<form>
<div class="form-group row">
<label for="staticEmail" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="text" readonly class="form-control-plaintext" id="staticEmail" value="[email protected]">
</div>
</div>
<div class="form-group row">
<label for="inputPassword" class="col-sm-2 col-form-label">Password</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword" placeholder="Password">
</div>
</div>
</form>
<form class="form-inline">
<div class="form-group mb-2">
<label for="staticEmail2" class="sr-only">Email</label>
<input type="text" readonly class="form-control-plaintext" id="staticEmail2" value="[email protected]">
</div>
<div class="form-group mx-sm-3 mb-2">
<label for="inputPassword2" class="sr-only">Password</label>
<input type="password" class="form-control" id="inputPassword2" placeholder="Password">
</div>
<button type="submit" class="btn btn-primary mb-2">Confirm identity</button>
</form>
Nastavte vodorovně rolovatelné vstupy rozsahu pomocí .form-control-range
.
<form>
<div class="form-group">
<label for="formControlRange">Example Range input</label>
<input type="range" class="form-control-range" id="formControlRange">
</div>
</form>
Výchozí zaškrtávací políčka a přepínače jsou vylepšeny pomocí jediné třídy pro oba typy vstupu, která zlepšuje rozvržení a chování jejich prvků.form-check
HTML . Zaškrtávací políčka jsou pro výběr jedné nebo několika možností v seznamu, zatímco rádia jsou pro výběr jedné možnosti z mnoha.
Jsou podporována zakázaná zaškrtávací políčka a rádia, ale chcete-li not-allowed
umístit kurzor na nadřazený prvek <label>
, musíte přidat disabled
atribut do .form-check-input
. Atribut disabled použije světlejší barvu, která pomůže indikovat stav vstupu.
Použití zaškrtávacích políček a rádií je navrženo tak, aby podporovalo ověřování formulářů založené na HTML a poskytovalo stručné a přístupné štítky. Jako takové jsou naše <input>
s a <label>
s sourozenecké prvky na rozdíl od prvků <input>
uvnitř <label>
. Toto je o něco podrobnější, protože musíte zadat id
a for
atributy, aby se vztahovaly <input>
a <label>
.
Ve výchozím nastavení bude libovolný počet zaškrtávacích políček a rádií, které jsou bezprostředními sourozenci, vertikálně naskládán a vhodně rozmístěn pomocí .form-check
.
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="defaultCheck1">
<label class="form-check-label" for="defaultCheck1">
Default checkbox
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="defaultCheck2" disabled>
<label class="form-check-label" for="defaultCheck2">
Disabled checkbox
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios1" value="option1" checked>
<label class="form-check-label" for="exampleRadios1">
Default radio
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios2" value="option2">
<label class="form-check-label" for="exampleRadios2">
Second default radio
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios3" value="option3" disabled>
<label class="form-check-label" for="exampleRadios3">
Disabled radio
</label>
</div>
Seskupte zaškrtávací políčka nebo rádia na stejném vodorovném řádku přidáním .form-check-inline
k libovolnému .form-check
.
<div class="form-check form-check-inline">
<input class="form-check-input" type="checkbox" id="inlineCheckbox1" value="option1">
<label class="form-check-label" for="inlineCheckbox1">1</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="checkbox" id="inlineCheckbox2" value="option2">
<label class="form-check-label" for="inlineCheckbox2">2</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="checkbox" id="inlineCheckbox3" value="option3" disabled>
<label class="form-check-label" for="inlineCheckbox3">3 (disabled)</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio1" value="option1">
<label class="form-check-label" for="inlineRadio1">1</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio2" value="option2">
<label class="form-check-label" for="inlineRadio2">2</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio3" value="option3" disabled>
<label class="form-check-label" for="inlineRadio3">3 (disabled)</label>
</div>
Přidat .position-static
ke vstupům .form-check
, které nemají žádný text štítku. Nezapomeňte stále poskytovat nějakou formu štítku pro asistenční technologie (například pomocí aria-label
).
<div class="form-check">
<input class="form-check-input position-static" type="checkbox" id="blankCheckbox" value="option1" aria-label="...">
</div>
<div class="form-check">
<input class="form-check-input position-static" type="radio" name="blankRadio" id="blankRadio1" value="option1" aria-label="...">
</div>
Protože Bootstrap platí display: block
pro width: 100%
téměř všechny naše ovládací prvky formulářů, formuláře se ve výchozím nastavení skládají svisle. Další třídy lze použít ke změně tohoto rozvržení na základě jednotlivých formulářů.
Třída .form-group
je nejjednodušší způsob, jak přidat nějakou strukturu do formulářů. Poskytuje flexibilní třídu, která podporuje správné seskupování štítků, ovládacích prvků, volitelného textu nápovědy a zasílání zpráv pro ověření formuláře. Ve výchozím nastavení platí pouze margin-bottom
, ale .form-inline
podle potřeby vybírá další styly. Použijte jej s <fieldset>
s, <div>
s nebo téměř jakýmkoli jiným prvkem.
<form>
<div class="form-group">
<label for="formGroupExampleInput">Example label</label>
<input type="text" class="form-control" id="formGroupExampleInput" placeholder="Example input">
</div>
<div class="form-group">
<label for="formGroupExampleInput2">Another label</label>
<input type="text" class="form-control" id="formGroupExampleInput2" placeholder="Another input">
</div>
</form>
Složitější formuláře lze sestavit pomocí našich tříd mřížky. Použijte je pro rozvržení formuláře, která vyžadují více sloupců, různé šířky a další možnosti zarovnání.
<form>
<div class="row">
<div class="col">
<input type="text" class="form-control" placeholder="First name">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="Last name">
</div>
</div>
</form>
Můžete také vyměnit .row
za .form-row
variantu naší standardní řady mřížky, která přepíše výchozí okapy sloupců pro těsnější a kompaktnější rozvržení.
<form>
<div class="form-row">
<div class="col">
<input type="text" class="form-control" placeholder="First name">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="Last name">
</div>
</div>
</form>
Pomocí mřížkového systému lze vytvořit i složitější rozvržení.
<form>
<div class="form-row">
<div class="form-group col-md-6">
<label for="inputEmail4">Email</label>
<input type="email" class="form-control" id="inputEmail4" placeholder="Email">
</div>
<div class="form-group col-md-6">
<label for="inputPassword4">Password</label>
<input type="password" class="form-control" id="inputPassword4" placeholder="Password">
</div>
</div>
<div class="form-group">
<label for="inputAddress">Address</label>
<input type="text" class="form-control" id="inputAddress" placeholder="1234 Main St">
</div>
<div class="form-group">
<label for="inputAddress2">Address 2</label>
<input type="text" class="form-control" id="inputAddress2" placeholder="Apartment, studio, or floor">
</div>
<div class="form-row">
<div class="form-group col-md-6">
<label for="inputCity">City</label>
<input type="text" class="form-control" id="inputCity">
</div>
<div class="form-group col-md-4">
<label for="inputState">State</label>
<select id="inputState" class="form-control">
<option selected>Choose...</option>
<option>...</option>
</select>
</div>
<div class="form-group col-md-2">
<label for="inputZip">Zip</label>
<input type="text" class="form-control" id="inputZip">
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="gridCheck">
<label class="form-check-label" for="gridCheck">
Check me out
</label>
</div>
</div>
<button type="submit" class="btn btn-primary">Sign in</button>
</form>
Vytvořte vodorovné formuláře s mřížkou přidáním .row
třídy do skupin formulářů a pomocí .col-*-*
tříd zadejte šířku štítků a ovládacích prvků. Nezapomeňte také přidat .col-form-label
do <label>
s, aby byly svisle vystředěny s přidruženými ovládacími prvky formuláře.
Někdy možná budete muset použít nástroje pro okraje nebo výplň, abyste vytvořili dokonalé zarovnání, které potřebujete. Odstranili jsme například padding-top
štítek naskládaných rádiových vstupů, abychom lépe zarovnali účaří textu.
<form>
<div class="form-group row">
<label for="inputEmail3" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control" id="inputEmail3" placeholder="Email">
</div>
</div>
<div class="form-group row">
<label for="inputPassword3" class="col-sm-2 col-form-label">Password</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword3" placeholder="Password">
</div>
</div>
<fieldset class="form-group">
<div class="row">
<legend class="col-form-label col-sm-2 pt-0">Radios</legend>
<div class="col-sm-10">
<div class="form-check">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios1" value="option1" checked>
<label class="form-check-label" for="gridRadios1">
First radio
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios2" value="option2">
<label class="form-check-label" for="gridRadios2">
Second radio
</label>
</div>
<div class="form-check disabled">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios3" value="option3" disabled>
<label class="form-check-label" for="gridRadios3">
Third disabled radio
</label>
</div>
</div>
</div>
</fieldset>
<div class="form-group row">
<div class="col-sm-2">Checkbox</div>
<div class="col-sm-10">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="gridCheck1">
<label class="form-check-label" for="gridCheck1">
Example checkbox
</label>
</div>
</div>
</div>
<div class="form-group row">
<div class="col-sm-10">
<button type="submit" class="btn btn-primary">Sign in</button>
</div>
</div>
</form>
Ujistěte se, že používáte .col-form-label-sm
nebo .col-form-label-lg
na vaše <label>
s nebo <legend>
s, abyste správně dodrželi velikost .form-control-lg
a .form-control-sm
.
<form>
<div class="form-group row">
<label for="colFormLabelSm" class="col-sm-2 col-form-label col-form-label-sm">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control form-control-sm" id="colFormLabelSm" placeholder="col-form-label-sm">
</div>
</div>
<div class="form-group row">
<label for="colFormLabel" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control" id="colFormLabel" placeholder="col-form-label">
</div>
</div>
<div class="form-group row">
<label for="colFormLabelLg" class="col-sm-2 col-form-label col-form-label-lg">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control form-control-lg" id="colFormLabelLg" placeholder="col-form-label-lg">
</div>
</div>
</form>
Jak je ukázáno v předchozích příkladech, náš mřížkový systém umožňuje umístit libovolný počet .col
s do a .row
nebo .form-row
. Rozdělí dostupnou šířku rovnoměrně mezi ně. Můžete si také vybrat podmnožinu svých sloupců, aby zabíraly více či méně místa, zatímco zbývající .col
s rovnoměrně rozdělí zbytek, se specifickými třídami sloupců, jako je .col-7
.
<form>
<div class="form-row">
<div class="col-7">
<input type="text" class="form-control" placeholder="City">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="State">
</div>
<div class="col">
<input type="text" class="form-control" placeholder="Zip">
</div>
</div>
</form>
Níže uvedený příklad používá obslužný program flexbox ke svislému vystředění obsahu a změny .col
tak .col-auto
, aby vaše sloupce zabíraly pouze tolik místa, kolik je potřeba. Jinými slovy, velikost sloupce závisí na obsahu.
<form>
<div class="form-row align-items-center">
<div class="col-auto">
<label class="sr-only" for="inlineFormInput">Name</label>
<input type="text" class="form-control mb-2" id="inlineFormInput" placeholder="Jane Doe">
</div>
<div class="col-auto">
<label class="sr-only" for="inlineFormInputGroup">Username</label>
<div class="input-group mb-2">
<div class="input-group-prepend">
<div class="input-group-text">@</div>
</div>
<input type="text" class="form-control" id="inlineFormInputGroup" placeholder="Username">
</div>
</div>
<div class="col-auto">
<div class="form-check mb-2">
<input class="form-check-input" type="checkbox" id="autoSizingCheck">
<label class="form-check-label" for="autoSizingCheck">
Remember me
</label>
</div>
</div>
<div class="col-auto">
<button type="submit" class="btn btn-primary mb-2">Submit</button>
</div>
</div>
</form>
Poté to můžete znovu smíchat s třídami sloupců specifických pro velikost.
<form>
<div class="form-row align-items-center">
<div class="col-sm-3 my-1">
<label class="sr-only" for="inlineFormInputName">Name</label>
<input type="text" class="form-control" id="inlineFormInputName" placeholder="Jane Doe">
</div>
<div class="col-sm-3 my-1">
<label class="sr-only" for="inlineFormInputGroupUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<div class="input-group-text">@</div>
</div>
<input type="text" class="form-control" id="inlineFormInputGroupUsername" placeholder="Username">
</div>
</div>
<div class="col-auto my-1">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="autoSizingCheck2">
<label class="form-check-label" for="autoSizingCheck2">
Remember me
</label>
</div>
</div>
<div class="col-auto my-1">
<button type="submit" class="btn btn-primary">Submit</button>
</div>
</div>
</form>
A samozřejmě jsou podporovány vlastní ovládací prvky formuláře .
<form>
<div class="form-row align-items-center">
<div class="col-auto my-1">
<label class="mr-sm-2 sr-only" for="inlineFormCustomSelect">Preference</label>
<select class="custom-select mr-sm-2" id="inlineFormCustomSelect">
<option selected>Choose...</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
</div>
<div class="col-auto my-1">
<div class="custom-control custom-checkbox mr-sm-2">
<input type="checkbox" class="custom-control-input" id="customControlAutosizing">
<label class="custom-control-label" for="customControlAutosizing">Remember my preference</label>
</div>
</div>
<div class="col-auto my-1">
<button type="submit" class="btn btn-primary">Submit</button>
</div>
</div>
</form>
Použijte .form-inline
třídu k zobrazení řady štítků, ovládacích prvků formuláře a tlačítek na jednom vodorovném řádku. Ovládací prvky formuláře v rámci vložených formulářů se mírně liší od jejich výchozího stavu.
- Ovládací prvky jsou
display: flex
, sbalují jakékoli prázdné místo HTML a umožňují vám poskytovat kontrolu zarovnání pomocí nástrojů pro mezery a flexbox . - Ovládací prvky a vstupní skupiny přijímají
width: auto
k přepsání výchozího nastavení Bootstrapwidth: 100%
. - Ovládací prvky se zobrazují vložené pouze ve výřezech, které jsou široké alespoň 576 pixelů , aby se zohlednily úzké výřezy na mobilních zařízeních.
Možná budete muset ručně upravit šířku a zarovnání jednotlivých ovládacích prvků formuláře pomocí nástrojů pro nastavení mezer (jak je uvedeno níže). Nakonec se ujistěte, že ke <label>
každému ovládacímu prvku formuláře vždy přidáte a, i když jej potřebujete skrýt před návštěvníky, kteří nepoužívají programy pro čtení z obrazovky, pomocí .sr-only
.
<form class="form-inline">
<label class="sr-only" for="inlineFormInputName2">Name</label>
<input type="text" class="form-control mb-2 mr-sm-2" id="inlineFormInputName2" placeholder="Jane Doe">
<label class="sr-only" for="inlineFormInputGroupUsername2">Username</label>
<div class="input-group mb-2 mr-sm-2">
<div class="input-group-prepend">
<div class="input-group-text">@</div>
</div>
<input type="text" class="form-control" id="inlineFormInputGroupUsername2" placeholder="Username">
</div>
<div class="form-check mb-2 mr-sm-2">
<input class="form-check-input" type="checkbox" id="inlineFormCheck">
<label class="form-check-label" for="inlineFormCheck">
Remember me
</label>
</div>
<button type="submit" class="btn btn-primary mb-2">Submit</button>
</form>
Podporovány jsou také vlastní ovládací prvky formuláře a výběry.
<form class="form-inline">
<label class="my-1 mr-2" for="inlineFormCustomSelectPref">Preference</label>
<select class="custom-select my-1 mr-sm-2" id="inlineFormCustomSelectPref">
<option selected>Choose...</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<div class="custom-control custom-checkbox my-1 mr-sm-2">
<input type="checkbox" class="custom-control-input" id="customControlInline">
<label class="custom-control-label" for="customControlInline">Remember my preference</label>
</div>
<button type="submit" class="btn btn-primary my-1">Submit</button>
</form>
Alternativy ke skrytým štítkům
Asistenční technologie, jako jsou čtečky obrazovky, budou mít potíže s vašimi formuláři, pokud pro každý vstup nezahrnete štítek. U těchto vložených formulářů můžete štítky skrýt pomocí .sr-only
třídy. Existují další alternativní způsoby poskytování označení pro asistenční technologie, jako je atribut aria-label
, aria-labelledby
nebo . title
Pokud není přítomen žádný z těchto atributů, mohou se asistenční technologie uchýlit k použití placeholder
atributu, pokud je přítomen, ale pamatujte, že použití placeholder
jako náhrady za jiné metody označování se nedoporučuje.
Text nápovědy na úrovni bloku ve formulářích lze vytvořit pomocí .form-text
(dříve známé jako .help-block
v3). Vložený text nápovědy lze flexibilně implementovat pomocí jakéhokoli vloženého prvku HTML a tříd nástrojů, jako je .text-muted
.
Přidružení textu nápovědy k ovládacím prvkům formuláře
Text nápovědy by měl být explicitně přidružen k ovládacímu prvku formuláře, ke kterému se vztahuje pomocí aria-describedby
atributu. To zajistí, že asistenční technologie – jako jsou čtečky obrazovky – oznámí tento text nápovědy, když uživatel zaostří nebo vstoupí do ovládacího prvku.
Text nápovědy pod vstupy lze upravit pomocí .form-text
. Tato třída obsahuje display: block
a přidává horní okraj pro snadné rozestupy od výše uvedených vstupů.
<label for="inputPassword5">Password</label>
<input type="password" id="inputPassword5" class="form-control" aria-describedby="passwordHelpBlock">
<small id="passwordHelpBlock" class="form-text text-muted">
Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
</small>
Vložený text může používat jakýkoli typický vložený prvek HTML (ať už je to <small>
, <span>
, nebo něco jiného) s ničím jiným než obslužnou třídou.
<form class="form-inline">
<div class="form-group">
<label for="inputPassword6">Password</label>
<input type="password" id="inputPassword6" class="form-control mx-sm-3" aria-describedby="passwordHelpInline">
<small id="passwordHelpInline" class="text-muted">
Must be 8-20 characters long.
</small>
</div>
</form>
Přidejte do disabled
vstupu booleovský atribut, abyste zabránili uživatelským interakcím a aby se zdál lehčí.
<input class="form-control" id="disabledInput" type="text" placeholder="Disabled input here..." disabled>
Přidáním disabled
atributu do a <fieldset>
deaktivujete všechny ovládací prvky.
<form>
<fieldset disabled>
<div class="form-group">
<label for="disabledTextInput">Disabled input</label>
<input type="text" id="disabledTextInput" class="form-control" placeholder="Disabled input">
</div>
<div class="form-group">
<label for="disabledSelect">Disabled select menu</label>
<select id="disabledSelect" class="form-control">
<option>Disabled select</option>
</select>
</div>
<div class="form-check">
<input class="form-check-input" type="checkbox" id="disabledFieldsetCheck" disabled>
<label class="form-check-label" for="disabledFieldsetCheck">
Can't check this
</label>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</fieldset>
</form>
Upozornění s kotvami
Ve výchozím nastavení budou prohlížeče považovat všechny ovládací prvky nativního formuláře ( <input>
a prvky) uvnitř a <select>
za zakázané, což zabrání interakci s klávesnicí a myší. Pokud však váš formulář obsahuje také prvky, bude jim přidělen pouze styl . Jak je uvedeno v části o vypnutém stavu pro tlačítka (a konkrétně v podsekci pro prvky kotvy), tato vlastnost CSS zatím není standardizovaná a není plně podporována v aplikaci Internet Explorer 10 a nebrání uživatelům klávesnice schopen zaměřit nebo aktivovat tyto odkazy. Chcete-li být v bezpečí, použijte k deaktivaci takových odkazů vlastní JavaScript.<button>
<fieldset disabled>
<a ... class="btn btn-*">
pointer-events: none
Kompatibilita mezi prohlížeči
Zatímco Bootstrap použije tyto styly ve všech prohlížečích, Internet Explorer 11 a nižší nepodporují plně disabled
atribut na <fieldset>
. K deaktivaci sady polí v těchto prohlížečích použijte vlastní JavaScript.
Poskytněte svým uživatelům hodnotnou zpětnou vazbu, která bude užitečná pro akce, pomocí ověření formuláře HTML5 – dostupného ve všech našich podporovaných prohlížečích . Vyberte si z výchozí zpětné vazby pro ověření prohlížeče nebo implementujte vlastní zprávy pomocí našich vestavěných tříd a startovacího JavaScriptu.
V současné době doporučujeme používat vlastní styly ověření, protože výchozí zprávy o ověření nativního prohlížeče nejsou konzistentně vystaveny asistenčním technologiím ve všech prohlížečích (zejména Chrome na stolních počítačích a mobilních zařízeních).
Takto funguje ověření formuláře s Bootstrap:
- Ověření formuláře HTML se používá pomocí dvou pseudotříd CSS
:invalid
a:valid
. Platí pro prvky<input>
,<select>
, a<textarea>
. - Bootstrap rozsahy stylů
:invalid
a:valid
na nadřazenou.was-validated
třídu, obvykle aplikované na<form>
. V opačném případě se jakékoli povinné pole bez hodnoty při načtení stránky zobrazí jako neplatné. Tímto způsobem si můžete vybrat, kdy je chcete aktivovat (obvykle po pokusu o odeslání formuláře). - Chcete-li obnovit vzhled formuláře (například v případě dynamického odesílání formuláře pomocí AJAX), odeberte
.was-validated
třídu z pole<form>
po odeslání znovu. - Jako záložní možnost lze pro ověření na straně serveru použít namísto pseudotříd třídy
.is-invalid
a . Nevyžadují rodičovskou třídu..is-valid
.was-validated
- Kvůli omezením v tom, jak CSS funguje, nemůžeme (v současnosti) použít styly na
<label>
prvek, který je před ovládacím prvkem formuláře v DOM bez pomoci vlastního JavaScriptu. - Všechny moderní prohlížeče podporují rozhraní API pro ověřování omezení , což je řada metod JavaScriptu pro ověřování ovládacích prvků formuláře.
- Zprávy zpětné vazby mohou využívat výchozí nastavení prohlížeče (různé pro každý prohlížeč a nestylovatelné pomocí CSS) nebo naše vlastní styly zpětné vazby s dalšími HTML a CSS.
setCustomValidity
V JavaScriptu můžete poskytovat vlastní zprávy o platnosti .
S ohledem na to zvažte následující ukázky našich vlastních stylů ověřování formulářů, volitelných tříd na straně serveru a výchozích nastavení prohlížeče.
Pro vlastní zprávy o ověření formuláře Bootstrap budete muset přidat novalidate
atribut boolean do souboru <form>
. To deaktivuje výchozí popisky zpětné vazby prohlížeče, ale stále poskytuje přístup k rozhraní API pro ověřování formulářů v JavaScriptu. Zkuste odeslat formulář níže; náš JavaScript zachytí tlačítko Odeslat a předá vám zpětnou vazbu.
Při pokusu o odeslání uvidíte styly :invalid
a :valid
použité na ovládací prvky formuláře.
<form class="needs-validation" novalidate>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationCustom01">First name</label>
<input type="text" class="form-control" id="validationCustom01" placeholder="First name" value="Mark" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationCustom02">Last name</label>
<input type="text" class="form-control" id="validationCustom02" placeholder="Last name" value="Otto" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationCustomUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend">@</span>
</div>
<input type="text" class="form-control" id="validationCustomUsername" placeholder="Username" aria-describedby="inputGroupPrepend" required>
<div class="invalid-feedback">
Please choose a username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationCustom03">City</label>
<input type="text" class="form-control" id="validationCustom03" placeholder="City" required>
<div class="invalid-feedback">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationCustom04">State</label>
<input type="text" class="form-control" id="validationCustom04" placeholder="State" required>
<div class="invalid-feedback">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationCustom05">Zip</label>
<input type="text" class="form-control" id="validationCustom05" placeholder="Zip" required>
<div class="invalid-feedback">
Please provide a valid zip.
</div>
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="invalidCheck" required>
<label class="form-check-label" for="invalidCheck">
Agree to terms and conditions
</label>
<div class="invalid-feedback">
You must agree before submitting.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
<script>
// Example starter JavaScript for disabling form submissions if there are invalid fields
(function() {
'use strict';
window.addEventListener('load', function() {
// Fetch all the forms we want to apply custom Bootstrap validation styles to
var forms = document.getElementsByClassName('needs-validation');
// Loop over them and prevent submission
var validation = Array.prototype.filter.call(forms, function(form) {
form.addEventListener('submit', function(event) {
if (form.checkValidity() === false) {
event.preventDefault();
event.stopPropagation();
}
form.classList.add('was-validated');
}, false);
});
}, false);
})();
</script>
Nezajímají vás zprávy se zpětnou vazbou pro vlastní ověření nebo psaní JavaScriptu pro změnu chování formuláře? Vše v pořádku, můžete použít výchozí nastavení prohlížeče. Zkuste odeslat formulář níže. V závislosti na vašem prohlížeči a operačním systému uvidíte trochu jiný styl zpětné vazby.
I když tyto styly zpětné vazby nelze upravovat pomocí CSS, stále můžete upravit text zpětné vazby pomocí JavaScriptu.
<form>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationDefault01">First name</label>
<input type="text" class="form-control" id="validationDefault01" placeholder="First name" value="Mark" required>
</div>
<div class="col-md-4 mb-3">
<label for="validationDefault02">Last name</label>
<input type="text" class="form-control" id="validationDefault02" placeholder="Last name" value="Otto" required>
</div>
<div class="col-md-4 mb-3">
<label for="validationDefaultUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend2">@</span>
</div>
<input type="text" class="form-control" id="validationDefaultUsername" placeholder="Username" aria-describedby="inputGroupPrepend2" required>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationDefault03">City</label>
<input type="text" class="form-control" id="validationDefault03" placeholder="City" required>
</div>
<div class="col-md-3 mb-3">
<label for="validationDefault04">State</label>
<input type="text" class="form-control" id="validationDefault04" placeholder="State" required>
</div>
<div class="col-md-3 mb-3">
<label for="validationDefault05">Zip</label>
<input type="text" class="form-control" id="validationDefault05" placeholder="Zip" required>
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="invalidCheck2" required>
<label class="form-check-label" for="invalidCheck2">
Agree to terms and conditions
</label>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Doporučujeme použít ověření na straně klienta, ale v případě, že požadujete stranu serveru, můžete označit neplatná a platná pole formuláře pomocí .is-invalid
a .is-valid
. Všimněte si, že .invalid-feedback
je to také podporováno těmito třídami.
<form>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationServer01">First name</label>
<input type="text" class="form-control is-valid" id="validationServer01" placeholder="First name" value="Mark" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationServer02">Last name</label>
<input type="text" class="form-control is-valid" id="validationServer02" placeholder="Last name" value="Otto" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationServerUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend3">@</span>
</div>
<input type="text" class="form-control is-invalid" id="validationServerUsername" placeholder="Username" aria-describedby="inputGroupPrepend3" required>
<div class="invalid-feedback">
Please choose a username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationServer03">City</label>
<input type="text" class="form-control is-invalid" id="validationServer03" placeholder="City" required>
<div class="invalid-feedback">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationServer04">State</label>
<input type="text" class="form-control is-invalid" id="validationServer04" placeholder="State" required>
<div class="invalid-feedback">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationServer05">Zip</label>
<input type="text" class="form-control is-invalid" id="validationServer05" placeholder="Zip" required>
<div class="invalid-feedback">
Please provide a valid zip.
</div>
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input is-invalid" type="checkbox" value="" id="invalidCheck3" required>
<label class="form-check-label" for="invalidCheck3">
Agree to terms and conditions
</label>
<div class="invalid-feedback">
You must agree before submitting.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Naše vzorové formuláře zobrazují nativní textové <input>
výše uvedené, ale styly ověřování formulářů jsou k dispozici i pro naše vlastní ovládací prvky formulářů.
<form class="was-validated">
<div class="custom-control custom-checkbox mb-3">
<input type="checkbox" class="custom-control-input" id="customControlValidation1" required>
<label class="custom-control-label" for="customControlValidation1">Check this custom checkbox</label>
<div class="invalid-feedback">Example invalid feedback text</div>
</div>
<div class="custom-control custom-radio">
<input type="radio" class="custom-control-input" id="customControlValidation2" name="radio-stacked" required>
<label class="custom-control-label" for="customControlValidation2">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio mb-3">
<input type="radio" class="custom-control-input" id="customControlValidation3" name="radio-stacked" required>
<label class="custom-control-label" for="customControlValidation3">Or toggle this other custom radio</label>
<div class="invalid-feedback">More example invalid feedback text</div>
</div>
<div class="form-group">
<select class="custom-select" required>
<option value="">Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<div class="invalid-feedback">Example invalid custom select feedback</div>
</div>
<div class="custom-file">
<input type="file" class="custom-file-input" id="validatedCustomFile" required>
<label class="custom-file-label" for="validatedCustomFile">Choose file...</label>
<div class="invalid-feedback">Example invalid custom file feedback</div>
</div>
</form>
Pokud to vaše rozvržení formuláře umožňuje, můžete zaměnit .{valid|invalid}-feedback
třídy za .{valid|invalid}-tooltip
třídy a zobrazit zpětnou vazbu k ověření ve stylizovaném popisku. Ujistěte se, že máte nadřazený position: relative
prvek pro umístění popisku. V níže uvedeném příkladu to naše třídy sloupců již mají, ale váš projekt může vyžadovat alternativní nastavení.
<form class="needs-validation" novalidate>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationTooltip01">First name</label>
<input type="text" class="form-control" id="validationTooltip01" placeholder="First name" value="Mark" required>
<div class="valid-tooltip">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationTooltip02">Last name</label>
<input type="text" class="form-control" id="validationTooltip02" placeholder="Last name" value="Otto" required>
<div class="valid-tooltip">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationTooltipUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="validationTooltipUsernamePrepend">@</span>
</div>
<input type="text" class="form-control" id="validationTooltipUsername" placeholder="Username" aria-describedby="validationTooltipUsernamePrepend" required>
<div class="invalid-tooltip">
Please choose a unique and valid username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationTooltip03">City</label>
<input type="text" class="form-control" id="validationTooltip03" placeholder="City" required>
<div class="invalid-tooltip">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationTooltip04">State</label>
<input type="text" class="form-control" id="validationTooltip04" placeholder="State" required>
<div class="invalid-tooltip">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationTooltip05">Zip</label>
<input type="text" class="form-control" id="validationTooltip05" placeholder="Zip" required>
<div class="invalid-tooltip">
Please provide a valid zip.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Pro ještě větší přizpůsobení a konzistenci napříč prohlížeči použijte naše zcela vlastní prvky formuláře, které nahradí výchozí nastavení prohlížeče. Jsou postaveny na sémantickém a přístupném označení, takže jsou solidní náhradou za jakýkoli výchozí ovládací prvek formuláře.
Each checkbox and radio is wrapped in a <div>
with a sibling <span>
to create our custom control and a <label>
for the accompanying text. Structurally, this is the same approach as our default .form-check
.
We use the sibling selector (~
) for all our <input>
states—like :checked
—to properly style our custom form indicator. When combined with the .custom-control-label
class, we can also style the text for each item based on the <input>
’s state.
We hide the default <input>
with opacity
and use the .custom-control-label
to build a new custom form indicator in its place with ::before
and ::after
. Unfortunately we can’t build a custom one from just the <input>
because CSS’s content
doesn’t work on that element.
In the checked states, we use base64 embedded SVG icons from Open Iconic. This provides us the best control for styling and positioning across browsers and devices.
<div class="custom-control custom-checkbox">
<input type="checkbox" class="custom-control-input" id="customCheck1">
<label class="custom-control-label" for="customCheck1">Check this custom checkbox</label>
</div>
Custom checkboxes can also utilize the :indeterminate
pseudo class when manually set via JavaScript (there is no available HTML attribute for specifying it).
If you’re using jQuery, something like this should suffice:
$('.your-checkbox').prop('indeterminate', true)
<div class="custom-control custom-radio">
<input type="radio" id="customRadio1" name="customRadio" class="custom-control-input">
<label class="custom-control-label" for="customRadio1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio">
<input type="radio" id="customRadio2" name="customRadio" class="custom-control-input">
<label class="custom-control-label" for="customRadio2">Or toggle this other custom radio</label>
</div>
<div class="custom-control custom-radio custom-control-inline">
<input type="radio" id="customRadioInline1" name="customRadioInline1" class="custom-control-input">
<label class="custom-control-label" for="customRadioInline1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio custom-control-inline">
<input type="radio" id="customRadioInline2" name="customRadioInline1" class="custom-control-input">
<label class="custom-control-label" for="customRadioInline2">Or toggle this other custom radio</label>
</div>
Custom checkboxes and radios can also be disabled. Add the disabled
boolean attribute to the <input>
and the custom indicator and label description will be automatically styled.
<div class="custom-control custom-checkbox">
<input type="checkbox" class="custom-control-input" id="customCheckDisabled" disabled>
<label class="custom-control-label" for="customCheckDisabled">Check this custom checkbox</label>
</div>
<div class="custom-control custom-radio">
<input type="radio" id="radio3" name="radioDisabled" id="customRadioDisabled" class="custom-control-input" disabled>
<label class="custom-control-label" for="customRadioDisabled">Toggle this custom radio</label>
</div>
Custom <select>
menus need only a custom class, .custom-select
to trigger the custom styles. Custom styles are limited to the <select>
’s initial appearance and cannot modify the <option>
s due to browser limitations.
<select class="custom-select">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
You may also choose from small and large custom selects to match our similarly sized text inputs.
<select class="custom-select custom-select-lg mb-3">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<select class="custom-select custom-select-sm">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
The multiple
attribute is also supported:
<select class="custom-select" multiple>
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
As is the size
attribute:
<select class="custom-select" size="3">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
Create custom <input type="range">
controls with .custom-range
. The track (the background) and thumb (the value) are both styled to appear the same across browsers. As only IE and Firefox support “filling” their track from the left or right of the thumb as a means to visually indicate progress, we do not currently support it.
<label for="customRange1">Example range</label>
<input type="range" class="custom-range" id="customRange1">
Range inputs have implicit values for min
and max
—0
and 100
, respectively. You may specify new values for those using the min
and max
attributes.
<label for="customRange2">Example range</label>
<input type="range" class="custom-range" min="0" max="5" id="customRange2">
By default, range inputs “snap” to integer values. To change this, you can specify a step
value. In the example below, we double the number of steps by using step="0.5"
.
<label for="customRange3">Example range</label>
<input type="range" class="custom-range" min="0" max="5" step="0.5" id="customRange3">
The file input is the most gnarly of the bunch and requires additional JavaScript if you’d like to hook them up with functional Choose file… and selected file name text.
<div class="custom-file">
<input type="file" class="custom-file-input" id="customFile">
<label class="custom-file-label" for="customFile">Choose file</label>
</div>
We hide the default file <input>
via opacity
and instead style the <label>
. The button is generated and positioned with ::after
. Lastly, we declare a width
and height
on the <input>
for proper spacing for surrounding content.
The :lang()
pseudo-class is used to allow for translation of the “Browse” text into other languages. Override or add entries to the $custom-file-text
Sass variable with the relevant language tag and localized strings. The English strings can be customized the same way. For example, here’s how one might add a Spanish translation (Spanish’s language code is es
):
$custom-file-text: (
en: "Browse",
es: "Elegir"
);
Here’s lang(es)
in action on the custom file input for a Spanish translation:
<div class="custom-file">
<input type="file" class="custom-file-input" id="customFileLang" lang="es">
<label class="custom-file-label" for="customFileLang">Seleccionar Archivo</label>
</div>
Aby se zobrazil správný text, musíte správně nastavit jazyk dokumentu (nebo jeho podstromu). To lze provést mimo jiné pomocí atributu nalang
prvku <html>
nebo Content-Language
hlavičky HTTP .