مفتاح لوحة المفاتيح
يعرض مفتاحًا أو اختصارًا بجانب الأمر الذي ينفّذه، في القوائم والتلميحات ونصوص المساعدة.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add kbdويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/kbdأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Kbd, KeyboardShortcut } from "@/components/ui/kbd";<KeyboardShortcut keys={["Ctrl", "K"]} /><Kbd size="lg">Enter</Kbd>أمثلة
مرجع الخصائص
Kbd
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | خاصية Label: اسم المفتاح كما هو مطبوع. |
size | "sm" | "md" | "lg" | "md" | خاصية Size: 20 أو 24 أو 32 بكسل. |
KeyboardShortcut
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
keys | ReactNode[] | لا يوجد | المفاتيح بالترتيب. |
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 بكسل، بلا علامات زائد. والمفاتيح التي تُضغط واحدًا بعد الآخر تتابع: ضع كلمة «ثم» بينها.
معًا أم واحدًا بعد الآخر
الذهاب إلى صندوق الوارد.
افعل
- المفاتيح المضغوطة معًا بفاصل 4 بكسل.
- اكتب «ثم» بين خطوات التتابع: G ثم I.
- الاختصارات مفتاحان أو ثلاثة.
تجنّب
- علامات زائد بين المفاتيح في الصف.
- عرض تتابع كأن مفاتيحه مضغوطة معًا.
- اختصارات تتعارض مع المتصفح أو قارئ الشاشة.
4. العربية والاتجاه من اليمين إلى اليسار
المفاتيح نفسها على لوحات المفاتيح العربية: Ctrl وShift والحرف اللاتيني المطبوع على المفتاح. والجملة حول الاختصار تنعكس؛ أما الاختصار نفسه فيبقى من اليسار إلى اليمين، فيأتي Ctrl قبل K في اللغتين.
الجملة تنعكس، والاختصار لا
«اضغط Ctrl K للبحث» بالعربية.
قبل التسليم
- كل اختصار بجوار أمره.
- المفاتيح تطابق النظام، مفتاح لكل مفتاح.
- التتابعات تستخدم «ثم».
- الجمل العربية تُبقي الاختصار من اليسار إلى اليمين.
- لا اختصار هو الطريقة الوحيدة لتشغيل أمر.
إمكانية الوصول
ARIA
- كل مفتاح
<kbd>، والاختصار<kbd>يضمّها. اكتب Ctrl لا ^ فقارئ الشاشة ينطق الأسماء. - ليست أزرارًا، ولا تعرضها في شاشات اللمس فقط.
افعل
- كل مفتاح
<kbd>، والاختصار كله<kbd>خارجي واحد. - أعطِ الرموز اسمًا منطوقًا: يُقرأ ⌘ «Command».
- كل أمر له اختصار يمكن الوصول إليه بطريقة أخرى.
- اسمح للناس بإيقاف اختصارات المفتاح الواحد أو تغييرها.
تجنّب
- جعل مفتاح لوحة المفاتيح قابلًا للضغط.
- تجاوز اختصارات المتصفح أو قارئ الشاشة.
- عرض اختصار لا يعمل على النظام الحالي.
ملاحظات العربية والاتجاه
ينعكس
- الجملة حول الاختصار تنعكس.
لا ينعكس
- ترتيب المفاتيح يبقى من اليسار لليمين داخل النص العربي (Ctrl ثم K).
- الأرقام
- المفاتيح كما هي مطبوعة، بلا تحويل للأرقام.
- الخط العربي
-
label-12بوزن Medium (وlabel-14في الكبير). - النص ثنائي الاتجاه
- الاختصار معزول باتجاه LTR.
افعل
- أبقِ أسماء المفاتيح بالإنجليزية: Ctrl، لا ترجمة لها.
- أبقِ الاختصار من اليسار إلى اليمين داخل الجملة العربية.
- اعرض الحرف اللاتيني؛ لوحات المفاتيح العربية تطبعه بجوار الحرف العربي.
- اكتب الجملة بالعربية أصلًا، لا ترجمةً.
تجنّب
- عكس ترتيب المفاتيح في العربية.
- ترجمة أسماء المفاتيح.
- استبدال الحرف بالحرف العربي المطبوع على المفتاح.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.