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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:كائنات <code>HTMLCalendar‎</code> في بايثون}}</noinclude> يستخدم هذا الصنف لإنشاء تقويم بهيئة ن...'
 
لا ملخص تعديل
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:كائنات <code>HTMLCalendar‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:كائنات <code>HTMLCalendar‎</code> في بايثون}}</noinclude>


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


== البنية العامة ==
== البنية العامة ==
سطر 14: سطر 14:
المعامل <code>firstweekday</code> هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد <code>0</code> يوم الإثنين (وهو القيمة الافتراضية) والعدد <code>6</code> هو يوم الأحد.
المعامل <code>firstweekday</code> هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد <code>0</code> يوم الإثنين (وهو القيمة الافتراضية) والعدد <code>6</code> هو يوم الأحد.


== توابع الصنف <code>TextCalendar</code> ==
== توابع الصنف <code>HTMLCalendar</code> ==


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


=== التابع <code>[[Python/HTMLCalendar/formatmonth|‎formatmonth()‎]]</code> ===
=== التابع <code>[[Python/HTMLCalendar/formatmonth|‎formatmonth()‎]]</code> ===
يعيد التابع تقويم الشهر المعطى بصيغة جدول HTML.
يعيد التابع تقويم الشهر المعطى بصيغة [[HTML/table|جدول HTML]].


=== التابع <code>‎[[Python/HTMLCalendar/formatyear|formatyear()‎]]</code> ===
=== التابع <code>‎[[Python/HTMLCalendar/formatyear|formatyear()‎]]</code> ===
يعيد التابع تقويم السنة المعطاة على هيئة جدول HTML.
يعيد التابع تقويم السنة المعطاة على هيئة [[HTML/table|جدول HTML]].


=== التابع <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>


== انظر أيضًا ==
== انظر أيضًا ==
سطر 31: سطر 84:
* كائنات <code>[[Python/TextCalendar|TextCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.
* كائنات <code>[[Python/TextCalendar|TextCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.
* كائنات <code>[[Python/LocaleTextCalendar|LocaleTextCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>TextCalendar</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.
* كائنات <code>[[Python/LocaleTextCalendar|LocaleTextCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>TextCalendar</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.
* كائنات <code>[[Python/HTMLCalendar|LocaleHTMLCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة [[HTML]].
* كائنات <code>[[Python/LocaleHTMLCalendar|LocaleHTMLCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>HTMLCalendar</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة [[HTML]].
== مصادر ==
== مصادر ==
[https://docs.python.org/3/library/calendar.html#calendar.HTMLCalendar صفحة General calendar-related functions في توثيق بايثون الرسمي.]
[https://docs.python.org/3/library/calendar.html#calendar.HTMLCalendar صفحة General calendar-related functions في توثيق بايثون الرسمي.]

المراجعة الحالية بتاريخ 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»