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

الزر

احصل على Ritla UI

زر الإجراء الرئيسي بخمسة أنماط وأربعة أحجام، مع نسخة للإجراءات الخطرة وحالة تحميل. أيقوناته الاتجاهية تنعكس في العربية وحدها.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add button

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

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

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

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

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

الاستخدام

button.tsx
import { ArrowRightIcon } from "@phosphor-icons/react/ssr";import { Button } from "@/components/ui/button";<Button variant="outline">Cancel</Button><Button iconTrailing={ArrowRightIcon}>Continue</Button><Button danger>Delete project</Button>

أمثلة

الأنماط

filled للإجراء الرئيسي، زر واحد لكل شاشة. tonal لإجراء ثانوي قوي، outline للبدائل مثل «إلغاء»، ghost للإجراءات الخفيفة، وinverted-ghost على الأسطح الملونة. danger يحوّل أي نمط إلى الأحمر.

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

الأحجام

lg ‏56 بكسل (الافتراضي)، md ‏48 للنماذج، sm ‏40 للجداول والمرشحات، xs ‏32 للواجهات الكثيفة. مساحة النقر تبقى 48 بكسل على الأقل في كل الأحجام.

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

الحالات

التمرير والضغط والتركيز تأتي من الفأرة ولوحة المفاتيح. loading يضع المؤشر مكان الأيقونة الأولى ويُبقي التركيز على الزر، وdisabled يوقفه. وعند الضغط ينخفض الزر بكسلًا واحدًا حين تسمح إعدادات الحركة. اضغط «حفظ».

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

الأيقونات

iconLeading وiconTrailing اختياريان. «التالي» يستخدم ArrowRightIcon في اللغتين ويُقلب في العربية ليشير إلى الأمام؛ أيقونة التنزيل لا تنعكس.

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

التخطيط الممتد

layout="spread" يضع النص في البداية والأيقونة اللاحقة عند حافة النهاية، بعرض لا يقل عن 216 بكسل في lg وmd. للأزرار التي تنقل إلى صفحة أو خطوة أخرى. السهم يشير إلى الوجهة (إلى اليسار في العربية) ويتقدّم نحوها عند تمرير المؤشر أو التركيز عليه؛ الأيقونات غير الاتجاهية تبقى ثابتة.

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

ترتيب الإجراءات

الإجراء الرئيسي عند نهاية السطر والبديل قبله. في العربية ينعكس الصف كله، فيبقى الرئيسي عند النهاية (اليسار). للإجراءات الخطرة نص محدد، لا «موافق».

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

مرجع الخصائص

Button

أي خاصية أخرى من Base UI Button تمر كما هي (onClick، type…).

الخاصيةالنوعالافتراضيالوصف
variant"filled" | "tonal" | "outline" | "ghost" | "inverted-ghost""filled"خاصية Style في Figma (الاسم style محجوز في React).
size"lg" | "md" | "sm" | "xs""lg"خاصية Size: ‏56 و48 و40 و32 بكسل.
dangerbooleanfalseخاصية Danger في Figma: الأحمر للإجراءات الخطرة، مع حلقة تركيز حمراء.
childrenReactNodeلا يوجدخاصية Label: نص الزر.
iconLeadingIconComponentلا يوجدIcon leading: أيقونة Phosphor أو من ⁨Ritla UI⁩ في بداية السطر.
iconTrailingIconComponentلا يوجدIcon trailing: أيقونة في نهاية السطر.
layout"default" | "spread""default"spread يضع النص في البداية والأيقونة اللاحقة عند حافة النهاية، ويحرّك السهم نحو الوجهة عند التمرير أو التركيز.
loadingbooleanfalseState = Loading: مؤشر مكان الأيقونة الأولى، aria-busy، الزر يبقى قابلًا للتركيز ويتجاهل الضغط.
disabledbooleanfalseState = Disabled.
renderReactElementلا يوجدعنصر آخر بشكل الزر، عادةً رابط (<a> أو <Link>). يحتفظ بدلالته، فلا يُعلن زرًا.
classNamestringلا يوجدأصناف إضافية تُدمج عبر cn()، مثل w-full.

البنية

إطار محتوى داخل مساحة لمس بارتفاع 48 بكسل: أيقونة اختيارية في البداية، ثم العنوان، ثم أيقونة اختيارية في النهاية.

  1. 1. مساحة اللمسsize/touch-target

    الإطار الخارجي: ارتفاعه 48 بكسل على الأقل في كل الأحجام. يضيفه sm وxs دون أن يأخذ مساحة في التخطيط.

  2. 2. المحتوىvariant, danger

    التعبئة والحد يتبعان النمط؛ radius/10 في lg، وradius/8 في md، وradius/6 في sm، وradius/4 في xs.

  3. 3. الأيقونة الأولىiconLeading

    24 في lg، و20 في md وsm وxs. تقع في بداية السطر.

  4. 4. العنوانchildren

    خاصية نص العنوان: body-16/Semibold، وbody-14/Semibold في xs.

  5. 5. الأيقونة الأخيرةiconTrailing

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

  6. 6. مؤشر التحميلloading

    يحلّ محل الأيقونة الأولى أثناء الانتظار؛ ويبقى العنوان كي لا يتغير العرض.

  7. 7. حلقة التركيز

    حلقة بعرض 2 بكسل عند focus-visible فقط، بعيدة عن إطار المحتوى.

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

الزر يبدأ إجراءً: حفظ، إرسال، إنشاء، حذف. هنا: أي نمط تختار، وكيف تكتب التسمية، وما تتحقق منه قبل التسليم.

1. اختر النمط حسب الأهمية

النمط يبيّن أهمية الإجراء لا طبيعته. تحتاج معظم الشاشات إلى زر filled واحد وبضعة أزرار أهدأ منه. وإذا علا صوت كل شيء، لم يعد شيء لافتًا.

النمطالعددالاستخدام
filledواحد في كل شاشةالإجراء الرئيسي في الشاشة: حفظ، إرسال، دفع، إنشاء.
tonalواحد أو اثنانإجراء ثانوي مهم يبقى ظاهرًا بجوار الرئيسي.
outlineحسب الحاجةبدائل الإجراء الرئيسي: إلغاء، رجوع، تخطٍّ.
ghostحسب الحاجةإجراءات قليلة الأهمية داخل المحتوى والبطاقات وأشرطة الأدوات.
inverted-ghostحسب الحاجةإجراءات فوق أسطح العلامة أو الأسطح الداكنة: اللافتات، وأقسام الواجهة الرئيسية، والإشعار المعكوس.
dangerواحد في نهاية المسارالإجراءات الخطرة التي تُفقد بيانات. يعمل مع كل الأنماط، ولا يكون filled إلا في خطوة التأكيد.

الأزرار فوق سطح العلامة

لافتة ترويجية بإجراء واحد.

افعل: inverted-ghostالنص الأبيض على تعبئة شفافة يحافظ على التباين فوق أزرق العلامة.
تجنّب: ghost فوق العلامةالنص الرمادي على أزرق العلامة يفشل في التباين ويبدو معطّلًا.

افعل

  • اجعل في كل شاشة زر filled واحدًا لإجرائها الرئيسي.
  • استخدم inverted-ghost فوق أسطح العلامة والأسطح الداكنة.
  • حافظ على النمط نفسه للإجراء نفسه في كل المنتج.

تجنّب

  • وضع زرّي filled متجاورين.
  • استخدام ghost أو outline فوق سطح العلامة، فنصّهما الرمادي يختفي.
  • اختيار نمط للونه، فالأحمر يعني إجراءً خطرًا لا إجراءً مهمًا.

2. اكتب التسمية

التسمية تقول بالضبط ما يحدث عند الضغط على الزر. ابدأ باسم الإجراء ثم سمِّ ما يقع عليه. واكتب التسمية العربية بلغتها لا بالترجمة: المصدر القصير مثل «حفظ» أو «إرسال» يُقرأ أمرًا في الواجهات ويبقى متسقًا في كل المنتج.

