نموذج العنوان الخليجي
نموذج عنوان تتبع حقوله الدولة: العنوان الوطني السعودي المختصر أو الكامل، والإمارة والمنطقة ورقم مكاني في الإمارات بلا رمز بريدي.
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add gcc-address-formويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/gcc-address-formأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { GccAddressForm } from "@/components/ui/gcc-address-form";<GccAddressForm name="address" onValueChange={setAddress} />أمثلة
مرجع الخصائص
GccAddressForm
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
countries | ("SA" | "AE")[] | ["SA", "AE"] | خاصية Country: الدول المعروضة. |
value / defaultValue / onValueChange | GccAddress | لا يوجد | العنوان: الدولة وحقولها. |
cities | SelectOption[] | لا يوجد | المدن السعودية قائمةً؛ دونها حقل نصي. |
errors | Partial<Record<keyof GccAddress, ReactNode>> | لا يوجد | أخطاؤك أنت؛ وإلا تُفحص الرموز عند مغادرة حقولها. |
name | string | لا يوجد | بادئة أسماء الحقول في النموذج: address.street. |
gccPatterns | { shortAddress, building, postalCode, makani } | لا يوجد | الأنماط المستعملة في الفحص. |
إمكانية الوصول
ARIA
- تغيير الدولة يبدّل الحقول التي تحتها؛ كل حقل بتسميته.
- الفاصل «أو العنوان الكامل»
separator، وأي من العنوانين يكفي.
ملاحظات العربية والاتجاه
ينعكس
- التسميات والحقول والقوائم تنعكس، ورقم المبنى على اليمين والرمز البريدي على اليسار.
لا ينعكس
- العنوان المختصر ورقم المبنى والرمز البريدي ورقم مكاني من اليسار إلى اليمين.
- الأرقام
- الأرقام العربية المكتوبة في الرموز تُحوّل إلى غربية، والحروف إلى كبيرة.
- الخط العربي
-
label-16في الحقول وlabel-12للتلميحات.