الفرق بين المراجعتين لصفحة: «Sass/comments»
< Sass
ط إضافة عنوان الصفحة والتصنيفات |
ط استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}' |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التعليقات في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE:التعليقات في Sass}}</noinclude> | ||
تدعم Sass الشكل القياسي للتعليقات | تدعم Sass الشكل القياسي للتعليقات متعدِّدة الأسطر باستعمال <code>/* */</code> المُعتمد في لغة CSS، وكذلك التعليقات أحادية السطر باستعمال<code>//</code>. يُحتفظ بالتّعليقات متعدّدة الأسطر في مُخرجات CSS حيثما كان ذلك ممكنًا في حين تُزال التعليقات أحاديّة السطر. انظر مثلًا إلى الشيفرة الآتية:<syntaxhighlight lang="sass"> | ||
/* هذا التعليق | /* هذا التعليق | ||
طوله عدِّة أسطر. | * طوله عدِّة أسطر. | ||
CSS | * CSS لمّا كان يستعمل بنية التعليقات في | ||
فسيظهر في الملف المُصرَّف. */ | * فسيظهر في الملف المُصرَّف. */ | ||
body { color: black; } | body { color: black; } | ||
| سطر 14: | سطر 14: | ||
</syntaxhighlight>ستُصرّف إلى:<syntaxhighlight lang="css"> | </syntaxhighlight>ستُصرّف إلى:<syntaxhighlight lang="css"> | ||
/* هذا التعليق | /* هذا التعليق | ||
طوله عدِّة أسطر. | *طوله عدِّة أسطر. | ||
CSS | * CSS لمّا كان يستعمل بنية التعليقات في | ||
فسيظهر في الملف المُصرَّف. */ | * فسيظهر في الملف المُصرَّف. */ | ||
body { | body { | ||
color: black; } | color: black; } | ||
| سطر 23: | سطر 23: | ||
color: green; } | color: green; } | ||
</syntaxhighlight> | </syntaxhighlight>إن كان الحرف الأول لتعليق متعدّد الأسطر هو <code>!</code>، فسيدرج هذا التعليق دائمًا في مُخرجات [[CSS]] حتى في وضع المُخرجات المضغوطة (compressed output modes). هذا مفيد إن أردت إضافة إشعارات حقوق المِلكيّة والنّشر لملف CSS الناتج. | ||
تُدرَج التّعليقات متعدّدة الأسطر في ملفّ CSS الناتج بعد استيفائها (interpolation). | تُدرَج التّعليقات متعدّدة الأسطر في ملفّ CSS الناتج بعد استيفائها (interpolation). توضح الشيفرة التالية ذلك:<syntaxhighlight lang="css"> | ||
$version: "1.2.3"; | $version: "1.2.3"; | ||
| سطر 35: | سطر 35: | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/file.SASS_REFERENCE.html#comments قسم Comments من توثيق Sass الرسمي]. | * [https://sass-lang.com/documentation/file.SASS_REFERENCE.html#comments قسم Comments من توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تدعم 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. */