أهداف التعلم

في نهاية هذا القسم، ينبغي أن تكون قادرًا على:

• استخدام دالّة المساعدة لاستكشاف محتويات وَحدة.
• تحديد أجزاء الشِفرة المُضمَّنة في التوثيق.

الألوان في مواقع الويب

يقدّم هذا القسم وَحدةً نموذجيةً للعمل مع ألوان HTML. تُستخدم لغة ترميز النص التشعبي (HTML) لتصميم مواقع الويب والتطبيقات الرسومية. تقرأ متصفحات الويب مثل Chrome و Safari لغة HTML وتعرض المحتويات المقابلة. مثال: شِفرة HTML <p style="color: Red">Look out!</p> تمثل فقرة بنص أحمر.

تُعرّف HTML عدد 140 اسم لون قياسي. يمكن تحديد ألوان إضافية باستخدام تنسيق سداسي عشري: #RRGGBB. تمثل الأرقام RR و GG و BB مكونات اللون الأحمر والأخضر والأزرق. مثال: #DC143C هو 220 أحمر + 20 أخضر + 60 أزرق، وهو اللون Crimson.

تتراوح قيم الأحمر والأخضر والأزرق من 0 إلى 255 (أو من 00 إلى FF بالنظام السداسي عشري). تحدد القيم الأقل ألوانًا أغمق، وتحدد القيم الأعلى ألوانًا أفتح. مثال: #008000 هو اللون Green، و #00FF00 هو اللون Lime.

وَحدة الألوان النموذجية

ستكون وَحدة للعمل مع رموز ألوان HTML مفيدة لمصممي الجرافيك ومطوري الويب. شِفرة بايثون التالية موجودة في ملف باسم colors.py.

• السطر 1 هو سلسلة التوثيق للوَحدة.
• الأسطر 3-16 تُسند مُتغيِّرات للألوان المستخدمة بشكل متكرر.
• الأسطر 18-24 تُعرّف دالّة لاستخدامها داخل الوَحدة.
• الأسطر 26-45 تُعرّف دوال لاستخدامها في وَحدات أخرى.

ملاحظة: تستخدم الدالتان tohex() و torgb() ميزات بايثون (تنسيق السلاسل النصية وتقطيع السلسلة النصية) الموصوفة لاحقًا في الكتاب. في الوقت الحالي، التوثيق والتعليقات أهم من تفاصيل التنفيذ.

    """Functions for working with color names and hex/rgb values."""

    # الألوان الأساسية
    RED = "#FF0000"
    YELLOW = "#FFFF00"
    BLUE = "#0000FF"

    # الألوان الثانوية
    ORANGE = "#FFA500"
    GREEN = "#008000"
    VIOLET = "#EE82EE"

    # الألوان المحايدة
    BLACK = "#000000"
    GRAY = "#808080"
    WHITE = "#FFFFFF"

    def _tohex(value):
      """Converts an integer to an 8-bit (2-digit) hexadecimal string."""
      if value <= 0:
        return "00"
      if value >= 255:
        return "FF"
      return format(value, "02X")

    def tohex(r, g, b):
      """Formats red, green, and blue integers as a color in hexadecimal."""
      return "#" + _tohex(r) + _tohex(g) + _tohex(b)

    def torgb(color):
      """Converts a color in hexadecimal to red, green, and blue integers."""
      r = int(color[1:3], 16) # أول رقمين
      g = int(color[3:5], 16) # الرقمان الأوسطان
      b = int(color[5:7], 16) # آخر رقمين
      return r, g, b

    def lighten(color):
      """Increases the red, green, and blue values of a color by 32 each."""
      r, g, b = torgb(color)
      return tohex(r+32, g+32, b+32)

    def darken(color):
      """Decreases the red, green, and blue values of a color by 32 each."""
      r, g, b = torgb(color)
      return tohex(r-32, g-32, b-32)

توثيق الوَحدة

توفر دالّة مُضمَّنة help() ملخصًا لدوال وبيانات الوَحدة. استدعاء help(module_name) في صَدَفة هو طريقة مريحة للتعرف على الوَحدة.

help(colors)

    Help on module colors:

    NAME
      colors - Functions for working with color names and hex/rgb values.

    FUNCTIONS
      darken(color)
        Decreases the red, green, and blue values of a color by 32 each.

      lighten(color)
        Increases the red, green, and blue values of a color by 32 each.

      tohex(r, g, b)
        Formats red, green, and blue integers as a color in hexadecimal.

      torgb(color)
        Converts a color in hexadecimal to red, green, and blue integers.

    DATA
      BLACK = '#000000'
      BLUE = '#0000FF'
      GRAY = '#808080'
      GREEN = '#008000'
      ORANGE = '#FFA500'
      RED = '#FF0000'
      VIOLET = '#EE82EE'
      WHITE = '#FFFFFF'
      YELLOW = '#FFFF00'

    FILE
      /home/student/Desktop/colors.py
    >>> help(colors)

    Help on module colors:

    NAME
      colors - Functions for working with color names and hex/rgb values.

    FUNCTIONS
      darken(color)
        Decreases the red, green, and blue values of a color by 32 each.

      lighten(color)
        Increases the red, green, and blue values of a color by 32 each.

      tohex(r, g, b)
        Formats red, green, and blue integers as a color in hexadecimal.

      torgb(color)
        Converts a color in hexadecimal to red, green, and blue integers.

    DATA
      BLACK = '#000000'
      BLUE = '#0000FF'
      GRAY = '#808080'
      GREEN = '#008000'
      ORANGE = '#FFA500'
      RED = '#FF0000'
      VIOLET = '#EE82EE'
      WHITE = '#FFFFFF'
      YELLOW = '#FFFF00'

    FILE
      /home/student/Desktop/colors.py