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

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

تُعيدُ الدالة ()lightness مُكوّن السطوع (lightness) للون الممرَّر إليها.

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

lightness ($color)

المعاملات

`‎$color`

القيمة اللونيَّة التي نريد الحصول على مكوِّن السطوع الخاص بها.

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

تُعاد قيمة السطوع، وتكون بين ‎0% و ‎100%.

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

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

أمثلة

مثال عن استخدام الدالة lightness()‎ لمقارنة إضاءة اللون المُعرَّف من المستخدم باللون الفضي باستخدام التعليمة ‎@if، ثم اعتمادًا على نتيجة الشرط السابق فسنجعل اللون أغمق (باستخدام الدالة darken()‎) أو أفتح (باستخدام الدالة lighten()‎):

$color: salmon;

.selector {
  // اختبار إن كانت إضاءة اللون أكبر من إضاءة اللون الفضي
  @if lightness($color) > lightness(gray) {
    // جعل اللون أغمق بنسبة 20 بالمئة
    color: darken($color, 20%);
  } @else {
    // جعل اللون أفتح بنسبة 20 بالمئة
    color: lighten($color, 20%);
  }
}

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

.selector {
  color: #f7270f; }

انظر أيضًا

الدالة ()lighten: تجعل اللون أكثر سطوعًا.
الدالة hue()‎: تُعيدُ قيمة مُكوّن الصبغة للون الممرَّر إليها.
الدالة saturation()‎: تُعيدُ قيمة مُكوّن التشبع للون الممرَّر إليها.
الدالة ()opacity: تعيد قيمة مكوِّن الشفافية للون الممرَّر إليها.
الدالة red()‎: تعيد قيمة المكوِّن الأحمر للون الممرَّر إليها.
الدالة ()blue‎: تعيد قيمة المكوِّن الأزرق للون الممرَّر إليها.
الدالة ()green‎: تعيد قيمة المكوِّن الأخضر للون الممرَّر إليها.
الدالة hsl()‎: تنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والسطوع والشفافيَّة.
الدالة ()darken : تجعل اللون أكثر ظلمة.

مصادر

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

@@ سطر 3: / سطر 3: @@
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-#lightness ($color)
+lightness ($color)
 </syntaxhighlight>
@@ سطر 16: / سطر 16: @@
 == الأخطاء والاستثناءات ==
 سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$color</code> لونًا.
+== أمثلة ==
+مثال عن استخدام الدالة <code>lightness()‎</code> لمقارنة إضاءة اللون المُعرَّف من المستخدم باللون الفضي باستخدام التعليمة <code>[[Sass/control directives#.E2.80.8E.40if|‎@if]]</code>، ثم اعتمادًا على نتيجة الشرط السابق فسنجعل اللون أغمق (باستخدام الدالة <code>[[Sass/darken|darken()‎]]</code>) أو أفتح (باستخدام الدالة <code>[[Sass/lighten|lighten()‎]]</code>):<syntaxhighlight lang="sass">
+$color: salmon;
+.selector {
+  // اختبار إن كانت إضاءة اللون أكبر من إضاءة اللون الفضي
+  @if lightness($color) > lightness(gray) {
+    // جعل اللون أغمق بنسبة 20 بالمئة
+    color: darken($color, 20%);
+  } @else {
+    // جعل اللون أفتح بنسبة 20 بالمئة
+    color: lighten($color, 20%);
+  }
+}
+</syntaxhighlight>ستُصرَّف الشيفرة السابقة إلى شيفرة CSS الآتية:<syntaxhighlight lang="css">
+.selector {
+  color: #f7270f; }
+</syntaxhighlight>
 == انظر أيضًا ==
+*الدالة <code>[[Sass/lighten|()lighten]]</code>: تجعل اللون أكثر سطوعًا.
 *الدالة <code>[[Sass/hue|hue()]]</code>‎: تُعيدُ قيمة مُكوّن الصبغة للون الممرَّر إليها.
 * الدالة <code>[[Sass/saturation|saturation()]]</code>‎: تُعيدُ قيمة مُكوّن التشبع للون الممرَّر إليها.
@@ سطر 24: / سطر 44: @@
 *الدالة <code>[[Sass/blue|()blue‎]]</code>: تعيد قيمة المكوِّن الأزرق للون الممرَّر إليها.
 *الدالة <code>[[Sass/green|()green‎]]</code>: تعيد قيمة المكوِّن الأخضر للون الممرَّر إليها.
-* الدالة <code>[[Sass/hsla|hsla()]]</code>‎: تنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والسطوع والشفافيَّة.
 * الدالة <code>[[Sass/hsl|hsl()]]</code>‎: تنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والسطوع والشفافيَّة.
+* الدالة <code>[[Sass/darken|()darken]]</code> : تجعل اللون أكثر ظلمة.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#lightness-instance_method قسم الدالة lightness في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#lightness-instance_method قسم الدالة lightness في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]