سمِّ الإجراء

الإجراء الرئيسي في صفحة الفواتير.

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

افعل

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

تجنّب

  • كتابة «اضغط هنا» أو «موافق» أو «نعم» حين يمكن تسمية الإجراء.
  • إنهاء التسمية بعلامة ترقيم أو بنقاط حذف.
  • اقتطاع التسمية؛ اختصر صياغتها بدلًا من ذلك.
  • الترجمة كلمة بكلمة: «Submit» تصبح «إرسال» لا «قدّم».

3. الأيقونات

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

الأسهم تتبع اتجاه القراءة

زر «التالي» في صفحة دفع عربية.

افعل: سهم معكوسالسهم يشير إلى اليسار، نحو الخطوة التالية في العربية.
تجنّب: سهم إنجليزي في العربيةالسهم يشير إلى الخطوة السابقة.

افعل

  • أيقونة واحدة على الأكثر، في البداية أو في النهاية.
  • ضع سهمًا في نهاية «التالي» و«متابعة»، وفي العربية يشير إلى اليسار.
  • اختر نسخة RTL = Yes من الأسهم وعلامات الاتجاه في الأزرار العربية.

تجنّب

  • الجمع بين أيقونة في البداية وأخرى في النهاية.
  • إبقاء السهم متجهًا إلى اليمين في زر عربي.
  • زر بأيقونة وحدها؛ استخدم زر الأيقونة مع تسمية بدلًا منه.

4. المقاس

المقاس lg (56) هو الافتراضي، كما في الكود، وهو مقاس الإجراء الرئيسي على الجوال وفي أقسام الواجهة الرئيسية. يناسب md (48) أزرار النماذج، وsm (40) الجداول وعوامل التصفية، وxs (32) أشرطة الأدوات المزدحمة. ويضيف sm وxs في الكود مساحة لمس غير مرئية بارتفاع 48 بكسل، فاترك لهما متّسعًا.

مقاس واحد في المجموعة

أزرار نموذج.

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

افعل

  • مقاس واحد لكل أزرار المجموعة.
  • اترك space-8 على الأقل بين أزرار sm وxs حتى لا تتداخل مساحات اللمس.
  • اجعل الإجراء الرئيسي بعرض الشاشة في أسفل شاشات الجوال.

تجنّب

  • خلط المقاسات في مجموعة واحدة.
  • جعل xs الإجراء الوحيد على شاشة لمس.
  • تثبيت ارتفاع الزر، فالتسميات العربية تحتاج أسطرًا أعلى.

5. الترتيب والموضع

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

الإجراء الرئيسي في نهاية السطر

تذييل نافذة حوار بالعربية.

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

افعل

  • ضع الإجراء الرئيسي في نهاية السطر في النوافذ والنماذج والتذييلات.
  • حاذِ المجموعة إلى نهاية حاويتها.
  • على الشاشات الضيقة رتّب الأزرار بعضها فوق بعض بعرض كامل، والرئيسي في الأعلى.

تجنّب

  • إبقاء الترتيب الإنجليزي في الشاشات العربية.
  • وضع الإجراء الرئيسي بين إجراءين ثانويين.
  • تفريق أزرار تنتمي إلى مجموعة واحدة.

6. التحميل والتعطيل

التحميل والتعطيل هما الحالتان اللتان تضبطهما بنفسك، أما التمرير والضغط والتركيز فتأتي من التفاعل. أثناء التحميل حوّل التسمية إلى صيغة «جارٍ …» («حفظ» إلى «جارٍ الحفظ»)، ويأخذ مؤشر التحميل مكان أيقونة البداية.

أظهر التقدّم في التسمية

حفظ نموذج.

افعل: تسمية بصيغة «جارٍ …»«حفظ التغييرات» تصبح «جارٍ حفظ التغييرات»، ويأخذ المؤشر مكان أيقونة البداية.
تجنّب: نص تحميل عام«جارٍ التحميل…» لم يعد يقول ما الذي يُحفظ.

