in English

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ářů.

Přehled

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ý typeatribut u všech vstupů (např. emailpro e-mailovou adresu nebo numberpro čí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.

Nikdy nebudeme sdílet váš e-mail s nikým jiným.
<form>
  <div class="form-group">
    <label for="exampleInputEmail1">Email address</label>
    <input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp">
    <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">
  </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 formuláře

Ovládací prvky textového formuláře – jako <input>s, <select>s a <textarea>s – jsou stylizovány podle .form-controltří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-controlza .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>

Dimenzování

Nastavte výšky pomocí tříd jako .form-control-lga .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>

Pouze ke čtení

Přidejte readonlyna 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>

Čistý text pouze pro čtení

Pokud chcete mít <input readonly>prvky ve formuláři stylizované jako prostý text, použijte tuto .form-control-plaintexttří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">
    </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>

Rozsah vstupů

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>

Zaškrtávací políčka a rádia

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 deaktivovaná zaškrtávací políčka a rádia. Atribut disabledpoužije světlejší barvu, která pomůže indikovat stav vstupu.

Zaškrtávací políčka a přepínače podporují ověřování formulářů založené na HTML a poskytují 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 ida foratributy, aby se vztahovaly <input>a <label>.

Výchozí (skládaný)

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>

V souladu

Seskupte zaškrtávací políčka nebo rádia na stejném vodorovném řádku přidáním .form-check-inlinek 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>

Bez štítků

Přidat .position-staticke vstupům .form-check, které nemají žádný text štítku. Nezapomeňte stále poskytnout nějakou formu přístupného názvu 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>

Rozložení

Protože Bootstrap platí display: blockpro 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ářů.

Vytvořte skupiny

Třída .form-groupje 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-inlinepodle 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 placeholder">
  </div>
  <div class="form-group">
    <label for="formGroupExampleInput2">Another label</label>
    <input type="text" class="form-control" id="formGroupExampleInput2" placeholder="Another input placeholder">
  </div>
</form>

Mřížka formuláře

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>

Řádek formuláře

Můžete také vyměnit .rowza .form-rowvariantu 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">
    </div>
    <div class="form-group col-md-6">
      <label for="inputPassword4">Password</label>
      <input type="password" class="form-control" id="inputPassword4">
    </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>

Horizontální tvar

Vytvořte vodorovné formuláře s mřížkou přidáním .rowtří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-labeldo <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.

Rádia
<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">
    </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">
    </div>
  </div>
  <fieldset class="form-group row">
    <legend class="col-form-label col-sm-2 float-sm-left 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>
  </fieldset>
  <div class="form-group row">
    <div class="col-sm-10 offset-sm-2">
      <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>
Horizontální velikost štítku formuláře

Ujistěte se, že používáte .col-form-label-smnebo .col-form-label-lgna vaše <label>s nebo <legend>s, abyste správně dodrželi velikost .form-control-lga .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>

Dimenzování sloupců

Jak je ukázáno v předchozích příkladech, náš mřížkový systém umožňuje umístit libovolný počet .cols do a .rownebo .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í .cols 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>

Automatické nastavení velikosti

Níže uvedený příklad používá obslužný program flexbox ke svislému vystředění obsahu a změny .coltak .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>

Inline formuláře

Použijte .form-inlinetří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: autok přepsání výchozího nastavení Bootstrap width: 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-onlytřídy. Existují další alternativní způsoby poskytování označení pro asistenční technologie, jako je atribut aria-label, aria-labelledbynebo . titlePokud není přítomen žádný z těchto atributů, mohou se asistenční technologie uchýlit k použití placeholderatributu, pokud je přítomen, ale pamatujte, že použití placeholderjako náhrady za jiné metody označování se nedoporučuje.

Pomocný text

Text nápovědy na úrovni bloku ve formulářích lze vytvořit pomocí .form-text(dříve známé jako .help-blockv3). 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-describedbyatributu. 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: blocka přidává horní okraj pro snadné rozestupy od výše uvedených vstupů.

Vaše heslo musí mít 8–20 znaků, obsahovat písmena a čísla a nesmí obsahovat mezery, speciální znaky ani emotikony.
<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.

Musí mít 8–20 znaků.
<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>

Zakázané formuláře

Přidejte do disabledvstupu 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 disabledatributu do a <fieldset>deaktivujete všechny ovládací prvky.

Příklad deaktivované sady polí
<form>
  <fieldset disabled>
    <legend>Disabled fieldset example</legend>
    <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-group">
      <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>
    </div>
    <button type="submit" class="btn btn-primary">Submit</button>
  </fieldset>
</form>
Upozornění s kotvami

Prohlížeče považují všechny ovládací prvky nativního formuláře ( <input>, <select>, a <button>elementy) uvnitř a <fieldset disabled>za deaktivované, čímž brání interakci s klávesnicí i myší.

Pokud však váš formulář obsahuje také vlastní prvky podobné tlačítkům, jako je <a ... class="btn btn-*">, bude jim přidělen pouze styl pointer-events: none. Jak je uvedeno v části o vypnutém stavu pro tlačítka (a konkrétně v podsekci pro prvky kotvy), tato vlastnost CSS ještě není standardizovaná a není plně podporována v aplikaci Internet Explorer 10. Ovládací prvky založené na kotvě budou také zaostřitelné a ovladatelné pomocí klávesnice. Tyto ovládací prvky musíte ručně upravit přidáním tabindex="-1", abyste jim zabránili ve fokusu a aria-disabled="disabled"signalizovali jejich stav asistenčním technologiím.

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ě disabledatribut na <fieldset>. K deaktivaci sady polí v těchto prohlížečích použijte vlastní JavaScript.

Validace

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.

Jsme si vědomi toho, že v současné době nejsou vlastní styly ověřování a popisky na straně klienta dostupné, protože nejsou vystaveny asistenčním technologiím. Zatímco pracujeme na řešení, doporučujeme použít buď možnost na straně serveru, nebo výchozí metodu ověření prohlížeče.

Jak to funguje

Takto funguje ověření formuláře s Bootstrap:

  • Ověření formuláře HTML se používá pomocí dvou pseudotříd CSS :invalida :valid. Platí pro prvky <input>, <select>, a <textarea>.
  • Bootstrap rozsahy stylů :invalida :validna nadřazenou .was-validatedtří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-validatedtří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-invalida . 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.
  • setCustomValidityV 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.

Vlastní styly

Pro vlastní zprávy o ověření formuláře Bootstrap budete muset přidat novalidateatribut 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 :invalida :validpoužité na ovládací prvky formuláře.

Vlastní styly zpětné vazby používají vlastní barvy, okraje, styly zaměření a ikony pozadí, aby lépe sdělovaly zpětnou vazbu. Ikony na pozadí pro <select>s jsou dostupné pouze s .custom-select, nikoli s .form-control.

Vypadá dobře!
Vypadá dobře!
Zadejte prosím platné město.
Vyberte prosím platný stát.
Zadejte prosím platný zip.
Před odesláním musíte souhlasit.
<form class="needs-validation" novalidate>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationCustom01">First name</label>
      <input type="text" class="form-control" id="validationCustom01" value="Mark" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationCustom02">Last name</label>
      <input type="text" class="form-control" id="validationCustom02" value="Otto" required>
      <div class="valid-feedback">
        Looks good!
      </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" required>
      <div class="invalid-feedback">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationCustom04">State</label>
      <select class="custom-select" id="validationCustom04" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
      <div class="invalid-feedback">
        Please select 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" 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>

Výchozí nastavení prohlížeče

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-6 mb-3">
      <label for="validationDefault01">First name</label>
      <input type="text" class="form-control" id="validationDefault01" value="Mark" required>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationDefault02">Last name</label>
      <input type="text" class="form-control" id="validationDefault02" value="Otto" required>
    </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" required>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationDefault04">State</label>
      <select class="custom-select" id="validationDefault04" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationDefault05">Zip</label>
      <input type="text" class="form-control" id="validationDefault05" 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>

Strana serveru

Doporučujeme používat ověření na straně klienta, ale v případě, že požadujete ověření na straně serveru, můžete označit neplatná a platná pole formuláře pomocí .is-invalida .is-valid. Všimněte si, že .invalid-feedbackje to také podporováno těmito třídami.

U neplatných polí zajistěte, aby byla neplatná zpětná vazba/chybová zpráva přidružena k příslušnému poli formuláře pomocí aria-describedby. Tento atribut umožňuje idodkazovat na více než jeden v případě, že pole již ukazuje na další text formuláře.

Vypadá dobře!
Vypadá dobře!
Zadejte prosím platné město.
Vyberte prosím platný stát.
Zadejte prosím platný zip.
Před odesláním musíte souhlasit.
<form>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationServer01">First name</label>
      <input type="text" class="form-control is-valid" id="validationServer01" value="Mark" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationServer02">Last name</label>
      <input type="text" class="form-control is-valid" id="validationServer02" value="Otto" required>
      <div class="valid-feedback">
        Looks good!
      </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" aria-describedby="validationServer03Feedback" required>
      <div id="validationServer03Feedback" class="invalid-feedback">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationServer04">State</label>
      <select class="custom-select is-invalid" id="validationServer04" aria-describedby="validationServer04Feedback" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
      <div id="validationServer04Feedback" class="invalid-feedback">
        Please select 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" aria-describedby="validationServer05Feedback" required>
      <div id="validationServer05Feedback" 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" aria-describedby="invalidCheck3Feedback" required>
      <label class="form-check-label" for="invalidCheck3">
        Agree to terms and conditions
      </label>
      <div  id="invalidCheck3Feedback" class="invalid-feedback">
        You must agree before submitting.
      </div>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

Podporované prvky

Styly ověření jsou k dispozici pro následující ovládací prvky formuláře a komponenty:

  • <input>s a <textarea>s.form-control
  • <select>s .form-controlnebo.custom-select
  • .form-checks
  • .custom-checkboxs a .custom-radios
  • .custom-file
Zadejte prosím zprávu do textové oblasti.
Příklad neplatného textu zpětné vazby
Další příklad textu neplatné zpětné vazby
Příklad neplatného vlastního výběru zpětné vazby
Příklad neplatné zpětné vazby vlastního souboru
@
Příklad neplatné zpětné vazby vstupní skupiny
Příklad neplatné zpětné vazby vstupní skupiny
Příklad neplatné zpětné vazby vstupní skupiny
<form class="was-validated">
  <div class="mb-3">
    <label for="validationTextarea">Textarea</label>
    <textarea class="form-control is-invalid" id="validationTextarea" placeholder="Required example textarea" required></textarea>
    <div class="invalid-feedback">
      Please enter a message in the textarea.
    </div>
  </div>

  <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="mb-3">
    <select class="custom-select" required>
      <option value="">Choose...</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 mb-3">
    <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>

  <div class="mb-3">
    <div class="input-group is-invalid">
      <div class="input-group-prepend">
        <span class="input-group-text" id="validatedInputGroupPrepend">@</span>
      </div>
      <input type="text" class="form-control is-invalid" aria-describedby="validatedInputGroupPrepend" required>
    </div>
    <div class="invalid-feedback">
      Example invalid input group feedback
    </div>
  </div>

  <div class="mb-3">
    <div class="input-group is-invalid">
      <div class="input-group-prepend">
        <label class="input-group-text" for="validatedInputGroupSelect">Options</label>
      </div>
      <select class="custom-select" id="validatedInputGroupSelect" required>
        <option value="">Choose...</option>
        <option value="1">One</option>
        <option value="2">Two</option>
        <option value="3">Three</option>
      </select>
    </div>
    <div class="invalid-feedback">
      Example invalid input group feedback
    </div>
  </div>

  <div class="input-group is-invalid">
    <div class="custom-file">
      <input type="file" class="custom-file-input" id="validatedInputGroupCustomFile" required>
      <label class="custom-file-label" for="validatedInputGroupCustomFile">Choose file...</label>
    </div>
    <div class="input-group-append">
       <button class="btn btn-outline-secondary" type="button">Button</button>
    </div>
  </div>
  <div class="invalid-feedback">
    Example invalid input group feedback
  </div>
</form>

Popisky

Pokud to vaše rozvržení formuláře umožňuje, můžete zaměnit .{valid|invalid}-feedbacktřídy za .{valid|invalid}-tooltiptřídy a zobrazit zpětnou vazbu k ověření ve stylizovaném popisku. Ujistěte se, že máte nadřazený position: relativeprvek 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í.

Vypadá dobře!
Vypadá dobře!
Zadejte prosím platné město.
Vyberte prosím platný stát.
Zadejte prosím platný zip.
<form class="needs-validation" novalidate>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationTooltip01">First name</label>
      <input type="text" class="form-control" id="validationTooltip01" value="Mark" required>
      <div class="valid-tooltip">
        Looks good!
      </div>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationTooltip02">Last name</label>
      <input type="text" class="form-control" id="validationTooltip02" value="Otto" required>
      <div class="valid-tooltip">
        Looks good!
      </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" required>
      <div class="invalid-tooltip">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationTooltip04">State</label>
      <select class="custom-select" id="validationTooltip04" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
      <div class="invalid-tooltip">
        Please select 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" required>
      <div class="invalid-tooltip">
        Please provide a valid zip.
      </div>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

Přizpůsobení

Stavy ověření lze upravit pomocí Sass s $form-validation-statesmapou. Tato mapa Sass, která se nachází v našem _variables.scsssouboru, je smyčkována, aby se vygenerovaly výchozí stavy valid/ invalidstavy ověření. Součástí je vnořená mapa pro přizpůsobení barvy a ikony každého státu. Prohlížeče sice nepodporují žádné jiné stavy, ale uživatelé používající vlastní styly mohou snadno přidat složitější zpětnou vazbu k formulářům.

Vezměte prosím na vědomí, že nedoporučujeme upravovat tyto hodnoty bez úpravy form-validation-statemixinu.

// Sass map from `_variables.scss`
// Override this and recompile your Sass to generate different states
$form-validation-states: map-merge(
  (
    "valid": (
      "color": $form-feedback-valid-color,
      "icon": $form-feedback-icon-valid
    ),
    "invalid": (
      "color": $form-feedback-invalid-color,
      "icon": $form-feedback-icon-invalid
    )
  ),
  $form-validation-states
);

// Loop from `_forms.scss`
// Any modifications to the above Sass map will be reflected in your compiled
// CSS via this loop.
@each $state, $data in $form-validation-states {
  @include form-validation-state($state, map-get($data, color), map-get($data, icon));
}

Ověření vstupní skupiny

Aby bylo možné zjistit, které prvky potřebují zaoblené rohy uvnitř vstupní skupiny s ověřením, vyžaduje vstupní skupina další .has-validationtřídu.

<div class="input-group has-validation">
  <div class="input-group-prepend">
    <span class="input-group-text">@</span>
  </div>
  <input type="text" class="form-control" required>
  <div class="invalid-feedback">
    Please choose a username.
  </div>
</div>
@
Vyberte prosím uživatelské jméno.

Vlastní formuláře

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.

Zaškrtávací políčka a rádia

Každé zaškrtávací políčko a rádio <input>a <label>párování jsou zabaleny do jednoho <div>, aby vytvořily náš vlastní ovládací prvek. Strukturálně je to stejný přístup jako náš výchozí .form-check.

Volič sourozenců ( ) používáme ~pro všechny naše <input>stavy – například – ke :checkedsprávnému stylu našeho vlastního indikátoru formuláře. V kombinaci s .custom-control-labeltřídou můžeme také stylovat text pro každou položku na základě stavu <input>'s.

Výchozí skryjeme <input>pomocí opacitya použijeme .custom-control-labelk vytvoření nového vlastního indikátoru formuláře na jeho místě pomocí ::beforea ::after. Naneštěstí nemůžeme vytvořit vlastní pouze z toho, <input>protože CSS contentna tomto prvku nefungují.

V zaškrtnutých stavech používáme base64 vložené ikony SVG z Open Iconic . To nám poskytuje nejlepší kontrolu nad stylováním a umístěním napříč prohlížeči a zařízeními.

Zaškrtávací políčka

<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>

Vlastní zaškrtávací políčka mohou také využívat :indeterminatepseudotřídu, když je ručně nastavena pomocí JavaScriptu (není k dispozici žádný atribut HTML pro její specifikaci).

Pokud používáte jQuery, mělo by stačit něco takového:

$('.your-checkbox').prop('indeterminate', true)

Rádia

<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>

V souladu

<div class="custom-control custom-radio custom-control-inline">
  <input type="radio" id="customRadioInline1" name="customRadioInline" 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="customRadioInline" class="custom-control-input">
  <label class="custom-control-label" for="customRadioInline2">Or toggle this other custom radio</label>
</div>

Zakázáno

Vlastní zaškrtávací políčka a rádia lze také deaktivovat. Přidejte disabledbooleovský atribut do <input>a vlastní indikátor a popis štítku budou automaticky upraveny.

<div class="custom-control custom-checkbox">
  <input type="checkbox" class="custom-control-input" id="customCheckDisabled1" disabled>
  <label class="custom-control-label" for="customCheckDisabled1">Check this custom checkbox</label>
</div>

<div class="custom-control custom-radio">
  <input type="radio" name="radioDisabled" id="customRadioDisabled2" class="custom-control-input" disabled>
  <label class="custom-control-label" for="customRadioDisabled2">Toggle this custom radio</label>
</div>

Přepínače

Přepínač má označení vlastního zaškrtávacího políčka, ale používá .custom-switchtřídu k vykreslení přepínače. Přepínače také podporují disabledatribut.

<div class="custom-control custom-switch">
  <input type="checkbox" class="custom-control-input" id="customSwitch1">
  <label class="custom-control-label" for="customSwitch1">Toggle this switch element</label>
</div>
<div class="custom-control custom-switch">
  <input type="checkbox" class="custom-control-input" disabled id="customSwitch2">
  <label class="custom-control-label" for="customSwitch2">Disabled switch element</label>
</div>

Vyberte nabídku

Vlastní <select>nabídky potřebují .custom-selectke spuštění vlastních stylů pouze vlastní třídu. Vlastní styly jsou omezeny na <select>původní vzhled a nemohou upravovat <option>s kvůli omezením prohlížeče.

<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>

Můžete si také vybrat z malých a velkých vlastních výběrů, které odpovídají našim podobně velkým textovým vstupům.

<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>

Atribut multipleje také podporován:

<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>

Stejně jako sizeatribut:

<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>

Rozsah

Vytvořte vlastní <input type="range">ovládací prvky pomocí .custom-range. Stopa (pozadí) a palec (hodnota) jsou stylizovány tak, aby vypadaly ve všech prohlížečích stejně. Protože pouze IE a Firefox podporují „vyplňování“ své stopy zleva nebo zprava od palce jako prostředek k vizuální indikaci pokroku, v současné době to nepodporujeme.

<label for="customRange1">Example range</label>
<input type="range" class="custom-range" id="customRange1">

Vstupy rozsahu mají implicitní hodnoty pro mina max0resp 100. Můžete zadat nové hodnoty pro ty, kteří používají atributy mina .max

<label for="customRange2">Example range</label>
<input type="range" class="custom-range" min="0" max="5" id="customRange2">

Ve výchozím nastavení se vstupy rozsahu „přichytí“ na celočíselné hodnoty. Chcete-li to změnit, můžete zadat stephodnotu. V níže uvedeném příkladu zdvojnásobíme počet kroků pomocí step="0.5".

<label for="customRange3">Example range</label>
<input type="range" class="custom-range" min="0" max="5" step="0.5" id="customRange3">

Prohlížeč souborů

Doporučený plugin pro animaci vlastního vstupu souboru: bs-custom-file-input , to je to, co aktuálně používáme zde v našich dokumentech.

Vstup souboru je nejdrsnější ze všech a vyžaduje další JavaScript, pokud je chcete propojit s funkčním Vybrat soubor… a vybraným textem názvu souboru.

<div class="custom-file">
  <input type="file" class="custom-file-input" id="customFile">
  <label class="custom-file-label" for="customFile">Choose file</label>
</div>

Skryjeme výchozí soubor <input>přes opacitya místo toho stylujeme <label>. Tlačítko je generováno a umístěno s ::after. Nakonec deklarujeme a widtha heightna <input>pro správné mezery pro okolní obsah.

Překlad nebo přizpůsobení řetězců pomocí SCSS

Pseudotřída :lang()se používá k umožnění překladu textu „Procházet“ do jiných jazyků. Přepište nebo přidejte položky do $custom-file-textproměnné Sass pomocí příslušné jazykové značky a lokalizovaných řetězců. Anglické struny lze upravit stejným způsobem. Zde je například uvedeno, jak lze přidat španělský překlad (španělský jazykový kód je es):

$custom-file-text: (
  en: "Browse",
  es: "Elegir"
);

Zde je lang(es)akce na vlastním vstupu souboru pro překlad do španělštiny:

<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-Languagehlavičky HTTP .

Překlad nebo přizpůsobení řetězců pomocí HTML

Bootstrap také poskytuje způsob, jak přeložit text „Procházet“ do HTML pomocí data-browseatributu, který lze přidat do vlastního vstupního štítku (příklad v holandštině):

<div class="custom-file">
  <input type="file" class="custom-file-input" id="customFileLangHTML">
  <label class="custom-file-label" for="customFileLangHTML" data-browse="Bestand kiezen">Voeg je document toe</label>
</div>