الفرق بين المراجعتين لصفحة: «Sass/hsla»
< Sass
لا ملخص تعديل |
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].' |
||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
تنشئ الدالة <code>hsla()</code> لونًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness) والشفافيَّة (alpha). تستخدم الدالة [http://www.w3.org/TR/css3-color/#hsl-color خوارزمية] من مواصفات [[CSS|CSS]].<noinclude>{{DISPLAYTITLE: الدالة <code>()hsla</code> في Sass | |||
}}</noinclude> | }}</noinclude> | ||
| سطر 10: | سطر 10: | ||
=== <code>$hue</code> === | === <code>$hue</code> === | ||
صبغة اللون. يجب أن تكون بين | قيمة صبغة اللون. يجب أن تكون بين 0 و 360 درجة. | ||
=== <code>$saturation</code> === | === <code>$saturation</code> === | ||
تشبُّع اللون. يجب أن | قيمة تشبُّع اللون. يجب أن تترواح بين 0% و 100%. | ||
=== <code>$lightness </code> === | === <code>$lightness </code> === | ||
قيمة سطوع اللون. يجب أن تترواح بين 0% و 100%. | |||
=== <code>$alpha</code> === | === <code>$alpha</code> === | ||
قيمة شفافيَّة اللون. يجب أن تكون بين 0 و 1. | |||
== القيم المعادة == | == القيم المعادة == | ||
اللون الناتج. | تُعاد قيمة اللون الناتج. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن كانت المعاملات من النوع | سيُرمى الخطأ <code>ArgumentError</code> إن كانت المعاملات من النوع الخطأ أو كانت قيمة المعاملات <code>$lightness</code> أو <code>$saturation</code> أو <code>$alpha</code> خارج المجال المسموح. | ||
== أمثلة == | == أمثلة == | ||
مثال | مثال عن ضبط قيمة الخاصية <code>[[CSS/color|color]]</code> باستخدام الدالة <code>hsla()</code>:<syntaxhighlight lang="sass"> | ||
.selector { | .selector { | ||
color: | color: hsla(50, 50, 50, 0.5); // rgba(191, 170, 64, 0.5); | ||
} | } | ||
</syntaxhighlight>ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:<syntaxhighlight lang="css"> | </syntaxhighlight>ستُصرّف الشيفرة السابقة إلى شيفرة [[CSS]] الآتية:<syntaxhighlight lang="css"> | ||
.selector { | .selector { | ||
color: | color: rgba(191, 170, 64, 0.5); } | ||
} | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/hsl|hsl()]]</code>: | * الدالة <code>[[Sass/hsl|hsl()]]</code>: تنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع. | ||
* الدالة <code>[[Sass/adjust color|adjust_color()]]</code>: تزيد أو تقلِّل قيمة خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد. | |||
* الدالة <code>[[Sass/scale color|()scale_color]]</code>: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales). | |||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#hsla-instance_method قسم الدالة hsla في صفحة الدوال في توثيق Sass الرسمي. | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#hsla-instance_method قسم الدالة hsla في صفحة الدوال في توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 06:59، 20 مايو 2018
تنشئ الدالة hsla() لونًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness) والشفافيَّة (alpha). تستخدم الدالة خوارزمية من مواصفات CSS.
البنية العامة
hsla($hue, $saturation, $lightness, $alpha)
المعاملات
$hue
قيمة صبغة اللون. يجب أن تكون بين 0 و 360 درجة.
$saturation
قيمة تشبُّع اللون. يجب أن تترواح بين 0% و 100%.
$lightness
قيمة سطوع اللون. يجب أن تترواح بين 0% و 100%.
$alpha
قيمة شفافيَّة اللون. يجب أن تكون بين 0 و 1.
القيم المعادة
تُعاد قيمة اللون الناتج.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن كانت المعاملات من النوع الخطأ أو كانت قيمة المعاملات $lightness أو $saturation أو $alpha خارج المجال المسموح.
أمثلة
مثال عن ضبط قيمة الخاصية color باستخدام الدالة hsla():
.selector {
color: hsla(50, 50, 50, 0.5); // rgba(191, 170, 64, 0.5);
}
ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:
.selector {
color: rgba(191, 170, 64, 0.5); }
انظر أيضًا
- الدالة
hsl(): تنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع. - الدالة
adjust_color(): تزيد أو تقلِّل قيمة خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد. - الدالة
()scale_color: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales).