JavaScript

JavaScript Comments
التعليقات في لغة جافا سكريبت

ستتعلم في هذا الدرس التعليقات في لغة جافا سكريبت JavaScript Comments وكيف تكتب, ولماذا يتم إستخدامها وهل هي ضروررية أم غير لك أيضاً ستتعلم حالات الأستخدام وعملية التنظيم أثناء برمجة وتطوير تطبيقات الويب.

التاريخ

20 نوفمبر 2021

الدروس

146

المستوى

العامة

اللغة

انجليزي

المشاهدات

1839

المواضيع

24
الشروحات chevron_left JavaScript Comments chevron_left JavaScript

JavaScript Comments
التعليقات في لغة جافا سكريبت

</> JavaScript comments
تعليقات جافا سكريبت

لماذا التعليقات في لغات البرمجة ؟

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

</> Why JavaScript comments؟
لماذا نستخدم التعليقات في لغة JavaScript؟

لماذا نستخدم التعليقات في لغة جافا سكريبت؟

  • لأضافة معلومات لشرح أجزاء من الأوامر البرمجية لتذكرها في المستقبل أو اضافة معلومات لفريق العمل البرمجي.
  • لتعليق بعض الأوامر لأختبار التطبيق بدون هذة الأوامر.
  • لعمل تعليقات متعددة الأسطر multi-line للوثائق الرسمية Documentations الخاصة بالمشروع.

</> JavaScript comments content
ما الزي يمكننا كتابتة بداخل أمر التعليقات في لغة CSS

ما الزي يمكننا كتابتة بداخل أمر التعليقات؟

  • نصوص توضحية,
  • أوامر برمجية لتجاهلها.

</> JavaScript comments lines
سطور التعليقات في لغة CSS

طرق كتابة التعليقات في لغة جافا سكريبت:

  • Single Line Comment التعليق لسطر واحد.
  • Multilines Comment التعليق لأكثر من سطر.
ملاحظة
يتم تجاهل الأوامر البرمجية أو النصوص التي تكتب بداخل التعليقات بواسطة محرك جافا سكريبت وسيتم تنفيذ فقط الأوامر التي خارج التعليقات,

</> Single Line Comments in JavaScript
تعليقات من سطر واحد في لغة جافا سكريبت

طريقة كتابة التعليق لسطر واحد Single Line Comment:

  • يبدأ بعلامتين Backslash // 
  • ثم كتابة اي نص أو امر برمجي يأتي بعد العلامتين يتم تجاهله بواسطة JavaScript.
تعليق سطر واحد نصي

اضافة تعليق نصي في لغة جافا سكريبت في سطر واحد.

//this is a single line comment
تعليق سطر واحد برمجي

اضافة تعليق برمجي في لغة جافا سكريبت في سطر واحد لتعطيل سطر كود.

//document.write('My first Comment.');

</> Multi-line Comments in JavaScript
تعليق عدة سطور في لغة جافا سكريبت

طريقة كتابة التعليق لعدة سطور Multi-line Comments:

  • تبدأ بعلامة Slash / متبوعة بعلامة Asterisk * في أول سطر.
  • تنتهي بعلامة Asterisk * متبوعة بعلامة Slash / في اخر سطر.
  • يمكن أن تضع عدد سطور غير محدود وسط علامة بداية وعلامة نهاية التعليق.
JavaScript Multi line Text Comment

اضافة تعليق نصي في لغة جافا سكريبت مكون من عدة سطور

/*
The code below will add
the heading h1
and the paragraph in html
*/
document.write('<h1>JavaScript Comments</h1>');
document.write('<p>My first Multi-line Comments in JavaScript.</p>');
JavaScript Multi line code Comment

إضافة تعليق برمجي لمجموعة أوامر ولا تقوم لغة جافا سكريبت بتنفيذ هذه الأوامر يتم تجاهلها.

/*
document.write('<p>Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's.</p>');
document.write('<p>standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.</p>');
document.write('<p>Contrary to popular belief, Lorem Ipsum is not simply random text. It has roots in a piece of classical Latin literature from.</p>');
*/
اختصارات التعليقات

جميع المحررات الحديثة تسمح لك بعمل اختصارات من لوحة المفاتيح لعمل تعليقات جافا سكريبت سواء كانت Single أو Multiline.

  • / + CTRL  نظام تشغير الويندوز Windows.
  • / + Cmd في نظام التشغيل ماكينتوش Macintosh.

</> Make Code Easier to Understand
لعمل أوامر برمجية سهلة الفهم

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

قواعد عامة ومتعارف عليها عالمياً لدي المطورين وهي كتابة شرح أو توضيح لماذا قمنا بكتابة هذة الأوامر.

ملاحظة

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

معلومات تهمك
  • لا تنسى تقييم الدروس لكي نُحدّث المُحتوى باستمرار حتى ينال إعجابك.
  • لا تنسى مشاركة الموقع مع أصدقاءك حتى تعمّ الفائدة وتكون سبب في نفعهم.
مشاركة
0
0
0
0
عدد المشاركات
هل هذه المعلومات نالت إعجابك ؟
0
0
عدد التقييمات