in English

Formos

Formų valdymo stilių, išdėstymo parinkčių ir pasirinktinių komponentų, skirtų įvairioms formoms kurti, pavyzdžiai ir naudojimo gairės.

Apžvalga

„Bootstrap“ formų valdikliai išplečia iš naujo paleistų formų stilius su klasėmis. Naudokite šias klases, kad pasirinktumėte tinkintus ekranus, kad naršyklėse ir įrenginiuose būtų nuoseklesnis atvaizdavimas.

Būtinai naudokite atitinkamą typeatributą visoms įvestims (pvz., emailel. pašto adresui arba numberskaitmeninei informacijai), kad galėtumėte pasinaudoti naujesniais įvesties valdikliais, pvz., el. pašto patvirtinimu, numerių pasirinkimu ir kt.

Štai trumpas pavyzdys, kaip parodyti „Bootstrap“ formų stilius. Skaitykite toliau, kad gautumėte dokumentus apie reikalingas klases, formų išdėstymą ir kt.

Mes niekada nebendrinsime jūsų el. pašto su niekuo kitu.
<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>

Formos valdikliai

Tekstiniai formų valdikliai, pvz <input>., s, <select>s ir <textarea>s, yra kuriami pagal .form-controlklasę. Įtraukti stiliai, skirti bendrajai išvaizdai, fokusavimo būsenai, dydžio nustatymui ir kt.

Būtinai ištirkite mūsų pasirinktines formas , kad papildytumėte stilių <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>

.form-controlNorėdami įvesti failus, pakeiskite į .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>

Dydžio nustatymas

Nustatykite aukščius naudodami tokias klases kaip .form-control-lgir .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>

Tik skaitymui

Pridėkite readonlyloginį atributą įvestyje, kad išvengtumėte įvesties vertės pakeitimo. Tik skaitomos įvestys atrodo šviesesnės (kaip ir išjungtos įvestys), tačiau išlaiko standartinį žymeklį.

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

Tik skaitomas paprastas tekstas

Jei norite, kad <input readonly>formos elementai būtų sukurti kaip paprastas tekstas, naudokite .form-control-plaintextklasę, kad pašalintumėte numatytąjį formos lauko stilių ir išlaikytumėte teisingą paraštę bei užpildymą.

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

Diapazono įėjimai

Nustatykite horizontaliai slenkamojo diapazono įvestis naudodami .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>

Žymės langeliai ir radijo imtuvai

Numatytieji žymimieji langeliai ir radijo imtuvai patobulinti naudojant vieną klasę abiem įvesties tipams .form-check, kuri pagerina jų HTML elementų išdėstymą ir elgseną . Žymieji langeliai yra skirti pasirinkti vieną ar kelias parinktis sąraše, o radijo imtuvai skirti pasirinkti vieną iš daugelio.

Palaikomi išjungti žymės langeliai ir radijo imtuvai. Atributas pritaikys šviesesnę spalvą, kad disabledbūtų lengviau nurodyti įvesties būseną.

Žymieji langeliai ir radijo mygtukai palaiko HTML pagrįstą formų patvirtinimą ir pateikia glaustas, prieinamas etiketes. Taigi mūsų <input>s ir <label>s yra brolių ir seserų elementai, o <input>ne a viduje <label>. Tai yra šiek tiek išsamesnė, nes turite nurodyti idir foratributus, kad susietumėte <input>ir <label>.

Numatytasis (sudarytas)

Pagal numatytuosius nustatymus bet koks žymimųjų laukelių ir radijo imtuvų skaičius, kurie yra tiesioginiai broliai, bus išdėstyti vertikaliai ir tinkamai išdėstyti su .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>

Inline

Grupuokite žymimuosius laukelius arba radijo imtuvus toje pačioje horizontalioje eilutėje pridėdami .form-check-inlineprie bet kurio .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>

Be etikečių

