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

بطاقة المنتج

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

بطاقة منتج للشبكات والعروض ونتائج البحث: الصورة والوسم والمفضلة، ثم العلامة والاسم والتقييم والسعر. البطاقة كلها رابط إلى المنتج.

المعاينة

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

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

التثبيت

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

    npx ritla add product-card

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

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

    buttonicon-buttonpriceproduct-imageratingtag

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

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

الاستخدام

product-card.tsx
import { ProductCard } from "@/components/ui/product-card";<ProductCard  name="Lina lounge chair, oak"  href="/products/lina"  brand="Dar Oak"  badge="New"  image={{ src: "/products/lina.jpg" }}  price={{ amount: 288, compareAt: 360 }}  rating={{ value: 4.8, count: 126 }}  wishlist/>

أمثلة

شبكة مع زر الإضافة

صور مربعة وزر «أضف إلى السلة»، عمودان على الهاتف.

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

مرجع الخصائص

ProductCard

الخاصيةالنوعالافتراضيالوصف
name / hrefstringلا يوجداسم المنتج ورابطه: الاسم هو الرابط، ممتدًا على البطاقة كلها.
brandReactNodeلا يوجدالعلامة أو الصانع فوق الاسم.
image / ratio{ src?, alt? } / "1:1" | "4:5" | "3:4""3:4"الصورة ونسبتها (Product image المكشوفة في Figma).
badgeReactNodeلا يوجدShow badge: كلمة قصيرة على الصورة («جديد»).
price{ amount, compareAt?, currency? … }لا يوجدخصائص Price.
rating{ value, count? }لا يوجدShow rating.
wishlistboolean | { pressed, onPressedChange }لا يوجدShow wishlist: زرّ القلب، بحالته إن أردت التحكم بها.
onAddToCart() => voidلا يوجدShow add to cart: زرّ بإطار تحت السعر.
renderLink(props) => ReactNodeلا يوجدعنصر الرابط (Next <Link>)؛ يستلم href والأصناف والاسم.
headingLevel2 | 3 | 43مستوى عنوان الاسم في صفحتك.

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

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

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

المفتاحما يفعله
Tabالرابط (الاسم) ثم المفضلة ثم زرّ الإضافة: كلٌّ عنصر مستقل.

ARIA

  • البطاقة article واسمها عنوان، والرابط يمتد فوقها بـ ::after فتُفتح من أي مكان دون أن يصير النص كله اسمًا للرابط.
  • المفضلة زرّ aria-pressed باسم المنتج («حفظ كرسي لينا في المفضلة»)، وكذلك «أضف … إلى السلة».

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

ينعكس

  • الوسم ينتقل إلى أعلى اليمين والقلب إلى أعلى اليسار، والنصوص تبدأ من اليمين.

لا ينعكس

  • الصورة والقلب والنجوم لا تنعكس، والمبالغ معزولة.
الأرقام
التقييم والسعر يتبعان numerals.
الخط العربي
label-12 Medium للعلامة وlabel-16 Medium للاسم.