مقدّمة

ما الكتلة

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

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

الصور

لا تتضمن الكتل صورًا. تعرض الكتلة التي فيها صورة مساحة بديلة، وتعرض الكتلة التي فيها أشخاص الأحرف الأولى من أسمائهم، حتى تمرّر صورك أنت: تأخذ image قيمتي src، alt، ويأخذ كل شخص src.

الكتل ذات السطح المعكوس

بعض الكتل على سطح معكوس: داكن في الوضع الفاتح، وفاتح في الوضع الداكن. تُلوَّن هذه الكتل بالرموز المعكوسة، فلا تفرض صنف الوضع الداكن على أي قسم. وإذا ثبّتّ إحداها بالأمر npx @smicolon/fasla-ui@latest add أو بالأمر npx shadcn@latest add، فإن الأمر يضيف ربط هذه الرموز إلى ملف الأنماط.

تحتاج الكتلة المعكوسة إذا ثبّتّها يدويًا إلى ثلاثة أسطر من CSS: راجع التثبيت.

عائلات الكتل

• الأسئلة الشائعة (FAQ): ستة وعشرون قسمًا للأسئلة الشائعة، من قائمة أسئلة في الوسط إلى البحث والتبويبات ومحادثة الدعم، متجاوبة ومعكوسة للعربية.