CSS: form-field

.instui-form-field — ovojnica polja obrazca: oznaka, pripadajoči kontrolniki ter postavitve v vrstici, obvezno ali samo-za-branje.

Sporočilo o napaki ostane skrito, dokler kontrolnik polja ni :user-invalid (po interakciji uporabnika) ali dokler ne dodate razreda -invalid. Uporabite -layout-inline, da postavite oznako poleg kontrolnikov, in -layout-stacked, da jo postavite nad njimi. Prav tako nastavi svoj gap med oznako, kontrolniki in sporočili; z verižnim uporabo pripomočka za razmik -gap-* se prekine ta vgrajena vrednost.

Source: form-field.css

Dostopnost

Element <label> ovije kontrolnik, zato ga besedilo oznake nativno poimenuje; zvezdica za obvezno polje je dekorativna in jo je treba skriti pred pomožno tehnologijo (aria-hidden), sporočilo o napaki pa se prikaže, ko je kontrolnik :user-invalid ali ko dodate razred -invalid.

Uporaba

@import "@pantoken/components/components.css";
@import "@pantoken/components/form-field.css";

Primeri

<label class="instui-form-field">
  <span class="label">Email address</span>
  <span class="controls"><input class="instui-text-input" type="email" placeholder="[email protected]"></span>
  <div class="instui-form-field-messages">
    <span class="instui-form-field-message -type-hint">We'll never share it.</span>
    <span class="instui-form-field-message -type-error">Enter a valid email address.</span>
  </div>
</label>

Struktura

.instui-form-field
  .label
  .controls
    text-input (component)
  form-field-messages (component)

flowchart TD n0[".instui-form-field"]:::cssdoc-root n1(".label"):::cssdoc-part n2(".controls"):::cssdoc-part n3(["text-input"]):::cssdoc-component n4(["form-field-messages"]):::cssdoc-component n0 --> n1 n2 --> n3 n0 --> n2 n0 --> n4 click n3 "/api/css/text-input.md" click n4 "/api/css/form-field-messages.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Spremenljivke (modifikatorji)

Modifikator	Opis
.-inline	Postavitev v vrstici (kratica za -layout-inline).
.-invalid	Neveljavno (napaka).
.-label-align-end	Poravnajte besedilo oznake ob koncu.
.-label-align-start	Poravnajte besedilo oznake na začetek.
.-layout-inline	Postavitev v vrstici: oznaka poleg kontrolnikov.
.-layout-stacked	Zložena postavitev: oznaka nad kontrolniki.
.-readonly	Stanje samo za branje.
.-v-align-bottom	Poravnajte oznako navzdol s kontrolniki.
.-v-align-top	Poravnajte oznako navzgor s kontrolniki.

Delii

Del	Opis
.controls	Področje kontrolnikov poleg ali pod oznako.
.label	Oznaka polja.

Psevdo-elementi

Psevdo-element	Opis
::after	Prikaže dekorativno zvezdico za obvezno polje za oznako, ko je polje obvezno.

Stanja

Stanje	Opis
:required	—

Porabljeni žetoni

Token	Tip	Vrednost
--instui-component-form-field-layout-asterisk-color	<color>	LightDarklight-dark(#CF1F24, #FA917F)
--instui-component-form-field-layout-font-family	[ <font-family-name> | <generic-font-family> ]#	Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-form-field-layout-font-size	<length>	1rem
--instui-component-form-field-layout-font-weight	<integer>	400
--instui-component-form-field-layout-gap-inputs	<length>	0.75rem
--instui-component-form-field-layout-gap-primitives	<length>	0.5rem
--instui-component-form-field-layout-line-height	<length>	1.125rem
--instui-component-form-field-layout-readonly-text-color	<color>	LightDarklight-dark(#576773, #AAB0B5)
--instui-component-form-field-layout-text-color	<color>	LightDarklight-dark(#273540, #ffffff)

Podpora brskalnika

• Vsebuje sloge elementa z CSS @scope at-pravilom; zahteva sodoben Chromium, Firefox ali Safari.

Podkomponente

• form-field-messages
• text-input

Sorodno

• form-field-messages — Prikaže namig, napako in sporočila o uspehu polja.
• form-field-group — Združi sorodna polja pod skupno legendo.