الفرق بين المراجعتين ل"Sass/hsl"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
|||
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | تُنشئ لونًا | + | تُنشئ الدالة <code>hsl()</code> لونًا جديدًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness). تستخدم هذه الدالة [http://www.w3.org/TR/css3-color/#hsl-color خوارزمية] من مواصفات [[CSS|CSS]].<noinclude>{{DISPLAYTITLE: الدالة <code>()hsl</code> في Sass |
}}</noinclude> | }}</noinclude> | ||
سطر 10: | سطر 10: | ||
=== <code>$hue</code> === | === <code>$hue</code> === | ||
− | صبغة اللون. يجب أن تكون بين | + | قيمة صبغة اللون. يجب أن تكون بين 0 و 360 درجة. |
=== <code>$saturation</code> === | === <code>$saturation</code> === | ||
− | تشبُّع اللون. يجب أن | + | قيمة تشبُّع اللون. يجب أن تترواح بين 0% و 100%. |
=== <code>$lightness </code> === | === <code>$lightness </code> === | ||
− | + | قيمة سطوع اللون. يجب أن تكون بين 0% و 100%. | |
== القيم المعادة == | == القيم المعادة == | ||
− | اللون الناتج. | + | تُعاد قيمة اللون الناتج. |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
− | سيُرمى الخطأ <code>ArgumentError</code> إن كانت المعاملات من النوع الخطأ أو | + | سيُرمى الخطأ <code>ArgumentError</code> إن كانت المعاملات من النوع الخطأ أو كانت قيمة المعامل <code>$lightness</code> والمعامل <code>$saturation</code> خارج المجال المسموح. |
== أمثلة == | == أمثلة == | ||
− | مثال عن ضبط لون العنصر (color) باستخدام الدالة hsl():<syntaxhighlight lang="sass"> | + | مثال عن ضبط لون العنصر (<code>[[CSS/color|color]]</code>) باستخدام الدالة <code>hsl()</code>:<syntaxhighlight lang="sass"> |
.selector { | .selector { | ||
color: hsl(50, 50, 50); // #bfaa40 | color: hsl(50, 50, 50); // #bfaa40 | ||
} | } | ||
− | </syntaxhighlight>ستُصرَّف الشيفرة السابقة إلى | + | </syntaxhighlight>ستُصرَّف الشيفرة السابقة إلى:<syntaxhighlight lang="css"> |
.selector { | .selector { | ||
− | color: #bfaa40; | + | color: #bfaa40; } |
− | } | ||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[Sass/hsla|hsla()]]</code>: تُنشئ لونًا | + | * الدالة <code>[[Sass/hsla|hsla()]]</code>: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة. |
+ | * الدالة <code>[[Sass/adjust color|adjust_color()]]</code>: تزيد أو تقلِّل قيمة خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد. | ||
+ | * الدالة <code>[[Sass/scale color|()scale_color]]</code>: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales). | ||
== مصادر == | == مصادر == | ||
− | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#hsl-instance_method قسم الدالة hsl في صفحة الدوال في توثيق Sass الرسمي. | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#hsl-instance_method قسم الدالة hsl في صفحة الدوال في توثيق Sass الرسمي]. |
− | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
− | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تُنشئ الدالة hsl()
لونًا جديدًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness). تستخدم هذه الدالة خوارزمية من مواصفات CSS.
البنية العامة
hsl($hue, $saturation, $lightness)
المعاملات
$hue
قيمة صبغة اللون. يجب أن تكون بين 0 و 360 درجة.
$saturation
قيمة تشبُّع اللون. يجب أن تترواح بين 0% و 100%.
$lightness
قيمة سطوع اللون. يجب أن تكون بين 0% و 100%.
القيم المعادة
تُعاد قيمة اللون الناتج.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError
إن كانت المعاملات من النوع الخطأ أو كانت قيمة المعامل $lightness
والمعامل $saturation
خارج المجال المسموح.
أمثلة
مثال عن ضبط لون العنصر (color
) باستخدام الدالة hsl()
:
.selector {
color: hsl(50, 50, 50); // #bfaa40
}
ستُصرَّف الشيفرة السابقة إلى:
.selector {
color: #bfaa40; }
انظر أيضًا
- الدالة
hsla()
: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة. - الدالة
adjust_color()
: تزيد أو تقلِّل قيمة خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد. - الدالة
()scale_color
: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales).