تخطَّ إلى المحتوى

الميزات15‏/11‏/2026مدة القراءة: 4 دقائق

CSS مخصص

مظهر Mitra مكتوب بـ CSS عادي، ويمكنك أن تضيف فوقه ما تشاء. أخفِ ما لا تستخدمه أبدًا، أو ضع إطارًا حول اليوم، أو امنح الخادم كله ألوانك. لذلك مكانان: الإعدادات → عام → CSS مخصص لنفسك، وحيث يسجّل الناس الدخول، الإعدادات → الإدارة → CSS مخصص للجميع لكل من على الخادم.

Mitra بذهبي شعاره، والقاعدة التي تفعل ذلك مفتوحة في خانة CSS مخصص في الإعداداتMitra بذهبي شعاره، والقاعدة التي تفعل ذلك مفتوحة في خانة CSS مخصص في الإعدادات

WARNING

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

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

يوقف المفتاح بجانب CSS مخصص ورقة أنماطك دون أن تفقدها، وتعرض لوحة الأوامر الأمرين CSS مخصص: إيقاف وCSS مخصص: تشغيل.

يُحذف @import عند حفظ ورقة أنماطك: الصق ورقة الأنماط كاملة بدلًا من الربط بها.

حيث يسجّل الناس الدخول، يستطيع المسؤول تغيير مظهر Mitra لكل من على الخادم: افتح الإعدادات → الإدارة واكتب CSS في المربع تحت CSS مخصص للجميع. تراه أنت أثناء الكتابة، ويراه الآخرون في المرة التالية التي يحمّلون فيها Mitra. يوقفها مفتاحها للجميع دون أن تفقدها. أول من يسجّل الدخول إلى الخادم هو مسؤوله. ودون تسجيل دخول، تصل ورقة أنماطك الخاصة أصلًا إلى كل من يستخدم Mitra، فهي الوحيدة.

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

تقع قواعد Mitra نفسه في طبقة تتالٍ اسمها mitra، أما قواعدك فلا، لذا تتغلب قاعدتك على قاعدة Mitra أيًّا كان محددها. لا تحتاج إلى !important. أما تصريحات !important القليلة الخاصة بـ Mitra فتبقى في الأعلى، لأن الطبقات ترتّبها بالعكس: فهي تحفظ تماسك التخطيط.

لتزيل شيئًا يضبطه Mitra بدلًا من الطلاء فوقه، اضبط الخاصية على revert. هذا يزيل سطح الأيام في عرض الشهر:

mitra-weeks mitra-day {
background: revert;
}

إخفاء الأيام خارج الشهر

Section titled “إخفاء الأيام خارج الشهر”
mitra-weeks [data-outside] {
visibility: hidden;
}

في عرض الشهر، يخفي هذا الأيام التي قبل الشهر المعروض وبعده، وتواريخها وخلفيتها. أما العناصر التي عليها فتبقى. تُبقي visibility الشبكة في مكانها، بينما كانت display: none ستفككها. كبّر العرض لتمنح أيام الشهر نفسه مساحة أكبر.

mitra-weeks mitra-day[today] {
outline: 2px solid var(--color-accent);
outline-offset: -2px;
}

outline بدلًا من border: فالحد سيكبّر اليوم ويحرّك الشبكة.

:root {
--color-accent: light-dark(#2e7d32, #81c784);
--border-radius: 8px;
}

تأخذ light-dark() لون السمة الفاتحة، ثم لون السمة الداكنة. كل ما يلوّنه Mitra بهذه المتغيرات يتبعها، ومنه شريط عنوان التطبيق المثبّت:

المتغيرما يلوّنه
--color-accentاليوم، وما هو محدد، وحلقات التركيز، والأزرار الرئيسية
--color-background-seedالأرضية خلف كل شيء؛ ومنها تأخذ مربعات الحوار أرضيتها
--color-surfaceالأيام في طرق العرض، وما يقع على الأرضية، مثل لوحة الأوامر
--color-textالنص
--color-text-mutedالنص الثانوي، مثل التلميحات والأوقات
--color-errorالأخطاء والتحذيرات
--border-radiusزوايا الأزرار والعناصر ومعظم عناصر التحكم
--font-familyخط النص

تعرض أدوات المطوّر في متصفحك ما على الصفحة: انقر بزر الفأرة الأيمن على شيء واختر فحص. عناصر Mitra نفسه تُسمّى mitra-…، مثل طرق العرض mitra-days (الأسبوع) وmitra-weeks (الشهر) وmitra-months (السنة) وmitra-timeline وmitra-table، واليوم mitra-day، والعنصر mitra-entry-segment، والشريط الجانبي mitra-sidebar. وتذكر السمات حقائق، مثل today وdata-outside وdata-date.

تحتفظ الأزرار والحقول والمفاتيح والقوائم وسائر عناصر التحكم بدواخلها لنفسها. صِل إليها عبر أجزائها، مثل mitra-switch::part(switch)، وعبر متغيرات --mitra-… التي تقرؤها. وإن احتجت أن تصل أبعد، فاطلب جزءًا في بلاغ.

أشياء قليلة تحفظ تماسك Mitra، وتغييرها يكسره:

  • display أو position على mitra-day، أو على .entries داخل طريقة عرض: فهي تقع على شبكة تتشاركها طريقة العرض كلها، ويصبح عرض الأسبوع بطيئًا جدًا دونها.
  • المتغيرات التي تبدأ بـ --_: فهي تتغير في كل إطار من التكبير، وضبطها يعاركه.
  • حجم العنصر: فعنوانه يختار تخطيطًا بحسب عرضه، لذا قد يبدّله تحديد الحجم من الخارج.
  • all: unset يلغي الإخفاء أيضًا، فأعد كتابة [hidden] { display: none } بجانبه.

حين تخفي قاعدةٌ طريق العودة

Section titled “حين تخفي قاعدةٌ طريق العودة”

أضف ?css=off إلى العنوان، مثل https://mitra.example.com/?css=off. عندها يُحمَّل Mitra مرة واحدة دون أي من ورقتي الأنماط، فتستطيع فتح الإعدادات وإصلاح ورقتك. ويصلح المسؤول ورقة الجميع بالطريقة نفسها.

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

تحت المربع، يفتح شارك على GitHub نقاشًا جديدًا في فئة Custom CSS وفيه ورقة أنماطك. قل ما تفعله، وأضف لقطة شاشة إن كانت تُظهر شيئًا، ثم انشره. أما ورقة الأنماط الأطول من أن يحملها الرابط فتُنسخ إلى الحافظة بدلًا من ذلك، لتلصقها في النقاش. وفي الفئة أيضًا تجد أوراق أنماط شاركها آخرون: اقرأها قبل أن تلصقها.