عرض مصدر Sass/desaturate

<noinclude>{{DISPLAYTITLE: الدالة <code>()desaturate</code> في Sass}}</noinclude>
تجعل الدالة <code>()desaturate</code> اللون أقل تشبُّعًا. يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل قيمة مكوِّن تشبُّعه بحسب القيمة الأخيرة.
== البنية العامة ==
<syntaxhighlight lang="sass">
desaturate($color, $amount)
</syntaxhighlight>

== المعاملات ==

=== <code>‎$color</code> ===
القيمة اللونيَّة التي ستُجرى عليها العمليَّة.

<code>‎$amount</code>

قيمة تمثِّل مقدار تقليل التشبُّع، ويجب أن يتراوح بين ‎0% و ‎100%.

== القيم المعادة ==
يُعاد اللون <code>‎$color</code> بعد تقليل قيمة تشبُّعه بمقدار <code>‎$amount</code>.

== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل <code>‎$amount</code> خارج المجال المسموح.

== أمثلة ==
مثال عن استخدام الدالة <code>desaturate()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
.selector {
  color: desaturate(hsla(120, 30%, 90%, 0.5), 20%); // rgba(227, 232, 227, 0.5)
  background-color: desaturate(#855, 20%); // #726b6b
}

</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <code>[[CSS]]</code> الآتية:<syntaxhighlight lang="css">
.selector {
  color: rgba(227, 232, 227, 0.5);
  background-color: #726b6b; }
</syntaxhighlight>

== انظر أيضًا ==
*الدالة <code>[[Sass/saturate|saturate()]]</code>‎: تجعل اللون أكثر تشبّعًا.
*الدالة <code>[[Sass/lighten|lighten()]]</code>‎: تجعل اللون أكثر إضاءة.
*الدالة <code>[[Sass/opacify|()opacify]]</code> : تجعل اللون أكثر عتامةً.
*الدالة <code>[[Sass/darken|darken()]]</code>‎: تجعل اللون أكثر ظلمة.
* الدالة <code>[[Sass/hsla|hsla()]]</code>‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والإضاءة والشفافيَّة.
* الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والإضاءة والشفافيَّة.
* الدالة <code>[[Sass/saturation|saturation()]]</code>‎: تُعيدُ الدالة قيمة مُكوّن التشبع الخاص باللون.

== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#desaturate-instance_method قسم الدالة desaturate في صفحة الدوال في توثيق Sass الرسمي.]
[[تصنيف:Sass]]
[[تصنيف: Sass Function]]