HTML: تعليقات HTML

التعليقات هي ملاحظات نصية تُكتب للمطورين. يتجاهلها المتصفح تمامًا. استخدام التعليقات بحكمة يمكن أن يحسن قابلية قراءة الكود بشكل كبير ويسهل التعاون الجماعي.

1. بناء جملة التعليقات

تبدأ تعليقات HTML بـ <!-- وتنتهي بـ -->. يمكن أن يكون المحتوى بينهما أي نص؛ لن يعرضه المتصفح على الصفحة:

▶ مثال

<!-- هذا تعليق، لا يمكن للمستخدمين رؤيتي -->
<p>هذا النص مرئي للمستخدمين.</p>

<!-- ======= بداية قسم التنقل ======= -->
<nav>
<a href="index.html">الرئيسية</a>
<a href="about.html">من نحن</a>
</nav>
<!-- ======= نهاية قسم التنقل ======= -->

2. الاستخدامات الشائعة للتعليقات

التعليقات ليست فقط لكتابة الملاحظات — إنها مفيدة جدًا أيضًا أثناء التطوير والتصحيح:

<!-- تعليق مؤقت لجزء من الكود (للتصحيح) -->
### ▶ مثال
<!--
<p>هذا الكود لا يحتاج إلى العرض الآن.</p>
<a href="old-page.html">رابط قديم</a>
-->

<!-- TODO: تحتاج لإضافة صورة المستخدم لاحقًا -->
<!-- @أحمد 2026-06-12: تأكيد النص هنا قبل الإطلاق -->

❓ أسئلة شائعة

📖 ملخص

• تبدأ التعليقات بـ <!-- وتنتهي بـ -->؛ لا يعرضها المتصفح
• يمكن استخدام التعليقات لشرح أجزاء الكود، إخفاء الكود مؤقتًا، وإضافة علامات TODO
• المعلومات الحساسة في التعليقات مرئية للجميع — لا تضع كلمات المرور هناك أبدًا
• نظف تعليقات التصحيح قبل النشر للحفاظ على نظافة كود المصدر

📝 تمارين

1. أضف تعليقات إلى كودك: اكتب صفحة بسيطة تحتوي على تنقل ومحتوى جسم، وأضف علامات تعليق قبل وبعد كل كتلة (مثل <!-- بداية التنقل -->).
2. تصحيح قائم على التعليقات: انسخ كودًا من درس سابق واستخدم التعليقات لإخفاء قسم مؤقتًا. تحقق من أن القسم المخفي لا يظهر بالفعل على الصفحة.

فريق Web-Tutorial التقني

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

من نحن