Source

Obrasci

Primjeri i smjernice za korištenje stilova kontrole obrazaca, opcija izgleda i prilagođenih komponenti za stvaranje širokog spektra obrazaca.

Pregled

Bootstrapove kontrole obrazaca proširuju naše Rebooted stilove obrazaca s klasama. Upotrijebite ove klase da biste se uključili u njihove prilagođene prikaze za dosljednije prikazivanje na svim preglednicima i uređajima.

Obavezno upotrijebite odgovarajući typeatribut na svim unosima (npr. emailza adresu e-pošte ili numberza numeričke informacije) kako biste iskoristili prednosti novijih kontrola unosa kao što su potvrda e-pošte, odabir broja i više.

Evo kratkog primjera za demonstraciju stilova obrasca Bootstrapa. Nastavite čitati za dokumentaciju o potrebnim razredima, izgledu obrazaca i više.

Nikada nećemo dijeliti vašu e-poštu ni s kim drugim.
<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-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>

Kontrole obrazaca

Kontrole tekstualnog obrasca - poput <input>s, <select>s i <textarea>s - stiliziraju se s .form-controlklasom. Uključeni su stilovi za opći izgled, stanje fokusa, veličinu i još mnogo toga.

Obavezno istražite naše prilagođene obrasce za daljnji stil <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>

Za unos datoteka zamijenite .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>

Dimenzioniranje

Postavite visine koristeći klase poput .form-control-lgi .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>

Samo za čitanje

Dodajte readonlybooleov atribut na unos kako biste spriječili promjenu vrijednosti unosa. Unosi samo za čitanje izgledaju svjetlije (baš kao i onemogućeni ulazi), ali zadržavaju standardni kursor.

<input class="form-control" type="text" placeholder="Readonly input here…" readonly>

Običan tekst samo za čitanje

Ako želite da <input readonly>elementi u vašem obrascu budu oblikovani kao običan tekst, upotrijebite .form-control-plaintextklasu za uklanjanje zadanog stila polja obrasca i očuvanje ispravne margine i ispune.

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

Polje za potvrdu i radio

Zadani potvrdni okviri i radio stanice poboljšani su uz pomoć .form-checkjedne klase za obje vrste unosa koja poboljšava izgled i ponašanje njihovih HTML elemenata . Potvrdni okviri služe za odabir jedne ili više opcija na popisu, dok radiji služe za odabir jedne opcije od više njih.

Onemogućeni potvrdni okviri i radio su podržani, ali da biste osigurali not-allowedkursor pri lebdenju iznad nadređenog <label>, morat ćete dodati disabledatribut u .form-check-input. Onemogućeni atribut će primijeniti svjetliju boju kako bi lakše označio stanje unosa.

Potvrdni okviri i korištenje radija izgrađeni su da podržavaju provjeru valjanosti obrazaca temeljenu na HTML-u i pružaju sažete, dostupne oznake. Kao takvi, naši <input>s i <label>s su srodni elementi za razliku od <input>unutar a <label>. Ovo je nešto opširnije jer morate navesti atribute idi forza povezivanje <input>i <label>.

Zadano (složeno)

Prema zadanim postavkama, bilo koji broj potvrdnih okvira i radija koji su neposredni srodnici bit će okomito naslagani i odgovarajuće razmaknuti s .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 disabled">
  <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>

U redu

Grupirajte potvrdne okvire ili radio u istom vodoravnom retku dodavanjem .form-check-inlinebilo kojem .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 etiketa

