الفرق بين المراجعتين ل"Sass/lighten"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()lighten</code> في Sass}}</noinclude> تُعيدُ الدالة <code>()lighten</code> مُكوّن الإضاءة (lig...')
 
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].')
 
(10 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()lighten</code> في Sass}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()lighten</code> في Sass}}</noinclude>
تُعيدُ الدالة <code>()lighten</code> مُكوّن الإضاءة (lightness) الخاص باللون. انظر [[https://sass-lang.com/documentation/Sass/Script/hsl مواصفات] [[CSS|CSS3]] HSL]. يُحتسب من مكونات RGB عند الضرورة عبر [هذه [https://sass-lang.com/documentation/Sass/Script/rgb-to-hsl الخوارزمية]].
+
تجعل الدالة <code>()lighten</code> اللون أكثر سطوعًا (lightness) إذ يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد بعدئذ ذلك اللون بعد زيادة السطوع بحسب القيمة الأخيرة.
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="sass">
 
<syntaxhighlight lang="sass">
#lightness ($color)
+
#lighten ($color, $amount)
 
</syntaxhighlight>
 
</syntaxhighlight>
  
سطر 9: سطر 9:
  
 
=== <code>‎$color</code> ===
 
=== <code>‎$color</code> ===
قيمة لونية.
+
قيمة اللون المراد تعديله.
 +
 
 +
<code>‎$amount</code>
 +
 
 +
قيمة السطوع المراد زيادتها، وتتراوح بين  ‎0% و ‎100%.
  
 
== القيم المعادة ==
 
== القيم المعادة ==
قيمة الإضاءة، وتكون بين ‎<code>100%</code> و ‎<code>0%</code>.
+
يُعاد اللون <code>‎$color</code> بعد زيادة إضاءته بحسب القيمة <code>‎$amount</code>.
  
 
== الأخطاء والاستثناءات ==
 
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$color</code> لونًا.
+
سيُرمى الخطأ <code>ArgumentError</code> إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل <code>‎$amount</code> خارج المجال المسموح.
 +
 
 +
== أمثلة ==
 +
مثال عن استخدام الدالة <code>lighten()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
 +
.selector {
 +
  color: lighten(hsl(0, 0%, 0%), 30%); // #4d4d4d
 +
  background-color: lighten(#800, 20%); // #ee0000
 +
}
 +
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة [[CSS]] الآتية:<syntaxhighlight lang="css">
 +
.selector {
 +
  color: #4d4d4d;
 +
  background-color: #ee0000; }
 +
</syntaxhighlight>
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الدالة <code>[[Sass/hsla|'''hsla'''()]]</code>‎:تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع  والإضاءة والشفافية.
+
* الدالة <code>[[Sass/lightness|()lightness]]</code>: تُعيدُ مُكوّن السطوع (lightness) للون الممرَّر إليها.
* الدالة <code>[[Sass/hsl|'''hsl'''()]]</code>‎:تُنشئ لونًا انطلاقا من قيم الصبغة والتشبع والإضاءة والشفافية.
+
* الدالة <code>[[Sass/darken|()darken]]</code> : تجعل اللون أكثر ظلمة.
* الدالة <code>[[Sass/hue|hue()]]</code>‎:تُعيدُ الدالة مُكوّن الصبغة الخاص باللون.
+
* الدالة <code>[[Sass/opacify|()opacify]]</code> : تجعل اللون أكثر  عتامةً.
* الدالة <code>[[Sass/saturation|saturation()]]</code>:تُعيدُ الدالة مُكوّن التشبع الخاص باللون.
+
* الدالة <code>[[Sass/saturate|saturate()]]</code>‎: تجعل اللون أكثر تشبّعًا.
 +
* الدالة <code>[[Sass/desaturate|desaturate()]]</code>‎: تجعل اللون أقل تشبّعًا.
 +
* الدالة <code>[[Sass/hsla|hsla()]]</code>‎: تنشئ لونًا جديدًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة.
 +
* الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تُنشئ لونًا انطلاقًا جديدًا  من قيم الصبغة والتشبع والسطوع.
 +
* الدالة <code>[[Sass/hue|hue()]]</code>‎: تُعيد الدالة مُكوّن الصبغة الخاص باللون.
 +
* الدالة <code>[[Sass/adjust color|adjust_color()]]</code>: تزيد أو تقلِّل خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد
  
 
== مصادر ==
 
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#saturation-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#lighten-instance_method قسم الدالة lighten في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
+
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
+
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

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

تجعل الدالة ()lighten اللون أكثر سطوعًا (lightness) إذ يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد بعدئذ ذلك اللون بعد زيادة السطوع بحسب القيمة الأخيرة.

البنية العامة

#lighten ($color, $amount)

المعاملات

‎$color

قيمة اللون المراد تعديله.

‎$amount

قيمة السطوع المراد زيادتها، وتتراوح بين ‎0% و ‎100%.

القيم المعادة

يُعاد اللون ‎$color بعد زيادة إضاءته بحسب القيمة ‎$amount.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل ‎$amount خارج المجال المسموح.

أمثلة

مثال عن استخدام الدالة lighten()‎ لضبط قيمة اللون (color) ولون الخلفية (background-color):

.selector {
  color: lighten(hsl(0, 0%, 0%), 30%); // #4d4d4d
  background-color: lighten(#800, 20%); // #ee0000
}

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

.selector {
  color: #4d4d4d;
  background-color: #ee0000; }

انظر أيضًا

  • الدالة ()lightness: تُعيدُ مُكوّن السطوع (lightness) للون الممرَّر إليها.
  • الدالة ()darken : تجعل اللون أكثر ظلمة.
  • الدالة ()opacify : تجعل اللون أكثر عتامةً.
  • الدالة saturate()‎: تجعل اللون أكثر تشبّعًا.
  • الدالة desaturate()‎: تجعل اللون أقل تشبّعًا.
  • الدالة hsla()‎: تنشئ لونًا جديدًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة.
  • الدالة hsl()‎: تُنشئ لونًا انطلاقًا جديدًا من قيم الصبغة والتشبع والسطوع.
  • الدالة hue()‎: تُعيد الدالة مُكوّن الصبغة الخاص باللون.
  • الدالة adjust_color()‎: تزيد أو تقلِّل خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد

مصادر