الرابط
روابط تنقل إلى صفحة أو قسم أو موقع آخر، داخل النص أو وحدها. للأفعال التي تغيّر البيانات استخدم زرًا.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add linkويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/linkالاعتماديات التي يضيفها
@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { TextLink } from "@/components/ui/link";<p> By continuing you agree to our <TextLink href="/terms" size="inline">Terms of service</TextLink>.</p><TextLink href="/transactions" size="md">View all transactions</TextLink>أمثلة
الأنماط
brand لمعظم الروابط، وneutral حيث تكون الروابط هادئة (التذييل، التنقل الثانوي)، وdanger لرابط يقود إلى مسار حذف أو إغلاق، لا للتنقل العادي.
المقاسات
للروابط المستقلة: sm بارتفاع 20px، وmd بارتفاع 24px، وlg بارتفاع 28px، بأيقونات 16 و20 و24px.
الحالات
المرور والتركيز من المؤشر ولوحة المفاتيح. disabled يزيل href فيخرج الرابط من ترتيب Tab ويبقى مرئيًا. أزل الخط السفلي فقط حيث يُفهم الرابط من مكانه.
داخل النص
size="inline" يلتف مع الجملة ويأخذ حجمها ووزنها، أيًا كان نمط النص. أبقِ الخط السفلي في النص الجاري: اللون وحده لا يكفي لتمييز الرابط.
رابط خارجي
external يفتح تبويبًا جديدًا بـrel="noopener noreferrer"، ويضيف سهم الرابط الخارجي، ويخبر قارئ الشاشة بأنه يفتح في تبويب جديد بلغة الصفحة.
مع موجّه التطبيق
مرّر <Link> من Next (أو موجّهك) في render: يبقى التنقل داخل التطبيق والتحميل المسبق، ويضيف TextLink الشكل.
مع سهم
arrow يضيف سهمًا لاحقًا يشير إلى الوجهة (إلى اليسار في العربية) ويتقدّم نحوها عند تمرير المؤشر أو التركيز عليه. للروابط المستقلة مثل «اقرأ الدليل»، لا للروابط داخل الفقرة.
مرجع الخصائص
TextLink
يقبل كل خصائص <a> أيضًا. سُمّي TextLink كي لا يتعارض مع Link في موجّه التطبيق.
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | خاصية Label. |
href | string | لا يوجد | وجهة الرابط. |
tone | "brand" | "neutral" | "danger" | "brand" | خاصية Tone في Figma. |
size | "sm" | "md" | "lg" | "inline" | "lg" | خاصية Size، أو inline داخل النص. |
underline | boolean | true | خاصية Show underline. |
iconLeading | IconComponent | لا يوجد | خاصية Icon leading مع الأيقونة. تنعكس أيقونات الاتجاه في RTL. |
iconTrailing | IconComponent | لا يوجد | خاصية Icon trailing مع الأيقونة. |
arrow | boolean | false | سهم لاحق يشير إلى الوجهة ويتقدّم نحوها عند التمرير أو التركيز. |
external | boolean | false | تبويب جديد، وسهم خارجي، وتنبيه لقارئ الشاشة. |
disabled | boolean | false | خاصية State = Disabled: بلا href، وخارج ترتيب Tab. |
render | ReactElement | لا يوجد | رابط الموجّه (<Link href>) يُعرض بشكل TextLink. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | ينقل التركيز إلى الرابط، مع حلقة التركيز حوله (حلقة الخطأ في danger). |
| Enter | يفتح الرابط. |
ARIA
- عنصر
<a href>حقيقي، فيُعلَن رابطًا ويعمل الفتح في تبويب جديد والنسخ. - الرابط الخارجي يضيف «(يفتح في علامة تبويب جديدة)» لقارئ الشاشة، بالعربية داخل الصفحات العربية.
- المعطّل يحمل
aria-disabled="true"بلاhref، فلا يصل إليه Tab. - الأيقونات زخرفية ومخفية عن قارئ الشاشة؛ النص يسمّي الرابط.
ملاحظات العربية والاتجاه
ينعكس
- الأيقونات الاتجاهية تنعكس: سهم «عرض كل المعاملات» يشير إلى اليسار، وسهم الرابط الخارجي إلى أعلى اليسار.
- الأيقونة البادئة في بداية السطر (اليمين) والتابعة في نهايته.
لا ينعكس
- الأيقونات غير الاتجاهية (المنزل، المساعدة) تبقى كما هي، وكذلك الخط السفلي.
- الأرقام
- الأرقام في نص الرابط تتبع خاصية
numeralsكبقية النص. - الخط العربي
- الروابط المستقلة بأنماط
labelبوزن Medium، بارتفاع سطر أطول في العربية؛ الارتفاع حدّ أدنى فلا يُقص النص. الخط السفلي تحت خط الأساس بـ4px فلا يقطع النقاط تحت الحروف العربية كثيرًا. - النص ثنائي الاتجاه
- داخل الجملة يتبع الرابط اتجاه الفقرة. اسم علامة تجارية لاتينية داخل رابط عربي يوضع في
<bdi>.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.