Dodajte .position-staticunosima unutar .form-checkkoji nemaju tekst oznake. Ne zaboravite i dalje osigurati neki oblik oznake za pomoćne tehnologije (na primjer, korištenje 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>

Izgled

Budući da se Bootstrap primjenjuje display: blockna width: 100%gotovo sve naše kontrole obrazaca, obrasci će se prema zadanim postavkama slagati okomito. Dodatne klase mogu se koristiti za mijenjanje ovog izgleda na temelju obrasca.

Formirajte grupe

Klasa .form-groupje najlakši način za dodavanje strukture obrascima. Pruža fleksibilnu klasu koja potiče pravilno grupiranje oznaka, kontrola, izbornog teksta pomoći i poruka za potvrdu valjanosti obrazaca. Prema zadanim postavkama primjenjuje se samo , ali po potrebi margin-bottompreuzima dodatne stilove . .form-inlineKoristite ga sa <fieldset>s, <div>s ili gotovo bilo kojim drugim elementom.

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

Mreža oblika

Složenije forme mogu se izgraditi korištenjem naših mrežnih klasa. Koristite ih za rasporede obrazaca koji zahtijevaju više stupaca, različite širine i dodatne mogućnosti poravnanja.

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

Formirajte red

Također možete zamijeniti .rowza .form-row, varijantu našeg standardnog retka rešetke koji nadjačava zadane oluke stupaca za čvršće i kompaktnije rasporede.

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

Složeniji izgledi također se mogu stvoriti pomoću sustava rešetki.

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

Horizontalni oblik

Stvorite vodoravne forme s mrežom dodavanjem .rowklase u grupe obrazaca i korištenjem .col-*-*klasa za određivanje širine vaših oznaka i kontrola. Obavezno dodajte .col-form-labeli svojim <label>s tako da budu okomito centrirani s pripadajućim kontrolama obrasca.

Ponekad ćete možda trebati koristiti pomoćne programe za margine ili podstave kako biste stvorili ono savršeno poravnanje koje vam je potrebno. Na primjer, uklonili smo padding-topoznaku s naslaganih radijskih ulaza kako bismo bolje poravnali osnovnu liniju teksta.

Radio aparati
Potvrdni okvir
<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>
Određivanje veličine naljepnice vodoravnog oblika

Obavezno koristite .col-form-label-smili .col-form-label-lgza svoje <label>s ili <legend>s kako biste točno pratili veličinu .form-control-lgi .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>

Dimenzioniranje stupaca

Kao što je prikazano u prethodnim primjerima, naš mrežni sustav omogućuje vam postavljanje bilo kojeg broja .cols unutar .rowili .form-row. Oni će ravnomjerno podijeliti dostupnu širinu. Također možete odabrati podskup svojih stupaca koji će zauzeti više ili manje prostora, dok preostali .colpodjednako dijele ostatak, s određenim klasama stupaca poput .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>

Automatsko određivanje veličine

Primjer u nastavku koristi uslužni program flexbox za okomito centriranje sadržaja i promjene tako .colda .col-autovaši stupci zauzimaju onoliko prostora koliko je potrebno. Drugim riječima, veličina stupca ovisi o sadržaju.

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

Zatim to možete ponovno pomiješati s klasama stupaca specifičnih za veličinu.

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

I naravno, prilagođene kontrole obrazaca su podržane.

<form>
  <div class="form-row align-items-center">
    <div class="col-auto my-1">
      <label class="mr-sm-2" 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 obrasci

Koristite .form-inlineklasu za prikaz niza oznaka, kontrola obrazaca i gumba u jednom horizontalnom retku. Kontrole obrazaca unutar ugrađenih obrazaca malo se razlikuju od svojih zadanih stanja.

  • Kontrole su display: flex, sažimaju bilo koji HTML bijeli prostor i omogućuju vam da omogućite kontrolu poravnanja pomoću pomoćnih programa za razmak i flexbox .
  • Kontrole i ulazne grupe dobivaju width: autoza nadjačavanje zadane Bootstrap width: 100%.
  • Kontrole se pojavljuju u liniji samo u okvirima za prikaz koji su široki najmanje 576 piksela kako bi se uzeli u obzir uski okviri za prikaz na mobilnim uređajima.

Možda ćete morati ručno riješiti širinu i poravnanje pojedinačnih kontrola obrasca pomoću uslužnih programa za razmake (kao što je prikazano u nastavku). Na kraju, svakako uključite <label>uz svaku kontrolu obrasca, čak i ako je trebate sakriti od posjetitelja koji ne koriste čitač zaslona pomoću .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>

Podržane su i prilagođene kontrole obrazaca i odabiri.

<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>
Alternative skrivenim oznakama

Pomoćne tehnologije kao što su čitači zaslona imat će problema s vašim obrascima ako ne uključite oznaku za svaki unos. Za ove ugrađene obrasce možete sakriti oznake pomoću .sr-onlyklase. Postoje daljnje alternativne metode davanja oznake za pomoćne tehnologije, kao što je aria-labelatribut ili aria-labelledby. titleAko ništa od toga nije prisutno, pomoćne tehnologije mogu pribjeći korištenju placeholderatributa, ako je prisutan, ali imajte na umu da placeholderse ne preporučuje korištenje kao zamjena za druge metode označavanja.

Tekst pomoći

Tekst pomoći na razini bloka u obrascima može se stvoriti pomoću .form-text(ranije poznatog kao .help-blocku v3). Umetnuti tekst pomoći može se fleksibilno implementirati korištenjem bilo kojeg umetnutog HTML elementa i uslužnih klasa kao što je .text-muted.

Povezivanje teksta pomoći s kontrolama obrasca

Tekst pomoći treba biti eksplicitno povezan s kontrolom obrasca na koju se odnosi pomoću aria-describedbyatributa. To će osigurati da će pomoćne tehnologije—kao što su čitači zaslona—najaviti ovaj tekst pomoći kada se korisnik fokusira ili uđe u kontrolu.

Tekst pomoći ispod unosa može se stilizirati s .form-text. Ova klasa uključuje display: blocki dodaje neku gornju marginu za jednostavno odvajanje od gornjih unosa.

Vaša lozinka mora imati 8-20 znakova, sadržavati slova i brojke i ne smije sadržavati razmake, posebne znakove ili emojije.
<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>

Umetnuti tekst može koristiti bilo koji tipični umetnuti HTML element (bilo to <small>, <span>, ili nešto drugo) s ništa više od klase korisnosti.

Mora imati 8-20 znakova.
<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>

Onesposobljeni oblici

Dodajte disabledbooleov atribut na unos kako biste spriječili interakcije korisnika i učinili da izgleda svjetlije.

<input class="form-control" id="disabledInput" type="text" placeholder="Disabled input here..." disabled>

Dodajte disabledatribut u <fieldset>da biste onemogućili sve unutarnje kontrole.

<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>
Upozorenje sa sidrima

Prema zadanim postavkama, preglednici će tretirati sve izvorne kontrole obrasca ( <input>, <select>i <button>elemente) unutar <fieldset disabled>kao onemogućene, sprječavajući interakcije tipkovnice i miša na njima. Međutim, ako vaš obrazac također uključuje <a ... class="btn btn-*">elemente, oni će dobiti samo stil pointer-events: none. Kao što je navedeno u odjeljku o onemogućenom stanju za gumbe (i posebno u pododjeljku za elemente sidra), ovo CSS svojstvo još nije standardizirano i nije u potpunosti podržano u Operi 18 i nižim, ili u Internet Exploreru 10, i pobijedilo je Ne sprječava korisnike tipkovnice da se mogu fokusirati ili aktivirati ove veze. Da biste bili sigurni, upotrijebite prilagođeni JavaScript da onemogućite takve veze.

Kompatibilnost s različitim preglednicima

Iako će Bootstrap primijeniti ove stilove u svim preglednicima, Internet Explorer 11 i niže verzije ne podržavaju u potpunosti disabledatribut na <fieldset>. Koristite prilagođeni JavaScript da onemogućite skup polja u ovim preglednicima.

Validacija

Pružite vrijedne, djelotvorne povratne informacije svojim korisnicima pomoću HTML5 provjere valjanosti obrasca– dostupne u svim našim podržanim preglednicima . Odaberite iz zadane povratne informacije o provjeri valjanosti preglednika ili implementirajte prilagođene poruke s našim ugrađenim klasama i početnim JavaScriptom.

Toplo preporučujemo prilagođene stilove provjere budući da se zadane izvorne postavke preglednika ne objavljuju čitačima zaslona.

Kako radi

Evo kako provjera valjanosti obrazaca radi s Bootstrapom:

  • Validacija HTML obrasca primjenjuje se putem CSS-ovih dviju pseudo-klasa :invalidi :valid. Primjenjuje se na <input>, <select>, i <textarea>elemente.
  • Bootstrap raspoređuje :invalidi :validstilove na roditeljsku .was-validatedklasu, obično primijenjenu na <form>. U suprotnom, svako obavezno polje bez vrijednosti prikazuje se kao nevažeće pri učitavanju stranice. Na taj način možete odabrati kada ćete ih aktivirati (obično nakon što se pokuša predati obrazac).
  • Kao zamjena, .is-invalidi .is-validklase se mogu koristiti umjesto pseudo-klasa za provjeru valjanosti na strani poslužitelja . Ne zahtijevaju .was-validatednadređenu klasu.
  • Zbog ograničenja u načinu na koji CSS funkcionira, ne možemo (trenutačno) primijeniti stilove na <label>koji dolazi prije kontrole obrasca u DOM-u bez pomoći prilagođenog JavaScripta.
  • Svi moderni preglednici podržavaju API za provjeru valjanosti ograničenja , niz JavaScript metoda za provjeru valjanosti kontrola obrazaca.
  • Poruke s povratnim informacijama mogu koristiti zadane postavke preglednika (različite za svaki preglednik i ne mogu se oblikovati putem CSS-a) ili naše prilagođene stilove povratnih informacija s dodatnim HTML-om i CSS-om.
  • Možete dati prilagođene poruke valjanosti setCustomValidityu JavaScriptu.

Imajući to na umu, razmotrite sljedeće demonstracije za naše prilagođene stilove provjere valjanosti obrasca, opcijske klase na strani poslužitelja i zadane postavke preglednika.

Prilagođeni stilovi

Za prilagođene poruke provjere valjanosti Bootstrap obrasca, morat ćete dodati novalidateBoolean atribut u svoj <form>. Ovo onemogućuje zadane opise alata preglednika za povratne informacije, ali i dalje omogućuje pristup API-jima za provjeru valjanosti obrasca u JavaScriptu. Pokušajte poslati obrazac ispod; naš JavaScript će presresti gumb za slanje i prenijeti vam povratne informacije.

Kada pokušate poslati, vidjet ćete stilove :invalidi :validkoji se primjenjuju na vaše kontrole obrasca.

Looks good!
Looks good!
@
Please choose a username.
Please provide a valid city.
Please provide a valid state.
Please provide a valid zip.
You must agree before submitting.
<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>

Zadane postavke preglednika

Niste zainteresirani za prilagođene povratne poruke za provjeru valjanosti ili pisanje JavaScripta za promjenu ponašanja obrazaca? Sve je u redu, možete koristiti zadane postavke preglednika. Pokušajte poslati obrazac ispod. Ovisno o vašem pregledniku i OS-u, vidjet ćete nešto drugačiji stil povratnih informacija.

Iako se ovi stilovi povratnih informacija ne mogu oblikovati pomoću CSS-a, ipak možete prilagoditi tekst povratnih informacija putem JavaScripta.

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

Strana poslužitelja

Preporučujemo korištenje provjere valjanosti na strani klijenta, ali u slučaju da vam je potrebna strana poslužitelja, možete označiti nevažeća i važeća polja obrasca pomoću .is-invalidi .is-valid. Imajte na umu da .invalid-feedbackje također podržan s ovim klasama.

Izgleda dobro!
Izgleda dobro!
@
Odaberite korisničko ime.
Navedite važeći grad.
Navedite važeće stanje.
Unesite važeći poštanski broj.
Morate se složiti prije slanja.
<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>

Podržani elementi

Naši primjeri obrazaca prikazuju izvorne tekstualne <input>elemente iznad, ali stilovi provjere valjanosti obrazaca dostupni su i za naše prilagođene kontrole obrazaca.

Primjer nevažećeg teksta povratne informacije
Više primjera nevažećeg teksta povratne informacije
Primjer nevažeće povratne informacije o prilagođenom odabiru
Primjer nevažeće povratne informacije o prilagođenoj datoteci
<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>

Opisi alata

Ako izgled vašeg obrasca to dopušta, možete zamijeniti .{valid|invalid}-feedbackklase .{valid|invalid}-tooltipklasama za prikaz povratne informacije o provjeri valjanosti u stiliziranom opisu alata. Obavezno imajte roditelja s position: relativenjim za pozicioniranje opisa alata. U donjem primjeru, naše klase stupaca to već imaju, ali vaš projekt može zahtijevati alternativno postavljanje.

Looks good!
Looks good!
@
Please choose a unique and valid username.
Please provide a valid city.
Please provide a valid state.
Please provide a valid zip.
<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>

Prilagođeni obrasci

Za još veću prilagodbu i dosljednost među preglednicima, upotrijebite naše potpuno prilagođene elemente obrasca za zamjenu zadanih postavki preglednika. Izgrađeni su na semantičkom i pristupačnom označavanju, pa su solidna zamjena za bilo koju zadanu kontrolu obrasca.

Polje za potvrdu i radio

Svaki potvrdni okvir i radio zamotan je u <div>s bratom ili sestrom <span>kako bismo stvorili našu prilagođenu kontrolu i a <label>za popratni tekst. Strukturno, ovo je isti pristup kao naš zadani .form-check.

Koristimo istorodni selektor ( ~) za sva naša <input>stanja—kao što je— :checkedkako bismo ispravno stilizirali naš prilagođeni indikator obrasca. U kombinaciji s .custom-control-labelklasom, također možemo stilizirati tekst za svaku stavku na temelju stanja <input>'s.

Sakrivamo zadanu postavku <input>pomoću opacityi koristimo .custom-control-labelza izgradnju novog prilagođenog indikatora obrasca na njenom mjestu pomoću ::beforei ::after. Nažalost, ne možemo izraditi prilagođeni samo od <input>jer CSS contentne radi na tom elementu.

U označenim stanjima koristimo base64 ugrađene SVG ikone iz Open Iconica . To nam omogućuje najbolju kontrolu za stiliziranje i pozicioniranje u preglednicima i uređajima.

Potvrdni okviri

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

Prilagođeni potvrdni okviri također mogu koristiti :indeterminatepseudo klasu kada se ručno postavljaju putem JavaScripta (ne postoji dostupan HTML atribut za njegovo određivanje).

Ako koristite jQuery, nešto poput ovoga trebalo bi biti dovoljno:

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

Radio aparati

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

U redu

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

Onemogućeno

Prilagođeni potvrdni okviri i radio također se mogu onemogućiti. Dodajte disabledbooleov atribut <input>i prilagođeni indikator i opis oznake bit će automatski oblikovani.

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

Odaberite izbornik

Prilagođeni <select>izbornici trebaju samo prilagođenu klasu .custom-selectza pokretanje prilagođenih stilova.

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

Također možete birati između malih i velikih prilagođenih odabira koji odgovaraju našim unosima teksta slične veličine.

<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 također podržan:

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

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

Preglednik datoteka

Datotečni unos je najkvrgaviji u nizu i zahtijeva dodatni JavaScript ako ih želite spojiti s funkcionalnim Odaberi datoteku… i odabranim tekstom naziva datoteke.

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

Sakrivamo zadanu datoteku <input>putem opacityi umjesto toga stiliziramo <label>. Gumb se generira i postavlja s ::after. Na kraju, izjavljujemo widthi heightna <input>za pravilan razmak za okolni sadržaj.

Prevođenje ili prilagodba nizova

Pseudoklasa :lang()se koristi za omogućavanje prijevoda teksta "Pregledaj" na druge jezike. Zaobiđite ili dodajte unose u $custom-file-textSass varijablu s relevantnom jezičnom oznakom i lokaliziranim nizovima. Engleske žice mogu se prilagoditi na isti način. Na primjer, evo kako se može dodati španjolski prijevod (kod španjolskog jezika je es):

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

Evo lang(es)na djelu prilagođenog unosa datoteke za španjolski prijevod:

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

Morat ćete ispravno postaviti jezik svog dokumenta (ili njegovog podstabla) kako bi se prikazao točan tekst. To se između ostalih metoda može učiniti pomoću atributalang na <html>elementu ili Content-LanguageHTTP zaglavlja .