in English

Veidlapas

Piemēri un lietošanas vadlīnijas veidlapu vadības stiliem, izkārtojuma opcijām un pielāgotiem komponentiem dažādu veidlapu izveidei.

Pārskats

Bootstrap veidlapu vadīklas paplašina mūsu Rebooted formu stilus ar klasēm. Izmantojiet šīs klases, lai izvēlētos to pielāgotos displejus konsekventākai atveidei visās pārlūkprogrammās un ierīcēs.

Noteikti izmantojiet atbilstošu typeatribūtu visās ievadēs (piemēram, emaile-pasta adresei vai numberskaitliskai informācijai), lai izmantotu jaunākas ievades vadīklas, piemēram, e-pasta verifikāciju, numura atlasi un citus.

Šeit ir īss piemērs Bootstrap veidlapu stilu demonstrēšanai. Turpiniet lasīt, lai iegūtu dokumentāciju par nepieciešamajām klasēm, veidlapu izkārtojumu un daudz ko citu.

Mēs nekad nekopīgosim jūsu e-pastu ar kādu citu.
<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>

Veidlapu vadīklas

Teksta formas vadīklas, piemēram <input>, s, <select>s un <textarea>s, ir veidotas atbilstoši .form-controlklasei. Iekļauti stili vispārējam izskatam, fokusa stāvoklim, izmēram un citiem.

Noteikti izpētiet mūsu pielāgotās veidlapas , lai uzlabotu stilus <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>

Failu ievadei nomainiet vērtību .form-controlpret .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>

Izmēru noteikšana

Iestatiet augstumus, izmantojot tādas klases kā .form-control-lgun .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>

Tikai lasīt

Pievienojiet readonlyievadei Būla atribūtu, lai novērstu ievades vērtības izmaiņas. Tikai lasāmās ievades šķiet gaišākas (tāpat kā atspējotas ievades), bet saglabā standarta kursoru.

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

Tikai lasāms vienkāršs teksts

Ja vēlaties, lai <input readonly>elementi veidlapā tiktu veidoti kā vienkāršs teksts, izmantojiet .form-control-plaintextklasi, lai noņemtu noklusējuma veidlapas lauka stilu un saglabātu pareizo piemaļu un polsterējumu.

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

Diapazona ieejas

Iestatiet horizontāli ritināmas diapazona ievades, izmantojot .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>

Izvēles rūtiņas un radio

Noklusējuma izvēles rūtiņas un radiouztvērēji tiek uzlaboti .form-check, izmantojot vienu klasi abiem ievades veidiem, kas uzlabo to HTML elementu izkārtojumu un darbību . Izvēles rūtiņas ir paredzētas, lai sarakstā atlasītu vienu vai vairākas opcijas, savukārt radio ir paredzētas vienas opcijas atlasei no daudzām.

Tiek atbalstītas atspējotās izvēles rūtiņas un radio. Atribūts disabledizmantos gaišāku krāsu, lai palīdzētu norādīt ievades stāvokli.

Izvēles rūtiņas un radio pogas atbalsta uz HTML balstītu veidlapu validāciju un nodrošina kodolīgas, pieejamas etiķetes. Tādējādi mūsu <input>s un s ir brāļu un māsu elementi , <label>nevis iekšējie elementi . Tas ir nedaudz detalizētāks, jo jums ir jānorāda un atribūti, lai saistītu ar un .<input><label>idfor<input><label>

Noklusējums (stacked)

Pēc noklusējuma jebkurš izvēles rūtiņu un radioaparātu skaits, kas ir tiešās brālis, tiks novietoti vertikāli un atbilstoši izvietoti ar .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>

Rindā

Grupējiet izvēles rūtiņas vai radio vienā un tajā pašā horizontālajā rindā, pievienojot .form-check-inlinejebkurai .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 etiķetēm

