التعليقات في Sass

تدعم Sass الشكل القياسي للتعليقات متعدِّدة الأسطر باستعمال /* */ المُعتمد في لغة CSS، وكذلك التعليقات أحادية السطر باستعمال//. يُحتفظ بالتّعليقات متعدّدة الأسطر في مُخرجات CSS حيثما كان ذلك ممكنًا في حين تُزال التعليقات أحاديّة السطر. انظر مثلًا إلى الشيفرة الآتية:

/* هذا التعليق
 * طوله عدِّة أسطر.‏
 * CSS لمّا كان يستعمل بنية التعليقات في
 * فسيظهر في الملف المُصرَّف.‏ */
body { color: black; }

// هذه التعليقات طولها سطرٌ واحدٌ فقط.
// ولن تظهر في الملف المُصرَّف
// CSS لأنها تستخدم شكلًا لا تدعمه لغة
a { color: green; }

ستُصرّف إلى:

/* هذا التعليق
 *طوله عدِّة أسطر. ‏
 * CSS لمّا كان يستعمل بنية التعليقات في
 * فسيظهر في الملف المُصرَّف.‏ */
body {
 color: black; }

a {
 color: green; }

إن كان الحرف الأول لتعليق متعدّد الأسطر هو !، فسيدرج هذا التعليق دائمًا في مُخرجات CSS حتى في وضع المُخرجات المضغوطة (compressed output modes). هذا مفيد إن أردت إضافة إشعارات حقوق المِلكيّة والنّشر لملف CSS الناتج. تُدرَج التّعليقات متعدّدة الأسطر في ملفّ CSS الناتج بعد استيفائها (interpolation). توضح الشيفرة التالية ذلك:

$version: "1.2.3";

/* This CSS is generated by My Snazzy Framework version #{$version}. */

ستُصرّف إلى:

/* This CSS is generated by My Snazzy Framework version 1.2.3. */

مصادر

• قسم Comments من توثيق Sass الرسمي.