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

حقل النسخ

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

قيمة يحتاج الناس إلى نسخها كما هي، كرقم الآيبان أو المرجع أو رمز الخصم، مع زر يؤكد النسخ.

المعاينة

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

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

التثبيت

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

    npx ritla add copy-field

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

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

    @phosphor-icons/react

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

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

الاستخدام

copy-field.tsx
import { CopyField } from "@/components/ui/copy-field";<CopyField label="IBAN" value="JO94CBJO0010000000000131000" />

مرجع الخصائص

CopyField

الخاصيةالنوعالافتراضيالوصف
valuestringلا يوجدالقيمة كما تُنسخ.
displayReactNodeلا يوجدطريقة عرضها إن اختلفت، كتقسيم الآيبان أربعًا أربعًا.
variant"field" | "inline""field"خاصية Style.
label / aria-labelReactNode / stringلا يوجدخاصية Show label، أو اسم لقارئ الشاشة حين تُخفى.
showButtonLabelbooleantrueخاصية Show button label.
onCopy(value) => voidلا يوجدبعد نسخ ناجح.

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

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

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

المفتاحما يفعله
TabEnterيصل إلى الزر وينسخ.

ARIA

  • «تم النسخ» تُعلن بمنطقة حيّة مهذبة، ولا تُعلن حين يفشل النسخ.
  • الزر موصوف بالقيمة التي ينسخها.

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

ينعكس

  • التسمية والزر يتبعان الصفحة: الزر في نهاية السطر على اليسار.

لا ينعكس

  • القيمة لاتينية من اليسار إلى اليمين دائمًا، حتى في العربية.
الأرقام
أرقام القيمة كما هي؛ لا تُحوَّل أبدًا لأنها تُنسخ.
الخط العربي
‏body-16 للقيمة وbody-14 Medium للتسمية والزر.
النص ثنائي الاتجاه
القيمة داخل <bdi dir="ltr"> فلا ينقلب ترتيب الآيبان، والكتلة تحفظ اتجاه الصفحة لتبدأ القيمة من بدايتها.