انتقل إلى المحتوى
uiify

Number field

مدخل رقمي بأزرار زيادة ونقصان.

المتصفحات
Chrome 123+Firefox 121+Safari 17.5+
الفئة
1
الحجم المضغوط
2.45 kB
ميزانية التخطيط القسري
0 ms
ميزانية axe
0
متوافق مع SSR
نعم
العقد المنشور
بيئة الاختبار

المختبر

Number Field

افتراضي

API

NumberField.Root

الخاصيةالنوعافتراضيالوصف
valuenumber—العدد الحالي، ويجعل الحقل متحكّمًا به.
defaultValuenumber—العدد الأولي للحقل غير المتحكّم به.
onValueChange(value: number | undefined) => void—تُستدعى بالعدد المحلّل، أو undefined إذا كان المدخل فارغًا.
minnumber—أدنى قيمة مقبولة.
maxnumber—أعلى قيمة مقبولة.
stepnumber1المقدار الذي يضيفه أو يطرحه زرا الزيادة والنقصان.
formatOptionsIntl.NumberFormatOptions—خيارات Intl.NumberFormat المستخدمة لعرض القيمة.
clampValueOnBlurbooleantrueيعيد القيمة الخارجة عن النطاق إلى حدود min وmax حين يفقد المدخل التركيز.
disabledbooleanfalseيعطّل المدخل وزرّي الزيادة والنقصان.
readOnlybooleanfalseيجعل القيمة للقراءة فقط مع إبقاء المدخل قابلًا للتركيز.
requiredbooleanfalseيعلّم المدخل كمطلوب للتحقق من النموذج.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

NumberField.Group

الخاصيةالنوعافتراضيالوصف
childrenReactNode—المدخل وزرا الزيادة والنقصان اللذان تحتويهما المجموعة.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

NumberField.Input

الخاصيةالنوعافتراضيالوصف
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

NumberField.Increment

الخاصيةالنوعافتراضيالوصف
childrenReactNode—محتوى زر الزيادة.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

NumberField.Decrement

الخاصيةالنوعافتراضيالوصف
childrenReactNode—محتوى زر النقصان.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

لوحة المفاتيح

المفتاحالإجراء
Tabنقل التركيز إلى عنصر التحكم أو منه
Enter / Spaceالتفعيل عند التركيز (لعناصر التحكم الشبيهة بالأزرار)

إمكانية الوصول

يستخدم HTML الدلالي متى أمكن. افحص بنية HTML المعروضة في المختبر؛ لا تُضاف ARIA إلا حين لا تكفي العناصر الأصلية.

نقاط التنسيق

data-uiify-number-fielddata-disabled