رأس التطبيق
أعلى الشاشة: الرجوع، وعنوان الشاشة، وبعض الإجراءات. الصغير يبقي العنوان في السطر نفسه، والمتوسط والكبير يضعان عنوانًا أكبر تحت الإجراءات للشاشات الرئيسية.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add app-headerويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/app-headerأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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" />}/>أمثلة
المتوسط والكبير والإجراءات فقط
للشاشات الرئيسية: العنوان تحت الإجراءات، مع صورة رمزية. «الإجراءات فقط» بلا عنوان.
عنوان في الوسط وخانة البحث
align="center" يبقي العنوان في منتصف الشريط مهما اختلف عرض الجانبين، والرجوع رابط <Link>. الأبناء تملأ الخانة تحت الشريط (حقل بحث أو تبويبات).
مرجع الخصائص
AppHeader
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
type | "small" | "medium" | "large" | "actions-only" | "small" | خاصية Type. |
title | ReactNode | لا يوجد | عنوان الشاشة، وهو عنوان الصفحة. |
subtitle | ReactNode | لا يوجد | خاصية Supporting text. |
align | "default" | "center" | "default" | خاصية Alignment. |
leading | ReactNode | لا يوجد | العنصر في البداية، عادة زر رجوع IconButton. |
actions | ReactNode | لا يوجد | إجراءان أو ثلاثة وصورة رمزية أو قائمة. |
headingLevel | 1 | 2 | 3 | 1 | مستوى عنوان الشاشة. |
children | ReactNode | لا يوجد | خاصية slot: حقل بحث أو تبويبات تحت الشريط. |
إرشادات الاستخدام
رأس التطبيق يسمّي الشاشة ويحمل الرجوع وإجراءاتها المتكررة. هنا: أي مقاس تختار، وكيف تكتب العنوان، وكم إجراء تضع، وكيف يعمل الرجوع في العربية، وما تتحقق منه قبل التسليم.
1. أي مقاس
المقاس الصغير يُبقي العنوان في الشريط بجوار الرجوع، للشاشات داخل مسار. والمتوسط والكبير يضعان عنوانًا أكبر تحت الإجراءات، للشاشات الرئيسية التي يصل إليها الناس. ونوع «الإجراءات فقط» يحذف العنوان حين تعرضه الشاشة في مكان آخر، مثل فوق صورة.
| النوع | الاستخدام |
|---|---|
| صغير | شاشات التفاصيل والخطوات داخل مسار؛ الرجوع هو الإجراء الرئيسي. |
| متوسط | الشاشات الرئيسية من شريط التنقل. |
| كبير | الشاشة الأولى في قسم، حين تتسع لعنوان كبير. |
| الإجراءات فقط | شاشات تعرض عنوانها بنفسها، مثل صورة منتج أو خريطة. |
2. العنوان
العنوان يسمّي الشاشة في كلمتين أو ثلاث، بكلمات العنصر الذي أوصل إليها نفسها. وهو عنوان الصفحة لقارئات الشاشة. والنص المساعد يضيف سياقًا واحدًا، مثل الحساب الذي تنتمي إليه الشاشة.
عناوين قصيرة ومطابقة
شاشة تفاصيل تحويل.
افعل
- طابِق العنوان مع عنصر التنقل أو الزر الذي فتح الشاشة.
- اجعله سطرًا واحدًا؛ العناوين الطويلة تلتف أو تُقص.
- استخدم النص المساعد للسياق: الحساب، التاريخ، العدد.
تجنّب
- كتابة العنوان جملةً أو تعليمات.
- وضع اسم التطبيق في كل عنوان.
- تكرار العنوان في النص المساعد.
3. الإجراءات
أبقِ من إجراء إلى ثلاثة إجراءات في النهاية لما يفعله الناس كثيرًا في هذه الشاشة: البحث، المشاركة، التعديل. وضع الباقي في قائمة «المزيد». وإجراءات النماذج الرئيسية («حفظ»، «إرسال») مكانها أسفل النموذج، حيث ينتهي الناس.
إجراءات قليلة ومتكررة
قائمة التحويلات.
افعل
- اعرض ثلاثة إجراءات على الأكثر، الأكثر استخدامًا.
- انقل الباقي إلى قائمة «المزيد» عند نهاية السطر.
- سمِّ كل إجراء بأيقونة: «بحث»، «مشاركة»، «المزيد».
تجنّب
- ملء الرأس بأربع أيقونات أو أكثر.
- وضع «حفظ» أو «إرسال» في الرأس وحده.
- الجمع بين الصورة الرمزية وثلاثة إجراءات على الشاشات الصغيرة.
4. الرجوع والعربية
يشير الرجوع إلى حيث جاء الناس: اليسار في الإنجليزية، واليمين في العربية. والنسخة العربية تعكس الشريط كله: الرجوع والعنوان على اليمين، والإجراءات على اليسار، وسهم الرجوع بأيقونته العربية. وفي الكود ينعكس السهم وحده؛ لا تثبّت سهمًا يشير إلى اليسار.
الرجوع يشير إلى حيث جئت
شاشة التحويلات بالعربية.
5. التمرير
يبقى الرأس في الأعلى أثناء تمرير المحتوى. وينطوي المتوسط والكبير إلى الصغير مع التمرير، فيبقى العنوان ظاهرًا دون أن يأخذ مساحة. والخانة تحت العنوان تحمل حقل بحث أو تبويبات تخص الشاشة كلها.
افعل
- ثبّت الرأس في الشاشات الطويلة.
- اطوِ المتوسط والكبير إلى الصغير مع التمرير.
- استخدم الخانة لبحث أو تبويبات تخص الشاشة كلها.
تجنّب
- إخفاء الرأس مع التمرير حين يكون الرجوع المخرج الوحيد.
- وضع محتوى الصفحة، مثل نموذج، في الخانة.
قبل التسليم
- المقاس يطابق مستوى الشاشة.
- العنوان يطابق ما فتح الشاشة.
- ثلاثة إجراءات على الأكثر، كل منها مسمّى.
- الشاشات العربية تستخدم النسخة العربية، والرجوع يشير إلى اليمين.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | بين عناصر التحكم بترتيب القراءة: الرجوع ثم الإجراءات. |
ARIA
- الشريط عنصر
header، والعنوان عنوان الصفحة (h1افتراضيًا). - كل زر أيقونة له اسم: رجوع، بحث، الإشعارات، المزيد. ومساحة اللمس 48 بكسل.
- لا تضع زر الحفظ أو الإرسال في الشريط وحده.
افعل
- العنوان هو عنوان الصفحة (
h1). - سمِّ كل زر أيقونة بلغة الصفحة: «رجوع»، «بحث»، «المزيد».
- مساحة لمس 48 بكسل لكل زر.
تجنّب
- أسماء عامة أو خاطئة على أزرار الأيقونات.
- عنوان الرأس صورةً أو شعارًا فقط.
ملاحظات العربية والاتجاه
ينعكس
- الرجوع على اليمين ويتجه لليمين، والإجراءات على اليسار.
- العنوان يبدأ من اليمين، والعنوان في الوسط يبقى في الوسط.
لا ينعكس
- أيقونات البحث والإشعارات والمزيد، والصورة الرمزية.
- الأرقام
- الأرقام في العنوان الفرعي (الخطوة 2 من 3) كما تمرّرها.
- الخط العربي
- الصغير
body-16، والمتوسطbody-20، والكبيرheading-36، بوزن Medium؛ والارتفاعات حدود دنيا لأن العناوين العربية أطول. - النص ثنائي الاتجاه
- لا تثبّت سهمًا لليسار:
ArrowLeftIconينعكس وحده في العربية.
افعل
- النسخة العربية في كل شاشة عربية.
- اكتب العناوين بالعربية أصلًا؛ وكثيرًا ما تحتاج إلى عرض أكبر.
- أبقِ الأيقونات التي لا اتجاه لها، مثل البحث والجرس، كما هي.
تجنّب
- الشريط الإنجليزي في شاشة عربية، فيشير الرجوع إلى الأمام.
- قلب صورة الشريط كله يدويًا.
- عكس أيقونة البحث أو الإشعارات.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.