CSS: checkbox ​

.instui-checkbox — Eine native Checkbox und ihr Label, oder ein Schalter via -variant-toggle.

Setze el.indeterminate = true in JavaScript, um den Strich für den gemischten Zustand anzuzeigen; das angekreuzte Häkchen kontrastiert automatisch gegen die Füllfarbe — weiß auf dunkler Füllung, fast schwarz auf heller. Setzt außerdem sein eigenes gap zwischen Steuerung und Label; das Hintereinanderschalten eines -gap-*-Abstands-Utility-Modifikators überschreibt diesen eingebauten Wert.

Source: checkbox.css

Barrierefreiheit ​

Eine native <input type="checkbox"> steuert :checked, :indeterminate und :disabled; setze el.indeterminate = true in JavaScript für den gemischten Zustand, und beachte, dass -readonly nur Styling ist, da Checkboxen kein natives readonly-Attribut haben.

Verwendung ​

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/checkbox.css";

Beispiele ​

html
<label class="instui-checkbox --display-block --mb-sm">
  <input type="checkbox" checked>Checkbox
</label>
<label class="instui-checkbox -variant-toggle">
  <input type="checkbox">Toggle
</label>

Modifikatoren ​

ModifikatorBeschreibung
.-invalidUngültiger (Fehler-)Zustand.
.-label-placement-endLabel nach der Steuerung platzieren.
.-label-placement-startLabel vor der Steuerung platzieren.
.-label-placement-topLabel über der Steuerung platzieren.
.-readonlyNur-Lese-Zustand.
.-requiredSternchen für Pflichtfeld neben dem Label anzeigen.
.-size-largeGroß. Langform-Alias von -size-lg.
.-size-lgGroß.
.-size-smKlein.
.-size-smallKlein. Langform-Alias von -size-sm.
.-variant-toggleAls Schalter statt als Feld darstellen.

Teile ​

TeilBeschreibung
.asteriskDas Sternchen für Pflichtfelder.

Pseudo-Elemente ​

Pseudo-ElementBeschreibung
::afterBei -variant-toggle das Zustandsglyph auf dem Griff: ein X, wenn aus; ein Häkchen, wenn an.
::beforeDas maskierte Häkchen- oder Strich-Glyph, zentriert im Feld; bei -variant-toggle wird es stattdessen zum gleitenden Griff.

Zustände ​

ZustandBeschreibung
:checked—
:disabled—
:indeterminate—

Benutzerdefinierte Eigenschaften ​

EigenschaftTypStandardBeschreibung
--pantoken-cb-glyph<url>—Das Masken-Glyph des Feldes: ein Häkchen, wenn angekreuzt; ein Strich, wenn unbestimmt.
--pantoken-toggle-bw<length>—Die Rahmenbreite des Schalters.
--pantoken-toggle-h<length>—Die Höhe des Schalters.
--pantoken-toggle-handle<length>—Der berechnete Griffdurchmesser.
--pantoken-toggle-inset<length>—Der Einzug des Griffs vom jeweiligen Schienenrand.
--pantoken-toggle-w<length>—Die Schienenbreite des Schalters.

Verbrauchte Tokens ​

TokenTypWert
--instui-border-width-sm<length>0.0625rem
--instui-color-background-muted<color>LightDarklight-dark(#F2F4F5, #273540)
--instui-color-stroke-base<color>LightDarklight-dark(#8D959F, #6A7883)
--instui-color-text-muted<color>LightDarklight-dark(#576773, #AAB0B5)
--instui-component-checkbox-asterisk-color<color>LightDarklight-dark(#CF1F24, #FA917F)
--instui-component-checkbox-background-checked-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-background-color<color>LightDarklight-dark(#ffffff, #171B21)
--instui-component-checkbox-background-disabled-color<color>LightDarklight-dark(#E8EAEC, #334450)
--instui-component-checkbox-background-hover-color<color>LightDarklight-dark(#ffffff, #171B21)
--instui-component-checkbox-background-readonly-color<color>LightDarklight-dark(#C7CACD, #6A7883)
--instui-component-checkbox-border-checked-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-border-color<color>LightDarklight-dark(#7E8792, #5F6E7A)
--instui-component-checkbox-border-disabled-color<color>LightDarklight-dark(#C7CACD, #4A5B68)
--instui-component-checkbox-border-hover-color<color>LightDarklight-dark(#334450, #7E8792)
--instui-component-checkbox-border-radius<length>0.25rem
--instui-component-checkbox-border-readonly-color<color>#8D959F
--instui-component-checkbox-border-width<length>0.0625rem
--instui-component-checkbox-control-size-lg<length>1.5rem
--instui-component-checkbox-control-size-md<length>1.5rem
--instui-component-checkbox-control-size-sm<length>1.5rem
--instui-component-checkbox-control-vertical-margin<length>0rem
--instui-component-checkbox-error-border-color<color>LightDarklight-dark(#CF1F24, #F56050)
--instui-component-checkbox-error-border-hover-color<color>LightDarklight-dark(#CF1F24, #FE7D6A)
--instui-component-checkbox-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-checkbox-font-size-lg<length>1.25rem
--instui-component-checkbox-font-size-md<length>1rem
--instui-component-checkbox-font-size-sm<length>0.875rem
--instui-component-checkbox-font-weight<integer>400
--instui-component-checkbox-gap<length>0.5rem
--instui-component-checkbox-label-base-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-label-disabled-color<color>LightDarklight-dark(#8D959F, #576773)
--instui-component-checkbox-label-hover-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-label-readonly-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-checkbox-line-height<percentage>125%
--instui-component-radio-input-toggle-background-success<color>#03893D
--instui-component-radio-input-toggle-handle-text<color>#ffffff
--instui-component-radio-input-toggle-medium-height<length>2.5rem
--instui-icon-check<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M20%206%209%2017l-5-5%22%2F%3E%3C%2Fsvg%3E')
--instui-icon-minus<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M5%2012h14%22%2F%3E%3C%2Fsvg%3E')
--instui-icon-x<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M18%206%206%2018%22%2F%3E%3Cpath%20d%3D%22m6%206%2012%2012%22%2F%3E%3C%2Fsvg%3E')
--instui-size-choice-control-height-md<length>1.5rem

Verwandt ​

  • radio — Das Gegenstück für Einzelauswahl.