CSS: form-field ​

.instui-form-field — غلاف لحقل النموذج: تسمية، عناصر التحكم الخاصة به، وتخطيطات متتالية أو مدمجة أو للقراءة فقط.

تبقى رسالة الخطأ مخفية حتى يصبح عنصر التحكم في الحقل :user-invalid (بعد تفاعل المستخدم) أو تضيف الفئة -invalid. استخدم -layout-inline لوضع التسمية بجانب عناصر التحكم و-layout-stacked لوضعها أعلاه. كما يحدد أيضًا gap خاصًا بين التسمية، عناصر التحكم، والرسائل؛ سيتجاوز ربط مُعدِّل مسافة من نوع -gap-* تلك القيمة المضمّنة.

Source: form-field.css

سهولة الوصول ​

يغلف عنصر <label> عنصر التحكم، لذا فإن نص التسمية يُسميه بشكل أصلي؛ النجمة الدالة على الإلزامية تجميلية ويجب إخفاؤها عن تقنيات المساعدة (aria-hidden)، وتظهر رسالة الخطأ بمجرد أن يصبح عنصر التحكم :user-invalid أو تضيف الفئة -invalid.

الاستخدام ​

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

أمثلة ​

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

الهيكل ​

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

المعدّلات ​

معدّلالوصف
.-inlineتخطيط مدمج (اختصار لـ -layout-inline).
.-invalidحالة غير صالحة (خطأ).
.-label-align-endمحاذاة نص التسمية إلى النهاية.
.-label-align-startمحاذاة نص التسمية إلى البداية.
.-layout-inlineتخطيط مدمج: التسمية بجانب عناصر التحكم.
.-layout-stackedتخطيط مكدس: التسمية فوق عناصر التحكم.
.-readonlyحالة للقراءة فقط.
.-v-align-bottomمحاذاة التسمية إلى أسفل مع عناصر التحكم.
.-v-align-topمحاذاة التسمية إلى الأعلى مع عناصر التحكم.

الأجزاء ​

جزءالوصف
.controlsمنطقة عناصر التحكم بجانب أو أسفل التسمية.
.labelتسمية الحقل.

عناصر زائفة ​

عنصر زائفالوصف
::afterيعرض النجمة الزخرفية لحقل الإلزام بعد نص التسمية عندما يكون الحقل مطلوبًا.

الحالات ​

حالةالوصف
:required—

الرموز المستهلكة ​

Tokenنوعقيمة
--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)

دعم المتصفّح ​

  • يحتوي على أنماط عناصره باستخدام توجيه CSS @scope؛ يتطلب إصدارًا حديثًا من Chromium أو Firefox أو Safari.

مكونات فرعية ​

ذات صلة ​

  • form-field-messages — يعرض تعليمات الحقل ورسائل الخطأ والنجاح.
  • form-field-group — يجمع الحقول المتعلقة تحت تسمية مشتركة.