CSS: form-field

.instui-form-field — Lomakekentän kääre: etiketti, sen ohjaimet sekä rivissä, pakollisena tai vain-luku -asettelut.

Virheilmoitus pysyy piilotettuna, kunnes kentän ohjain on :user-invalid (käyttäjän oltua tekemisissä) tai lisäät -invalid-luokan. Käytä -layout-inline asettaaksesi etiketin ohjainten viereen ja -layout-stacked asettaaksesi sen yläpuolelle. Määrittää myös oman gap etiketin, ohjainten ja viestien välille; kun ketjutat -gap-*-välinapautteen, se korvaa sisäänrakennetun arvon.

Source: form-field.css

Saavutettavuus

<label>-elementti käärii ohjaimen, joten etiketin teksti nimeää sen natiivisti; pakollinen tähti on koristeellinen ja tulisi piilottaa avustavilta teknologioilta (aria-hidden), ja virheilmoitus näkyy, kun ohjain on :user-invalid tai lisäät -invalid-luokan.

Käyttö

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

Esimerkit

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

Rakenne

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

Muokkaajat

Muokkaaja	Kuvaus
.-inline	Riviasettelu (lyhenne -layout-inline-elementille).
.-invalid	Virheellinen (virhe) tila.
.-label-align-end	Tasaa etiketin teksti loppuun (oikealle).
.-label-align-start	Tasaa etiketin teksti alkuun (vasemmalle).
.-layout-inline	Riviasettelu: etiketti ohjainten vieressä.
.-layout-stacked	Pinottu asettelu: etiketti ohjainten yläpuolella.
.-readonly	Vain-luku -tila.
.-v-align-bottom	Tasaa etiketti ohjainten alareunaan.
.-v-align-top	Tasaa etiketti ohjainten yläreunaan.

Osat

Osa	Kuvaus
.controls	Ohjainalue, joka sijaitsee etiketin vieressä tai alla.
.label	Kentän etiketti.

Pseudo-elementit

Pseudo-elementti	Kuvaus
::after	Renderöi koristeellisen pakollisen kenttä tähden etiketin tekstin jälkeen, kun kenttä on pakollinen.

Tilat

Tila	Kuvaus
:required	—

Käytetyt tokenit

Token	Tyyppi	Arvo
--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)

Selaintuki

• Sisältää elementtityylinsä CSS:n @scope-at-säännöllä; vaatii tuoreen Chromium-, Firefox- tai Safari-version.

Alikomponentit

• form-field-messages
• text-input

Liittyvät

• form-field-messages — Renderöi kentän vihje-, virhe- ja onnistumisviestit.
• form-field-group — Ryhmittelee toisiinsa liittyvät kentät yhteisen legendan alle.