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

قائمة الأوامر

احصل على Ritla UI

ابحث عن أي أمر وشغّله من أي مكان بلوحة المفاتيح. تفتحها ⌘K أو Ctrl+K، وتفهم أشكال الحروف العربية التي يكتبها الناس بطرق مختلفة.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add command

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

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

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

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

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

الاستخدام

command.tsx
import { CommandDialog } from "@/components/ui/command";<CommandDialog  trigger={<Button variant="outline" />}  triggerLabel="Search commands"  groups={[    { heading: "Suggestions", items: [{ value: "transfer", label: "New transfer", icon: ArrowsLeftRightIcon, onSelect: newTransfer }] },  ]}/>

أمثلة

أشخاص بسطرين

‏Command داخل الصفحة بلا نافذة: صور رمزية، والمعرّف تحت الاسم (stacked)، ويُبحث فيه أيضًا.

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

نقاط الحالة

‏dot لحالة كل صف، والحالة مكتوبة بجانبه فلا يكون اللون وحده الدليل. الحجم md، والصف المتوقف disabled.

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

بحث يفهم العربية

اكتب «اضافه» فتجد «إضافة بطاقة»، و«فاتوره» فتجد «دفع الفاتورة»: البحث يوحّد الهمزات والتاء المربوطة والألف المقصورة ويتجاهل التشكيل والتطويل، والأرقام الهندية تطابق العربية. وkeywords تضيف أسماء إنجليزية: «invoice». واكتب ما لا يوجد لترى حالة «لا نتائج».

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

مرجع الخصائص

Command

الخاصيةالنوعالافتراضيالوصف
groups{ heading?: string; items: CommandItemData[] }[]لا يوجدالأقسام وصفوفها.
size"sm" | "md""sm"خاصية Size للصفوف.
stackedbooleanfalseخاصية Text = Stacked: النص المساعد تحت الاسم.
label / placeholderstring"Search commands" / "Search"اسم حقل البحث ونصه المؤقت، بلغة المكان افتراضيًا.
emptyReactNodeلا يوجدما يظهر حين لا يطابق شيء.
footer / footerActionboolean / ReactNodetrueتلميحات المفاتيح، وزر في نهايتها.
onSelect(item) => voidلا يوجديعمل بعد onSelect الخاص بالصف.

CommandItemData

الخاصيةالنوعالافتراضيالوصف
value / labelstringلا يوجدمعرّف الصف ونصه.
supportingTextstringلا يوجدخاصية Supporting text، ويُبحث فيها.
icon / avatar / dotIconComponent / ReactNode / "green" | "amber" | "red" | "brand" | "gray"لا يوجدخاصية Type: أيقونة أو صورة رمزية أو نقطة حالة.
shortcutstring[]لا يوجداختصار الأمر في التطبيق، للعرض فقط.
keywordsstring[]لا يوجدكلمات أخرى تجد الصف، كالأسماء الإنجليزية.
onSelect / disabled() => void / booleanلا يوجدما يحدث عند الاختيار.

CommandDialog

الخاصيةالنوعالافتراضيالوصف
trigger / triggerLabelReactElement / ReactNodeلا يوجدالزر الذي يفتحها ونصه.
shortcutbooleantrue‏⌘K على ماك وCtrl+K على غيره، على مفتاح K نفسه في أي لغة لوحة مفاتيح.
open / defaultOpen / onOpenChangebooleanلا يوجدللتحكم في الفتح.
titlestring"Command menu"اسم النافذة لقارئ الشاشة.
…CommandPropsلا يوجدكل خصائص Command.

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

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

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

المفتاحما يفعله
⌘KCtrl+Kيفتح القائمة ويغلقها من أي مكان.
ArrowDownArrowUpبين الصفوف، والتركيز يبقى في حقل البحث.
Enterيشغّل الصف المحدد ويغلق النافذة.
Escيغلق النافذة ويعيد التركيز.

ARIA

  • حقل البحث combobox يتحكم في listbox، والصف المحدد يُعلن بـ aria-activedescendant.
  • الأقسام مجموعات لها عناوين، والنافذة لها اسم («قائمة الأوامر»).
  • نقاط الحالة مصحوبة بكلمة، وتلميحات المفاتيح تكرار لما يعلنه قارئ الشاشة فهي مخفية عنه.

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

ينعكس

  • الأيقونات والصور الرمزية على اليمين، والاختصارات على اليسار، وعناوين الأقسام تبدأ من اليمين.
  • تكتب في الحقل بأي لغة فيتبعها اتجاه النص (dir="auto").

لا ينعكس

  • مفاتيح الاختصار (⌘ T) تبقى من اليسار إلى اليمين كما على لوحة المفاتيح، ورمز مفتاح الإدخال لا ينعكس.
  • سهما الأعلى والأسفل.
الأرقام
الأرقام الهندية في البحث تطابق العربية: «٣» تجد «3».
الخط العربي
النص body-14 (وbody-16 في الحجم md) ونص الحقل body-16، والصفوف تكبر مع الأسطر العربية.
النص ثنائي الاتجاه
‏⌘K يعمل على مفتاح K نفسه ولو كانت لوحة المفاتيح عربية (حيث يكتب «ن»).

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

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

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