عرض مصدر Sass/complement

<noinclude>{{DISPLAYTITLE: الدالة <code>()complement</code> في Sass}}</noinclude>
تعيد الدالة <code>()complement</code> مكمّل اللون (complement of a color) الممرَّر إليها، وتكافئ استدعاء الدالة <code>[[Sass/adjust hue|adjust_hue(color, 180deg)‎]]</code>.
== البنية العامة ==
<syntaxhighlight lang="sass">
complement($color)
</syntaxhighlight>

== المعاملات ==

=== <code>‎$color</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>‎: تعدّل قيمة مكوِّن الصبغة (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 قسم الدالة complement في صفحة الدوال في توثيق Sass الرسمي.]
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]