افعل

  • انتقل إلى حالة التحميل فور بدء الإجراء، وعُد منها عند انتهائه.
  • حوّل التسمية إلى صيغة «جارٍ …» أثناء التحميل: «حفظ» إلى «جارٍ الحفظ».
  • اشرح بجوار الزر المعطّل سبب تعطيله، أو اتركه مفعّلًا وأظهر الخطأ عند الضغط.

تجنّب

  • استبدال التسمية بعبارة عامة مثل «جارٍ التحميل…».
  • تعطيل زر دون قول ما الذي ينقص.
  • التعطيل لإجراء لا يستطيعه المستخدم أبدًا؛ أخفِه بدلًا من ذلك.

7. الإجراءات الخطرة

تفعيل danger يحوّل أي نمط إلى الألوان الحمراء. استخدمه فقط حين يحذف الإجراء شيئًا أو يُفقده، وأكّد كل ما لا يمكن التراجع عنه في نافذة حوار يكرّر زرها filled مع danger الإجراءَ نفسه بالضبط.

افعل: سمِّ ما سيُفقدoutline أو ghost مع danger في الصفحة، وfilled مع danger في التأكيد فقط.
تجنّب: الأحمر على إجراء آمنتسجيل الخروج والإلغاء ليسا إجراءين خطرين، فلا يكونان أحمرين أبدًا.

افعل

  • سمِّ ما سيُفقد: «حذف المشروع».
  • استخدم outline أو ghost مع danger في الصفحة، وfilled مع danger في التأكيد فقط.
  • إن أمكن التراجع عن الإجراء، فاعرض «تراجع» بدل طلب التأكيد.

تجنّب

  • الأحمر لإجراءات غير خطرة مثل تسجيل الخروج أو الإلغاء.
  • تسمية إجراء خطِر «موافق» أو «نعم».
  • جعل الإجراء الخطِر الزرَّ الذي يأخذ التركيز تلقائيًا.

قبل التسليم

  • زر filled واحد في كل شاشة، في نهاية مجموعته.
  • كل تسمية تبدأ باسم الإجراء وتسمّي ما يقع عليه.
  • الشاشات العربية تستخدم النسخ العربية بأسهمها المعكوسة.
  • الإجراءات الخطرة تستخدم danger وتسمية محددة.
  • حالات التحميل والتعطيل والخطأ مصمّمة، لا الحالة الافتراضية وحدها.
  • الروابط التي تشبه الأزرار معلَّمة روابطَ لفريق التطوير.

رموز التصميم والمواصفات

كل قيمة في الزر متغيّر أو نمط نص. هذه هي القيم المربوطة بالمكوّن، حسب المقاس وحسب النمط.

المقاسات

الارتفاع الظاهر، والحشوة على امتداد السطر، والمسافة بين العناصر، ونصف قطر الزوايا لإطار المحتوى. وكل مقاس داخل مساحة لمس size/touch-target (48).

المقاسالارتفاع والحشوة والمسافة ونصف القطرالتسمية والأيقونات
lg56 · space-24 · space-8 · radius/10body-16/Semibold · 24
md48 · space-24 · space-8 · radius/8body-16/Semibold · 20
sm40 · space-16 · space-8 · radius/6body-16/Semibold · 20
xs32 · space-12 · space-8 · radius/4body-14/Semibold · 20

الألوان

لون التعبئة والحدّ والتسمية لكل نمط في الحالة الافتراضية. ويأتي الوضعان الفاتح والداكن من وضع 1. Colors، لا من نسخ منفصلة.

النمطالتعبئة والحدّالتسمية
filledbackground/brand/solidtext/brand/on-brand
filled · dangerbackground/danger/solidtext/static/white
tonalbackground/brand/fainttext/brand/subtle
tonal · dangerbackground/danger/fainttext/danger/subtle
outlinebackground/surface/lowest · border/gray/softtext/gray/subtle
outline · dangerbackground/surface/lowest · border/danger/softtext/danger/subtle
ghostalpha/tint-12text/gray/subtle
ghost · dangeralpha/tint-12text/danger/subtle
inverted-ghostalpha/tint-12text/static/white

