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

تجعل الدالة ()lighten اللون أكثر سطوعًا (lightness) إذ يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد بعدئذ ذلك اللون بعد زيادة السطوع بحسب القيمة الأخيرة.

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

#lighten ($color, $amount)

المعاملات

‎$color

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

‎$amount

قيمة السطوع المراد زيادتها، وتتراوح بين ‎0% و ‎100%.

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

يُعاد اللون ‎$color بعد زيادة إضاءته بحسب القيمة ‎$amount.

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

سيُرمى الخطأ ArgumentError إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل ‎$amount خارج المجال المسموح.

أمثلة

مثال عن استخدام الدالة lighten()‎ لضبط قيمة اللون (color) ولون الخلفية (background-color):

.selector {
  color: lighten(hsl(0, 0%, 0%), 30%); // #4d4d4d
  background-color: lighten(#800, 20%); // #ee0000
}

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

.selector {
  color: #4d4d4d;
  background-color: #ee0000; }

انظر أيضًا

• الدالة ()lightness: تُعيدُ مُكوّن السطوع (lightness) للون الممرَّر إليها.
• الدالة ()darken : تجعل اللون أكثر ظلمة.
• الدالة ()opacify : تجعل اللون أكثر عتامةً.
• الدالة saturate()‎: تجعل اللون أكثر تشبّعًا.
• الدالة desaturate()‎: تجعل اللون أقل تشبّعًا.
• الدالة hsla()‎: تنشئ لونًا جديدًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة.
• الدالة hsl()‎: تُنشئ لونًا انطلاقًا جديدًا من قيم الصبغة والتشبع والسطوع.
• الدالة hue()‎: تُعيد الدالة مُكوّن الصبغة الخاص باللون.
• الدالة adjust_color()‎: تزيد أو تقلِّل خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد

مصادر

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