الفرق بين المراجعتين ل"Sass/lightness"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()lightness</code> في Sass}}</noinclude> تُعيدُ الدالة <code>()'''saturation'''</code> مُكوّن التش...') |
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
||
(9 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()lightness</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()lightness</code> في Sass}}</noinclude> | ||
− | تُعيدُ الدالة <code>() | + | تُعيدُ الدالة <code>()lightness</code> مُكوّن السطوع (lightness) للون الممرَّر إليها. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
− | + | lightness ($color) | |
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 9: | سطر 9: | ||
=== <code>$color</code> === | === <code>$color</code> === | ||
− | + | القيمة اللونيَّة التي نريد الحصول على مكوِّن السطوع الخاص بها. | |
== القيم المعادة == | == القيم المعادة == | ||
− | قيمة | + | تُعاد قيمة السطوع، وتكون بين 0% و 100%. |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
− | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>$color</code> لونًا. | + | سيُرمى الخطأ <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/ | + | *الدالة <code>[[Sass/lighten|()lighten]]</code>: تجعل اللون أكثر سطوعًا. |
− | * الدالة <code>[[Sass/hsl| | + | *الدالة <code>[[Sass/hue|hue()]]</code>: تُعيدُ قيمة مُكوّن الصبغة للون الممرَّر إليها. |
− | * | + | * الدالة <code>[[Sass/saturation|saturation()]]</code>: تُعيدُ قيمة مُكوّن التشبع للون الممرَّر إليها. |
+ | * الدالة <code>[[Sass/opacity|()opacity]]</code>: تعيد قيمة مكوِّن الشفافية للون الممرَّر إليها. | ||
+ | *الدالة <code>[[Sass/red|red()]]</code>: تعيد قيمة المكوِّن الأحمر للون الممرَّر إليها. | ||
+ | *الدالة <code>[[Sass/blue|()blue]]</code>: تعيد قيمة المكوِّن الأزرق للون الممرَّر إليها. | ||
+ | *الدالة <code>[[Sass/green|()green]]</code>: تعيد قيمة المكوِّن الأخضر للون الممرَّر إليها. | ||
+ | * الدالة <code>[[Sass/hsl|hsl()]]</code>: تنشئ لونًا انطلاقًا من قيم الصبغة والتشبع والسطوع والشفافيَّة. | ||
+ | * الدالة <code>[[Sass/darken|()darken]]</code> : تجعل اللون أكثر ظلمة. | ||
== مصادر == | == مصادر == | ||
− | * [https://sass-lang.com/documentation/Sass/Script/Functions.html# | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#lightness-instance_method قسم الدالة lightness في صفحة الدوال في توثيق Sass الرسمي]. |
− | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
− | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 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
: تجعل اللون أكثر ظلمة.