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

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

تجعل الدالة ()opacify (تٌسمّى أيضًا fade_in) اللون أكثر عتامةً. يمرَّر إليها لونًا وعددًا بين 0 و 1 ثمَّ تعيد ذلك اللون بعد زيادة عتامته بحسب القيمة الأخيرة.

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

opacify($color, $amount)

المعاملات

`‎$color`

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

`‎$amount`

قيمة عددية تتراوح بين 0 و 1 تمثِّل مقدار زيادة العتامة.

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

يعاد اللون ‎$color بعد زيادة عتامته بمقدار ‎$amount.

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

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

أمثلة

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

.selector {
  color: opacify(rgba(0, 0, 0, 0.5), 0.1); // rgba(0, 0, 0, 0.6)
  background-color: opacify(rgba(255, 255, 17, 0.8), 0.2); // #001
}

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

.selector {
  color: rgba(0, 0, 0, 0.6);
  background-color: #ffff11; }

انظر أيضًا

الدالة ()transparentize: تجعل اللون أكثر شفافيَّةً.
الدالة saturate()‎: تجعل اللون أكثر تشبّعًا.
الدالة desaturate()‎: تجعل اللون أقل تشبّعًا.
الدالة ()darken : تجعل اللون أكثر ظلمة.
الدالة ()lighten: تجعل اللون أكثر سطوعًا.
الدالة ()rgba: تضبط شفافيَّة لون معيّن أو تُنشئ لونًا انطلاقا من المركبات: الأحمر والأخضر والأزرق والشفافيَّة.
الدالة adjust_color()‎: تزيد أو تقلِّل خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد.
الدالة ()scale_color: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales).

مصادر

قسم الدالة opacify في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()opacify</code> في Sass}}</noinclude>
-تجعل الدالة <code>()opacify</code> اللون بالأبيض والأسود. وهذا مثل <code>desaturate(color, 100%)‎.</code>
+تجعل الدالة <code>()opacify</code>  (تٌسمّى أيضًا <code>fade_in</code>) اللون أكثر  عتامةً. يمرَّر إليها لونًا وعددًا بين 0 و 1 ثمَّ تعيد ذلك اللون بعد زيادة عتامته بحسب القيمة الأخيرة.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-opacify($color)
+opacify($color, $amount)
 </syntaxhighlight>
@@ سطر 9: / سطر 9: @@
 === <code>‎$color</code> ===
-قيمة لونية.
+اللون المراد زيادة عتامته.
+=== <code>‎$amount</code> ===
+قيمة عددية تتراوح بين 0 و 1 تمثِّل مقدار زيادة العتامة.
 == القيم المعادة ==
-اللون المُعدّل.
+يعاد اللون <code>‎$color</code> بعد زيادة عتامته بمقدار <code>‎$amount</code>.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$color</code> لونًا.
+سيُرمى الخطأ <code>ArgumentError</code> إن كانت قيمة المعامل <code>‎$amount</code> خارج المجال المسموح، أو كان أحد المعاملين من النوع الخطأ.
+==أمثلة==
+مثال عن استخدام الدالة <code>opacify()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>) ولون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass">
+.selector {
+  color: opacify(rgba(0, 0, 0, 0.5), 0.1); // rgba(0, 0, 0, 0.6)
+  background-color: opacify(rgba(255, 255, 17, 0.8), 0.2); // #001
+}
+</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة CSS الآتية:<syntaxhighlight lang="css">
+.selector {
+  color: rgba(0, 0, 0, 0.6);
+  background-color: #ffff11; }
+</syntaxhighlight>
 == انظر أيضًا ==
+* الدالة <code>[[Sass/transparentize|()transparentize]]</code>: تجعل اللون أكثر شفافيَّةً.
+* الدالة <code>[[Sass/saturate|saturate()]]</code>‎: تجعل اللون أكثر تشبّعًا.
 * الدالة <code>[[Sass/desaturate|desaturate()]]</code>‎: تجعل اللون أقل تشبّعًا.
+* الدالة <code>[[Sass/darken|()darken]]</code> : تجعل اللون أكثر ظلمة.
+* الدالة <code>[[Sass/lighten|()lighten]]</code>: تجعل اللون أكثر سطوعًا.
+* الدالة <code>[[Sass/rgba|()rgba]]</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#grayscale-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#opacify-instance_method قسم الدالة opacify في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]