Pievienot .position-staticievadēm, .form-checkkurām nav etiķetes teksta. Atcerieties, ka palīgtehnoloģijām joprojām ir jānorāda kāds pieejams nosaukums (piemēram, izmantojot 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>

Izkārtojums

Tā kā Bootstrap tiek lietots display: blockun width: 100%gandrīz visām mūsu veidlapu vadīklām, veidlapas pēc noklusējuma tiks krautas vertikāli. Papildu klases var izmantot, lai mainītu šo izkārtojumu atkarībā no veidlapas.

Veidojiet grupas

Klase .form-groupir vienkāršākais veids, kā veidlapām pievienot kādu struktūru. Tā nodrošina elastīgu klasi, kas mudina pareizi grupēt etiķetes, vadīklas, izvēles palīdzības tekstu un veidlapas validācijas ziņojumus. Pēc noklusējuma tas attiecas tikai uz margin-bottom, taču pēc .form-inlinevajadzības tiek atlasīti papildu stili. Izmantojiet to ar <fieldset>s, <div>s vai gandrīz jebkuru citu 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>

Veidlapas režģis

Sarežģītākas formas var izveidot, izmantojot mūsu režģa klases. Izmantojiet tos veidlapu izkārtojumiem, kuriem nepieciešamas vairākas kolonnas, dažādi platumi un papildu līdzināšanas opcijas.

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

Veidlapas rinda

Varat arī apmainīt .rowpret .form-row, mūsu standarta režģa rindas variantu, kas ignorē noklusējuma kolonnu notekas, lai iegūtu stingrākus un kompaktākus izkārtojumus.

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

Ar režģa sistēmu var izveidot arī sarežģītākus izkārtojumus.

<form>
  <div class="form-row">
    <div class="form-group col-md-6">
      <label for="inputEmail4">Email</label>
      <input type="email" class="form-control" id="inputEmail4">
    </div>
    <div class="form-group col-md-6">
      <label for="inputPassword4">Password</label>
      <input type="password" class="form-control" id="inputPassword4">
    </div>
  </div>
  <div class="form-group">
    <label for="inputAddress">Address</label>
    <input type="text" class="form-control" id="inputAddress" placeholder="1234 Main St">
  </div>
  <div class="form-group">
    <label for="inputAddress2">Address 2</label>
    <input type="text" class="form-control" id="inputAddress2" placeholder="Apartment, studio, or floor">
  </div>
  <div class="form-row">
    <div class="form-group col-md-6">
      <label for="inputCity">City</label>
      <input type="text" class="form-control" id="inputCity">
    </div>
    <div class="form-group col-md-4">
      <label for="inputState">State</label>
      <select id="inputState" class="form-control">
        <option selected>Choose...</option>
        <option>...</option>
      </select>
    </div>
    <div class="form-group col-md-2">
      <label for="inputZip">Zip</label>
      <input type="text" class="form-control" id="inputZip">
    </div>
  </div>
  <div class="form-group">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="gridCheck">
      <label class="form-check-label" for="gridCheck">
        Check me out
      </label>
    </div>
  </div>
  <button type="submit" class="btn btn-primary">Sign in</button>
</form>

Horizontālā forma

Izveidojiet horizontālas veidlapas ar režģi, pievienojot .rowklasi grupām un izmantojot .col-*-*klases, lai norādītu iezīmju un vadīklu platumu. Noteikti pievienojiet .col-form-labelarī savas <label>s, lai tās būtu vertikāli centrētas ar tām saistītajām veidlapu vadīklām.

Reizēm jums, iespējams, ir jāizmanto piemaļu vai polsterējuma utilītas, lai izveidotu vajadzīgo perfekto līdzinājumu. Piemēram, mēs esam noņēmuši padding-topno mūsu salikto radio ievades etiķetes, lai labāk saskaņotu teksta bāzes līniju.

Radioaparāti
<form>
  <div class="form-group row">
    <label for="inputEmail3" class="col-sm-2 col-form-label">Email</label>
    <div class="col-sm-10">
      <input type="email" class="form-control" id="inputEmail3">
    </div>
  </div>
  <div class="form-group row">
    <label for="inputPassword3" class="col-sm-2 col-form-label">Password</label>
    <div class="col-sm-10">
      <input type="password" class="form-control" id="inputPassword3">
    </div>
  </div>
  <fieldset class="form-group row">
    <legend class="col-form-label col-sm-2 float-sm-left pt-0">Radios</legend>
    <div class="col-sm-10">
      <div class="form-check">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios1" value="option1" checked>
        <label class="form-check-label" for="gridRadios1">
          First radio
        </label>
      </div>
      <div class="form-check">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios2" value="option2">
        <label class="form-check-label" for="gridRadios2">
          Second radio
        </label>
      </div>
      <div class="form-check disabled">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios3" value="option3" disabled>
        <label class="form-check-label" for="gridRadios3">
          Third disabled radio
        </label>
      </div>
    </div>
  </fieldset>
  <div class="form-group row">
    <div class="col-sm-10 offset-sm-2">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" id="gridCheck1">
        <label class="form-check-label" for="gridCheck1">
          Example checkbox
        </label>
      </div>
    </div>
  </div>
  <div class="form-group row">
    <div class="col-sm-10">
      <button type="submit" class="btn btn-primary">Sign in</button>
    </div>
  </div>
</form>
Horizontālās formas etiķetes izmēru noteikšana

Noteikti izmantojiet .col-form-label-smvai .col-form-label-lgsavam <label>s vai s, lai pareizi ievērotu un <legend>izmēru ..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>

Kolonnu izmēra noteikšana

Kā parādīts iepriekšējos piemēros, mūsu režģa sistēma ļauj ievietot jebkuru .cols skaitu a .rowvai .form-row. Viņi sadalīs pieejamo platumu vienādi. Varat arī izvēlēties sleju apakškopu, lai tā aizņemtu vairāk vai mazāk vietas, bet atlikušās .cols vienādi sadala pārējās, izmantojot noteiktas kolonnu klases, piemēram, .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>

Automātiska izmēra noteikšana

Tālāk sniegtajā piemērā tiek izmantota flexbox utilīta, lai vertikāli centrētu saturu un mainītu tā, .collai .col-autokolonnas aizņemtu tikai tik daudz vietas, cik nepieciešams. Citiem vārdiem sakot, kolonnas izmērs tiek noteikts atkarībā no satura.

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

Pēc tam varat to vēlreiz sajaukt ar lieluma kolonnu klasēm.

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

Un, protams, tiek atbalstītas pielāgotas veidlapas vadīklas .

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

Iekļautās veidlapas

Izmantojiet .form-inlineklasi, lai vienā horizontālā rindā parādītu vairākas etiķetes, veidlapas vadīklas un pogas. Veidlapu vadīklas iekļautajās veidlapās nedaudz atšķiras no to noklusējuma stāvokļiem.

  • Vadīklas ir display: flex, sakļaujot jebkuru HTML balto atstarpi un ļaujot nodrošināt līdzinājuma kontroli ar atstarpēm un flexbox utilītiem.
  • Vadīklas un ievades grupas saņem width: auto, lai ignorētu Bootstrap noklusējuma iestatījumus width: 100%.
  • Vadības elementi tiek rādīti iekļauti tikai tajos skatu laukos, kuru platums ir vismaz 576 pikseļi , lai ņemtu vērā šauros skatu logus mobilajās ierīcēs.

Iespējams, jums būs manuāli jārisina atsevišķu veidlapu vadīklu platums un līdzinājums, izmantojot atstarpju utilītus (kā parādīts tālāk). Visbeidzot, katrā veidlapas vadīklā vienmēr iekļaujiet <label>simbolu, pat ja vēlaties to paslēpt no apmeklētājiem, kuri nav ekrāna lasītāji, izmantojot .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>

Tiek atbalstītas arī pielāgotas veidlapas vadīklas un atlases.

<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>
Alternatīvas slēptajām etiķetēm

Palīgtehnoloģijām, piemēram, ekrāna lasītājiem, būs problēmas ar jūsu veidlapām, ja katrai ievadei neiekļausiet etiķeti. Šo iekļauto veidlapu etiķetes varat paslēpt, izmantojot .sr-onlyklasi. Ir arī citas alternatīvas metodes, kā nodrošināt marķējumu palīgtehnoloģijām, piemēram, aria-label, aria-labelledbyvai titleatribūts. Ja neviena no tām nav, palīgtehnoloģijas var izmantot placeholderatribūtu, ja tāds ir, taču ņemiet vērā, ka placeholdernav ieteicams to izmantot kā citu marķēšanas metožu aizstājēju.

Palīdzības teksts

Bloka līmeņa palīdzības tekstu veidlapās var izveidot, izmantojot .form-text(iepriekš zināms kā .help-blockv3). Iekļauto palīdzības tekstu var elastīgi ieviest, izmantojot jebkuru iekļauto HTML elementu un utilītu klases, piemēram, .text-muted.

Palīdzības teksta saistīšana ar veidlapas vadīklām

Palīdzības tekstam jābūt skaidri saistītam ar formas vadīklu, kas ir saistīta ar aria-describedbyatribūta lietošanu. Tas nodrošinās, ka palīgtehnoloģijas, piemēram, ekrāna lasītāji, paziņos šo palīdzības tekstu, kad lietotājs fokusēsies vai ievadīs vadīklu.

Palīdzības tekstu zem ievades var veidot ar .form-text. Šī klase ietver display: blockun pievieno dažas augšējās piemales, lai atvieglotu atstarpi no iepriekš norādītajām ievadēm.

Jūsu parolei ir jābūt 8–20 rakstzīmes garai, tajā nedrīkst būt burti un cipari, un tajā nedrīkst būt atstarpes, speciālās rakstzīmes vai emocijzīmes.
<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>

Iekļautajā tekstā var izmantot jebkuru tipisku iekļauto HTML elementu (vai tas būtu <small>, <span>, vai kaut kas cits) ar lietderības klasi.

Jābūt 8–20 rakstzīmēm.
<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>

Invalīdu formas

Pievienojiet disabledievadei Būla atribūtu, lai novērstu lietotāja mijiedarbību un padarītu to gaišāku.

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

Pievienojiet disabledatribūtu a <fieldset>, lai atspējotu visas vadīklas.

Atspējota lauku kopas piemērs
<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>
Brīdinājums ar enkuriem

Pārlūkprogrammas visas vietējās formas vadīklas ( <input>, <select>, un <button>elementus) apstrādā <fieldset disabled>kā atspējotas, novēršot gan tastatūras, gan peles mijiedarbību.

Tomēr, ja veidlapā ir iekļauti arī pielāgoti pogām līdzīgi elementi, piemēram, <a ... class="btn btn-*">, tiem tiks piešķirts tikai stils pointer-events: none. Kā norādīts sadaļā par pogu atspējošanas stāvokli (un jo īpaši enkura elementu apakšsadaļā), šis CSS rekvizīts vēl nav standartizēts un nav pilnībā atbalstīts pārlūkprogrammā Internet Explorer 10. Uz enkuru balstītās vadīklas joprojām būs fokusējams un darbināms, izmantojot tastatūru. Šīs vadīklas ir manuāli jāmaina, pievienojot tabindex="-1"tās, lai tās nesaņemtu fokusu un aria-disabled="disabled"signalizētu par to stāvokli palīgtehnoloģijām.

Saderība starp pārlūkprogrammām

Lai gan Bootstrap lietos šos stilus visās pārlūkprogrammās, pārlūkprogramma Internet Explorer 11 un vecākas versijas pilnībā neatbalsta disabledatribūtu <fieldset>. Izmantojiet pielāgotu JavaScript, lai atspējotu lauku kopu šajās pārlūkprogrammās.

Validācija

Sniedziet lietotājiem vērtīgas, praktiskas atsauksmes, izmantojot HTML5 veidlapu validāciju — tā ir pieejama visās mūsu atbalstītajās pārlūkprogrammās . Izvēlieties kādu no pārlūkprogrammas noklusējuma validācijas atsauksmēm vai ieviesiet pielāgotus ziņojumus, izmantojot mūsu iebūvētās klases un iesācēju JavaScript.

Mēs apzināmies, ka pašlaik klienta puses pielāgotie validācijas stili un rīka padomi nav pieejami, jo tie nav pakļauti palīgtehnoloģijām. Kamēr mēs strādājam pie risinājuma, mēs iesakām izmantot servera puses opciju vai noklusējuma pārlūkprogrammas validācijas metodi.

Kā tas strādā

Lūk, kā veidlapu validācija darbojas ar Bootstrap:

  • HTML veidlapas validācija tiek lietota, izmantojot divas CSS pseidoklases :invalidun :valid. Tas attiecas uz <input>, <select>un <textarea>elementiem.
  • Bootstrap aptver :invalidun :validstilus uz vecāku .was-validatedklasi, kas parasti tiek lietots <form>. Pretējā gadījumā jebkurš obligātais lauks bez vērtības lapas ielādes laikā tiek rādīts kā nederīgs. Tādā veidā jūs varat izvēlēties, kad tās aktivizēt (parasti pēc veidlapas iesniegšanas mēģinājuma).
  • Lai atiestatītu veidlapas izskatu (piemēram, dinamisku veidlapu iesniegšanas gadījumā, izmantojot AJAX), pēc iesniegšanas vēlreiz noņemiet .was-validatedklasi no veidlapas.<form>
  • Kā rezerves, .is-invalidun .is-validklases var izmantot pseidoklases vietā servera puses validācijai . Viņiem nav nepieciešama .was-validatedvecāku klase.
  • CSS darbības ierobežojumu dēļ mēs (pašlaik) nevaram lietot stilus, <label>kas atrodas pirms veidlapas vadīklas DOM, neizmantojot pielāgotu JavaScript.
  • Visas mūsdienu pārlūkprogrammas atbalsta ierobežojumu validācijas API — JavaScript metožu sēriju veidlapu vadīklu apstiprināšanai.
  • Atsauksmju ziņojumos var tikt izmantoti pārlūkprogrammas noklusējuma iestatījumi (atšķirīgi katrā pārlūkprogrammā un nav stilizēti, izmantojot CSS) vai mūsu pielāgotie atsauksmju stili ar papildu HTML un CSS.
  • Varat nodrošināt pielāgotus derīguma ziņojumus ar setCustomValidityJavaScript.

Paturot to prātā, apsveriet tālāk norādītās demonstrācijas par mūsu pielāgotajiem veidlapu validācijas stiliem, papildu servera sānu klasēm un pārlūkprogrammas noklusējuma iestatījumiem.

Pielāgoti stili

Pielāgotiem Bootstrap veidlapas validācijas ziņojumiem jums būs jāpievieno novalidateBūla atribūts savam <form>. Tādējādi tiek atspējoti pārlūkprogrammas noklusējuma atsauksmju rīka padomi, taču joprojām tiek nodrošināta piekļuve veidlapu validācijas API JavaScript. Mēģiniet iesniegt zemāk esošo veidlapu; mūsu JavaScript pārtvers iesniegšanas pogu un nosūtīs jums atsauksmes. Mēģinot iesniegt, jūs redzēsit veidlapas vadīklām piemērotos stilus :invalidun .:valid

Pielāgotie atsauksmju stili izmanto pielāgotas krāsas, apmales, fokusa stilus un fona ikonas, lai labāk sniegtu atsauksmes. Fona ikonas priekš <select>s ir pieejamas tikai ar .custom-select, bet ne .form-control.

Izskatās labi!
Izskatās labi!
Lūdzu, norādiet derīgu pilsētu.
Lūdzu, atlasiet derīgu štatu.
Lūdzu, norādiet derīgu pasta indeksu.
Pirms iesniegšanas jums ir jāpiekrīt.
<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>

Pārlūka noklusējuma iestatījumi

Vai neinteresē pielāgotas validācijas atgriezeniskās saites ziņojumi vai JavaScript rakstīšana, lai mainītu veidlapas darbību? Viss kārtībā, varat izmantot pārlūkprogrammas noklusējuma iestatījumus. Mēģiniet iesniegt zemāk esošo veidlapu. Atkarībā no pārlūkprogrammas un operētājsistēmas jūs redzēsit nedaudz atšķirīgu atsauksmju stilu.

Lai gan šos atsauksmju stilus nevar veidot ar CSS, jūs joprojām varat pielāgot atsauksmju tekstu, izmantojot 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>

Servera puse

Mēs iesakām izmantot klienta puses validāciju, taču, ja nepieciešama servera puses validācija, nederīgos un derīgos veidlapas laukus varat norādīt ar .is-invalidun .is-valid. Ņemiet vērā, ka .invalid-feedbacktas tiek atbalstīts arī šajās klasēs.

Ja lauki ir nederīgi, pārliecinieties, vai nederīgais atsauksmes/kļūdas ziņojums ir saistīts ar attiecīgo veidlapas lauku, izmantojot aria-describedby. idŠis atribūts ļauj atsaukties uz vairāk nekā vienu , ja lauks jau norāda uz papildu veidlapas tekstu.

Izskatās labi!
Izskatās labi!
Lūdzu, norādiet derīgu pilsētu.
Lūdzu, atlasiet derīgu štatu.
Lūdzu, norādiet derīgu pasta indeksu.
Pirms iesniegšanas jums ir jāpiekrīt.
<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>

Atbalstītie elementi

Validācijas stili ir pieejami šādām veidlapas vadīklām un komponentiem:

  • <input>s un <textarea>s ar.form-control
  • <select>s ar .form-controlvai.custom-select
  • .form-checks
  • .custom-checkboxs un .custom-radios
  • .custom-file
Lūdzu, ievadiet ziņojumu teksta apgabalā.
Nederīgas atsauksmes teksta piemērs
Vairāk nederīgas atsauksmes teksta piemēru
Nederīgas pielāgotās atlases atsauksmes piemērs
Nederīgas pielāgotā faila atsauksmes piemērs
@
Nederīgas ievades grupas atsauksmes piemērs
Nederīgas ievades grupas atsauksmes piemērs
Nederīgas ievades grupas atsauksmes piemērs
<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>

Rīku padomi

Ja jūsu veidlapas izkārtojums to atļauj, varat apmainīt .{valid|invalid}-feedbackklases pret .{valid|invalid}-tooltipklasēm, lai parādītu validācijas atsauksmes stila rīka padomos. position: relativeRīka padoma pozicionēšanai noteikti ir jābūt kādam no vecākiem . Tālāk esošajā piemērā mūsu kolonnu klasēs tas jau ir, taču jūsu projektam var būt nepieciešama alternatīva iestatīšana.

Izskatās labi!
Izskatās labi!
Lūdzu, norādiet derīgu pilsētu.
Lūdzu, atlasiet derīgu štatu.
Lūdzu, norādiet derīgu pasta indeksu.
<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>

Pielāgošana

Validācijas stāvokļus var pielāgot, izmantojot Sass ar $form-validation-stateskarti. Šī Sass karte atrodas mūsu _variables.scssfailā, un tā tiek cilāta, lai ģenerētu noklusējuma valid/ invalidvalidācijas stāvokļus. Iekļauts ir ligzdots karte katras valsts krāsas un ikonas pielāgošanai. Lai gan pārlūkprogrammas neatbalsta citus stāvokļus, tie, kas izmanto pielāgotus stilus, var viegli pievienot sarežģītākas veidlapas atsauksmes.

Lūdzu, ņemiet vērā, ka mēs neiesakām pielāgot šīs vērtības, nepārveidojot arī form-validation-statemixin.

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

Ievades grupas validācija

Lai noteiktu, kuriem elementiem ir nepieciešami noapaļoti stūri ievades grupā ar validāciju, ievades grupai ir nepieciešama papildu .has-validationklase.

<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>
@
Lūdzu, izvēlieties lietotājvārdu.

Pielāgotas veidlapas

Lai nodrošinātu vēl lielāku pielāgošanu un vairāku pārlūkprogrammu konsekvenci, izmantojiet mūsu pilnībā pielāgotos veidlapas elementus, lai aizstātu pārlūkprogrammas noklusējuma iestatījumus. Tie ir veidoti, pamatojoties uz semantisku un pieejamu marķējumu, tāpēc tie lieliski aizstāj jebkuru noklusējuma veidlapu vadīklu.

Izvēles rūtiņas un radio

Katra izvēles rūtiņa un radio <input>un <label>savienošana pārī ir iesaiņota, <div>lai izveidotu mūsu pielāgoto vadīklu. Strukturāli šī ir tāda pati pieeja kā mūsu noklusējuma pieeja .form-check.

Mēs izmantojam brāļa atlasītāju ( ~) visiem mūsu <input>stāvokļiem, piemēram, :checkedlai pareizi izveidotu pielāgotās veidlapas indikatoru. Apvienojot ar .custom-control-labelklasi, mēs varam arī veidot katra vienuma teksta stilu, pamatojoties uz statusu <input>.

Mēs slēpjam noklusējuma vērtību <input>ar opacityun izmantojam, .custom-control-labellai tā vietā izveidotu jaunu pielāgotas formas indikatoru ar ::beforeun ::after. Diemžēl mēs nevaram izveidot pielāgotu elementu tikai no šī elementa, <input>jo CSS contentnedarbojas ar šo elementu.

Atzīmētajos stāvokļos mēs izmantojam base64 iegultās SVG ikonas no Open Iconic . Tādējādi mēs varam vislabāk kontrolēt stilu un pozicionēšanu dažādās pārlūkprogrammās un ierīcēs.

izvēles rūtiņas

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

Pielāgotās izvēles rūtiņas var izmantot arī :indeterminatepseidoklasi, ja tās ir manuāli iestatītas, izmantojot JavaScript (nav pieejams HTML atribūts, lai to norādītu).

Ja izmantojat jQuery, vajadzētu pietikt ar kaut ko līdzīgu:

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

Radioaparāti

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

Rindā

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

Atspējots

Var atspējot arī pielāgotās izvēles rūtiņas un radio. Pievienojiet disabledBūla atribūtu, <input>un pielāgotais indikators un etiķetes apraksts tiks automātiski veidoti.

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

Slēdži

Slēdžam ir pielāgotas izvēles rūtiņas atzīme, bet tas izmanto .custom-switchklasi, lai renderētu pārslēgšanas slēdzi. Slēdži arī atbalsta disabledatribūtu.

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

Izvēlieties izvēlni

Pielāgotajām <select>izvēlnēm ir nepieciešama tikai pielāgota klase, .custom-selectlai aktivizētu pielāgotos stilus. Pielāgotie stili ir ierobežoti ar sākotnējo izskatu, un pārlūkprogrammas ierobežojumu dēļ tos <select>nevar mainīt .<option>

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

Varat arī izvēlēties no maziem un lieliem pielāgotajiem atlases veidiem, lai tie atbilstu mūsu līdzīgā izmēra teksta ievadei.

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

Tiek multipleatbalstīts arī atribūts:

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

Tāpat kā sizeatribūts:

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

Diapazons

Izveidojiet pielāgotas <input type="range">vadīklas, izmantojot .custom-range. Ieraksts (fons) un īkšķis (vērtība) ir veidoti tā, lai visās pārlūkprogrammās būtu vienādi. Tā kā tikai IE un Firefox atbalsta celiņa “aizpildīšanu” no īkšķa kreisās vai labās puses, lai vizuāli norādītu progresu, mēs to pašlaik neatbalstām.

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

Diapazona ievadiem ir netiešas vērtības attiecīgi minun max0un 100. Varat norādīt jaunas vērtības tiem, kas izmanto minun maxatribūtus.

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

Pēc noklusējuma diapazona ievades tiek “pieslēgtas” veselām vērtībām. Lai to mainītu, varat norādīt stepvērtību. Tālāk esošajā piemērā mēs dubultojam soļu skaitu, izmantojot step="0.5".

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

Failu pārlūks

Ieteicamais spraudnis pielāgotas faila ievades animēšanai: bs-custom-file-input , to mēs pašlaik izmantojam savos dokumentos.

Faila ievade ir visizplatītākā, un tai ir nepieciešams papildu JavaScript, ja vēlaties tos saistīt ar funkcionālu Izvēlēties failu… un atlasītā faila nosaukuma 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>

Mēs slēpjam noklusējuma failu <input>, izmantojot opacityun tā vietā veidojam <label>. Poga tiek ģenerēta un novietota ar ::after. Visbeidzot, mēs paziņojam widthpar heightpareizu <input>atstarpi apkārtējam saturam.

Virkņu tulkošana vai pielāgošana, izmantojot SCSS

Pseidoklase :lang()tiek izmantota, lai “Pārlūkot” tekstu varētu tulkot citās valodās. Ignorēt vai pievienot $custom-file-textSass mainīgā ierakstus ar atbilstošo valodas tagu un lokalizētām virknēm. Angļu valodas stīgas var pielāgot tādā pašā veidā. Piemēram, šādi var pievienot tulkojumu spāņu valodā (spāņu valodas kods ir es):

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

Lūk lang(es), kā pielāgotā faila ievade spāņu valodas tulkojumam:

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

Lai tiktu parādīts pareizais teksts, jums ir pareizi jāiestata sava dokumenta (vai tā apakškoka) valoda. To var izdarīt, izmantojot elementa atribūtu langvai<html> HTTP Content-Languagegalveni , kā arī citas metodes.

Virkņu tulkošana vai pielāgošana, izmantojot HTML

Bootstrap nodrošina arī veidu, kā tulkot tekstu “Pārlūkot” HTML valodā ar data-browseatribūtu, ko var pievienot pielāgotajai ievades etiķetei (piemērs holandiešu valodā):

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