الفرق بين المراجعتين ل"Sass/lighten"

مراجعة 13:25، 12 مايو 2018

تجعل الدالة ()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;
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()lighten</code> في Sass}}</noinclude>
-تجعل الدالة <code>()lighten</code> اللون أكثر إضاءةً (lightness) إذ يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد بعدئذ ذلك اللون بعد زيادة الإضاءة بحسب القيمة الأخيرة.
+تجعل الدالة <code>()lighten</code> اللون أكثر سطوعًا (lightness) إذ يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد بعدئذ ذلك اللون بعد زيادة السطوع بحسب القيمة الأخيرة.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
@@ سطر 13: / سطر 13: @@
 <code>‎$amount</code>
-قيمة الإضاءة المراد زيادتها، وتتراوح بين  ‎0% و ‎100%.
+قيمة السطوع المراد زيادتها، وتتراوح بين  ‎0% و ‎100%.
 == القيم المعادة ==
@@ سطر 22: / سطر 22: @@
 == أمثلة ==
-المثال 1: استخدام الدالة <code>lighten()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>).<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>lighten()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
 .selector {
    color: lighten(hsl(0, 0%, 0%), 30%); // #4d4d4d
@@ سطر 41: / سطر 41: @@
 * الدالة <code>[[Sass/saturate|saturate()]]</code>‎: تجعل اللون أكثر تشبّعًا.
 * الدالة <code>[[Sass/desaturate|desaturate()]]</code>‎: تجعل اللون أقل تشبّعًا.
-* الدالة <code>[[Sass/hsla|hsla()]]</code>‎: تنشئ لونًا جديدًا انطلاقًا من قيم الصبغة والتشبُّع والإضاءة والشفافيَّة.
+* الدالة <code>[[Sass/hsla|hsla()]]</code>‎: تنشئ لونًا جديدًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة.
-* الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تُنشئ لونًا انطلاقًا جديدًا  من قيم الصبغة والتشبع والإضاءة.
+* الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تُنشئ لونًا انطلاقًا جديدًا  من قيم الصبغة والتشبع والسطوع.
 * الدالة <code>[[Sass/hue|hue()]]</code>‎: تُعيد الدالة مُكوّن الصبغة الخاص باللون.
 * الدالة <code>[[Sass/adjust color|adjust_color()‎]]</code>: تزيد أو تقلِّل خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد