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

الرابط

احصل على Ritla UI

روابط تنقل إلى صفحة أو قسم أو موقع آخر، داخل النص أو وحدها. للأفعال التي تغيّر البيانات استخدم زرًا.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add link

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

  2. الاعتماديات التي يضيفها

    @phosphor-icons/react

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

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

الاستخدام

link.tsx
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 لرابط يقود إلى مسار حذف أو إغلاق، لا للتنقل العادي.

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

المقاسات

للروابط المستقلة: sm بارتفاع 20px، وmd بارتفاع 24px، وlg بارتفاع 28px، بأيقونات 16 و20 و24px.

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

الحالات

المرور والتركيز من المؤشر ولوحة المفاتيح. disabled يزيل href فيخرج الرابط من ترتيب Tab ويبقى مرئيًا. أزل الخط السفلي فقط حيث يُفهم الرابط من مكانه.

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

داخل النص

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

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

رابط خارجي

external يفتح تبويبًا جديدًا بـrel="noopener noreferrer"، ويضيف سهم الرابط الخارجي، ويخبر قارئ الشاشة بأنه يفتح في تبويب جديد بلغة الصفحة.

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

مع موجّه التطبيق

مرّر <Link> من Next (أو موجّهك) في render: يبقى التنقل داخل التطبيق والتحميل المسبق، ويضيف TextLink الشكل.

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

مع سهم

arrow يضيف سهمًا لاحقًا يشير إلى الوجهة (إلى اليسار في العربية) ويتقدّم نحوها عند تمرير المؤشر أو التركيز عليه. للروابط المستقلة مثل «اقرأ الدليل»، لا للروابط داخل الفقرة.

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

مرجع الخصائص

TextLink

يقبل كل خصائص <a> أيضًا. سُمّي TextLink كي لا يتعارض مع Link في موجّه التطبيق.

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label.
hrefstringلا يوجدوجهة الرابط.
tone"brand" | "neutral" | "danger""brand"خاصية Tone في Figma.
size"sm" | "md" | "lg" | "inline""lg"خاصية Size، أو inline داخل النص.
underlinebooleantrueخاصية Show underline.
iconLeadingIconComponentلا يوجدخاصية Icon leading مع الأيقونة. تنعكس أيقونات الاتجاه في RTL.
iconTrailingIconComponentلا يوجدخاصية Icon trailing مع الأيقونة.
arrowbooleanfalseسهم لاحق يشير إلى الوجهة ويتقدّم نحوها عند التمرير أو التركيز.
externalbooleanfalseتبويب جديد، وسهم خارجي، وتنبيه لقارئ الشاشة.
disabledbooleanfalseخاصية State = Disabled: بلا href، وخارج ترتيب Tab.
renderReactElementلا يوجدرابط الموجّه (<Link href>) يُعرض بشكل TextLink.

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

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

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

المفتاحما يفعله
Tabينقل التركيز إلى الرابط، مع حلقة التركيز حوله (حلقة الخطأ في danger).
Enterيفتح الرابط.

ARIA

  • عنصر <a href> حقيقي، فيُعلَن رابطًا ويعمل الفتح في تبويب جديد والنسخ.
  • الرابط الخارجي يضيف «(يفتح في علامة تبويب جديدة)» لقارئ الشاشة، بالعربية داخل الصفحات العربية.
  • المعطّل يحمل aria-disabled="true" بلا href، فلا يصل إليه Tab.
  • الأيقونات زخرفية ومخفية عن قارئ الشاشة؛ النص يسمّي الرابط.

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

ينعكس

  • الأيقونات الاتجاهية تنعكس: سهم «عرض كل المعاملات» يشير إلى اليسار، وسهم الرابط الخارجي إلى أعلى اليسار.
  • الأيقونة البادئة في بداية السطر (اليمين) والتابعة في نهايته.

لا ينعكس

  • الأيقونات غير الاتجاهية (المنزل، المساعدة) تبقى كما هي، وكذلك الخط السفلي.
الأرقام
الأرقام في نص الرابط تتبع خاصية numerals كبقية النص.
الخط العربي
الروابط المستقلة بأنماط label بوزن Medium، بارتفاع سطر أطول في العربية؛ الارتفاع حدّ أدنى فلا يُقص النص. الخط السفلي تحت خط الأساس بـ4px فلا يقطع النقاط تحت الحروف العربية كثيرًا.
النص ثنائي الاتجاه
داخل الجملة يتبع الرابط اتجاه الفقرة. اسم علامة تجارية لاتينية داخل رابط عربي يوضع في <bdi>.

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

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

  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة