كائنات HTMLCalendar‎ في بايثون

يستخدم هذا الصنف لإنشاء تقويم بهيئة HTML.

البنية العامة

calendar.HTMLCalendar(firstweekday=0)

المعاملات

firstweekday

المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد.

توابع الصنف HTMLCalendar

تقدّم نسخ الصنف HTMLCalendar التوابع التالية:

التابع ‎formatmonth()‎

يعيد التابع تقويم الشهر المعطى بصيغة جدول HTML.

التابع ‎formatyear()‎

يعيد التابع تقويم السنة المعطاة على هيئة جدول HTML.

التابع ‎formatyearpage()‎

يعيد التابع تقويم السنة المعطاة على هيئة صفحة HTML كاملة.

خصائص الصنف HTMLCalendar

يقدّم الصنف HTMLCalendar عددًا من الخصائص التي يمكن إعادة تعريفها override لتخصيص فئات CSS المستخدمة في التقويم:

الخاصية cssclasses

قائمة بالفئات المستخدمة مع كل يوم في الأسبوع، وتتضمّن قائمة الفئات الافتراضية القيم التالية:

cssclasses = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"]

يمكن إضافة المزيد من الفئات لكل يوم من أيام الأسبوع:

cssclasses = ["mon text-bold", "tue", "wed", "thu", "fri", "sat", "sun red"]

يجدر التنبيه إلى أنّه يجب أن تضمّ هذه القائمة 7 عناصر فقط.

الخاصية cssclass_noday

فئة CSS التي ستستخدم مع أيام الأسابيع التي تقع في الشهر الماضي أو القادم.

ملاحظة: هذه الخاصية جديدة في الإصدار 3.7.

الخاصية cssclasses_weekday_head

قائمة بفئات CSS التي تُستخدم لتنسيق أسماء أيام الأسبوع في الترويسة. القيمة الافتراضية لهذه الخاصية هي ذاتها قيمة الخاصية cssclasses.

ملاحظة: هذه الخاصية جديدة في الإصدار 3.7.

الخاصية cssclass_month_head

اسم فئة CSS الخاصّة باسم الشهر في الترويسة (يستخدم التابع formatmonthname()‎ هذه الخاصية)، وتأخذ الخاصية القيمة "month" كقيمة افتراضية.

ملاحظة: هذه الخاصية جديدة في الإصدار 3.7.

الخاصية cssclass_month

فئة CSS الخاصة بجدول الشهر بأكمله (يستخدم التابع formatmonth()‎ هذه الخاصية). القيمة الافتراضية لهذه الخاصية هي "month".

ملاحظة: هذه الخاصية جديدة في الإصدار 3.7.

الخاصية cssclass_year

فئة CSS الخاصة بالجدول الذي يتضمّن جداول الأشهر للسنة كاملة (يستخدم التابع formatmonth()‎ هذه الخاصية). القيمة الافتراضية لهذه الخاصية هي "year".

ملاحظة: هذه الخاصية جديدة في الإصدار 3.7.

الخاصية cssclass_year_head

فئة CSS الخاصّة بترويسة الجدول الذي يضمّ تقويم السنة كاملة (يستخدم التابع formatmonth()‎ هذه الخاصية). القيمة الافتراضية لهذه الخاصية هي "year".

ملاحظة: هذه الخاصية جديدة في الإصدار 3.7.

يجب الانتباه إلى أنّه وعلى الرغم من أن تسمية الفئات السابقة كانت بصيغة المفرد (مثل csslass_month و cssclass_noday) فبالإمكان استبدال فئة CSS الواحدة بقائمة من فئات CSS المفصولة عن بعضها البعض بفواصل بيضاء، مثل: "text-bold text-red".

يبيّن المثال التالي طريقة تخصيص الصنف HTMLCalendar:

class CustomHTMLCal(calendar.HTMLCalendar):
    cssclasses = [style + " text-nowrap" for style in
                  calendar.HTMLCalendar.cssclasses]
    cssclass_month_head = "text-center month-head"
    cssclass_month = "text-center month"
    cssclass_year = "text-italic lead"

انظر أيضًا

• كائنات Calendar: يقدّم هذا الصنف عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق.
• كائنات TextCalendar: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.
• كائنات LocaleTextCalendar: هذا الصنف متفرّع من الصنف TextCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.
• كائنات LocaleHTMLCalendar: هذا الصنف متفرّع من الصنف HTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML.

مصادر

صفحة General calendar-related functions في توثيق بايثون الرسمي.