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

تجعل الدالة ()darken اللون أكثر ظلمة. يُمرر لها لونًا وعددا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل الإضاءة بحسب القيمة الأخيرة.

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

darken($color, $amount)

المعاملات

‎$color

القيمة اللونيَّة التي ستُجرى عليها العمليَّة.

‎$amount

قيمة تمثِّل مقدار تقليل الإضاءة، ويجب أن تترواح بين ‎0% و ‎100%.

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

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

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

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

أمثلة

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

.selector {
  color: darken(hsla(25, 100%, 80%, 0.2), 30%); // rgba(255, 106, 0, 0.2)
  background-color: darken(#800, 20%); // #220000
}

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

.selector {
  color: rgba(255, 106, 0, 0.2);
  background-color: #220000;
}

انظر أيضًا

• الدالة saturate()‎: تجعل اللون أكثر تشبّعًا.
• الدالة desaturate()‎: تجعل اللون أقل تشبّعًا.
• الدالة lighten()‎: تجعل اللون أكثر إضاءة.
• الدالة ()opacify : تجعل اللون أكثر عتامةً.
• الدالة hsla()‎: تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع والإضاءة والشفافيَّة.
• الدالة hsl()‎: تُنشئ لونًا انطلاقا من قيم الصبغة والتشبُّع والإضاءة.
• الدالة hue()‎: تُعيدُ قيمة مُكوّن الصبغة للون المرَّر إليها.

مصادر

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