CSS: form-field-messages ​

.instui-form-field-messages — رسائل مساعدة الحقل والتحقق — تلميح، خطأ، نجاح، والنسخة المخصصة لقراءة الشاشة — مع رمز مرئي (glyph) عند الخطأ والنجاح.

يحدد gap الخاص به بين الرسائل المتتابعة؛ ربط مُعدِّل تباعد -gap-* يتجاوز تلك القيمة المضمنة.

Source: form-field-messages.css

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

رسالة -type-screenreader-only مخفية بصريًا لكنها تبقى في شجرة الوصول (accessibility tree)، لذلك ما زال يتم الإعلان عنها؛ قم بإقران رسائل الخطأ والنجاح بالحقل عبر aria-describedby حتى تقرأها تقنيات المساعدة مع عنصر التحكم.

الاستخدام ​

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

أمثلة ​

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

الهيكل ​

text
.instui-form-field-messages
  .instui-form-field-message
flowchart TD n0[".instui-form-field-messages"]:::cssdoc-root n1(".instui-form-field-message"):::cssdoc-part n0 --> n1 classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

المعدّلات ​

معدّلالوصف
.-type-new-errorAlias — maps to .-type-error.

الأجزاء ​

جزءالوصف
.instui-form-field-messageرسالة فردية؛ يختار -type-* فيها المتغير تلميح أو خطأ أو نجاح أو المخصص لقراءة الشاشة.

عناصر زائفة ​

عنصر زائفالوصف
::beforeيعرض الرمز الحالة الرائد في رسائل الخطأ والنجاح: دائرة تنبيه للأخطاء ودائرة علامة صح للنجاح.

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

Tokenنوعقيمة
--instui-component-form-field-layout-gap-primitives<length>0.5rem
--instui-component-form-field-message-error-text-color<color>LightDarklight-dark(#CF1F24, #FA917F)
--instui-component-form-field-message-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-form-field-message-font-size<length>0.875rem
--instui-component-form-field-message-font-weight<integer>400
--instui-component-form-field-message-hint-text-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-component-form-field-message-line-height<length>1.25rem
--instui-component-form-field-message-success-text-color<color>LightDarklight-dark(#037D37, #61C378)
--instui-icon-circle-alert<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Ccircle%20cx%3D%2212%22%20cy%3D%2212%22%20r%3D%2210%22%2F%3E%3Cline%20x1%3D%2212%22%20x2%3D%2212%22%20y1%3D%228%22%20y2%3D%2212%22%2F%3E%3Cline%20x1%3D%2212%22%20x2%3D%2212.01%22%20y1%3D%2216%22%20y2%3D%2216%22%2F%3E%3C%2Fsvg%3E')
--instui-icon-circle-check<image>url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Ccircle%20cx%3D%2212%22%20cy%3D%2212%22%20r%3D%2210%22%2F%3E%3Cpath%20d%3D%22m9%2012%202%202%204-4%22%2F%3E%3C%2Fsvg%3E')

ذات صلة ​

  • form-field — يغلف تسمية وعنصر التحكم وهذه الرسائل.