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

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

احصل على Ritla UI

يعرض مفتاحًا أو اختصارًا بجانب الأمر الذي ينفّذه، في القوائم والتلميحات ونصوص المساعدة.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add kbd

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

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

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

الاستخدام

kbd.tsx
import { Kbd, KeyboardShortcut } from "@/components/ui/kbd";<KeyboardShortcut keys={["Ctrl", "K"]} /><Kbd size="lg">Enter</Kbd>

أمثلة

بجانب الأوامر

مفاتيح صغيرة في نهاية صفوف القائمة؛ اعرض ⌘ على ماك وCtrl على ويندوز.

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

مرجع الخصائص

Kbd

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label: اسم المفتاح كما هو مطبوع.
size"sm" | "md" | "lg""md"خاصية Size: ‏20 أو 24 أو 32 بكسل.

KeyboardShortcut

الخاصيةالنوعالافتراضيالوصف
keysReactNode[]لا يوجدالمفاتيح بالترتيب.
size"sm" | "md" | "lg""md"مقاس كل مفتاح.

إرشادات الاستخدام

مفتاح لوحة المفاتيح يُظهر اختصارًا كما يبدو على لوحة المفاتيح. هنا: أين تنتمي الاختصارات، وكيف تسمّي المفاتيح، والتركيبات والتتابعات، وكيف تبقى من اليسار إلى اليمين في العربية، وما تتحقق منه قبل التسليم.

1. أين تنتمي الاختصارات

اعرض الاختصار بجوار الأمر الذي يشغّله، حيث يبحث الناس عن ذلك الأمر أصلًا. والاختصارات تساعد من يستخدم لوحة المفاتيح؛ وهي تلميحات، لا الطريقة الوحيدة لفعل شيء أبدًا.

الموضعالمقاسالسبب
عنصر قائمة، عند نهاية السطرsmيتعلم الناس الاختصار أثناء استخدام القائمة.
تلميح على زر أيقونةsmيسمّي التلميح الإجراء واختصاره معًا.
نتائج قائمة الأوامر وحقول البحثsmيُظهر كيف تفتح أمرًا أو تشغّله دون الفأرة.
النص المساعد وجمل التعريف بالتطبيقmdيطابق النص بمقاسه.
صفحة أو نافذة اختصارات لوحة المفاتيحmd أو lgالمفاتيح هي المحتوى، فيمكن أن تكبر.
شاشات اللمس فقطلا شيءلا لوحة مفاتيح للضغط عليها.

2. تسمية المفاتيح

اطبع كل مفتاح كما يظهر على لوحة المفاتيح. واتبع النظام: ⌘ و⌥ على Mac، وCtrl وAlt على Windows وLinux. واكتب بالحروف أسماء المفاتيح التي قد لا يعرف الناس رموزها، واعرض الحروف كبيرة.

مفتاح لكل مفتاح

فتح قائمة الأوامر.

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

افعل

  • اعرض مفاتيح النظام الذي يستخدمه الناس: ⌘ K على Mac، وCtrl K على Windows.
  • اكتب بالحروف Shift وEnter وEsc وTab وSpace.
  • حروف كبيرة: K لا k.
  • مفاتيح التعديل أولًا بترتيب ثابت: Ctrl، Alt، Shift، ثم المفتاح.

تجنّب

  • رموز مثل ^ أو ⏎ على الناس فك رموزها.
  • عرض مفاتيح Mac لمستخدمي Windows.
  • وضع اختصار كامل في مفتاح واحد: Ctrl+Shift+P.

3. التركيبات والتتابعات

المفاتيح التي تُضغط معًا تقع في صف بفاصل 4 بكسل، بلا علامات زائد. والمفاتيح التي تُضغط واحدًا بعد الآخر تتابع: ضع كلمة «ثم» بينها.

معًا أم واحدًا بعد الآخر

الذهاب إلى صندوق الوارد.

افعل: تتابع بكلمة «ثم»يضغط الناس G، ويرفعون أصابعهم، ثم يضغطون I.
تجنّب: تتابع معروض تركيبةًيُقرأ كأن G وI مضغوطان معًا.

افعل

  • المفاتيح المضغوطة معًا بفاصل 4 بكسل.
  • اكتب «ثم» بين خطوات التتابع: G ثم I.
  • الاختصارات مفتاحان أو ثلاثة.

تجنّب

  • علامات زائد بين المفاتيح في الصف.
  • عرض تتابع كأن مفاتيحه مضغوطة معًا.
  • اختصارات تتعارض مع المتصفح أو قارئ الشاشة.

4. العربية والاتجاه من اليمين إلى اليسار

المفاتيح نفسها على لوحات المفاتيح العربية: Ctrl وShift والحرف اللاتيني المطبوع على المفتاح. والجملة حول الاختصار تنعكس؛ أما الاختصار نفسه فيبقى من اليسار إلى اليمين، فيأتي Ctrl قبل K في اللغتين.

الجملة تنعكس، والاختصار لا

«اضغط Ctrl K للبحث» بالعربية.

افعل: Ctrl قبل Kالجملة تُقرأ من اليمين إلى اليسار، والاختصار ما زال يُقرأ Ctrl ثم K.
تجنّب: مفاتيح معكوسةعكس الاختصار يجعله يُقرأ K ثم Ctrl.

قبل التسليم

  • كل اختصار بجوار أمره.
  • المفاتيح تطابق النظام، مفتاح لكل مفتاح.
  • التتابعات تستخدم «ثم».
  • الجمل العربية تُبقي الاختصار من اليسار إلى اليمين.
  • لا اختصار هو الطريقة الوحيدة لتشغيل أمر.

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

ARIA

  • كل مفتاح <kbd>، والاختصار <kbd> يضمّها. اكتب Ctrl لا ^ فقارئ الشاشة ينطق الأسماء.
  • ليست أزرارًا، ولا تعرضها في شاشات اللمس فقط.

افعل

  • كل مفتاح <kbd>، والاختصار كله <kbd> خارجي واحد.
  • أعطِ الرموز اسمًا منطوقًا: يُقرأ ⌘ «Command».
  • كل أمر له اختصار يمكن الوصول إليه بطريقة أخرى.
  • اسمح للناس بإيقاف اختصارات المفتاح الواحد أو تغييرها.

تجنّب

  • جعل مفتاح لوحة المفاتيح قابلًا للضغط.
  • تجاوز اختصارات المتصفح أو قارئ الشاشة.
  • عرض اختصار لا يعمل على النظام الحالي.

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

ينعكس

  • الجملة حول الاختصار تنعكس.

لا ينعكس

  • ترتيب المفاتيح يبقى من اليسار لليمين داخل النص العربي (Ctrl ثم K).
الأرقام
المفاتيح كما هي مطبوعة، بلا تحويل للأرقام.
الخط العربي
‏label-12 بوزن Medium (وlabel-14 في الكبير).
النص ثنائي الاتجاه
الاختصار معزول باتجاه LTR.

افعل

  • أبقِ أسماء المفاتيح بالإنجليزية: Ctrl، لا ترجمة لها.
  • أبقِ الاختصار من اليسار إلى اليمين داخل الجملة العربية.
  • اعرض الحرف اللاتيني؛ لوحات المفاتيح العربية تطبعه بجوار الحرف العربي.
  • اكتب الجملة بالعربية أصلًا، لا ترجمةً.

تجنّب

  • عكس ترتيب المفاتيح في العربية.
  • ترجمة أسماء المفاتيح.
  • استبدال الحرف بالحرف العربي المطبوع على المفتاح.

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

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

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