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

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

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

تجعل الدالة ()desaturate اللون أقل تشبُّعًا. يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل قيمة مكوِّن تشبُّعه بحسب القيمة الأخيرة.

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

desaturate($color, $amount)

المعاملات

‎$color

القيمة اللونيَّة التي ستُجرى عليها العمليَّة.

‎$amount

قيمة تمثِّل مقدار تقليل التشبُّع، ويجب أن تتراوح بين ‎0% و ‎100%.

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

يُعاد اللون ‎$color بعد تقليل قيمة مكوِّن التشبع له بمقدار ‎$amount.

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

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

أمثلة

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

.selector {
  color: desaturate(hsla(120, 30%, 90%, 0.5), 20%); // rgba(227, 232, 227, 0.5)
  background-color: desaturate(#855, 20%); // #726b6b
}

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

.selector {
  color: rgba(227, 232, 227, 0.5);
  background-color: #726b6b; }

انظر أيضًا

  • الدالة saturate()‎: تجعل اللون أكثر تشبّعًا.
  • الدالة lighten()‎: تجعل اللون أكثر سطوعًا.
  • الدالة ()opacify : تجعل اللون أكثر عتامةً.
  • الدالة darken()‎: تجعل اللون أكثر ظلمة.
  • الدالة hsla()‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة.
  • الدالة hsl()‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع والشفافيَّة.
  • الدالة saturation()‎: تُعيدُ الدالة قيمة مُكوّن التشبع الخاص باللون.

مصادر