Botons
Utilitzeu els estils de botons personalitzats de Bootstrap per a accions en formularis, diàlegs i més amb suport per a diverses mides, estats i molt més.
Bootstrap inclou diversos estils de botons predefinits, cadascun amb el seu propi propòsit semàntic, amb alguns extres incorporats per a més control.
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-secondary">Secondary</button>
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-light">Light</button>
<button type="button" class="btn btn-dark">Dark</button>
<button type="button" class="btn btn-link">Link</button>
Transmetre significat a les tecnologies d'assistència
L'ús del color per afegir significat només proporciona una indicació visual, que no es transmetrà als usuaris de tecnologies d'assistència, com ara lectors de pantalla. Assegureu-vos que la informació indicada pel color sigui òbvia del contingut en si (per exemple, el text visible) o s'inclogui mitjançant mitjans alternatius, com ara text addicional amagat amb la .sr-only
classe.
Les .btn
classes estan dissenyades per ser utilitzades amb l' <button>
element. Tanmateix, també podeu utilitzar aquestes classes en <a>
o <input>
elements (tot i que alguns navegadors poden aplicar una representació lleugerament diferent).
Quan s'utilitzen classes de botons en <a>
elements que s'utilitzen per activar la funcionalitat de la pàgina (com ara col·lapsar el contingut), en lloc d'enllaçar a pàgines o seccions noves dins de la pàgina actual, aquests enllaços s'han de donar una role="button"
opció per transmetre adequadament el seu propòsit a tecnologies d'assistència com ara lectors de pantalla.
<a class="btn btn-primary" href="#" role="button">Link</a>
<button class="btn btn-primary" type="submit">Button</button>
<input class="btn btn-primary" type="button" value="Input">
<input class="btn btn-primary" type="submit" value="Submit">
<input class="btn btn-primary" type="reset" value="Reset">
Necessites un botó, però no els intensos colors de fons que aporten? Substituïu les classes de modificadors predeterminades per .btn-outline-*
les per eliminar totes les imatges i colors de fons de qualsevol botó.
<button type="button" class="btn btn-outline-primary">Primary</button>
<button type="button" class="btn btn-outline-secondary">Secondary</button>
<button type="button" class="btn btn-outline-success">Success</button>
<button type="button" class="btn btn-outline-danger">Danger</button>
<button type="button" class="btn btn-outline-warning">Warning</button>
<button type="button" class="btn btn-outline-info">Info</button>
<button type="button" class="btn btn-outline-light">Light</button>
<button type="button" class="btn btn-outline-dark">Dark</button>
Voleu botons més grans o més petits? Afegiu .btn-lg
o .btn-sm
per a mides addicionals.
<button type="button" class="btn btn-primary btn-lg">Large button</button>
<button type="button" class="btn btn-secondary btn-lg">Large button</button>
<button type="button" class="btn btn-primary btn-sm">Small button</button>
<button type="button" class="btn btn-secondary btn-sm">Small button</button>
Creeu botons de nivell de bloc, els que abasten tota l'amplada d'un pare, afegint .btn-block
.
<button type="button" class="btn btn-primary btn-lg btn-block">Block level button</button>
<button type="button" class="btn btn-secondary btn-lg btn-block">Block level button</button>
Els botons apareixeran premuts (amb un fons més fosc, una vora més fosca i una ombra inserida) quan estiguin actius. No cal afegir una classe a <button>
s ja que utilitzen una pseudo-classe . Tanmateix, encara podeu forçar la mateixa aparença activa amb .active
(i incloure l' aria-pressed="true"
atribut) si necessiteu replicar l'estat programadament.
<a href="#" class="btn btn-primary btn-lg active" role="button" aria-pressed="true">Primary link</a>
<a href="#" class="btn btn-secondary btn-lg active" role="button" aria-pressed="true">Link</a>
Feu que els botons semblin inactius afegint l' disabled
atribut booleà a qualsevol <button>
element.
<button type="button" class="btn btn-lg btn-primary" disabled>Primary button</button>
<button type="button" class="btn btn-secondary btn-lg" disabled>Button</button>
Els botons desactivats que utilitzen l' <a>
element es comporten una mica diferent:
<a>
s no admeten l'disabled
atribut, de manera que heu d'afegir la.disabled
classe perquè sembli visualment desactivada.- S'inclouen alguns estils futurs per desactivar tots
pointer-events
els botons d'ancoratge. Als navegadors que admeten aquesta propietat, no veureu en absolut el cursor desactivat. - Els botons desactivats haurien d'incloure l'
aria-disabled="true"
atribut per indicar l'estat de l'element a les tecnologies d'assistència.
<a href="#" class="btn btn-primary btn-lg disabled" role="button" aria-disabled="true">Primary link</a>
<a href="#" class="btn btn-secondary btn-lg disabled" role="button" aria-disabled="true">Link</a>
Advertència sobre la funcionalitat de l'enllaç
La .disabled
classe fa servir pointer-events: none
per intentar desactivar la funcionalitat d'enllaç de <a>
s, però aquesta propietat CSS encara no està estandarditzada. A més, fins i tot en navegadors que admeten pointer-events: none
, la navegació amb el teclat no es veu afectada, el que significa que els usuaris de teclat vidents i els usuaris de tecnologies d'assistència encara podran activar aquests enllaços. Així que per estar segur, afegiu un tabindex="-1"
atribut en aquests enllaços (per evitar que rebin el focus del teclat) i utilitzeu JavaScript personalitzat per desactivar la seva funcionalitat.
Fes més amb els botons. Controla els estats dels botons o crea grups de botons per a més components com ara barres d'eines.
Afegeix data-toggle="button"
per canviar l'estat d'un botó active
. Si esteu activant un botó prèviament, heu d'afegir manualment la .active
classe i aria-pressed="true"
al fitxer <button>
.
<button type="button" class="btn btn-primary" data-toggle="button" aria-pressed="false" autocomplete="off">
Single toggle
</button>
Els estils de Bootstrap .button
es poden aplicar a altres elements, com ara <label>
s, per proporcionar la commutació de la casella de selecció o el botó d'estil de ràdio. Afegiu data-toggle="buttons"
a un .btn-group
que conté els botons modificats per habilitar el seu comportament de commutació mitjançant JavaScript i afegiu -hi .btn-group-toggle
per estilitzar les <input>
s dels vostres botons. Tingueu en compte que podeu crear botons d'entrada únics o grups d'ells.
L'estat marcat d'aquests botons només s'actualitza mitjançant click
un esdeveniment al botó. Si utilitzeu un altre mètode per actualitzar l'entrada, per exemple, amb <input type="reset">
o aplicant manualment la checked
propietat de l'entrada, haureu d'activar .active
-la <label>
manualment.
Tingueu en compte que els botons marcats prèviament requereixen que afegiu manualment la .active
classe a l'entrada <label>
.
<div class="btn-group-toggle" data-toggle="buttons">
<label class="btn btn-secondary active">
<input type="checkbox" checked autocomplete="off"> Checked
</label>
</div>
<div class="btn-group btn-group-toggle" data-toggle="buttons">
<label class="btn btn-secondary active">
<input type="radio" name="options" id="option1" autocomplete="off" checked> Active
</label>
<label class="btn btn-secondary">
<input type="radio" name="options" id="option2" autocomplete="off"> Radio
</label>
<label class="btn btn-secondary">
<input type="radio" name="options" id="option3" autocomplete="off"> Radio
</label>
</div>
Mètode | Descripció |
---|---|
$().button('toggle') |
Commuta l'estat push. Dóna al botó l'aspecte que s'ha activat. |
$().button('dispose') |
Destrueix el botó d'un element. |