Pridėkite .position-staticprie įvesties .form-check, kuriose nėra etiketės teksto. Nepamirškite pateikti tam tikros formos pasiekiamo pagalbinių technologijų pavadinimo (pvz., naudojant 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>

Išdėstymas

Kadangi „Bootstrap“ taikomas display: blockir width: 100%beveik visiems mūsų formų valdikliams, formos pagal numatytuosius nustatymus bus kaupiamos vertikaliai. Papildomos klasės gali būti naudojamos šiam išdėstymui keisti pagal formą.

Suformuokite grupes

.form-groupKlasė yra lengviausias būdas pridėti tam tikrą formų struktūrą . Tai suteikia lanksčią klasę, skatinančią tinkamai grupuoti etiketes, valdiklius, pasirenkamą pagalbos tekstą ir formos patvirtinimo pranešimus. Pagal numatytuosius nustatymus jis taikomas tik margin-bottom, bet prireikus paima papildomų stilių .form-inline. Naudokite jį su <fieldset>s, <div>s ar beveik bet kokiu kitu elementu.

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

Formos tinklelis

Naudojant mūsų tinklelio klases, galima sukurti sudėtingesnes formas. Naudokite juos formų išdėstymams, kuriems reikia kelių stulpelių, įvairaus pločio ir papildomų lygiavimo parinkčių.

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

Formos eilutė

Taip pat galite pakeisti .rowį .form-rowstandartinės tinklelio eilutės variantą, kuris pakeičia numatytuosius stulpelių latakus, kad būtų griežtesni ir kompaktiškesni.

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

Su tinklelio sistema taip pat galima sukurti sudėtingesnius maketus.

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

Horizontali forma

Kurkite horizontalias formas naudodami tinklelį, įtraukdami .rowklasę prie formų grupių ir naudodami .col-*-*klases nurodydami etikečių ir valdiklių plotį. Būtinai pridėkite .col-form-labelir prie savo <label>s, kad jie būtų vertikaliai centre su susijusiais formos valdikliais.

Kartais jums gali tekti naudoti paraščių arba užpildymo priemones, kad sukurtumėte reikiamą tobulą išlygiavimą. Pavyzdžiui, pašalinome padding-topsukrautų radijo įvesties etiketę, kad geriau suderintume pagrindinę teksto liniją.

Radijas
<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>
Horizontalios formos etiketės dydis

Būtinai naudokite .col-form-label-smarba .col-form-label-lgprie savo <label>s ar s, kad teisingai laikytumėte ir <legend>dydį ..form-control-lg.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>

Stulpelių dydžio nustatymas

Kaip parodyta ankstesniuose pavyzdžiuose, mūsų tinklelio sistema leidžia a arba dėti bet kokį skaičių .cols . Galimą plotį jie paskirstys vienodai. Taip pat galite pasirinkti stulpelių poaibį, kuris užimtų daugiau ar mažiau vietos, o likę s vienodai padalins likusias dalis su konkrečiomis stulpelių klasėmis, pvz ., ..row.form-row.col.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>

Automatinis dydžio nustatymas

Toliau pateiktame pavyzdyje naudojama „flexbox“ priemonė, skirta vertikaliai centruoti turinį ir pakeisti .colį .col-autotaip, kad stulpeliai užimtų tik tiek vietos, kiek reikia. Kitaip tariant, stulpelio dydis nustatomas pagal turinį.

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

Tada galėsite tai dar kartą permaišyti naudodami konkretaus dydžio stulpelių klases.

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

Ir, žinoma , palaikomi pasirinktiniai formų valdikliai .

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

Eilutinės formos

Naudokite .form-inlineklasę, kad vienoje horizontalioje eilutėje būtų rodoma etikečių, formų valdiklių ir mygtukų serija. Įterptųjų formų formų valdikliai šiek tiek skiriasi nuo numatytųjų būsenų.

  • Valdikliai yra display: flex, sutraukiantys bet kokį HTML tarpą ir leidžiantys valdyti lygiavimo valdymą naudojant tarpų ir „flexbox“ priemones.
  • Valdikliai ir įvesties grupės width: autoturi nepaisyti numatytosios Bootstrap width: 100%.
  • Valdikliai rodomi tik įterptose peržiūros srityse, kurios yra bent 576 pikselių pločio , kad būtų atsižvelgta į siauras peržiūros sritis mobiliuosiuose įrenginiuose.

Jums gali tekti rankiniu būdu nustatyti atskirų formos valdiklių plotį ir lygiavimą su tarpų programomis (kaip parodyta toliau). Galiausiai būtinai visada įtraukite a <label>prie kiekvieno formos valdiklio, net jei norite jį paslėpti nuo lankytojų, kurie neskaito ekrano naudodami .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>

Taip pat palaikomi pasirinktiniai formų valdikliai ir pasirinkimai.

<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>
Paslėptų etikečių alternatyvos

Pagalbinės technologijos, pvz., ekrano skaitytuvai, turės problemų su formomis, jei neįtrauksite etiketės prie kiekvienos įvesties. Šių eilutinių formų etiketes galite paslėpti naudodami .sr-onlyklasę. Yra ir kitų alternatyvių metodų, kaip suteikti etiketę pagalbinėms technologijoms, pvz., aria-label, aria-labelledbyarba titleatributas. Jei nė vieno iš jų nėra, pagalbinės technologijos gali naudoti placeholderatributą, jei yra, tačiau atminkite, kad placeholdernepatartina naudoti kaip kitų ženklinimo metodų pakaitalo.

Pagalbos tekstas

Bloko lygio pagalbos tekstas formose gali būti sukurtas naudojant .form-text(anksčiau žinomą kaip .help-blockv3). Inline žinyno tekstas gali būti lanksčiai įdiegtas naudojant bet kurį eilutinį HTML elementą ir naudingumo klases, pvz ., .text-muted.

Pagalbos teksto susiejimas su formos valdikliais

Pagalbos tekstas turi būti aiškiai susietas su formos valdikliu, su kuriuo jis susijęs su aria-describedbyatributo naudojimu. Taip bus užtikrinta, kad pagalbinės technologijos, pvz., ekrano skaitytuvai, praneštų šį pagalbos tekstą, kai naudotojas susifokusuos arba įjungs valdiklį.

Pagalbos tekstas, esantis žemiau, gali būti stilizuotas naudojant .form-text. Ši klasė apima display: blockir prideda šiek tiek viršutinės paraštės, kad būtų lengviau atskirti pirmiau pateiktas įvestis.

Jūsų slaptažodis turi būti 8–20 simbolių ilgio, sudarytas iš raidžių ir skaičių, jame neturi būti tarpų, specialiųjų simbolių ar jaustukų.
<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>

Įterptajame tekste gali būti naudojamas bet koks įprastas eilutinis HTML elementas (ar tai būtų <small>, <span>, ar kažkas kita) be naudingumo klasės.

Turi būti 8–20 simbolių ilgio.
<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>

Neįgaliosios formos

Pridėkite disabledloginį atributą įvestyje, kad išvengtumėte naudotojo sąveikos ir ji atrodytų šviesesnė.

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

Pridėkite disabledatributą prie a <fieldset>, kad išjungtumėte visus valdiklius.

Išjungto laukų rinkinio pavyzdys
<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>
Įspėjimas su inkarais

Naršyklės visus savuosius formų valdiklius ( <input>, <select>, ir <button>elementus) <fieldset disabled>laiko išjungtais, užkertant kelią klaviatūros ir pelės sąveikai.

Tačiau jei formoje taip pat yra pasirinktinių mygtukų elementų, pvz., <a ... class="btn btn-*">, jiems bus suteiktas tik stilius pointer-events: none. Kaip pažymėta skiltyje apie mygtukų išjungtą būseną (ir ypač prieraišo elementų poskyryje), ši CSS ypatybė dar nėra standartizuota ir nėra visiškai palaikoma „Internet Explorer 10“. Prieraišo valdikliai taip pat vis tiek bus naudojami fokusuojamas ir valdomas naudojant klaviatūrą. Turite rankiniu būdu modifikuoti šiuos valdiklius pridėdami tabindex="-1", kad jie nesufokusuotų ir aria-disabled="disabled"signalizuotų apie jų būseną pagalbinėms technologijoms.

Suderinamumas tarp naršyklių

Nors „Bootstrap“ taikys šiuos stilius visose naršyklėse, „Internet Explorer 11“ ir senesnės versijos visiškai nepalaiko disabledatributo <fieldset>. Naudokite tinkintą JavaScript, kad išjungtumėte laukų rinkinį šiose naršyklėse.

Patvirtinimas

Pateikite vertingų, naudingų atsiliepimų savo naudotojams naudodami HTML5 formos patvirtinimą – pasiekiamą visose mūsų palaikomose naršyklėse . Pasirinkite iš numatytųjų naršyklės patvirtinimo atsiliepimų arba pritaikykite tinkintus pranešimus naudodami mūsų integruotas klases ir pradedančiąją „JavaScript“.

Žinome, kad šiuo metu kliento pasirinktiniai patvirtinimo stiliai ir patarimai nepasiekiami, nes jie nėra veikiami pagalbinių technologijų. Kol dirbame su sprendimu, rekomenduojame naudoti serverio parinktį arba numatytąjį naršyklės patvirtinimo metodą.

Kaip tai veikia

Štai kaip formos patvirtinimas veikia naudojant Bootstrap:

  • HTML formos patvirtinimas taikomas naudojant dvi CSS pseudoklases :invalidir :valid. Tai taikoma <input>, <select>, ir <textarea>elementams.
  • Bootstrap aprėpia :invalidir :validstilius pirminei .was-validatedklasei, paprastai taikomai <form>. Kitu atveju bet koks privalomas laukas be reikšmės įkeliant puslapį bus rodomas kaip negaliojantis. Tokiu būdu galite pasirinkti, kada juos suaktyvinti (paprastai po to, kai bandoma pateikti formą).
  • Norėdami iš naujo nustatyti formos išvaizdą (pvz., dinaminės formos pateikimo naudojant AJAX), po pateikimo dar kartą pašalinkite .was-validatedklasę iš .<form>
  • Kaip atsarginis variantas, .is-invalidir .is-validklasės gali būti naudojamos vietoj pseudoklasių serverio pusės patvirtinimui . Jiems nereikia .was-validatedtėvų klasės.
  • Dėl CSS veikimo apribojimų negalime (šiuo metu) taikyti stilių, <label>kurie yra prieš formos valdiklį DOM be tinkintos JavaScript pagalbos.
  • Visos šiuolaikinės naršyklės palaiko apribojimų patvirtinimo API – „JavaScript“ metodų, skirtų formos valdikliams patvirtinti, seriją.
  • Atsiliepimų pranešimuose gali būti naudojami numatytieji naršyklės nustatymai (skirtingi kiekvienoje naršyklėje ir nekeičiami naudojant CSS) arba mūsų pasirinktiniai atsiliepimų stiliai su papildomu HTML ir CSS.
  • Galite pateikti tinkintus galiojimo pranešimus naudodami setCustomValidity„JavaScript“.

Turėdami tai omenyje, apsvarstykite šias demonstracines versijas, skirtas pasirinktinių formų patvirtinimo stiliams, pasirenkamoms serverio šoninėms klasėms ir naršyklės numatytiesiems parametrams.

Individualūs stiliai

Norėdami gauti tinkintus Bootstrap formos patvirtinimo pranešimus, turėsite pridėti novalidateloginį atributą prie savo <form>. Tai išjungia numatytuosius naršyklės atsiliepimų patarimus, bet vis tiek suteikia prieigą prie „JavaScript“ formos patvirtinimo API. Pabandykite pateikti žemiau esančią formą; mūsų „JavaScript“ perims pateikimo mygtuką ir perduos jums atsiliepimą. Bandydami pateikti, matysite formos valdikliams pritaikytus stilius :invalidir .:valid

Pasirinktiniai atsiliepimų stiliai taiko pasirinktines spalvas, rėmelius, fokusavimo stilius ir fono piktogramas, kad būtų galima geriau perduoti atsiliepimus. s fono piktogramos <select>galimos tik su .custom-select, bet ne .form-control.

Atrodo gerai!
Atrodo gerai!
Nurodykite galiojantį miestą.
Pasirinkite tinkamą būseną.
Pateikite galiojantį pašto kodą.
Prieš pateikdami turite sutikti.
<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>

Numatytieji naršyklės nustatymai

Nedomina pasirinktiniai patvirtinimo grįžtamojo ryšio pranešimai arba „JavaScript“ rašymas, kad pakeistumėte formos elgseną? Viskas gerai, galite naudoti numatytuosius naršyklės nustatymus. Pabandykite pateikti žemiau esančią formą. Atsižvelgiant į naršyklę ir OS, matysite šiek tiek kitokį atsiliepimų stilių.

Nors šių atsiliepimų stilių negalima sukurti naudojant CSS, vis tiek galite tinkinti atsiliepimo tekstą naudodami „JavaScript“.

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

Serverio pusė

Rekomenduojame naudoti kliento pusės patvirtinimą, bet jei reikia serverio patvirtinimo, netinkamus ir galiojančius formos laukus galite nurodyti naudodami .is-invalidir .is-valid. Atminkite, kad .invalid-feedbacktai taip pat palaikoma šiose klasėse.

Jei laukai yra neteisingi, įsitikinkite, kad neteisingas atsiliepimo / klaidos pranešimas yra susietas su atitinkamu formos lauku naudojant aria-describedby. Šis atributas leidžia nurodyti daugiau nei vieną id, jei laukas jau nurodo papildomą formos tekstą.

Atrodo gerai!
Atrodo gerai!
Nurodykite galiojantį miestą.
Pasirinkite tinkamą būseną.
Pateikite galiojantį pašto kodą.
Prieš pateikdami turite sutikti.
<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>

Palaikomi elementai

Galimi šių formų valdiklių ir komponentų patvirtinimo stiliai:

  • <input>s ir <textarea>s su.form-control
  • <select>s su .form-controlarba.custom-select
  • .form-checks
  • .custom-checkboxs ir .custom-radios
  • .custom-file
Į teksto sritį įveskite pranešimą.
Netinkamo atsiliepimo teksto pavyzdys
Daugiau netinkamo atsiliepimo teksto pavyzdžių
Netinkamo tinkinto pasirinkimo atsiliepimo pavyzdys
Netinkamo tinkinto failo atsiliepimo pavyzdys
@
Netinkamo įvesties grupės atsiliepimo pavyzdys
Netinkamo įvesties grupės atsiliepimo pavyzdys
Netinkamo įvesties grupės atsiliepimo pavyzdys
<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>

Patarimai

Jei formos išdėstymas tai leidžia, galite sukeisti .{valid|invalid}-feedbackklases į .{valid|invalid}-tooltipklases, kad pateiktumėte patvirtinimo atsiliepimą stiliaus patarime. Būtinai turėkite vieną iš tėvų position: relative, kad galėtų nustatyti patarimo vietą. Toliau pateiktame pavyzdyje mūsų stulpelių klasėse tai jau yra, tačiau jūsų projektui gali prireikti kitos sąrankos.

Atrodo gerai!
Atrodo gerai!
Nurodykite galiojantį miestą.
Pasirinkite tinkamą būseną.
Pateikite galiojantį pašto kodą.
<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>

Tinkinimas

Patvirtinimo būsenas galima tinkinti naudojant Sass su $form-validation-statesžemėlapiu. Šis mūsų _variables.scssfaile esantis Sass žemėlapis perjungiamas, kad būtų sukurtos numatytosios valid/ invalidpatvirtinimo būsenos. Pridedamas įdėtas žemėlapis, skirtas tinkinti kiekvienos būsenos spalvą ir piktogramą. Nors naršyklės nepalaiko jokių kitų būsenų, naudojantys pasirinktinius stilius gali lengvai pridėti sudėtingesnių formų atsiliepimų.

Atkreipkite dėmesį, kad nerekomenduojame tinkinti šių reikšmių nepakeitus form-validation-statemaišymo.

// 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));
}

