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

حقل الأرقام

احصل على Ritla UI

حقل رقمي بزرّي زيادة ونقصان وبادئة عملة اختيارية. يكتب القيمة بأرقام الصفحة (123 أو ١٢٣) ويقبل النوعين عند الكتابة.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 40 من 41مقاسات العرض: 3تاريخ الفحص: قراءة خاطئة معروفة في محرّك الفحص لدينا: R023

افتح في Figma

المعاينة

«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add number-input

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/number-input

  2. الاعتماديات التي يضيفها

    @base-ui/react@phosphor-icons/react

  3. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

number-input.tsx
import { NumberInput } from "@/components/ui/number-input";<NumberInput label="Amount" prefix="$" defaultValue={100} min={0} step={50} />

أمثلة

الحالات والتنسيق

format يمرّر خيارات Intl.NumberFormat (الكسور والتجميع). في حالة القراءة فقط تختفي الأزرار.

إنجليزيمعكوسعربي
← RTL

مرجع الخصائص

NumberInput

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدخاصية Label.
value / defaultValuenumberلا يوجدالقيمة الرقمية (لا النص المنسّق).
onValueChange(value: number | null) => voidلا يوجدعند تغيّر القيمة.
min / max / stepnumberstep 1الحدود والخطوة.
largeStepnumberstep × 10خطوة Shift مع الأسهم: عشر خطوات افتراضيًا.
formatIntl.NumberFormatOptionsلا يوجدتنسيق القيمة.
prefixReactNodeلا يوجد‏_Leading content: عملة أو وحدة.
stepperbooleantrueإظهار زرّي الزيادة والنقصان.
decrementLabel / incrementLabelstringلا يوجداسما الزرّين لقارئ الشاشة. الافتراضي بلغة الصفحة.
required / helperText / error / disabled / readOnly…لا يوجدكما في حقل الإدخال.

إرشادات الاستخدام

حقل الأرقام للمبالغ والكميات التي تُكتب باليد. هنا: متى تستخدمه، وكيف تقول الحدود والأخطاء، وما تتحقق منه قبل التسليم.

1. متى تستخدمه

للمال والكميات التي تُكتب باليد: مبالغ التحويل، والحدود، والكميات. واستخدم المنزلق فقط للقيم التقريبية.

افعل

  • اعرض العملة بجوار القيمة.
  • اعرض الرصيد أو الحد تحت الحقل.
  • نسّق القيمة بفواصل الآلاف أثناء الكتابة.

تجنّب

  • استخدام حقل نصي عادي للمال.
  • السماح بخانات عشرية أكثر مما للعملة.

2. الحدود والأخطاء

قل القاعدة قبل أن يخالفها الناس، وتحقّق منها حين يتوقفون عن الكتابة.

افعل

  • استخدم ثلاث خانات عشرية للدينار الأردني والدينار الكويتي، وخانتين لمعظم العملات الأخرى.
  • اعرض الحد نصًا مساعدًا.

تجنّب

  • استخدام أزرار الزيادة والنقص للمبالغ.
  • عرض خطأ قبل أن ينتهي الشخص من الكتابة.

3. العربية والاتجاه من اليمين إلى اليسار

ينعكس الحقل وتقع العملة عند نهاية القراءة. وتبقى الأرقام لاتينية ومن اليسار إلى اليمين.

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

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

المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.

المفتاحما يفعله
ArrowUpArrowDownيزيد القيمة أو ينقصها بخطوة.
ShiftArrowUpعشر خطوات (largeStep).
HomeEndأدنى وأعلى قيمة، إن وُجدتا.

ARIA

  • الحقل مرتبط بالتسمية والنص المساعد مثل حقل الإدخال.
  • زرّا الزيادة والنقصان باسمين («زيادة» و«إنقاص») بلغة الصفحة.

افعل

  • inputmode="decimal" على الهواتف.
  • اربط النص المساعد والخطأ بالحقل.

تجنّب

  • النص المؤقت بدل التسمية.

ملاحظات العربية والاتجاه

ينعكس

  • العملة في بداية الحقل (اليمين) والزرّان في نهايته، والزيادة في أقصى اليسار.

لا ينعكس

  • الرقم يُقرأ من اليسار إلى اليمين (dir="ltr") فلا تنقلب إشارة السالب، ويُحاذى إلى بداية الحقل.
الأرقام
يتبع numerals من RitlaProvider: ‏١٬٢٣٤ أو 1,234. الأرقام العربية والفارسية المكتوبة تُفهم كأرقام.
الخط العربي
label-16 كبقية الحقول.

افعل

  • اقبل الأرقام المشرقية من لوحة المفاتيح وحوّلها.
  • استخدم «د.أ» و«ر.س» في العربية.

تجنّب

  • عرض الأرقام المشرقية ما لم يعرضها المنتج كله.
  • إبعاد إشارة السالب عن الرقم.

الفحوص التي يجتازها

فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.

  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
  • R021مخاطر اتجاه غير معزولة: أرقام هواتف وبريد إلكتروني ومقاطع لاتينية داخل نص عربي
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة