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