Sass/comments

تدعم 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 الرسمي.