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

مراجعة 08:06، 4 مايو 2018

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

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

#saturate($color, $amount)

المعاملات

`‎$color`

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

‎$amount

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

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

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

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

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

أمثلة

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

.selector {
  color: saturate(hsl(120, 30%, 90%), 20%); // #d9f2d9
  background-color: saturate(#855, 20%); // #9e3f3f
}

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

.selector {
  color: #d9f2d9;
  background-color: #9e3f3f;
}

انظر أيضًا

الدالة desaturate()‎: تجعل اللون أقل تشبّعًا.
الدالة saturation()‎: تعيد الدالة مُكوّن التشبع للون الممرَّر إليها.
الدالة adjust_color()‎: تغيِّر قيمة أي مكوِّن من مكونات اللون.
الدالة hsl()‎: تنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والإضاءة.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()saturate</code> في Sass}}</noinclude>
-تجعل الدالة <code>()saturate</code> اللون أكثر تشبُّعًا. وتأخذ لونا وعددا بين <code>‎0%</code> و <code>‎100%</code>، وتعيد لونًا بعد زيادة التشبع.
+تزيد الدالة <code>()saturate</code> من تشبُّع اللون إذ يممرَّر إليها لونًا وعددًا بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد زيادة قيمة التشبع له بحسب القيمة الأخيرة.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
@@ سطر 9: / سطر 9: @@
 === <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>saturate()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
+المثال 1: استخدام الدالة <code>saturate()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>).<syntaxhighlight lang="sass">
 .selector {
    color: saturate(hsl(120, 30%, 90%), 20%); // #d9f2d9
@@ سطر 37: / سطر 37: @@
 == انظر أيضًا ==
-* الدالة <code>[[Sass/hsla|hsla()]]</code>‎:تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والإضاءة والشفافية.
-* الدالة <code>[[Sass/hsl|hsl()]]</code>‎:تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والإضاءة.
 * الدالة <code>[[Sass/desaturate|desaturate()]]</code>‎: تجعل اللون أقل تشبّعًا.
-* الدالة <code>[[Sass/saturation|saturation()]]</code>‎:تُعيدُ الدالة مُكوّن التشبع الخاص باللون.
+* الدالة <code>[[Sass/saturation|saturation()]]</code>‎: تعيد الدالة مُكوّن التشبع للون الممرَّر إليها.
+* الدالة <code>[[Sass/adjust color|adjust_color()‎]]</code>: تغيِّر قيمة أي مكوِّن من مكونات اللون.
+* الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والإضاءة.
 == مصادر ==