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

رأس التطبيق

احصل على Ritla UI

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

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add app-header

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

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

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

الاستخدام

app-header.tsx
import { AppHeader } from "@/components/ui/app-header";<AppHeader  title="Transfer money"  leading={<IconButton variant="ghost" shape="square" size="md" icon={ArrowLeftIcon} label="Back" />}  actions={<IconButton variant="ghost" shape="round" size="md" icon={DotsThreeVerticalIcon} label="More" />}/>

أمثلة

المتوسط والكبير والإجراءات فقط

للشاشات الرئيسية: العنوان تحت الإجراءات، مع صورة رمزية. «الإجراءات فقط» بلا عنوان.

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

عنوان في الوسط وخانة البحث

‏align="center" يبقي العنوان في منتصف الشريط مهما اختلف عرض الجانبين، والرجوع رابط <Link>. الأبناء تملأ الخانة تحت الشريط (حقل بحث أو تبويبات).

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

مرجع الخصائص

AppHeader

الخاصيةالنوعالافتراضيالوصف
type"small" | "medium" | "large" | "actions-only""small"خاصية Type.
titleReactNodeلا يوجدعنوان الشاشة، وهو عنوان الصفحة.
subtitleReactNodeلا يوجدخاصية Supporting text.
align"default" | "center""default"خاصية Alignment.
leadingReactNodeلا يوجدالعنصر في البداية، عادة زر رجوع IconButton.
actionsReactNodeلا يوجدإجراءان أو ثلاثة وصورة رمزية أو قائمة.
headingLevel1 | 2 | 31مستوى عنوان الشاشة.
childrenReactNodeلا يوجدخاصية slot: حقل بحث أو تبويبات تحت الشريط.

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

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

1. أي مقاس

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

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

2. العنوان

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

عناوين قصيرة ومطابقة

شاشة تفاصيل تحويل.

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

افعل

  • طابِق العنوان مع عنصر التنقل أو الزر الذي فتح الشاشة.
  • اجعله سطرًا واحدًا؛ العناوين الطويلة تلتف أو تُقص.
  • استخدم النص المساعد للسياق: الحساب، التاريخ، العدد.

تجنّب

  • كتابة العنوان جملةً أو تعليمات.
  • وضع اسم التطبيق في كل عنوان.
  • تكرار العنوان في النص المساعد.

3. الإجراءات

أبقِ من إجراء إلى ثلاثة إجراءات في النهاية لما يفعله الناس كثيرًا في هذه الشاشة: البحث، المشاركة، التعديل. وضع الباقي في قائمة «المزيد». وإجراءات النماذج الرئيسية («حفظ»، «إرسال») مكانها أسفل النموذج، حيث ينتهي الناس.

إجراءات قليلة ومتكررة

قائمة التحويلات.

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

افعل

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

تجنّب

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

4. الرجوع والعربية

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

الرجوع يشير إلى حيث جئت

شاشة التحويلات بالعربية.

افعل: النسخة العربيةالرجوع والعنوان على اليمين، والسهم يشير إلى اليمين، عائدًا إلى الشاشة السابقة.
تجنّب: الشريط الإنجليزي في شاشة عربيةيشير الرجوع إلى اليسار، فيُقرأ «التالي» عند القارئ العربي.

5. التمرير

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

افعل

  • ثبّت الرأس في الشاشات الطويلة.
  • اطوِ المتوسط والكبير إلى الصغير مع التمرير.
  • استخدم الخانة لبحث أو تبويبات تخص الشاشة كلها.

تجنّب

  • إخفاء الرأس مع التمرير حين يكون الرجوع المخرج الوحيد.
  • وضع محتوى الصفحة، مثل نموذج، في الخانة.

قبل التسليم

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

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

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

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

المفتاحما يفعله
Tabبين عناصر التحكم بترتيب القراءة: الرجوع ثم الإجراءات.

ARIA

  • الشريط عنصر header، والعنوان عنوان الصفحة (h1 افتراضيًا).
  • كل زر أيقونة له اسم: رجوع، بحث، الإشعارات، المزيد. ومساحة اللمس 48 بكسل.
  • لا تضع زر الحفظ أو الإرسال في الشريط وحده.

افعل

  • العنوان هو عنوان الصفحة (h1).
  • سمِّ كل زر أيقونة بلغة الصفحة: «رجوع»، «بحث»، «المزيد».
  • مساحة لمس 48 بكسل لكل زر.

تجنّب

  • أسماء عامة أو خاطئة على أزرار الأيقونات.
  • عنوان الرأس صورةً أو شعارًا فقط.

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

ينعكس

  • الرجوع على اليمين ويتجه لليمين، والإجراءات على اليسار.
  • العنوان يبدأ من اليمين، والعنوان في الوسط يبقى في الوسط.

لا ينعكس

  • أيقونات البحث والإشعارات والمزيد، والصورة الرمزية.
الأرقام
الأرقام في العنوان الفرعي (الخطوة 2 من 3) كما تمرّرها.
الخط العربي
الصغير body-16، والمتوسط body-20، والكبير heading-36، بوزن Medium؛ والارتفاعات حدود دنيا لأن العناوين العربية أطول.
النص ثنائي الاتجاه
لا تثبّت سهمًا لليسار: ArrowLeftIcon ينعكس وحده في العربية.

افعل

  • النسخة العربية في كل شاشة عربية.
  • اكتب العناوين بالعربية أصلًا؛ وكثيرًا ما تحتاج إلى عرض أكبر.
  • أبقِ الأيقونات التي لا اتجاه لها، مثل البحث والجرس، كما هي.

تجنّب

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

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

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

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