الدالة ()‎adjust_hue في Sass

تغيِّر الدالة adjust_hue()‎ قيمة مكوِّن الصبغة (hue) للون إذ يمرر لها اللون وعدد الدرجات (يكون عادةً ما بين ‎-‎360 و 360 درجة [deg]) ، ثمَّ تُعيد لونًا بعد تدوير الصبغة على طول عجلة اللون (color wheel) بالمقدار المُحدّد.

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

adjust_hue($color, $degrees)‎

المعاملات

‎$color

اللون المراد تعديله.

‎$degrees

عدد درجات تدوير الصبغة، ويتراوح ما بين ‎-‎360 و 360 درجة (deg).

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

تُعاد قيمة لونيَّة بعد التعديل.

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

سيُرمى الخطأ ArgumentError إذا كان أيٌّ من المعاملات من النوع الخطأ.

أمثلة

مثال عن استخدام الدالة adjust_hue()‎ مع قيمة لونيَّة بالنظام الست عشري، وأخرى باستخدام الدالة hsl()‎:

.selector {
  background-color: adjust-hue(hsl(120, 30%, 90%), 60deg); // #deeded
  color: adjust-hue(#811, 45deg); // #886a11
}

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

.selector {
  background-color: #deeded;
  color: #886a11; }

انظر أيضًا

• الدالة alpha()‎: تُعيد قيمة مكون قناة الشفافيَّة (alpha).
• الدالة adjust_color()‎: تغيِّر خاصِّيَّات اللون.
• الدالة ()scale_color: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales).
• الدالة hsl()‎‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع.

مصادر

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