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

شريط البحث

احصل على Ritla UI

البحث في رأس التطبيق: شريط مستدير بارتفاع 56px بزر القائمة وحقل البحث وحتى إجراءين أو الصورة الرمزية.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add search-bar

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

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

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

الاستخدام

search-bar.tsx
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). سهم الرجوع في البداية ينعكس مع اتجاه القراءة.

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

مرجع الخصائص

SearchBar

يقبل خصائص <input> أيضًا.

الخاصيةالنوعالافتراضيالوصف
labelstringلا يوجداسم الحقل لقارئ الشاشة ونصه النائب. اكتبه بلغة الصفحة.
leadingReactNodeلا يوجد‏Leading Button: عادةً زر أيقونة مستدير للقائمة.
trailingReactNodeلا يوجد‏Trailing Button 1 و2 أو الصورة الرمزية (Show avatar).

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

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

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

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

ARIA

  • الشريط role="search" والحقل type="search" باسم (label).
  • أزرار الأيقونات تحتاج أسماء (label في IconButton).

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

ينعكس

  • زر القائمة في بداية الشريط (اليمين) والإجراءات في نهايته (اليسار).

لا ينعكس

  • أيقونات القائمة والعدسة والميكروفون لا تنعكس.
الأرقام
لا أرقام في الشريط.
الخط العربي
label-16.
النص ثنائي الاتجاه
الحقل يأخذ dir="auto".

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

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

  • R023حقول نص تُعرض من اليسار إلى اليمين حيث يُتوقع إدخال عربي