JavaScript Comments
التعليقات في لغة جافا سكريبت
التاريخ
الدروس
المستوى
اللغة
المشاهدات
المواضيع
الشروحات 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
لعمل أوامر برمجية سهلة الفهم
مطوري التطبيقات بلغة جافا سكريبت لا يقومون فقط بكتابة الأوامر البرمجية ولكن ايضاً يقومون ايضاً بالتعديل علي أوامر برمجية تمت بواسطة مطورين اخرين وفي هذة الحالة يحتاجون الي خريطة أو نصوص توضيحية أو تفصيلية عن هذه الأوامر التي كتبت بواسطة مطورين اخرين سيكون كتابة التعليقات لفهم وشرح اجزاء التطبيق هو الحل الامثل في المستقبل للتعديل بسهوله بمساعدة التعليقات.
قواعد عامة ومتعارف عليها عالمياً لدي المطورين وهي كتابة شرح أو توضيح لماذا قمنا بكتابة هذة الأوامر.
ملاحظة
يجب عليك دائمًا كتابة كود جيد ومنظم وواضح ثم استخدم التعليقات التفصيلية التي تشرح بسهولة كيف يتم هذا الأمر ولا تستخدم عبارات سيئة الفهم.