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

منطقة النص

احصل على Ritla UI

حقل نص متعدد الأسطر للإجابات الأطول، كالملاحظات والأوصاف والرسائل، بتسمية حقل الإدخال ونصه المساعد وحالاته، مع عدّاد للأحرف ومقبض لتغيير الارتفاع.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add textarea

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

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

    @base-ui/react@phosphor-icons/react

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

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

الاستخدام

textarea.tsx
import { Textarea } from "@/components/ui/textarea";<Textarea label="Note to recipient" limit={200} helperText="The recipient sees this note." />

أمثلة

الحالات

الحالات والألوان نفسها في حقل الإدخال. اجعل الارتفاع مناسبًا للإجابة المتوقعة: من 3 إلى 6 أسطر (rows).

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

عدّاد الأحرف

limit يُظهر «37/100» بأرقام الصفحة. تجاوز الحد مسموح: يحمرّ العدّاد ويظهر السبب تحت الحقل، فلا يُقطع النص دون رسالة. قارئ الشاشة يسمع «بقي 10 حرفًا» قرب الحد فقط.

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

تغيير الارتفاع

resize: ‏vertical (مقبض Figma، الافتراضي) أو auto (يكبر مع النص حتى maxRows) أو none.

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

مرجع الخصائص

Textarea

يقبل كل خصائص <textarea> أيضًا.

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدخاصية Label.
limitnumberلا يوجدخاصية Counter: العدّاد والحد، دون قطع النص.
limitMessagestringلا يوجدرسالتك عند تجاوز الحد. الافتراضي بلغة الصفحة.
resize"vertical" | "auto" | "none""vertical"مقبض Figma، أو يكبر مع النص، أو ثابت.
rowsnumber4عدد الأسطر الظاهرة.
maxRowsnumberلا يوجدمع resize="auto": أقصى عدد أسطر قبل التمرير.
required / helperText / error / disabled / readOnly…لا يوجدكما في حقل الإدخال.

إرشادات الاستخدام

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

1. منطقة نص أم حقل إدخال

طابِق الصندوق مع الإجابة. إن كانت الإجابة كلمات قليلة فاستخدم حقل الإدخال، فالصندوق الطويل يجعل الإجابة القصيرة تبدو خطأ. واستخدم منطقة النص حين تكون الإجابة جملًا، ويحتاج الناس إلى رؤية ما كتبوه أثناء الكتابة.

الإجابةاستخدمالسبب
اسم، مدينة، عنوان، رمز قصيرحقل الإدخالسطر واحد، ويمكن أن يرسل Enter النموذج.
ملاحظات، وصف، مراجعة، رسالةمنطقة النصعدة أسطر ظاهرة أثناء الكتابة، وEnter يضيف سطرًا.
خيار واحد من قائمة معروفةالقائمة المنسدلةلا كتابة، ولا أخطاء إملائية.

الصندوق يحدد التوقعات

حقلان في نموذج توصيل.

افعل: منطقة نص للملاحظاتمساحة لشرح أين يُترك الطرد.
تجنّب: منطقة نص للمدينةصندوق طويل لكلمة واحدة يبدو كأنه يطلب فقرة.

2. الارتفاع وتغيير الحجم

اعرض من 3 إلى 6 أسطر بقدر الإجابة المتوقعة: الملاحظة القصيرة تحتاج إلى 3، ووصف المنتج إلى 6. واسمح للناس بزيادة الارتفاع. في الكود resize="vertical" (الافتراضي) يُبقي مقبض Figma، وresize="auto" يكبّر الصندوق مع النص حتى maxRows، وresize="none" يثبّت الارتفاع.

افعل

  • اجعل الصندوق بقدر الإجابة المتوقعة، بين 3 و6 أسطر.
  • اسمح للصندوق بأن يكبر أو يُغيَّر حجمه عموديًا.
  • أبقِ عرضه مثل عرض الحقول الأخرى في النموذج.

