الفرق بين المراجعتين ل"Sass/saturation"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
|||
(6 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: الدالة <code>()saturation</code> في Sass}}</noinclude> | + | <noinclude>{{DISPLAYTITLE: الدالة <code>()saturation</code> في Sass}}</noinclude>تُعيدُ الدالة <code>()saturation</code> قيمة مُكوّن التشبُّع (saturation) للون الممرَّر إليها. |
− | تُعيدُ الدالة <code>()saturation</code> | + | |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
− | + | saturation($color) | |
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 9: | سطر 9: | ||
=== <code>$color</code> === | === <code>$color</code> === | ||
− | + | القيمة اللونيَّة التي نريد الحصول على مكوِّن التشبُّع الخاص بها. | |
== القيم المعادة == | == القيم المعادة == | ||
− | قيمة | + | تُعاد قيمة التشبّع للون <code>$color</code>، وتكون بين %0 و %100. |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>$color</code> لونًا. | سيُرمى الخطأ <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/saturate|()saturate]]</code>: تزيد من تشبُّع اللون. |
− | * الدالة <code>[[Sass/ | + | *الدالة <code>[[Sass/desaturate|desaturate()]]</code>: تجعل اللون أقل تشبّعًا. |
− | * الدالة <code>[[Sass/hue|hue()]]</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#saturation-instance_method قسم الدالة saturation في صفحة الدوال في توثيق Sass الرسمي. | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#saturation-instance_method قسم الدالة saturation في صفحة الدوال في توثيق Sass الرسمي]. |
− | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
− | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 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()
: تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع والسطوع.