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

من موسوعة حسوب
لا ملخص تعديل
ط مراجعة الصفحة وتدقيقها.
سطر 1: سطر 1:
تُنشئ لونًا انطلاقا من قيم الصبغة (hue) والتشبع (saturation) والإضاءة (lightness) والشفافية (alpha). تستخدم الدالة [http://www.w3.org/TR/css3-color/#hsl-color خوارزمية] من مواصفات [[CSS|CSS]].<noinclude>{{DISPLAYTITLE: الدالة <code>()hsla</code> في Sass
تُنشئ الدالة <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> ===
صبغة اللون. يجب أن تكون بين <code>0</code> و <code>360</code> درجة.
قيمة صبغة اللون. يجب أن تكون بين 0 و 360 درجة.


=== <code>‎$saturation</code> ===
=== <code>‎$saturation</code> ===
تشبُّع اللون. يجب أن يكون محصورًا بين ‎<code>0%‎</code> و  ‎<code>100%</code>.
قيمة تشبُّع اللون. يجب أن تترواح بين ‎0%‎ و  ‎100%.


=== <code>‎$lightness </code> ===
=== <code>‎$lightness </code> ===
إضاءة اللون. يجب أن تكون بين  ‎<code>0%‎</code> و  ‎<code>100%</code>.
قيمة إضاءة اللون. يجب أن تترواح بين  ‎0%‎ و  ‎100%.


=== <code>‎$alpha</code> ===
=== <code>‎$alpha</code> ===
شفافية اللون. يجب أن تكون بين <code>0</code> و <code>1</code>.
قيمة شفافيَّة اللون. يجب أن تكون بين 0 و 1.


== القيم المعادة ==
== القيم المعادة ==
اللون الناتج.
تُعاد قيمة اللون الناتج.


== الأخطاء والاستثناءات ==
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن كانت المعاملات من النوع الخاطئ أو كان <code>‎$lightness</code> أو <code>‎$saturation</code> أو <code>‎$alpha</code> خارج الحدود.
سيُرمى الخطأ <code>ArgumentError</code> إن كانت المعاملات من النوع الخطأ أو كانت قيمة المعاملات <code>‎$lightness</code> أو <code>‎$saturation</code> أو <code>‎$alpha</code> خارج المجال المسموح.


== أمثلة ==
== أمثلة ==
مثال على ضبط قيمة الخاصية <code>[[CSS/color|color]]</code> باستخدام الدالة <code>hsla()‎</code>:<syntaxhighlight lang="sass">
المثال 1: ضبط قيمة الخاصية <code>[[CSS/color|color]]</code> باستخدام الدالة <code>hsla()‎</code>.<syntaxhighlight lang="sass">
.selector {
.selector {
   color: hsl(50, 50, 50); // #bfaa40
   color: hsl(50, 50, 50); // #bfaa40
}
}


</syntaxhighlight>ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:<syntaxhighlight lang="css">
</syntaxhighlight>ستُصرّف الشيفرة السابقة إلى شيفرة [[CSS]] الآتية:<syntaxhighlight lang="css">
.selector {
.selector {
   color: #bfaa40;
   color: #bfaa40;
سطر 41: سطر 41:


== انظر أيضًا ==
== انظر أيضًا ==
* الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والإضاءة.
* الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والإضاءة.
* الدالة <code>[[Sass/adjust color|adjust_color()]]‎</code>: تزيد أو تقلِّل قيمة خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد.


== مصادر ==
== مصادر ==

مراجعة 06:14، 3 مايو 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 خارج المجال المسموح.

أمثلة

المثال 1: ضبط قيمة الخاصية color باستخدام الدالة hsla()‎.

.selector {
  color: hsl(50, 50, 50); // #bfaa40
}

ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:

.selector {
  color: #bfaa40;
}

انظر أيضًا

  • الدالة hsl()‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والإضاءة.
  • الدالة adjust_color(): تزيد أو تقلِّل قيمة خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد.

مصادر