شريط البحث
البحث في رأس التطبيق: شريط مستدير بارتفاع 56px بزر القائمة وحقل البحث وحتى إجراءين أو الصورة الرمزية.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add search-barويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/search-barأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { SearchBar } from "@/components/ui/search-bar";<SearchBar label="Search" leading={<IconButton variant="ghost" size="md" shape="round" icon={ListIcon} label="Menu" />} trailing={<IconButton variant="ghost" size="md" shape="round" icon={MicrophoneIcon} label="Search by voice" />}/>أمثلة
الإجراءات
إجراء أو إجراءان في النهاية (Show 2nd button). سهم الرجوع في البداية ينعكس مع اتجاه القراءة.
مرجع الخصائص
SearchBar
يقبل خصائص <input> أيضًا.
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | string | لا يوجد | اسم الحقل لقارئ الشاشة ونصه النائب. اكتبه بلغة الصفحة. |
leading | ReactNode | لا يوجد | Leading Button: عادةً زر أيقونة مستدير للقائمة. |
trailing | ReactNode | لا يوجد | Trailing Button 1 و2 أو الصورة الرمزية (Show avatar). |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | زر القائمة، ثم الحقل ويصير إطار الشريط أزرق داكنًا مع هالة خفيفة، ثم الإجراءات. |
ARIA
- الشريط
role="search"والحقلtype="search"باسم (label). - أزرار الأيقونات تحتاج أسماء (
labelفي IconButton).
ملاحظات العربية والاتجاه
ينعكس
- زر القائمة في بداية الشريط (اليمين) والإجراءات في نهايته (اليسار).
لا ينعكس
- أيقونات القائمة والعدسة والميكروفون لا تنعكس.
- الأرقام
- لا أرقام في الشريط.
- الخط العربي
label-16.- النص ثنائي الاتجاه
- الحقل يأخذ
dir="auto".
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.