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

من موسوعة حسوب
لا ملخص تعديل
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].'
 
(7 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()complement</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()complement</code> في Sass}}</noinclude>
تعيد الدالة <code>()complement</code> مكمّل اللون (complement of a color). وهذا مثل <code>adjust-hue(color, 180deg)‎.</code>
تعيد الدالة <code>()complement</code> مكمّل اللون (complement of a color) الممرَّر إليها، وتكافئ استدعاء الدالة <code>[[Sass/adjust hue|adjust_hue(color, 180deg)‎]]</code>.
== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="sass">
<syntaxhighlight lang="sass">
سطر 9: سطر 9:


=== <code>‎$color</code> ===
=== <code>‎$color</code> ===
قيمة لونية.
القيمة اللونيَّة المراد الحصول على القيمة المكملة لها.


== القيم المعادة ==
== القيم المعادة ==
قيمةٌ لونيةٌ.
تُعاد القيمة اللونيَّة المكملة للون <code>‎$color</code>.


== الأخطاء والاستثناءات ==
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$color</code> لونًا.
سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$color</code> لونًا.
== أمثلة ==
المثال الآتي سيضبط لون العنصر (<code>[[CSS/color|color]]</code>) إلى اللون البنفسجي (<code>purple</code>)، الذي هو مُكمِّل اللون الأخضر، وذلك بتمرير القيمة <code>green</code> إلى الدالة <code>complement()‎</code>:<syntaxhighlight lang="sass">
.selector {
  color: complement(green); // purple
}
</syntaxhighlight>ستصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:<syntaxhighlight lang="css">
.selector {
  color: purple; }
</syntaxhighlight>


== انظر أيضًا ==
== انظر أيضًا ==
* الدالة <code>[[Sass/adjust hue|adjust-hue()]]</code>‎: تعدّل تشبع اللون.
* الدالة <code>[[Sass/adjust hue|adjust_hue()]]</code>‎: تعدّل قيمة مكوِّن الصبغة (hue) للون الممرَّر إليها.
* الدالة <code>[[Sass/scale color|()scale_color]]</code>: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales).
* الدالة <code>[[Sass/alpha|hsl()‎]]</code>‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع.


== مصادر ==
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#complement-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#complement-instance_method قسم الدالة complement في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

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

تعيد الدالة ()complement مكمّل اللون (complement of a color) الممرَّر إليها، وتكافئ استدعاء الدالة adjust_hue(color, 180deg)‎.

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

complement($color)

المعاملات

‎$color

القيمة اللونيَّة المراد الحصول على القيمة المكملة لها.

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

تُعاد القيمة اللونيَّة المكملة للون ‎$color.

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

سيُرمى الخطأ ArgumentError إن لم يكن ‎$color لونًا.

أمثلة

المثال الآتي سيضبط لون العنصر (color) إلى اللون البنفسجي (purple)، الذي هو مُكمِّل اللون الأخضر، وذلك بتمرير القيمة green إلى الدالة complement()‎:

.selector {
  color: complement(green); // purple
}

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

.selector {
  color: purple; }

انظر أيضًا

  • الدالة adjust_hue()‎: تعدّل قيمة مكوِّن الصبغة (hue) للون الممرَّر إليها.
  • الدالة ()scale_color: تعدِّل مكوِّنًا واحدًا أو أكثر للون الممرَّر إليها بتدرج انسيابي (Fluidly scales).
  • الدالة hsl()‎‎: تُنشئ لونًا انطلاقًا من قيم الصبغة والتشبُّع والسطوع.

مصادر