الفرق بين المراجعتين لصفحة: «Sass/darken»

المراجعة الحالية بتاريخ 07:00، 20 مايو 2018

تجعل الدالة ()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 الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()darken</code> في Sass}}</noinclude>
-تجعل الدالة <code>()darken</code> اللون أكثر ظلمة. يُمرر لها لونًا وعددا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل الإضاءة بحسب القيمة الأخيرة.
+تجعل الدالة <code>()darken</code> اللون أكثر ظلمة. يُمرر لها لونًا وعددا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل السطوع بحسب القيمة الأخيرة.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
@@ سطر 13: / سطر 13: @@
 <code>‎$amount</code>
-قيمة تمثِّل مقدار تقليل الإضاءة، ويجب أن تترواح بين ‎0% و ‎100%.
+قيمة تمثِّل مقدار تقليل السطوع، ويجب أن تترواح بين ‎0% و ‎100%.
 == القيم المعادة ==
-يُعاد اللون <code>‎$color</code> بعد تقليل إضاءته بحسب قيمة المعامل <code>‎$amount</code>.
+يُعاد اللون <code>‎$color</code> بعد تقليل سطوعه بحسب قيمة المعامل <code>‎$amount</code>.
 == الأخطاء والاستثناءات ==
@@ سطر 22: / سطر 22: @@
 == أمثلة ==
-المثال 1: استخدام الدالة <code>darken()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>).<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>darken()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
 .selector {
    color: darken(hsla(25, 100%, 80%, 0.2), 30%); // rgba(255, 106, 0, 0.2)
@@ سطر 31: / سطر 31: @@
 .selector {
    color: rgba(255, 106, 0, 0.2);
-   background-color: #220000;
+   background-color: #220000; }
-}
 </syntaxhighlight>
@@ سطر 39: / سطر 37: @@
 *الدالة <code>[[Sass/saturate|saturate()]]</code>‎: تجعل اللون أكثر تشبّعًا.
 *الدالة <code>[[Sass/desaturate|desaturate()]]</code>‎: تجعل اللون أقل تشبّعًا.
-*الدالة <code>[[Sass/lighten|lighten()]]</code>‎: تجعل اللون أكثر إضاءة.
+*الدالة <code>[[Sass/lighten|lighten()]]</code>‎: تجعل اللون أكثر سطوعًا.
 *الدالة <code>[[Sass/opacify|()opacify]]</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>‎: تُعيدُ قيمة مُكوّن الصبغة للون المرَّر إليها.
-*
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#darken-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#darken-instance_method قسم الدالة darken في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]