تجنّب

  • عرض منطقة نص بسطر واحد؛ ذلك حقل إدخال.
  • السماح بتغيير الحجم أفقيًا، فهو يكسر تخطيط النموذج.
  • جعل الصندوق أطول من الشاشة على الجوال.

3. حدّ الأحرف

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

قل ما العمل بعد الحد

وصف قصير لمنتج.

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

افعل

  • اذكر الحد في النص المساعد قبل أن يبدأ الناس.
  • اسمح بالكتابة بعد الحد، ثم اعرض حالة الخطأ مع رسالة.
  • استخدم رسالتك الخاصة للحد حين لا تناسب الرسالة الافتراضية.

تجنّب

  • قص النص بصمت عند الحد.
  • عرض عدّاد حين لا يوجد حد.
  • عرض الخطأ بعدّاد أحمر فقط دون رسالة.

4. العربية والإنجليزية ومزيج منهما

يكتب الناس ملاحظاتهم باللغة التي يفكرون بها، وكثيرًا بالاثنتين. في الكود يأخذ النص dir="auto"، فتسير كل فقرة في اتجاهها. وفي الشاشات العربية استخدم النسخة العربية: تُحاذى التسمية والنص المساعد إلى اليمين، وينتقل العدّاد ومقبض تغيير الحجم إلى أسفل اليسار، أي نهاية السطر.

نموذج عربي ونص مختلط

ملاحظة توصيل في صفحة دفع عربية.

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

قبل التسليم

  • منطقة النص فقط حيث تحتاج الإجابات إلى جمل.
  • الارتفاع بين 3 و6 أسطر، ونمط تغيير الحجم مدوّن.
  • الحد، إن وُجد، في النص المساعد، مع رسالة خطأ.
  • الشاشات العربية تستخدم النسخة العربية.

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

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

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

المفتاحما يفعله
Tabينقل التركيز إلى الحقل؛ Enter يضيف سطرًا.

ARIA

  • عنصر <textarea> حقيقي بتسمية، والنص المساعد والعدّاد مرتبطان عبر aria-describedby.
  • قرب الحد (20 و10 و5 و0 أحرف) وعند تجاوزه يُعلَن الباقي بهدوء، لا مع كل حرف.
  • تجاوز الحد يضع aria-invalid ويُظهر السبب.
  • مقبض تغيير الارتفاع للمؤشر واللمس فقط ومخفي عن قارئ الشاشة؛ resize="auto" بديل لا يحتاج سحبًا.

افعل

  • تسمية ظاهرة، وهي اسم الحقل الذي يُعلَن.
  • مفتاح Enter يضيف سطرًا جديدًا، والإرسال بزر النموذج.
  • أبقِ العدّاد مقروءًا بلون النص المساعد.

تجنّب

  • الإرسال بمفتاح Enter داخل منطقة النص.
  • وضع التعليمات الوحيدة في النص المؤقت.

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

ينعكس

  • العدّاد والمقبض في نهاية السطر (أسفل اليسار)، والمقبض ينعكس ليشير إلى الزاوية.

لا ينعكس

  • العدّاد «37/100» معزول من اليسار إلى اليمين.
الأرقام
العدّاد يتبع numerals: ‏٣٧/١٠٠ أو 37/100.
الخط العربي
النص body-16 بارتفاع سطر أطول في العربية، فيتسع السطر الواحد للحركات.
النص ثنائي الاتجاه
الحقل يأخذ dir="auto": ملاحظة إنجليزية في نموذج عربي تجري من اليسار وتبقى علامة ترقيمها في آخرها.

افعل

  • النسخة العربية في كل شاشة عربية.
  • أبقِ dir="auto"، ولا تفرض اتجاهًا على النص.
  • أسماء العلامات والمنتجات بخطها هي داخل النص العربي.

تجنّب

  • نص عربي في النسخة الإنجليزية.
  • عكس مقبض تغيير الحجم يدويًا.

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

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

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