Įvesties grupės patvirtinimas

Norint nustatyti, kokiems elementams reikia užapvalintų kampų įvesties grupėje su patvirtinimu, įvesties grupei reikia papildomos .has-validationklasės.

<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>
@
Pasirinkite vartotojo vardą.

Individualios formos

Jei norite dar daugiau tinkinti ir nuoseklumo tarp naršyklių, naudokite visiškai tinkintus formos elementus, kad pakeistumėte numatytuosius naršyklės nustatymus. Jie sukurti remiantis semantiniu ir prieinamu žymėjimu, todėl yra tvirti bet kokio numatytojo formos valdymo pakaitalai.

Žymės langeliai ir radijo imtuvai

Kiekvienas žymimasis laukelis, radijas <input>ir <label>susiejimas yra supakuoti į a <div>, kad sukurtume pasirinktinį valdiklį. Struktūriškai tai yra toks pat metodas, kaip numatytasis .form-check.

Naudojame brolių ir seserų parinkiklį ( ~) visoms savo <input>būsenoms, pvz ., norėdami :checkedtinkamai pritaikyti tinkintos formos indikatorių. Kartu su .custom-control-labelklase taip pat galime sukurti kiekvieno elemento teksto stilių pagal <input>būseną.

Paslėpiame numatytąjį nustatymą <input>ir opacitynaudojame , .custom-control-labelkad sukurtume naują tinkintos formos indikatorių jo vietoje naudodami ::beforeir ::after. Deja, negalime sukurti tinkinto vien tik iš šio elemento, <input>nes CSS contentneveikia šio elemento.

