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

نموذج العنوان الخليجي

تجريبي
احصل على Ritla UI

نموذج عنوان تتبع حقوله الدولة: العنوان الوطني السعودي المختصر أو الكامل، والإمارة والمنطقة ورقم مكاني في الإمارات بلا رمز بريدي.

المعاينة

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

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

التثبيت

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

    npx ritla add gcc-address-form

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/gcc-address-form

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

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

الاستخدام

gcc-address-form.tsx
import { GccAddressForm } from "@/components/ui/gcc-address-form";<GccAddressForm name="address" onValueChange={setAddress} />

أمثلة

الإمارات

الإمارة والمنطقة والشارع والمبنى ورقم مكاني.

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

مرجع الخصائص

GccAddressForm

الخاصيةالنوعالافتراضيالوصف
countries("SA" | "AE")[]["SA", "AE"]خاصية Country: الدول المعروضة.
value / defaultValue / onValueChangeGccAddressلا يوجدالعنوان: الدولة وحقولها.
citiesSelectOption[]لا يوجدالمدن السعودية قائمةً؛ دونها حقل نصي.
errorsPartial<Record<keyof GccAddress, ReactNode>>لا يوجدأخطاؤك أنت؛ وإلا تُفحص الرموز عند مغادرة حقولها.
namestringلا يوجدبادئة أسماء الحقول في النموذج: address.street.
gccPatterns{ shortAddress, building, postalCode, makani }لا يوجدالأنماط المستعملة في الفحص.

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

ARIA

  • تغيير الدولة يبدّل الحقول التي تحتها؛ كل حقل بتسميته.
  • الفاصل «أو العنوان الكامل» separator، وأي من العنوانين يكفي.

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

ينعكس

  • التسميات والحقول والقوائم تنعكس، ورقم المبنى على اليمين والرمز البريدي على اليسار.

لا ينعكس

  • العنوان المختصر ورقم المبنى والرمز البريدي ورقم مكاني من اليسار إلى اليمين.
الأرقام
الأرقام العربية المكتوبة في الرموز تُحوّل إلى غربية، والحروف إلى كبيرة.
الخط العربي
‏label-16 في الحقول وlabel-12 للتلميحات.