كتابة تعليقات توضيحية html و css و js

 السلام عليكم 

الكثير منا يحتاج إلى بعض المفاهيم البسيطه داخل ملف ال css او html علشان تقدر تحدد أهم النقاط اللي انت عايزها بدل ما تقعد وقت تطويل تدور عليها وتحتار 

في البداية ، يمكنني تمييز طريقة كتابة التعليقات ، لكنني غالبًا ما أستخدمها لاحقًاctrl + /أوCtrl+shift+/استخدم مفاتيح الاختصار لتدوين ملاحظات سريعة. أتذكر دائمًا أنني أشعر بالارتباك. إذا كان لديك وقت اليوم ، فسأقوم بفرزها لتجنب الالتباس لاحقًا.

كلا النوعين من التعليقات لهما سيناريوهات استخدام خاصة بهما ولا يمكن استخدامهما بشكل عشوائي. أتذكر الرمز الذي كتبته في البداية. ولأن تعليقًا واحدًا كان خاطئًا ، فقد قمت بتعديله طوال الليل ولم أعرف مكان الخطأ. أخيرًا ، أدركت أن التعليق كان خاطئًا. لا يوجد شيء للغش!

1.1 كتابة تعليق HTML

 <! - هذه كتابة وسم تعليق HTML ->

نصائح:

• تبدأ فيقوس الزاوية اليسرى+ !--
• لأول وهلةأقواس زاويةفقط فكر فيعلامة htmlهو مكتوب ، اعتقدت بطبيعة الحال أنه كانتعليق أتش تي أم أل، هذا أسهل في التذكر ؛
• استعمال< مع> يتماشى معقواعد بناء علامة HTMLمن؛

1.2 التعليقات الشرطية في html

<!--[if IE 9]>
    .... some HTML here ....
<![endif]-->

هذا التعليق الشرطي مخصص فقط لعلامات HTML المنفذة بواسطة متصفحات IE.

2.1 كتابة تعليق css و js

/ * التعليقات متعددة الأسطر css و js code هي تعليقات على الكود * /
 
 // تعليق سطر مفرد css أو js

ملحوظة:

• يمكن لـ css و js استخدام نفس كتابة التعليقات ؛
• تعليق سطر واحداستعمالشرطة مائلة مزدوجة；
• تعليقات متعددة الأسطرإلىسلاش + نجمةأبدا بنجمة + شرطة مائلةالنهاية؛

3.1 أعط كستناء:

1. <! - محتوى الملاحظات ->
 2. // محتوى التعليق (أدخل تعليق سطر واحد في css أو javascript)
 3. / * محتوى التعليق * / (أدخل أسطرًا متعددة من التعليقات في css أو javascript)  
 

تستخدم JavaScript شرطات مائلة مزدوجة للتعليق على أسطر مفردة من التعليمات البرمجية:

// console.log ("hello، cute little jiro zmh")؛

استخدم النجوم المائلة للتعليق على كتل التعليمات البرمجية (أسطر متعددة من التعليمات البرمجية):

/*
    var person = new Object();
        person.name = 'zhouminghang';
        person.age = '23',
        person.job = 'webEngineer';
         console.log ("أنا" + person.name + "،" + person.age + "years old" + "I am a" + person.job + "!")؛
*/

4.1 مشروح مشاكل الأداء

• ستؤدي تعليقات JavaScript الكثيرة جدًا إلى تقليل سرعة التنفيذ وسرعة تحميل JavaScript ، لذلك عند نشر موقع ويب ، قم بإزالة تعليقات JavaScript واستخدامها بشكل عامgulpأوwebpackالتوصل؛
• كتلة التعليق/* ... */لم تعد قادرة على احتواء/ * أو * / ، يمكن إنشاء هذا النوع من التعليمات البرمجية في تعبيرات JavaScript العادية، سيؤدي ذلك إلى أخطاء نحوية ؛
• الاستخدام الموصى به//كود التعليق

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

------- التعلم هو عملية إدخال وإخراج ثنائية الاتجاه ، -
             ------ بدون إدخال ، كيف يمكن أن يكون هناك الكثير من الإخراج! -        
      
                                                         ----- أنا جيرو الصغير اللطيف

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

ومصدر المقاله هنا