إجراء التداول
زرّا الشراء والبيع جنبًا إلى جنب لشاشات التداول والوساطة. كلاهما إجراء رئيسي، فالشراء أخضر في بداية السطر والبيع أحمر بعده، ولا تتبدل الألوان في العربية.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add trade-actionويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/trade-actionالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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 بكسل على الأقل.
غير متاح
disabled يوقف النصفين، عند إغلاق السوق مثلًا. اكتب السبب بجانبهما، فالزر المعطّل لا يشرح نفسه.
مرجع الخصائص
TradeAction
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
buyLabel | ReactNode | لا يوجد | Buy label: نص الشراء، ويمكن أن يحمل السعر («شراء 38.45»). |
sellLabel | ReactNode | لا يوجد | Sell label: نص البيع. |
onBuy | (event) => void | لا يوجد | يُستدعى عند الضغط على الشراء. |
onSell | (event) => void | لا يوجد | يُستدعى عند الضغط على البيع. |
size | "lg" | "md" | "sm" | "xs" | "lg" | خاصية Size. |
disabled | boolean | false | State = Disabled للنصفين. |
className | string | لا يوجد | أصناف للمجموعة، مثل w-full لملء العرض. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | ينتقل من الشراء إلى البيع؛ التركيز يُظهر الحلقة دون تغيير اللون. |
| EnterSpace | ينفّذ الإجراء الذي عليه التركيز. |
ARIA
- زران أصليان داخل
role="group"؛ الاسم هو النص، فلا يعتمد المعنى على اللون وحده. - الشراء والبيع يفتحان عادةً نموذج تأكيد؛ لا تنفّذ أمرًا ماليًا بضغطة واحدة دون مراجعة.
ملاحظات العربية والاتجاه
ينعكس
- الشراء في بداية السطر: اليمين في العربية، والبيع بعده، فيبقى ترتيب القراءة «شراء ثم بيع».
لا ينعكس
- الألوان لا تتبدل: الشراء أخضر والبيع أحمر في اللغتين.
- الأرقام
- الأسعار داخل النص تُنسّق بـ
formatNumberوتتبع إعداد الأرقام؛ جرّب ١٢٣ في المعاينة. - الخط العربي
body-16(وbody-14فيxs) بوزن Semibold، والارتفاع ثابت يتسع للنص العربي.- النص ثنائي الاتجاه
- سعر بعد نص عربي («شراء 38.45») يُعرض صحيحًا؛ رمز سهم لاتيني داخل النص («شراء AAPL») يوضع في
<bdi>.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.