الدالة ()hsl في Sass

من موسوعة حسوب

تُنشئ الدالة 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).

مصادر