التركيز

في حالة التركيز يُرسم نمط التأثير Focus/focus-ring (effects/focus/main) بسماكة border-width/thicker، وتصبح الحلقة حمراء مع danger. وفي الكود يحدث ذلك تلقائيًا مع :focus-visible.

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

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

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

المفتاحما يفعله
Tabينقل التركيز إلى الزر، وتظهر حلقة التركيز (حمراء مع danger).
EnterSpaceينفّذ الإجراء. أثناء التحميل يبقى التركيز ولا يتكرر الإجراء.

ARIA

  • عنصر <button> أصلي (أو <a> مع render)، فلا حاجة لـrole.
  • التحميل يضبط aria-busy="true" وaria-disabled="true" بدل disabled، فلا يضيع التركيز ويعلن قارئ الشاشة الحالة. غيّر النص أيضًا («جارٍ الحفظ»).
  • الأيقونات زخرفية؛ النص هو الاسم. الأزرار التي لا تحوي إلا أيقونة تأتي في زر الأيقونة.
  • مساحة النقر 48 بكسل على الأقل حتى في sm وxs (WCAG 2.5.8).

افعل

  • ينقل Tab التركيز، ويضغط Enter وSpace الزر. وتظهر عند التركيز حلقة ريتلا بلون العلامة، أو بالأحمر مع danger.
  • حافظ على مساحة لمس بارتفاع 48 بكسل، ويحصل عليها sm وxs من مساحة غير مرئية.
  • أعطِ الإجراءات ذات الأيقونة وحدها تسمية عبر زر الأيقونة.
  • علّم الأزرار أثناء التحميل بأنها مشغولة (aria-busy)، والكود يفعل ذلك عنك.

تجنّب

  • إزالة حلقة التركيز أو تغيير شكلها.
  • الاعتماد على اللون وحده لتمييز الإجراء الرئيسي، فالنمط والموضع يحملانه أيضًا.
  • وضع زرين أقرب من space-8 على شاشات اللمس.

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

ينعكس

  • الأيقونة الأولى في بداية السطر (اليمين في العربية) والأخيرة في نهايته، دون أي خاصية RTL.
  • الأسهم والأسهم المثلثة تنعكس عبر <Icon>: «التالي» يشير إلى اليسار في العربية.
  • ترتيب الإجراءات ينعكس: الرئيسي عند نهاية السطر في الاتجاهين.

لا ينعكس

  • مؤشر التحميل يدور في اتجاه عقارب الساعة في اللغتين.
  • علامات الصح والتنزيل والشعارات داخل الأزرار لا تنعكس.
الأرقام
الأرقام داخل النص («حذف 3 ملفات») تتبع إعداد الأرقام عبر formatNumber، لا الزر.
الخط العربي
النص بنمط body-16 (وbody-14 في xs) بوزن Semibold؛ ارتفاع الزر ثابت، ونص العربية يتسع فيه دون قص.
النص ثنائي الاتجاه
اسم لاتيني داخل نص عربي («تسجيل الدخول باستخدام Google») يوضع في <bdi> كي لا تنتقل علامات الترقيم.

افعل

  • استخدم النسخة العربية لكل زر عربي، حتى دون أيقونات.
  • بدّل الأيقونات الاتجاهية إلى نسختها RTL = Yes.
  • اترك متّسعًا للتسميات العربية، فهي غالبًا أطول من الإنجليزية.
  • اكتب الأرقام في التسميات حسب إعداد الأرقام: «٣ عناصر» أو «3 عناصر».

تجنّب

  • كتابة العربية في النسخة الإنجليزية، فهي تُبقي خط Geist وارتفاعات الأسطر الإنجليزية.
  • عكس مؤشر التحميل أو علامات الصح أو الشعارات.
  • اختصار التسمية العربية لتناسب عرضًا ثابتًا.

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

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

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