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

إجراء التداول

احصل على Ritla UI

زرّا الشراء والبيع جنبًا إلى جنب لشاشات التداول والوساطة. كلاهما إجراء رئيسي، فالشراء أخضر في بداية السطر والبيع أحمر بعده، ولا تتبدل الألوان في العربية.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add trade-action

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

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

    @base-ui/react

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

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

الاستخدام

trade-action.tsx
import { TradeAction } from "@/components/ui/trade-action";<TradeAction buyLabel="Buy" sellLabel="Sell" onBuy={openBuy} onSell={openSell} />

أمثلة

الأحجام

lg ‏56 وmd ‏48 وsm ‏40 وxs ‏32 بكسل. النصفان بعرض واحد دائمًا، ومساحة النقر 48 بكسل على الأقل.

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

غير متاح

disabled يوقف النصفين، عند إغلاق السوق مثلًا. اكتب السبب بجانبهما، فالزر المعطّل لا يشرح نفسه.

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

مرجع الخصائص

TradeAction

الخاصيةالنوعالافتراضيالوصف
buyLabelReactNodeلا يوجدBuy label: نص الشراء، ويمكن أن يحمل السعر («شراء 38.45»).
sellLabelReactNodeلا يوجدSell label: نص البيع.
onBuy(event) => voidلا يوجديُستدعى عند الضغط على الشراء.
onSell(event) => voidلا يوجديُستدعى عند الضغط على البيع.
size"lg" | "md" | "sm" | "xs""lg"خاصية Size.
disabledbooleanfalseState = Disabled للنصفين.
classNamestringلا يوجدأصناف للمجموعة، مثل w-full لملء العرض.

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

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

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

المفتاحما يفعله
Tabينتقل من الشراء إلى البيع؛ التركيز يُظهر الحلقة دون تغيير اللون.
EnterSpaceينفّذ الإجراء الذي عليه التركيز.

ARIA

  • زران أصليان داخل role="group"؛ الاسم هو النص، فلا يعتمد المعنى على اللون وحده.
  • الشراء والبيع يفتحان عادةً نموذج تأكيد؛ لا تنفّذ أمرًا ماليًا بضغطة واحدة دون مراجعة.

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

ينعكس

  • الشراء في بداية السطر: اليمين في العربية، والبيع بعده، فيبقى ترتيب القراءة «شراء ثم بيع».

لا ينعكس

  • الألوان لا تتبدل: الشراء أخضر والبيع أحمر في اللغتين.
الأرقام
الأسعار داخل النص تُنسّق بـformatNumber وتتبع إعداد الأرقام؛ جرّب ١٢٣ في المعاينة.
الخط العربي
body-16 (وbody-14 في xs) بوزن Semibold، والارتفاع ثابت يتسع للنص العربي.
النص ثنائي الاتجاه
سعر بعد نص عربي («شراء 38.45») يُعرض صحيحًا؛ رمز سهم لاتيني داخل النص («شراء AAPL») يوضع في <bdi>.

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

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

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