البناء · جديد

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

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

المعاينة

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

التثبيت

قريبًايُفتح التثبيت من السجل مع الإطلاق. حتى ذلك الحين، هذا هو الأمر الذي ستستخدمه.
npx shadcn@latest add @ritla/keyboard-key

الاستخدام

import { KeyboardKey, KeyboardShortcut } from "@/components/ui/keyboard-key";
<KeyboardShortcut keys={["Ctrl", "K"]} />
<KeyboardKey size="lg">Enter</KeyboardKey>

أمثلة

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

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

مرجع الخصائص

KeyboardKey

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

KeyboardShortcut

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

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

ARIA

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

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

ينعكس

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

لا ينعكس

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

كل المكونات ›