CSS: form-field

.instui-form-field — Bir form alanı kapsayıcısı: bir etiket, ilgili denetimleri ve satır içi, zorunlu veya salt okunur düzenleri.

Bir hata mesajı, alanın denetimi :user-invalid olana kadar (kullanıcı etkileşimde bulunduktan sonra) gizli kalır veya -invalid sınıfını eklersiniz. Etiketi denetimlerin yanına koymak için -layout-inline, üstüne koymak için -layout-stacked kullanın. Ayrıca etiket, denetimler ve mesajlar arasında kendi gap değerini ayarlar; bir -gap-* boşluk yardımcı modifikatörü zincirlendiğinde bu dahili değer üzerine yazılır.

Source: form-field.css

Erişilebilirlik

<label> elementi denetimi sarar, böylece etiket metni onu doğal olarak adlandırır; zorunlu yıldız işareti dekoratiftir ve yardımcı teknolojiden gizlenmelidir (aria-hidden) ve hata mesajı denetim :user-invalid olduğunda veya -invalid sınıfını eklediğinizde görünür hale gelir.

Kullanım

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

Örnekler

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

Yapı

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

Değiştiriciler

Değiştirici	Açıklama
.-inline	Satır içi düzen (-layout-inline için kısaltma).
.-invalid	Geçersiz (hata) durumu.
.-label-align-end	Etiket metnini sona dayalı hizala.
.-label-align-start	Etiket metnini başa dayalı hizala.
.-layout-inline	Satır içi düzen: etiket denetimlerin yanında.
.-layout-stacked	Yığılı düzen: etiket denetimlerin üzerinde.
.-readonly	Salt okunur durum.
.-v-align-bottom	Etiketi denetimlerle alt kenara hizala.
.-v-align-top	Etiketi denetimlerle üst kenara hizala.

Bölümler

Parça	Açıklama
.controls	Etiketin yanında veya altında bulunan denetim alanı.
.label	Alan etiketi.

Sözde elemanlar

Sözde eleman	Açıklama
::after	Alan zorunluysa, etiket metninin sonuna dekoratif zorunlu alan yıldızını render eder.

Durumlar

Durum	Açıklama
:required	—

Tüketilen tokenler

Token	Tür	Değer
--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)

Tarayıcı desteği

• CSS @scope at-kuralı ile öğe stillerini içerir; güncel bir Chromium, Firefox veya Safari gerektirir.

Alt bileşenler

• form-field-messages
• text-input

İlgili

• form-field-messages — Alanın ipucunu, hata ve başarı mesajlarını render eder.
• form-field-group — İlgili alanları ortak bir başlık (legend) altında gruplar.