المكوّنات
ترجمة لـفهرس المكوّنات بالإنجليزية. إن اختلفت الترجمة عن الأصل، فالإنجليزية هي المرجع.
وهذه ترجمة لكل المواصفات؛ وتربط بها صفحة العناصر حين تكون الصفحة بالعربية، وكل منها صفحة قائمة بذاتها في الموقع. وحين تتغير مواصفات بالإنجليزية، تتغير ترجمتها معها.
وتراها تعمل كلها في صفحة العناصر، وبـReact، في صفحة لكل منها، في الأمثلة (انظر docs/react.md، بالإنجليزية).
تغطي كل مواصفات: البنية، والأنواع والأحجام، والحالات، ولوحة المفاتيح، وARIA، والكتابة من اليمين إلى اليسار، وما يُفعل وما لا يُفعل، والرموز التي يستخدمها المكوّن (مأخوذة من ملف CSS الخاص به). وتراها تعمل في صفحة العناصر.
| المكوّن | ما هو |
|---|---|
| الزر | إجراء. |
| الحقل | عنصر إدخال في نموذج، مع تسميته وتلميحه وخطئه. |
| مربع الاختيار وزر الاختيار ومفتاح التبديل | مربعات اختيار وأزرار اختيار أصلية بلون التمييز، ومفتاح تبديل للإعدادات التي تسري فورًا. |
| عنصر التحكم المقسم | خيار واحد من بين خيارين إلى خمسة خيارات قصيرة، ظاهرة كلها معًا. |
| الطيّ | عنصر <details> أصلي لما هو ثانوي، يعرض اختياريًا ما اختير بداخله وهو مطويّ (الطيّة مع قيمة ملخصة). |
| البطاقة واللوح والإحصائيات والاقتباس | حاويات، والأرقام التي تبدأ بها الصفحة، وما قاله أحدهم. |
| رأس الصفحة | عنوان الصفحة، وفي الجهة الختامية ما ينطبق على الصفحة كلها: إعداداتها وطرق عرضها وإجراؤها الرئيسي. |
| علامات التبويب وتنقل الأقسام | علامات تبويب بين طرق عرض شيء واحد، وتنقل أقسام بين الصفحات؛ يتشابهان في الشكل ويختلفان في الترميز. |
| ترويسة الموقع | الشريط العلوي للموقع: التركيبة، والأقسام، واللغة والمظهر؛ وقائمة تحت md. |
| الشريط الجانبي | أقسام التطبيق في عمود يمكن طيّه إلى أيقونات؛ وشريط قابل للتمرير في الأعلى تحت نقطة التوقف md. |
| الرابط النصي | رابط قائم بذاته: تحته خط بلون التمييز، ومعه سهم إلى خطوة تالية أو أيقونة إلى موقع آخر. |
| رابط اللغة | الصفحة نفسها باللغة الأخرى، مسمّاة بتلك اللغة. |
| التذييل | من صنعه، وإلى أين بعد ذلك، والسطر القانوني؛ هادئ، ومتطابق في كل صفحة. |
| الخطوات | تسلسل مرقّم: مراحل إنجاز أمر ما. |
| الجدول | لمقارنة القيم: الأرقام تصطف، والإجمالي يبرز، والملاحظات الجانبية تتراجع. |
| الشارة والوسم | الشارة حالة قصيرة بجانب شيء ما («نشط»، «تجريبي»، عدد). |
| الإشعار وملاحظة الأثر الجانبي | الإشعار رسالة داخل الصفحة، بأربعة أنواع. |
| الإشعار العابر | يقول ما حدث للتو، باختصار ودون أن يعيق؛ ويعرض «تراجع» حين يمكن التراجع. |
| مربع الحوار | عنصر <dialog> أصلي، لقرار يحتاج انتباه الشخص الآن. |
| القائمة | إجراءات على شيء واحد، خلف زر («المزيد»، «نقل إلى…»)، في نافذة منبثقة أصلية. |
| تلميح الأدوات | تسمية قصيرة لزر أيقونة أو لعلامة في رسم بياني، عند التمرير والتركيز. |
| الحالة الفارغة | لماذا لا يوجد شيء هنا، والإجراء التالي. |
| التحميل والتقدم | التقدم يظهر حيث يجري العمل: مؤشر دوّار في العنصر أو المنطقة المشغولة، وهيكل مبدئي حيث سيظهر المحتوى، وشريط حين يمكن قياس التقدم. |
| التغييرات المعلّقة: حالة الحفظ، والحقل المتغيّر، والتراجع التلقائي، والنتائج القديمة | هل حُفظ التغيير، وما الذي تغيّر ولم يُحفظ، وتغيير متفائل فشل فأُعيد، ونتيجة لم تعد تطابق مدخلاتها. |
| شريط الإجراءات الجماعية | حين تُحدَّد عناصر: كم عددها، وما يمكن فعله بها كلها، وطريقة لإلغاء التحديد. |
| مفاتيح لوحة المفاتيح والاختصارات | المفاتيح، وقائمة الاختصارات التي يفتحها ?. |
| جدار الشعارات | من يستخدمه: شعاراتهم بلون واحد، بقدر ما يتسع الصف. |
| دعوة إلى الفعل | كلمة الصفحة الأخيرة: سطر واحد، ثم ما يُفعل. |
| في هذه الصفحة | أقسام الصفحة بجانبها، ويُعلَّم القسم الذي يُقرأ أثناء التمرير. |
| العودة إلى الأعلى | في الصفحة الطويلة، رابط للعودة إلى أعلاها، يظهر في الزاوية بعد أن تُمرَّر الصفحة شاشتين. |
| الشيفرة والأمر | شيفرة تُقرأ أو تُنسخ، من اليسار إلى اليمين دائمًا، والأسطر المهمة فيها مُعلَّمة؛ وأمر، سطر واحد يُلصق. |
| الرسوم البيانية | أعمدة، وشريط منقسم، ومخطط نقطي موجّه، بلغة HTML وCSS فقط. |
| الهوية: العلامة، والشعار النصي، والتركيبة | العلامة (بلاطة واحدة من النمط في إطار مربع) بجانب الشعار النصي. |
| الإسناد | «من منتجات معامل آرابيسك»، أو «من معامل آرابيسك»: السطر الذي يحمله كل منتج من منتجات الشركة، مكوّنًا وصورًا. |
| النمط الزخرفي | تبليط بلاطة العلامة: نسيجًا خلف شريط، أو عبر القسم الافتتاحي مع بلاطته المحورية، مرسومًا عند التحميل. |
| شكل الإنشاء | كيف يُصنع النمط، في ثلاث خطوات تُقرأ بلغة البرمجيات. |
| الأيقونة | أيقونات خطية من ملف الأيقونات المجمّع. |
| مسار التنقل ورابط الرجوع | مسار التنقل يُظهر موقع الصفحة في التسلسل؛ ورابط الرجوع يعود إلى الخطوة السابقة في مسار عمل. |
| التأكيد | يقول إن شيئًا قد تم، ويعطي رقمًا مرجعيًا إن وُجد، ويقول ما سيحدث بعد ذلك. |
| عداد الحروف | حدّ على حقل نصي، يُعبَّر عنه بما تبقى، وبمقدار التجاوز حين يُتجاوز. |
| حقل التاريخ | ثلاثة حقول لتاريخ يعرفه الناس مسبقًا (تاريخ ميلاد، تاريخ إصدار). |
| منتقي التاريخ | تاريخ قريب من اليوم، يُكتب أو يُختار من تقويم بلغة الصفحة. |
| ملخص الأخطاء | عند إرسال نموذج فيه مشكلات: قائمة في أعلى النموذج، كل مشكلة فيها رابط إلى حقلها. |
| شريط المرحلة | يخبر الناس أن الخدمة جديدة أو تجريبية، وأين يقولون رأيهم. |
| البحث | حقل بحث بتسمية ظاهرة وأيقونة بحث وزر مسح. |
| قائمة الملخص | حقائق في أزواج من مفتاح وقيمة، لكلٍّ منها اختياريًا رابط «تغيير»: خطوة «راجع إجاباتك»، أو تفاصيل سجل. |
| قائمة المهام | أجزاء عمل طويل، لكلٍّ منها حالته، فيُنجزها الناس بأي ترتيب ويرون ما تبقى. |
| الدرجات اللونية: التمييز والوسم والصورة الرمزية | ألوان خفيفة للإبراز والهوية. |
| ترقيم الصفحات | صفحات قائمة طويلة، روابطَ: «السابقة» و«التالية» بالكلمات، والأرقام حول الصفحة الحالية. |
| مؤشر الخطوات | أين يقف الشخص في مسار من ثلاث إلى ست خطوات: المكتملة، والحالية، والقادمة، و«الخطوة 2 من 4». |
| الحالة | حالة بكلمة، تسبقها نقطة بلون الحالة. |
| التقييم | من واحد إلى خمسة، أزرار اختيار مرسومة بنجمة العلامة، لكل منها اسم بالكلمات؛ أو معروضًا، صورةً مسمّاة بقيمتها. |
| الخط الزمني | ما جرى، كل حدث في وقته، على امتداد خط: تاريخ سجلّ أو موجز نشاط. |
| القائمة | أشياء من نوع واحد، كل منها في صف، بينها خطوط رفيعة؛ والصف الذي يفتح شيئًا رابطٌ من حافة إلى حافة. |
| النافذة المنبثقة | مزيد عن شيء ما، حين يُطلب: يفتحها زر بجانبه، في popover أصلي. |