CSS: form-field

.instui-form-field — Pembungkus medan borang: label, kawalannya, dan susun atur selari (inline), wajib, atau baca-sahaja.

Mesej ralat tetap tersembunyi sehingga kawalan medan menjadi :user-invalid (selepas pengguna berinteraksi) atau anda menambah kelas -invalid. Gunakan -layout-inline untuk meletakkan label di sisi kawalan dan -layout-stacked untuk meletakkannya di atas. Juga menetapkan gap tersendiri antara label, kawalan, dan mesej; rantai mod pemodifikasi jarak -gap-* menggantikan nilai terbina itu.

Source: form-field.css

Aksesibiliti

Elemen <label> membalut kawalan, jadi teks label menamainya secara asli; asterisk wajib adalah hiasan dan harus disembunyikan dari teknologi bantuan (aria-hidden), dan mesej ralat dipaparkan setelah kawalan menjadi :user-invalid atau anda menambah kelas -invalid.

Penggunaan

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

Contoh

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

Pemodifikasi

Pemodifikasi	Penerangan
.-inline	Susun atur selari (pendek untuk -layout-inline).
.-invalid	Keadaan tidak sah (ralat).
.-label-align-end	Petak teks label diselaraskan ke hujung (akhir).
.-label-align-start	Petak teks label diselaraskan ke permulaan.
.-layout-inline	Susun atur selari: label di sebelah kawalan.
.-layout-stacked	Susun atur bertindan: label di atas kawalan.
.-readonly	Keadaan baca-sahaja.
.-v-align-bottom	Selaraskan label di bahagian bawah berbanding kawalan.
.-v-align-top	Selaraskan label di bahagian atas berbanding kawalan.

Bahagian

Bahagian	Penerangan
.controls	Kawasan kawalan di sebelah atau di bawah label.
.label	Label medan.

Pseudo-elemen

Pseudo-elemen	Penerangan
::after	Membentangkan asterisk hiasan untuk medan wajib selepas teks label apabila medan itu diwajibkan.

Keadaan

Keadaan	Penerangan
:required	—

Token digunakan

Token	Jenis	Nilai
--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)

Sokongan pelayar

• Mengandungi gaya elemennya dengan at-perintah CSS @scope; memerlukan Chromium, Firefox, atau Safari versi terkini.

Subkomponen

• form-field-messages
• text-input

Berkaitan

• form-field-messages — Membentangkan mesej petunjuk, ralat, dan kejayaan medan.
• form-field-group — Mengumpulkan medan berkaitan di bawah legenda yang dikongsi.