الفرق بين المراجعتين لصفحة: «Python/HTMLCalendar»

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
لا ملخص تعديل
 
سطر 26: سطر 26:
=== التابع <code>‎[[Python/HTMLCalendar/formatyearpage|formatyearpage()‎]]</code> ===
=== التابع <code>‎[[Python/HTMLCalendar/formatyearpage|formatyearpage()‎]]</code> ===
يعيد التابع تقويم السنة المعطاة على هيئة صفحة [[HTML]] كاملة.
يعيد التابع تقويم السنة المعطاة على هيئة صفحة [[HTML]] كاملة.
== خصائص الصنف <code>HTMLCalendar</code> ==
يقدّم الصنف <code>HTMLCalendar</code> عددًا من الخصائص التي يمكن إعادة تعريفها override لتخصيص [[CSS/Class Selectors|فئات CSS]] المستخدمة في التقويم:
=== الخاصية <code>cssclasses</code> ===
قائمة بالفئات المستخدمة مع كل يوم في الأسبوع، وتتضمّن قائمة الفئات الافتراضية القيم التالية:<syntaxhighlight lang="python3">
cssclasses = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"]
</syntaxhighlight>يمكن إضافة المزيد من الفئات لكل يوم من أيام الأسبوع:<syntaxhighlight lang="python3">
cssclasses = ["mon text-bold", "tue", "wed", "thu", "fri", "sat", "sun red"]
</syntaxhighlight>يجدر التنبيه إلى أنّه يجب أن تضمّ هذه القائمة 7 عناصر فقط.
=== الخاصية <code>cssclass_noday</code> ===
فئة CSS التي ستستخدم مع أيام الأسابيع التي تقع في الشهر الماضي أو القادم.
'''ملاحظة:''' هذه الخاصية جديدة في الإصدار 3.7.
=== الخاصية <code>cssclasses_weekday_head</code> ===
قائمة بفئات CSS التي تُستخدم لتنسيق أسماء أيام الأسبوع في الترويسة. القيمة الافتراضية لهذه الخاصية هي ذاتها قيمة الخاصية <code>cssclasses</code>.
'''ملاحظة:''' هذه الخاصية جديدة في الإصدار 3.7.
=== الخاصية <code>cssclass_month_head</code> ===
اسم فئة CSS الخاصّة باسم الشهر في الترويسة (يستخدم التابع <code>formatmonthname()‎</code> هذه الخاصية)، وتأخذ الخاصية القيمة <code>"month"</code> كقيمة افتراضية.
'''ملاحظة''': هذه الخاصية جديدة في الإصدار 3.7.
=== الخاصية <code>cssclass_month</code> ===
فئة CSS الخاصة بجدول الشهر بأكمله (يستخدم التابع <code>formatmonth()‎</code> هذه الخاصية). القيمة الافتراضية لهذه الخاصية هي <code>"month"</code>.
'''ملاحظة:''' هذه الخاصية جديدة في الإصدار 3.7.
=== الخاصية <code>cssclass_year</code> ===
فئة CSS الخاصة بالجدول الذي يتضمّن جداول الأشهر للسنة كاملة (يستخدم التابع <code>formatmonth()</code>‎ هذه الخاصية). القيمة الافتراضية لهذه الخاصية هي <code>"year"</code>.
'''ملاحظة:''' هذه الخاصية جديدة في الإصدار 3.7.
=== الخاصية <code>cssclass_year_head</code> ===
فئة CSS الخاصّة بترويسة الجدول الذي يضمّ تقويم السنة كاملة (يستخدم التابع <code>formatmonth()‎</code> هذه الخاصية). القيمة الافتراضية لهذه الخاصية هي <code>"year"</code>.
'''ملاحظة:''' هذه الخاصية جديدة في الإصدار 3.7.
يجب الانتباه إلى أنّه وعلى الرغم من أن تسمية الفئات السابقة كانت بصيغة المفرد (مثل <code>csslass_month</code> و <code>cssclass_noday</code>) فبالإمكان استبدال فئة CSS الواحدة بقائمة من فئات CSS المفصولة عن بعضها البعض بفواصل بيضاء، مثل: <code>"text-bold text-red"</code>.
يبيّن المثال التالي طريقة تخصيص الصنف <code>HTMLCalendar:</code><syntaxhighlight lang="python3">
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"
</syntaxhighlight>


== انظر أيضًا ==
== انظر أيضًا ==

المراجعة الحالية بتاريخ 18:46، 5 أغسطس 2018


يستخدم هذا الصنف لإنشاء تقويم بهيئة 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 في توثيق بايثون الرسمي.

مجلوبة من «https://wiki.hsoub.com/index.php?title=Python/HTMLCalendar&oldid=14481»