Pažymėtose būsenose naudojame base64 įterptas SVG piktogramasOpen Iconic . Taip galime geriausiai valdyti stilių ir padėties nustatymą naršyklėse ir įrenginiuose.

Žymės langeliai

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

Pasirinktiniuose žymimuosiuose laukeliuose taip pat gali būti naudojama :indeterminatepseudo klasė, kai ji nustatoma rankiniu būdu naudojant „JavaScript“ (nėra pasiekiamo HTML atributo, kad būtų galima ją nurodyti).

Jei naudojate jQuery, turėtų pakakti tokio dalyko:

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

Radijas

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

Inline

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

Išjungta

Taip pat galima išjungti pasirinktinius žymimuosius laukelius ir radijo imtuvus. Pridėkite disabledloginį atributą <input>ir pasirinktinis indikatorius bei etiketės aprašymas bus automatiškai kuriami.

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

Jungikliai

Jungiklis turi pasirinktinio žymės langelio žymėjimą, bet naudoja .custom-switchklasę perjungimo jungikliui pateikti. Jungikliai taip pat palaiko 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>

Pasirinkite meniu

Pasirinktiniams <select>meniu reikia tik tinkintos klasės, .custom-selectkad suaktyvintų pasirinktinius stilius. Pasirinktiniai stiliai apsiriboja <select>pradine išvaizda ir negali keisti <option>s dėl naršyklės apribojimų.

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

