HTML Comments
التعليقات في لغة HTML
سنتعرف في هذا الدراس على عناصر التعليقات في لغة HTML، والتي تمكّنك من إضافة نصوص توضيحية لمعرفة خارطة الأكواد البرمجية مستقبلًا، كما أن التعليقات تسمح لك بتهميش أو تعطيل جزء من عناصر HTML لتجربة الصفحة بدونه.
التاريخ
الدروس
المستوى
اللغة
المشاهدات
المواضيع
HTML Comments
التعليقات في لغة HTML
</>
HTML Comments
التعليقات في لغة HTML
هي معلومات تنظيمية حول صفحة الويب تمكّن مطوري المواقع من معرفة دليل الأكواد البرمجية داخل صفحة HTML، فمثلًا: يقوم المطور بإضافة تعليق comment عند بداية الصفحة ونهايتها، ويكتب بداية الصفحة [Start of page] و نهاية الصفحة [End of page].
وكذلك عند بداية أي قسم ونهايته، وذلك حتى يتذكر المطور أين البداية وأين النهاية، لأن بعد مرور فترة زمنية سوف ينسى المطور دليل الأكواد البرمجية، فتسهل التعليقات عملية التذكر والتعديل على المشروع مستقبلًا.
كما تستخدم التعليقات comments في تعطيل أي جزء من أجزاء عناصر HTML ومنع ظهوره على المتصفح وعدم تنفيذه، كأن يقوم المطور بتجربة تقسيمة الصفحة بدون العناصر المهمشة عن طريق التعليقات للمقارنة.
يمكن إضافة عدد غير محدود من التعليقات comments داخل صفحة HTML وفي أي مكان.
لماذا نستخدم التعليقات في لغة HTML؟
- لعمل توثيق كامل دليل الأكواد البرمجية [documentation]، مما يساعد المطورين في فهم دليل الأوامر البرمجية.
- لسهولة قراءة الأوامر البرمجية وعدم تداخلها، وهي أيضًا عملية تنظيمية يستخدمها أغلب مطوري الويب.
- لوصف النتيجة المقصودة من الأوامر البرمجية أو لشرح سبب استخدام هذا الأمر البرمجي أو لتوضيح سطر معقد.
ملاحظات هامة
- أي نص أو عنصر تقوم بوضعه داخل تعليق [comment] داخل صفحة HTML، لا يظهر على المتصفح؛ لأن المتصفحات تتجاهل تعليقات HTML.
- بينما يمكن أن تكون التعليقات مفيدة في شرح الأوامر البرمجية، يجب استخدامها بحكمة؛ فالتعليقات الكثيرة جدًا أو التعليقات المكتوبة بشكل سيئ يمكن أن تجعل قراءة وفهم الكود أكثر صعوبة.
</>
HTML Comments Syntax
طريقة كتابة التعليقات في لغة HTML
HTML Comments Syntax
طريقة كتابة التعليقات Comments في لغة HTML.
<!-- Comments are not displayed in the browser -->
Add A Comment
يمكنك إضافة تعليق في أي مكان داخل صفحة HTML.
<!-- This is a comment --> <p>This is a paragraph.</p> <!-- Comments are not displayed in the browser -->
ملاحظة
لا تظهر تعليقات HTML Comments على المتصفح، لكن ضع في اعتبارك أنه يمكن لأي شخص عرض جميع عناصر HTML على المتصفحات من خلال الاختصار ctrl+u وهذا يشمل أيضًا جميع التعليقات التي تمت كتابتها بداخل أكواد تصميم الواجهة الأمامية للموقع.
</>
Single-Line Comment In HTML
كتابة تعليق سطر واحد في HTML
قد يتكون التعليق من سطر واحد أي يمتد على سطر واحد فقط، ولن يتم عرض هذا السطر على المتصفح.
Single-Line Comments In HTML
يوجد في المثال التالي تعليق مكوّن من سطر واحد أي يمتد على سطر واحد فقط، ويشير هذا السطر إلى بداية إضافة موقع شريط المهام داخل صفحة HTML، ولن يتم عرض هذا السطر على المتصفح.
<body> <!-- Add the navbar here --> <h1>About me</h1> <p>I am learning to code with closeTag.</p> <p>I am going through each and every one of their awesome and super helpful certifications. </p> <p>I am on my way to becoming a fullstack web developer!</p> <h2>Work Experience</h2> </body>
هام
نستخدم تعليق مؤلف من سطر واحد عندما نريد شرح وتوضيح الغرض من الكود الذي يتبعه، أو عندما نريد إضافة ملاحظات على أجزاء من صفحة الويب.
</>
Nested Comments In HTML
التعليق المُتداخل في HTML
يمكنك إضافة تعليقات في منتصف جملة أو سطر من التعليمات البرمجية، سيتم إضافة التعليق على النص الموجود داخل [ <! - -> ] فقط، ولن يتأثر باقي النص الموجود خارج العلامة، بمعنى أن المتصفح لن يظهر هذا الجزء من الكود.
Nested Comments In HTML
إضافة تعليقات في منتصف جملة أو سطر من التعليمات البرمجية.
<p>I am <!--going to be--> a web developer</p>
</>
Multi-Line Comment In HTML
كتابة تعليق متعدد الأسطر في لغة HTML
يمكن أن تمتد التعليقات لعدّة سطور باستخدام نفس الصيغة.
لكن يجب عليك مراعاة علامة البدء open tag عند بداية أول سطر، وعلامة الإغلاق close tag عند نهاية آخر سطر.
Multi-Line Comments in HTML
يمكن أن تمتد التعليقات لعدّة أسطر,
<!-- This is going to be my portfolio. It will show off the projects that I'm most proud of. I could go on and on about what I want to add because I am writing a multi-line comment here -->
</>
Comments Keyboard Shortcut In HTML
اختصارات لوحة المفاتيح لإضافة التعليقات في لغة HTML
يمكنك استخدام اختصارات التعليقات في لوحة المفاتيح Keyboard لإضافة التعليقات، وستحتاج إلى استخدام هذه الاختصارات كثيرًا، وهذه الاختصارات هي:
- [ / cmd ] لمستخدمي Mac.
- [ / Ctrl ] لمستخدمي Windows و Linux.
لإضافة تعليق من سطر واحد:
اضغط باستمرار على مجموعة المفاتيح الموضحة أعلاه داخل المحرر الذي تستخدمه، مع تحديد السطر المراد تعليقه.
لإضافة تعليقات متعددة الأسطر:
حدد النص بأكمله أو العلامة التي تريد وضعها بداخل تعليق، واضغط على المفتاحين الموضحين سابقًا، سيكون كل سطر قمت بتحديده تعليق الآن.