ما هي التعليقات؟

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

كيف نستخدم التعليقات؟

يمكنك إنشاء تعليق عن طريق استخدام علامات تختلف من لغة لأخرى، لكن معظم لغات البرمجة تتفق في علامتين مشهورتين وكذلك لغة جافاسكريبت التي نستخدمها اﻵن لتجربة ما نتعلم تستخدم هاتين العلامتين فقط ﻹنشاء تعليق جديد... ولكن عندما تتعلم أي لغة أخرى ستقرأ فقط ما العلامات المستخدم فيها!

تعليقات السطر الواحد

يمكنك إنشاء تعليق على سطر واحد باستخدام العلامة // في بداية السطر.

ستلاحظ أن التعليق دائما يأخذ لون خافت، رمادي خافت مثلاً..

مثال:

// Let's Print test to console!
console.log("test");

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

// Let's Print test to console!
// console.log("test");

اﻵن المفسر سيعتبر السطر الثاني "سطر الطباعة" تعليق، بالتالي سيتجاهله ولن يشغله.

تعليقات متعددة اﻷسطر

يمكنك إنشاء تعليق على أسطر متعددة أياً كان عددها بوضع الكتابة بين العلامتين /* */.

لا تعرف كيف تكتب العلامة / ؟ ستجدها في أسفل يمين لوحة المفاتيح في مفتاح ظ فعندما تضغط عليه واللغة التي تكتب بها هي اﻹنجليزية سيكتب لك /

لا تعرف كيف تكتب العلامة *؟ يمكنك كتابتها عن طريق الضغط المستمر على Shift ثم الضغط على مفتاح الرقم 8 الموجود أعلى لوحة المفاتيح.

وتستخدم التعليقات متعددة اﻷسطر غالباً إما في:

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

ستلاحظ أن التعليق دائما يأخذ لون خافت، رمادي خافت مثلاً..

/* console.log("test");
console.log("test");
console.log("test");
console.log("test");*/

اﻵن المفسر سيتجاهل كل ما بين العلامتين !

مثال أخر:

/* console.log("test");
console.log("test");
console.log("test");
console.log("test");*/
console.log("here");

عند تشغيل الكود، ستجد المشغل لم يفسر إلّا السطر اﻵخير ﻷنه خارج التعليق، بالتالي سيطبع فقط hello

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

/* 
  You're Learning now from Dalilmobarmg.com
  Dalilmobarmg is an Open-Source Arabic Platform
  We wish you understood comments lesson and everything is good with you!
  
  كما يمكنك أيضاً الكتابة باللغة العربية!
  ﻷن هذه اﻷسطر لن يمر عليها مفسّر اللغة وسيتجاهلها
*/