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

الكمية

تجريبي
احصل على Ritla UI

عدّاد الكمية لصفحة المنتج والسلة: إنقاص والعدد وزيادة، من 1 إلى المخزون المتوفر.

المعاينة

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

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

التثبيت

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

    npx ritla add quantity

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

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

    button

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

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

الاستخدام

quantity.tsx
import { Quantity } from "@/components/ui/quantity";<Quantity value={quantity} onValueChange={setQuantity} max={stock} />

مرجع الخصائص

Quantity

الخاصيةالنوعالافتراضيالوصف
value / defaultValue / onValueChangenumber1العدد.
minnumber1أقل عدد. سطر السلة يُحذف بزرّ الإزالة، لا بالنزول إلى صفر.
maxnumberلا يوجدالمخزون المتوفر.
size"md" | "sm""md"خاصية Size: أزرار 40 بكسل لصفحة المنتج و32 للسلة.
labelstringلا يوجداسم الحقل. في السلة أضف اسم المنتج («الكمية، كرسي لينا»).
decrementLabel / incrementLabelstringلا يوجداسما الزرّين. افتراضيًا «إنقاص الكمية» و«زيادة الكمية».
name / disabled…لا يوجدكما في حقل الأرقام.

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

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

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

المفتاحما يفعله
ArrowUpArrowDownيزيد وينقص واحدًا.
Tabإنقاص ثم الحقل ثم زيادة.

ARIA

  • الحقل spinbutton بين زرّين مسمّيين؛ الزرّ يتعطّل عند الحد الأدنى والأقصى.
  • الزرّان مرسومان 40 و32 بكسل، ومنطقة اللمس 48 بكسل طولًا، لا عرضًا كي لا تغطي العدد.

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

ينعكس

  • الإنقاص في البداية على اليمين والزيادة على اليسار.

لا ينعكس

  • رمزا − و+ والعدد لا تنعكس.
الأرقام
العدد بأرقام الصفحة، ويقبل الأرقام العربية حين تُكتب.
الخط العربي
label-16 Medium في md وlabel-14 Medium في sm.