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

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

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

darken($color, $amount)

المعاملات

‎$color

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

‎$amount

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

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

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

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

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

أمثلة

مثال عن استخدام الدالة 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()‎: تُعيدُ قيمة مُكوّن الصبغة للون المرَّر إليها.

مصادر

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