الفرق بين المراجعتين ل"Sass/saturation"

المراجعة الحالية بتاريخ 06:59، 20 مايو 2018

تُعيدُ الدالة ()saturation قيمة مُكوّن التشبُّع (saturation) للون الممرَّر إليها.

البنية العامة

saturation($color)

المعاملات

`‎$color`

القيمة اللونيَّة التي نريد الحصول على مكوِّن التشبُّع الخاص بها.

القيم المعادة

تُعاد قيمة التشبّع للون ‎$color، وتكون بين %0 و %100.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن لم يكن ‎$color لونًا.

أمثلة

مثال عن استخدام الدالة saturation()‎ لمقارنة تشبّع اللون المُعرَّف من المستخدم بالقيمة 50% باستخدام التعليمة ‎@if، ثم اعتمادًا على نتيجة الشرط السابق فسنجعل اللون أكثر تشبعًا (باستخدام الدالة saturate()‎) أو أقل تشبعًا (باستخدام الدالة desaturate()‎):

$color: salmon;

.selector {
  // اختبار إن كان تشبّع اللون أكبر من 50 بالمئة
  @if saturation($color) > 50% {
    // جعل اللون أقل تشبعًا بنسبة 20 بالمئة
    color: desaturate($color, 20%);
  } @else {
    // جعل اللون أكثر تشبعًا بنسبة 20 بالمئة
    color: saturate($color, 20%);
  }
}

ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:

.selector {
  color: #eb8c81; }

انظر أيضًا

الدالة ()saturate: تزيد من تشبُّع اللون.
الدالة desaturate()‎: تجعل اللون أقل تشبّعًا.
الدالة ()lightness: تُعيدُ قيمة مُكوّن السطوع للون الممرَّر إليها.
الدالة hue()‎: تُعيدُ قيمة مُكوّن الصبغة للون الممرَّر إليها.
الدالة red()‎: تعيد قيمة المكوِّن الأحمر للون الممرَّر إليها.
الدالة ()blue‎: تعيد قيمة المكوِّن الأزرق للون الممرَّر إليها.
الدالة ()green‎: تعيد قيمة المكوِّن الأخضر للون الممرَّر إليها.
الدالة hsl()‎: تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع والسطوع.

مصادر

قسم الدالة saturation في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>()saturation</code> في Sass}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>()saturation</code> في Sass}}</noinclude>تُعيدُ الدالة <code>()saturation</code> قيمة مُكوّن التشبُّع (saturation) للون الممرَّر إليها.
-تُعيدُ الدالة <code>()hue</code> مُكوّن الصبغة الخاص باللون. انظر [[https://sass-lang.com/documentation/Sass/Script/hsl مواصفات] [[CSS|CSS3]] HSL]. يُحتسب من مكونات RGB عند الضرورة عبر [هذه [https://sass-lang.com/documentation/Sass/Script/rgb-to-hsl الخوارزمية]].
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-#hue($color)
+saturation($color)
 </syntaxhighlight>
@@ سطر 9: / سطر 9: @@
 === <code>‎$color</code> ===
-قيمة لونية.
+القيمة اللونيَّة التي نريد الحصول على مكوِّن التشبُّع الخاص بها.
 == القيم المعادة ==
-قيمة الصبغة، وتكون بين <code>0deg</code> و <code>360deg</code>.
+تُعاد قيمة التشبّع للون <code>‎$color</code>، وتكون بين %0 و %100.
 == الأخطاء والاستثناءات ==
 سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$color</code> لونًا.
+== أمثلة ==
+مثال عن استخدام الدالة <code>saturation()‎</code> لمقارنة تشبّع اللون المُعرَّف من المستخدم بالقيمة 50% باستخدام التعليمة <code>[[Sass/control directives#.E2.80.8E.40if|‎@if]]</code>، ثم اعتمادًا على نتيجة الشرط السابق فسنجعل اللون أكثر تشبعًا (باستخدام الدالة <code>[[Sass/saturate|saturate()‎]]</code>) أو أقل تشبعًا (باستخدام الدالة <code>[[Sass/desaturate|desaturate()‎]]</code>):<syntaxhighlight lang="sass">
+$color: salmon;
+.selector {
+  // اختبار إن كان تشبّع اللون أكبر من 50 بالمئة
+  @if saturation($color) > 50% {
+    // جعل اللون أقل تشبعًا بنسبة 20 بالمئة
+    color: desaturate($color, 20%);
+  } @else {
+    // جعل اللون أكثر تشبعًا بنسبة 20 بالمئة
+    color: saturate($color, 20%);
+  }
+}
+</syntaxhighlight>ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:<syntaxhighlight lang="css">
+.selector {
+  color: #eb8c81; }
+</syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/hsla|'''hsla'''()]]</code>‎:تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع  والإضاءة والشفافية.
+*الدالة <code>[[Sass/saturate|()saturate]]</code>: تزيد من تشبُّع اللون.
-* الدالة <code>[[Sass/hsl|'''hsl'''()]]</code>‎:تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع  والإضاءة والشفافية.
+*الدالة <code>[[Sass/desaturate|desaturate()]]</code>‎: تجعل اللون أقل تشبّعًا.
+*الدالة <code>[[Sass/lightness|()lightness]]</code>: تُعيدُ قيمة مُكوّن السطوع للون الممرَّر إليها.
+*الدالة <code>[[Sass/hue|hue()]]</code>‎: تُعيدُ قيمة مُكوّن الصبغة للون الممرَّر إليها.
+*الدالة <code>[[Sass/red|red()]]‎</code>: تعيد قيمة المكوِّن الأحمر للون الممرَّر إليها.
+*الدالة <code>[[Sass/blue|()blue‎]]</code>: تعيد قيمة المكوِّن الأزرق للون الممرَّر إليها.
+*الدالة <code>[[Sass/green|()green‎]]</code>: تعيد قيمة المكوِّن الأخضر للون الممرَّر إليها.
+*الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع والسطوع.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#hue-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#saturation-instance_method قسم الدالة saturation في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]