Taip pat galite pasirinkti iš mažų ir didelių pasirinktinių pasirinkimų, kad atitiktų mūsų panašaus dydžio teksto įvestis.

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

multipleAtributas taip pat palaikomas :

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

Kaip ir sizeatributas:

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

diapazonas

Sukurkite pasirinktinius <input type="range">valdiklius naudodami .custom-range. Takelis (fonas) ir nykštis (vertė) yra sukurti taip, kad visose naršyklėse atrodytų vienodai. Kadangi tik IE ir Firefox palaiko savo takelio „užpildymą“ iš kairės arba dešinės nykščio, kaip priemonę vizualiai parodyti pažangą, šiuo metu mes to nepalaikome.

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

minDiapazono įvestis turi numanomas ir max0ir 100atitinkamai reikšmes . Galite nurodyti naujas reikšmes tiems, kurie naudoja minir maxatributus.

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

Pagal numatytuosius nustatymus diapazono įvestis „prisijungia“ prie sveikųjų skaičių. Norėdami tai pakeisti, galite nurodyti stepreikšmę. Toliau pateiktame pavyzdyje mes padvigubiname žingsnių skaičių naudodami step="0.5".

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

Failų naršyklė

Rekomenduojamas papildinys, skirtas animuoti tinkintą failo įvestį: bs-custom-file-input , kurį šiuo metu naudojame savo dokumentuose.

