الفرق بين المراجعتين ل"Sass/darken"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة الصفحة وتدقيقها.) |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()darken</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()darken</code> في Sass}}</noinclude> | ||
| − | تجعل الدالة <code>()darken</code> اللون أكثر ظلمة. | + | تجعل الدالة <code>()darken</code> اللون أكثر ظلمة. يُمرر لها لونًا وعددا يتراوح بين 0% و 100% ثمَّ تعيد ذلك اللون بعد تقليل الإضاءة بحسب القيمة الأخيرة. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 9: | سطر 9: | ||
=== <code>$color</code> === | === <code>$color</code> === | ||
| − | + | القيمة اللونيَّة التي ستُجرى عليها العمليَّة. | |
| − | <code>$ | + | <code>$amount</code> |
| − | مقدار تقليل الإضاءة، | + | قيمة تمثِّل مقدار تقليل الإضاءة، ويجب أن تترواح بين 0% و 100%. |
== القيم المعادة == | == القيم المعادة == | ||
| − | اللون | + | يُعاد اللون <code>$color</code> بعد تقليل إضاءته بحسب قيمة المعامل <code>$amount</code>. |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيُرمى الخطأ <code>ArgumentError</code> إن كان أحد المعاملات من النوع الخطأ، أو إن | + | سيُرمى الخطأ <code>ArgumentError</code> إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل <code>$amount</code> خارج المجال المسموح. |
== أمثلة == | == أمثلة == | ||
| − | + | المثال 1: استخدام الدالة <code>darken()</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>).<syntaxhighlight lang="sass"> | |
.selector { | .selector { | ||
color: darken(hsla(25, 100%, 80%, 0.2), 30%); // rgba(255, 106, 0, 0.2) | color: darken(hsla(25, 100%, 80%, 0.2), 30%); // rgba(255, 106, 0, 0.2) | ||
| سطر 37: | سطر 37: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <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/hue|hue()]]</code>: تُعيدُ قيمة مُكوّن الصبغة للون المرَّر إليها. |
| − | * الدالة <code>[[Sass/lighten|lighten()]]</code>: تجعل اللون أكثر | + | * الدالة <code>[[Sass/lighten|lighten()]]</code>: تجعل اللون أكثر فتوحًا. |
== مصادر == | == مصادر == | ||
مراجعة 15:14، 2 مايو 2018
تجعل الدالة ()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;
}
انظر أيضًا
- الدالة
hsla(): تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع والإضاءة والشفافيَّة. - الدالة
hsl(): تُنشئ لونًا انطلاقا من قيم الصبغة والتشبُّع والإضاءة. - الدالة
hue(): تُعيدُ قيمة مُكوّن الصبغة للون المرَّر إليها. - الدالة
lighten(): تجعل اللون أكثر فتوحًا.