CSS: form-field

.instui-form-field — En wrapper til et formularfelt: et label, dets controls og inline-, required- eller readonly-layouts.

En fejlmeddelelse forbliver skjult, indtil feltets control er :user-invalid (efter brugerinteraktion) eller du tilføjer klassen -invalid. Brug -layout-inline for at placere label ved siden af controls og -layout-stacked for at placere det ovenover. Sætter også sit eget gap mellem label, controls og meddelelser; kædning af en -gap-* spacing-utility-modifier overskriver den indbyggede værdi.

Source: form-field.css

Tilgængelighed

<label>-elementet omslutter controlen, så label-teksten navngiver den nativt; det påkrævede asterisk er dekorativ og bør være skjult for assistiv teknologi (aria-hidden), og fejlmeddelelsen vises, når controlen er :user-invalid eller du tilføjer klassen -invalid.

Brug

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

Eksempler

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

Struktur

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

Modifikatorer

Modifikator	Beskrivelse
.-inline	Inline-layout (kortform for -layout-inline).
.-invalid	Ugyldig (fejl) tilstand.
.-label-align-end	Justér label-teksten mod enden.
.-label-align-start	Justér label-teksten mod starten.
.-layout-inline	Inline-layout: label ved siden af controls.
.-layout-stacked	Stablet layout: label over controls.
.-readonly	Skrivebeskyttet tilstand.
.-v-align-bottom	Bundjuster labelen med controls.
.-v-align-top	Topjuster labelen med controls.

Dele

Del	Beskrivelse
.controls	Kontrolområdet ved siden af eller under labelen.
.label	Feltets label.

Pseudo-elementer

Pseudo-element	Beskrivelse
::after	Renderer det dekorative påkrævede-asterisk efter label-teksten, når feltet er påkrævet.

Tilstande

Tilstand	Beskrivelse
:required	—

Forbrugte tokens

Token	Type	Værdi
--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)

Browserunderstøttelse

• Indeholder sine elementstilarter med CSS @scope at‑reglen; kræver en nyere Chromium-, Firefox‑ eller Safari‑version.

Underkomponenter

• form-field-messages
• text-input

Relateret

• form-field-messages — Renderer feltets hint-, fejl- og succesmeddelelser.
• form-field-group — Grupperer relaterede felter under en fælles legend.