Failo įvestis yra pati niūriausia ir reikalauja papildomo „JavaScript“, jei norite juos susieti su funkcine Pasirinkti failą… ir pasirinkto failo pavadinimo tekstu.

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

Paslėpiame numatytąjį failą <input>naudodami . Mygtukas sugeneruojamas ir nustatomas su . Galiausiai, pažymime a ir , kad aplinkiniam turiniui būtų tinkami tarpai.opacity<label>::afterwidthheight<input>

Eilučių vertimas arba tinkinimas naudojant SCSS

Pseudoklasė :lang()naudojama norint išversti „Naršyti“ tekstą į kitas kalbas. Nepaisykite arba pridėkite Sass kintamojo įrašus $custom-file-textsu atitinkama kalbos žyma ir lokalizuotomis eilutėmis. Angliškas stygas galima pritaikyti taip pat. Pavyzdžiui, štai kaip galima pridėti vertimą į ispanų kalbą (ispanų kalbos kodas yra es):

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

Štai kaip lang(es)veikia pasirinktinė failo įvestis vertimui į ispanų kalbą:

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

Kad būtų rodomas teisingas tekstas, turėsite teisingai nustatyti dokumento (arba jo pomedžio) kalbą. Tai galima padaryti naudojant elemento atributą langarba<html> HTTP Content-Languageantraštę ir kitus metodus.

Eilučių vertimas arba tinkinimas naudojant HTML

„Bootstrap“ taip pat suteikia galimybę išversti „Naršyti“ tekstą HTML su data-browseatributu, kurį galima pridėti prie tinkintos įvesties etiketės (pavyzdys olandų kalba):

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