مكتبة CSS/JS خفيفة (~4KB) تُقدِّم متغيرات type scale مُعايَرة خصيصاً للعربي، line-height مُحسَّن، وpresets جاهزة لـ Tailwind وCSS خالص. RTL-first. بلا تبعيات.
صُمِّم من الصفر لحل مشاكل حقيقية في الطباعة العربية على الويب
لقطات من المنتج
10 مستويات مُعايَرة على أساس 16px - تُغطي كل حالة من التعليق حتى البطل
| المتغير | rem | px | معاينة | الاستخدام |
|---|---|---|---|---|
| --q-text-xs | 0.640rem | ~10px | نص تعليق صغير جداً | تسميات توضيحية |
| --q-text-sm | 0.800rem | ~13px | نص ثانوي صغير | caption, label |
| --q-text-base | 1.000rem | 16px | النص الأساسي | body |
| --q-text-md | 1.125rem | 18px | نص متوسط | lead paragraph |
| --q-text-lg | 1.250rem | 20px | عنوان صغير | h5, h6 |
| --q-text-xl | 1.563rem | 25px | عنوان متوسط | h4 |
| --q-text-2xl | 1.953rem | 31px | عنوان كبير | h3 |
| --q-text-3xl | 2.441rem | 39px | عنوان قسم | h2 |
| --q-text-4xl | 3.052rem | 49px | بطل صغير | h1 |
| --q-text-5xl | 3.815rem | 61px | بطل | hero |
فئات CSS مُركَّبة تجمع الحجم والوزن وارتفاع السطر دفعة واحدة
.q-hero
.q-heading .q-h2
.q-body
.q-prose
.q-label
.q-caption
.q-fluid-hero
.q-kashida
1 - HTML خالص
2 - JavaScript / تهيئة ديناميكية
3 - Tailwind CSS Plugin
يعاني كثير من المطورين العرب من مشكلة واحدة متكررة: يُطبّقون مقاييس الطباعة المصممة للغات اللاتينية على النصوص العربية، فتبدو الصفحة غير متناسقة، والخطوط متداخلة، والقراءة مُرهقة. مكتبة Qalam جاءت لحل هذه المشكلة تحديداً - مكتبة CSS/JS خفيفة (~4KB) مُصمَّمة من الصفر للغة العربية، توفر متغيرات type scale مُعايَرة، line-height مُحسَّن، وpresets جاهزة للنسخ واللصق.
المقياس الأكثر شيوعاً في الطباعة الرقمية هو "Perfect Fourth" بنسبة 1.333، وهو مُعايَر للحروف اللاتينية ذات الامتدادات الرأسية. الحروف العربية بطبيعتها أوسع أفقياً وأقل ارتفاعاً، مما يعني أن تطبيق نسبة 1.333 ينتج فجوات بصرية مُبالغاً فيها بين الأحجام، وتعظم الكلمات بشكل يخل بالتسلسل البصري للصفحة. نسبة 1.25 (Major Third) التي تعتمدها Qalam تمنح تدرجاً طبيعياً ومتوازناً يناسب الحروف العربية، من أصغر حجم (xs: ~10px) وحتى أكبرها (5xl: ~61px)، في 10 مستويات متناسقة.
التشكيل (الفتحة، الكسرة، الشدة، التنوين) يمتد فوق الحروف وتحتها. إذا استخدمت line-height: 1.5 الافتراضي، ستتداخل الحركات مع السطر الأعلى وتصبح النصوص المُشكَّلة غير قابلة للقراءة. Qalam تُعيّن:
هذه القيم ليست عشوائية - هي نتيجة اختبارات على نصوص عربية حقيقية بخطوط Cairo وTajawal وAmiri.
بدلاً من تذكّر قيم متغيرات متعددة في كل مرة، توفر Qalam فئات preset تجمع الحجم والوزن وارتفاع السطر والتتبع في class واحدة:
يأتي مع Qalam Tailwind plugin رسمي يُضاف بسطر واحد في tailwind.config.js. بعدها يتوفر لك مباشرة: font-cairo، font-tajawal، leading-arabic-normal، وjميع utilities الطباعة العربية كـ q-body وq-prose داخل JSX وHTML.
للمشاريع التي لا تستخدم Tailwind، يتوفر CSS خالص يُضاف بـ <link> واحد، وESM module للمشاريع الحديثة مع TypeScript types كاملة في ملف index.d.ts.
كل خط عربي له إيقاعه الخاص وarتفاع السطر الأنسب له. Qalam تُدير هذا تلقائياً عند استدعاء Qalam.init({ font: 'amiri' }):
تحتوي المكتبة على 4 utility classes تستخدم clamp() لإنشاء طباعة سائلة تتكيف تلقائياً بين حجمَي الشاشة الأصغر والأكبر دون نقاط توقف (breakpoints) يدوية: q-fluid-sm وq-fluid-base وq-fluid-heading وq-fluid-hero. هذا يعني صفحة بطولية تبدو مثالية على الهاتف والجهاز اللوحي والحاسب في آن واحد.
Qalam مُصمَّمة لمطورين محددين:
الترخيص فردي مدى الحياة - يعمل في عدد غير محدود من المشاريع الشخصية والتجارية.
ترخيص مدى الحياة - استخدام في مشاريع غير محدودة - تحديثات مجانية