الفرق بين المراجعتين ل"Sass/hsla"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
|||
(5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 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> | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
− | + | hsla($hue, $saturation, $lightness, $alpha) | |
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 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 { | ||
+ | color: hsla(50, 50, 50, 0.5); // rgba(191, 170, 64, 0.5); | ||
+ | } | ||
+ | |||
+ | </syntaxhighlight>ستُصرّف الشيفرة السابقة إلى شيفرة [[CSS]] الآتية:<syntaxhighlight lang="css"> | ||
+ | .selector { | ||
+ | color: rgba(191, 170, 64, 0.5); } | ||
+ | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[Sass/hsl| | + | * الدالة <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 قسم الدالة | + | * [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).