الفرق بين المراجعتين لصفحة: «Sass/desaturate»

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


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


<code>‎$amount </code>
<code>‎$amount</code>


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


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


== الأخطاء والاستثناءات ==
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</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">
المثال 1: استخدام الدالة <code>desaturate()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>).<syntaxhighlight lang="sass">
.selector {
.selector {
   color: desaturate(hsla(120, 30%, 90%, 0.5), 20%); // rgba(227, 232, 227, 0.5)
   color: desaturate(hsla(120, 30%, 90%, 0.5), 20%); // rgba(227, 232, 227, 0.5)
سطر 37: سطر 37:


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


== مصادر ==
== مصادر ==

مراجعة 15:24، 2 مايو 2018

تجعل الدالة ()desaturate اللون أقل تشبُّعًا. يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل قيمة مكوِّن تشبُّعه بحسب القيمة الأخيرة.

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

#desaturate($color, $amount)

المعاملات

‎$color

القيمة اللونيَّة التي ستُجرى عليها العمليَّة.

‎$amount

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

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

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

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

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

أمثلة

المثال 1: استخدام الدالة desaturate()‎ لضبط قيمة اللون (color) ولون الخلفية (background-color).

.selector {
  color: desaturate(hsla(120, 30%, 90%, 0.5), 20%); // rgba(227, 232, 227, 0.5)
  background-color: desaturate(#855, 20%); // #726b6b
}

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

.selector {
  color: rgba(227, 232, 227, 0.5);
  background-color: #726b6b;
}

انظر أيضًا

  • الدالة hsla()‎: تُنشئ لونًا انطلاقا من قيم الصبغة والتشبُّع والإضاءة والشفافيَّة.
  • الدالة hsl()‎: تُنشئ لونًا انطلاقا من قيم الصبغة والتشبُّع والإضاءة والشفافيَّة.
  • الدالة saturate()‎: تجعل اللون أكثر تشبّعًا.
  • الدالة saturation()‎: تُعيدُ الدالة قيمة مُكوّن التشبع الخاص باللون.
  • الدالة darken()‎: تجعل اللون أكثر ظلمة.

مصادر