Formos
Formų valdymo stilių, išdėstymo parinkčių ir pasirinktinių komponentų, skirtų įvairioms formoms kurti, pavyzdžiai ir naudojimo gairės.
„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ą type
atributą visoms įvestims (pvz., email
el. pašto adresui arba number
skaitmeninei 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.
<form>
<div class="form-group">
<label for="exampleInputEmail1">Email address</label>
<input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp" placeholder="Enter email">
<small id="emailHelp" class="form-text text-muted">We'll never share your email with anyone else.</small>
</div>
<div class="form-group">
<label for="exampleInputPassword1">Password</label>
<input type="password" class="form-control" id="exampleInputPassword1" placeholder="Password">
</div>
<div class="form-check">
<input type="checkbox" class="form-check-input" id="exampleCheck1">
<label class="form-check-label" for="exampleCheck1">Check me out</label>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</form>
Tekstiniai formų valdikliai, pvz <input>
., s, <select>
s ir <textarea>
s, yra kuriami pagal .form-control
klasę. Į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-control
Norė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>
Nustatykite aukščius naudodami tokias klases kaip .form-control-lg
ir .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>
Pridėkite readonly
loginį 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>
Jei norite, kad <input readonly>
formos elementai būtų sukurti kaip paprastas tekstas, naudokite .form-control-plaintext
klasę, 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" placeholder="Password">
</div>
</div>
</form>
<form class="form-inline">
<div class="form-group mb-2">
<label for="staticEmail2" class="sr-only">Email</label>
<input type="text" readonly class="form-control-plaintext" id="staticEmail2" value="[email protected]">
</div>
<div class="form-group mx-sm-3 mb-2">
<label for="inputPassword2" class="sr-only">Password</label>
<input type="password" class="form-control" id="inputPassword2" placeholder="Password">
</div>
<button type="submit" class="btn btn-primary mb-2">Confirm identity</button>
</form>
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 žymimieji laukeliai ir radijo imtuvai, bet norėdami pateikti not-allowed
žymeklį ant pirminio <label>
, turėsite pridėti disabled
atributą prie .form-check-input
. Išjungtam atributui bus pritaikyta šviesesnė spalva, kad būtų lengviau nurodyti įvesties būseną.
Naudojami žymimieji laukeliai ir radijo imtuvai yra sukurti taip, kad palaikytų HTML pagrįstą formų patvirtinimą ir pateiktų 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 id
ir for
atributus, kad susietumėte <input>
ir <label>
.
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 disabled">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios3" value="option3" disabled>
<label class="form-check-label" for="exampleRadios3">
Disabled radio
</label>
</div>
Grupuokite žymimuosius laukelius arba radijo imtuvus toje pačioje horizontalioje eilutėje pridėdami .form-check-inline
prie 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>
Pridėkite .position-static
prie įvesties .form-check
, kuriose nėra etiketės teksto. Nepamirškite pateikti tam tikros formos pagalbinių technologijų etiketės (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>
Kadangi „Bootstrap“ taikomas display: block
ir 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ą.
.form-group
Klasė yra lengviausias būdas pridėti tam tikrą formų struktūrą . Tai lanksti klasė, skatinanti 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">
</div>
<div class="form-group">
<label for="formGroupExampleInput2">Another label</label>
<input type="text" class="form-control" id="formGroupExampleInput2" placeholder="Another input">
</div>
</form>
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>
Taip pat galite pakeisti .row
į .form-row
standartinė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" placeholder="Email">
</div>
<div class="form-group col-md-6">
<label for="inputPassword4">Password</label>
<input type="password" class="form-control" id="inputPassword4" placeholder="Password">
</div>
</div>
<div class="form-group">
<label for="inputAddress">Address</label>
<input type="text" class="form-control" id="inputAddress" placeholder="1234 Main St">
</div>
<div class="form-group">
<label for="inputAddress2">Address 2</label>
<input type="text" class="form-control" id="inputAddress2" placeholder="Apartment, studio, or floor">
</div>
<div class="form-row">
<div class="form-group col-md-6">
<label for="inputCity">City</label>
<input type="text" class="form-control" id="inputCity">
</div>
<div class="form-group col-md-4">
<label for="inputState">State</label>
<select id="inputState" class="form-control">
<option selected>Choose...</option>
<option>...</option>
</select>
</div>
<div class="form-group col-md-2">
<label for="inputZip">Zip</label>
<input type="text" class="form-control" id="inputZip">
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="gridCheck">
<label class="form-check-label" for="gridCheck">
Check me out
</label>
</div>
</div>
<button type="submit" class="btn btn-primary">Sign in</button>
</form>
Kurkite horizontalias formas naudodami tinklelį, įtraukdami .row
klasę prie formų grupių ir naudodami .col-*-*
klases nurodydami etikečių ir valdiklių plotį. Būtinai pridėkite .col-form-label
ir 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-top
sukrautų radijo įvesties etiketę, kad geriau suderintume pagrindinę teksto liniją.
<form>
<div class="form-group row">
<label for="inputEmail3" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="email" class="form-control" id="inputEmail3" placeholder="Email">
</div>
</div>
<div class="form-group row">
<label for="inputPassword3" class="col-sm-2 col-form-label">Password</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword3" placeholder="Password">
</div>
</div>
<fieldset class="form-group">
<div class="row">
<legend class="col-form-label col-sm-2 pt-0">Radios</legend>
<div class="col-sm-10">
<div class="form-check">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios1" value="option1" checked>
<label class="form-check-label" for="gridRadios1">
First radio
</label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios2" value="option2">
<label class="form-check-label" for="gridRadios2">
Second radio
</label>
</div>
<div class="form-check disabled">
<input class="form-check-input" type="radio" name="gridRadios" id="gridRadios3" value="option3" disabled>
<label class="form-check-label" for="gridRadios3">
Third disabled radio
</label>
</div>
</div>
</div>
</fieldset>
<div class="form-group row">
<div class="col-sm-2">Checkbox</div>
<div class="col-sm-10">
<div class="form-check">
<input class="form-check-input" type="checkbox" id="gridCheck1">
<label class="form-check-label" for="gridCheck1">
Example checkbox
</label>
</div>
</div>
</div>
<div class="form-group row">
<div class="col-sm-10">
<button type="submit" class="btn btn-primary">Sign in</button>
</div>
</div>
</form>
Būtinai naudokite .col-form-label-sm
arba .col-form-label-lg
prie savo <label>
s arba 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>
Kaip parodyta ankstesniuose pavyzdžiuose, mūsų tinklelio sistema leidžia a arba dėti bet kokį skaičių .col
s . 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>
Toliau pateiktame pavyzdyje naudojama „flexbox“ priemonė, skirta vertikaliai centruoti turinį ir pakeisti .col
į .col-auto
taip, 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" 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>
Naudokite .form-inline
klasę, 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: auto
turi nepaisyti numatytosios Bootstrapwidth: 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-only
klasę. Yra ir kitų alternatyvių metodų, kaip suteikti etiketę pagalbinėms technologijoms, pvz., aria-label
, aria-labelledby
arba title
atributas. Jei nė vieno iš jų nėra, pagalbinės technologijos gali naudoti placeholder
atributą, jei yra, tačiau atminkite, kad placeholder
nepatartina naudoti kaip kitų ženklinimo metodų pakaitalo.
Bloko lygio pagalbos tekstas formose gali būti sukurtas naudojant .form-text
(anksčiau žinomą kaip .help-block
v3). 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-describedby
atributo 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: block
ir prideda šiek tiek viršutinės paraštės, kad būtų lengviau atskirti pirmiau pateiktas įvestis.
<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.
<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>
Pridėkite disabled
loginį atributą įvestyje, kad išvengtumėte naudotojo sąveikos ir ji atrodytų šviesesnė.
Pridėkite disabled
atributą prie a <fieldset>
, kad išjungtumėte visus valdiklius.
<form>
<fieldset disabled>
<div class="form-group">
<label for="disabledTextInput">Disabled input</label>
<input type="text" id="disabledTextInput" class="form-control" placeholder="Disabled input">
</div>
<div class="form-group">
<label for="disabledSelect">Disabled select menu</label>
<select id="disabledSelect" class="form-control">
<option>Disabled select</option>
</select>
</div>
<div class="form-check">
<input class="form-check-input" type="checkbox" id="disabledFieldsetCheck" disabled>
<label class="form-check-label" for="disabledFieldsetCheck">
Can't check this
</label>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</fieldset>
</form>
Įspėjimas su inkarais
<input>
Pagal numatytuosius nustatymus naršyklės visus savuosius formų valdiklius ( ir elementus), esančius a viduje <select>
, laikys išjungtais, užkertant kelią klaviatūros ir pelės sąveikai. Tačiau jei jūsų formoje taip pat yra elementų, jiems bus suteiktas tik stilius . Kaip pažymėta skiltyje apie mygtukų išjungtą būseną (ir ypač prieraišo elementų poskyryje), ši CSS nuosavybė dar nėra standartizuota ir nėra visiškai palaikoma Opera 18 ir senesnėse versijose arba Internet Explorer 10 ir laimėjo. Netrukdykite klaviatūros naudotojams sutelkti dėmesį arba suaktyvinti šias nuorodas. Taigi, kad būtumėte saugūs, naudokite tinkintą JavaScript, kad išjungtumėte tokias nuorodas.<button>
<fieldset disabled>
<a ... class="btn btn-*">
pointer-events: none
Suderinamumas tarp naršyklių
Nors „Bootstrap“ taikys šiuos stilius visose naršyklėse, „Internet Explorer 11“ ir senesnės versijos visiškai nepalaiko disabled
atributo <fieldset>
. Naudokite tinkintą JavaScript, kad išjungtumėte laukų rinkinį šiose naršyklėse.
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“.
Primygtinai rekomenduojame pasirinkti tinkintus patvirtinimo stilius, nes ekrano skaitytuvams nėra pranešama apie savo naršyklės numatytuosius nustatymus.
Štai kaip formos patvirtinimas veikia naudojant Bootstrap:
- HTML formos patvirtinimas taikomas naudojant dvi CSS pseudoklases
:invalid
ir:valid
. Tai taikoma<input>
,<select>
, ir<textarea>
elementams. - Bootstrap aprėpia
:invalid
ir:valid
stilius pirminei.was-validated
klasei, 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ą). - Kaip atsarginis variantas,
.is-invalid
ir.is-valid
klasės gali būti naudojamos vietoj pseudoklasių serverio pusės patvirtinimui . Jiems nereikia.was-validated
tė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.
Norėdami gauti tinkintus Bootstrap formos patvirtinimo pranešimus, turėsite pridėti novalidate
loginį 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 :invalid
ir .:valid
<form class="needs-validation" novalidate>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationCustom01">First name</label>
<input type="text" class="form-control" id="validationCustom01" placeholder="First name" value="Mark" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationCustom02">Last name</label>
<input type="text" class="form-control" id="validationCustom02" placeholder="Last name" value="Otto" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationCustomUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend">@</span>
</div>
<input type="text" class="form-control" id="validationCustomUsername" placeholder="Username" aria-describedby="inputGroupPrepend" required>
<div class="invalid-feedback">
Please choose a username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationCustom03">City</label>
<input type="text" class="form-control" id="validationCustom03" placeholder="City" required>
<div class="invalid-feedback">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationCustom04">State</label>
<input type="text" class="form-control" id="validationCustom04" placeholder="State" required>
<div class="invalid-feedback">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationCustom05">Zip</label>
<input type="text" class="form-control" id="validationCustom05" placeholder="Zip" required>
<div class="invalid-feedback">
Please provide a valid zip.
</div>
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="invalidCheck" required>
<label class="form-check-label" for="invalidCheck">
Agree to terms and conditions
</label>
<div class="invalid-feedback">
You must agree before submitting.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
<script>
// Example starter JavaScript for disabling form submissions if there are invalid fields
(function() {
'use strict';
window.addEventListener('load', function() {
// Fetch all the forms we want to apply custom Bootstrap validation styles to
var forms = document.getElementsByClassName('needs-validation');
// Loop over them and prevent submission
var validation = Array.prototype.filter.call(forms, function(form) {
form.addEventListener('submit', function(event) {
if (form.checkValidity() === false) {
event.preventDefault();
event.stopPropagation();
}
form.classList.add('was-validated');
}, false);
});
}, false);
})();
</script>
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-4 mb-3">
<label for="validationDefault01">First name</label>
<input type="text" class="form-control" id="validationDefault01" placeholder="First name" value="Mark" required>
</div>
<div class="col-md-4 mb-3">
<label for="validationDefault02">Last name</label>
<input type="text" class="form-control" id="validationDefault02" placeholder="Last name" value="Otto" required>
</div>
<div class="col-md-4 mb-3">
<label for="validationDefaultUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend2">@</span>
</div>
<input type="text" class="form-control" id="validationDefaultUsername" placeholder="Username" aria-describedby="inputGroupPrepend2" required>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationDefault03">City</label>
<input type="text" class="form-control" id="validationDefault03" placeholder="City" required>
</div>
<div class="col-md-3 mb-3">
<label for="validationDefault04">State</label>
<input type="text" class="form-control" id="validationDefault04" placeholder="State" required>
</div>
<div class="col-md-3 mb-3">
<label for="validationDefault05">Zip</label>
<input type="text" class="form-control" id="validationDefault05" placeholder="Zip" required>
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input" type="checkbox" value="" id="invalidCheck2" required>
<label class="form-check-label" for="invalidCheck2">
Agree to terms and conditions
</label>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Rekomenduojame naudoti kliento pusės patvirtinimą, bet jei jums reikia serverio pusės, netinkamus ir galiojančius formos laukus galite nurodyti naudodami .is-invalid
ir .is-valid
. Atminkite, kad .invalid-feedback
tai taip pat palaikoma šiose klasėse.
<form>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationServer01">First name</label>
<input type="text" class="form-control is-valid" id="validationServer01" placeholder="First name" value="Mark" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationServer02">Last name</label>
<input type="text" class="form-control is-valid" id="validationServer02" placeholder="Last name" value="Otto" required>
<div class="valid-feedback">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationServerUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroupPrepend3">@</span>
</div>
<input type="text" class="form-control is-invalid" id="validationServerUsername" placeholder="Username" aria-describedby="inputGroupPrepend3" required>
<div class="invalid-feedback">
Please choose a username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationServer03">City</label>
<input type="text" class="form-control is-invalid" id="validationServer03" placeholder="City" required>
<div class="invalid-feedback">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationServer04">State</label>
<input type="text" class="form-control is-invalid" id="validationServer04" placeholder="State" required>
<div class="invalid-feedback">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationServer05">Zip</label>
<input type="text" class="form-control is-invalid" id="validationServer05" placeholder="Zip" required>
<div class="invalid-feedback">
Please provide a valid zip.
</div>
</div>
</div>
<div class="form-group">
<div class="form-check">
<input class="form-check-input is-invalid" type="checkbox" value="" id="invalidCheck3" required>
<label class="form-check-label" for="invalidCheck3">
Agree to terms and conditions
</label>
<div class="invalid-feedback">
You must agree before submitting.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
Mūsų pavyzdinėse formose rodomi pirmiau pateikti vietiniai tekstiniai <input>
tekstai, tačiau formų patvirtinimo stiliai taip pat galimi mūsų pasirinktiniuose formų valdikliuose.
<form class="was-validated">
<div class="custom-control custom-checkbox mb-3">
<input type="checkbox" class="custom-control-input" id="customControlValidation1" required>
<label class="custom-control-label" for="customControlValidation1">Check this custom checkbox</label>
<div class="invalid-feedback">Example invalid feedback text</div>
</div>
<div class="custom-control custom-radio">
<input type="radio" class="custom-control-input" id="customControlValidation2" name="radio-stacked" required>
<label class="custom-control-label" for="customControlValidation2">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio mb-3">
<input type="radio" class="custom-control-input" id="customControlValidation3" name="radio-stacked" required>
<label class="custom-control-label" for="customControlValidation3">Or toggle this other custom radio</label>
<div class="invalid-feedback">More example invalid feedback text</div>
</div>
<div class="form-group">
<select class="custom-select" required>
<option value="">Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<div class="invalid-feedback">Example invalid custom select feedback</div>
</div>
<div class="custom-file">
<input type="file" class="custom-file-input" id="validatedCustomFile" required>
<label class="custom-file-label" for="validatedCustomFile">Choose file...</label>
<div class="invalid-feedback">Example invalid custom file feedback</div>
</div>
</form>
Jei formos išdėstymas tai leidžia, galite sukeisti .{valid|invalid}-feedback
klases į .{valid|invalid}-tooltip
klases, 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.
<form class="needs-validation" novalidate>
<div class="form-row">
<div class="col-md-4 mb-3">
<label for="validationTooltip01">First name</label>
<input type="text" class="form-control" id="validationTooltip01" placeholder="First name" value="Mark" required>
<div class="valid-tooltip">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationTooltip02">Last name</label>
<input type="text" class="form-control" id="validationTooltip02" placeholder="Last name" value="Otto" required>
<div class="valid-tooltip">
Looks good!
</div>
</div>
<div class="col-md-4 mb-3">
<label for="validationTooltipUsername">Username</label>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text" id="validationTooltipUsernamePrepend">@</span>
</div>
<input type="text" class="form-control" id="validationTooltipUsername" placeholder="Username" aria-describedby="validationTooltipUsernamePrepend" required>
<div class="invalid-tooltip">
Please choose a unique and valid username.
</div>
</div>
</div>
</div>
<div class="form-row">
<div class="col-md-6 mb-3">
<label for="validationTooltip03">City</label>
<input type="text" class="form-control" id="validationTooltip03" placeholder="City" required>
<div class="invalid-tooltip">
Please provide a valid city.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationTooltip04">State</label>
<input type="text" class="form-control" id="validationTooltip04" placeholder="State" required>
<div class="invalid-tooltip">
Please provide a valid state.
</div>
</div>
<div class="col-md-3 mb-3">
<label for="validationTooltip05">Zip</label>
<input type="text" class="form-control" id="validationTooltip05" placeholder="Zip" required>
<div class="invalid-tooltip">
Please provide a valid zip.
</div>
</div>
</div>
<button class="btn btn-primary" type="submit">Submit form</button>
</form>
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.
Kiekvienas žymimasis laukelis ir radijas yra supakuoti į a <div>
su broliu ir seserimi <span>
, kad būtų sukurtas pasirinktinis valdiklis ir <label>
pridedamam tekstui a. 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 :checked
tinkamai pritaikyti tinkintos formos indikatorių. Kartu su .custom-control-label
klase taip pat galime sukurti kiekvieno elemento teksto stilių pagal <input>
būseną.
Paslėpiame numatytąjį nustatymą <input>
ir opacity
naudojame , .custom-control-label
kad sukurtume naują tinkintos formos indikatorių jo vietoje naudodami ::before
ir ::after
. Deja, negalime sukurti tinkinto vien tik iš šio elemento, <input>
nes CSS content
neveikia šio elemento.
Pažymėtose būsenose naudojame base64 įterptas SVG piktogramas iš Open Iconic . Taip galime geriausiai valdyti stilių ir padėties nustatymą naršyklėse ir įrenginiuose.
<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>
Pasirinktiniai žymimieji laukeliai taip pat gali naudoti :indeterminate
pseudo klasę, kai jie nustatomi rankiniu būdu naudojant „JavaScript“ (nėra pasiekiamo HTML atributo jai nurodyti).
Jei naudojate jQuery, turėtų pakakti tokio dalyko:
<div class="custom-control custom-radio">
<input type="radio" id="customRadio1" name="customRadio" class="custom-control-input">
<label class="custom-control-label" for="customRadio1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio">
<input type="radio" id="customRadio2" name="customRadio" class="custom-control-input">
<label class="custom-control-label" for="customRadio2">Or toggle this other custom radio</label>
</div>
<div class="custom-control custom-radio custom-control-inline">
<input type="radio" id="customRadioInline1" name="customRadioInline1" class="custom-control-input">
<label class="custom-control-label" for="customRadioInline1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio custom-control-inline">
<input type="radio" id="customRadioInline2" name="customRadioInline1" class="custom-control-input">
<label class="custom-control-label" for="customRadioInline2">Or toggle this other custom radio</label>
</div>
Taip pat galima išjungti pasirinktinius žymimuosius laukelius ir radijo imtuvus. Pridėkite disabled
loginį 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="customCheckDisabled" disabled>
<label class="custom-control-label" for="customCheckDisabled">Check this custom checkbox</label>
</div>
<div class="custom-control custom-radio">
<input type="radio" id="radio3" name="radioDisabled" id="customRadioDisabled" class="custom-control-input" disabled>
<label class="custom-control-label" for="customRadioDisabled">Toggle this custom radio</label>
</div>
Pasirinktiniams <select>
meniu reikia tik tinkintos klasės, .custom-select
kad suaktyvintų pasirinktinius stilius.
<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>
multiple
Atributas 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 size
atributas:
<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>
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 nurodome a ir , kad aplinkiniam turiniui būtų tinkami tarpai.opacity
<label>
::after
width
height
<input>
Pseudoklasė :lang()
naudojama norint išversti „Naršyti“ tekstą į kitas kalbas. Nepaisykite arba pridėkite Sass kintamojo įrašus $custom-file-text
su 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
):
Š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ą lang
arba<html>
HTTP Content-Language
antraštę , be kitų metodų.