الفرق بين المراجعتين ل"Sass/to lower case"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
|||
| (5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()to_lower_case</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()to_lower_case</code> في Sass}}</noinclude> | ||
| − | + | تحوِّل الدالة <code>to_lower_case()</code> جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة (lowercase). | |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 9: | سطر 9: | ||
=== <code>$string</code> === | === <code>$string</code> === | ||
| − | + | السلسلة النصّيَّة المراد تحويل جميع حروفها إلى حالة الحروف الصغيرة. | |
== القيم المعادة == | == القيم المعادة == | ||
| − | + | تُعاد السلسلة النصيَّة <code>$string</code> بعد تحويل جميع حروفها إلى حروف صغيرة. | |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيُرمى الخطأ <code>ArgumentError</code> إن لم تكن <code>$string</code> | + | سيُرمى الخطأ <code>ArgumentError</code> إن لم تكن <code>$string</code> سلسلة نصيَّة. |
== أمثلة == | == أمثلة == | ||
| − | مثال عن استخدام الدالة <code>to_lower_case()</code> لضبط قيمة لون الخلفية ([[CSS/background-color|background-color]]):<syntaxhighlight lang="sass"> | + | مثال عن استخدام الدالة <code>to_lower_case()</code> لضبط قيمة لون الخلفية (<code>[[CSS/background-color|background-color]]</code>)، لاحظ أنَّ الدالة <code>to_lower_case()</code> تتطلب تمرير سلسلة نصية، لكن الخاصية <code>[[CSS/background-color|background-color]]</code> تتوقع مُعرَّفًا لونيًا وليس سلسلةً نصية، لذا استعنّا بالدالة <code>[[Sass/unquote|unquote()]]</code> لإزالة علامتَي الاقتباس عنها:<syntaxhighlight lang="sass"> |
| − | selector { | + | .selector { |
| − | background-color: | + | background-color: unquote(to_lower_case("RED")) // red |
} | } | ||
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css"> | </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css"> | ||
| − | selector { | + | .selector { |
| − | background-color: red; | + | background-color: red; } |
| − | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[Sass/str insert| | + | * الدالة <code>[[Sass/to upper case|to_upper_case()]]</code>: تحوِّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف كبيرة. |
| − | + | * الدالة <code>[[Sass/str insert|str_insert()]]</code>: تضيف سلسلةً نصيةً داخل أخرى عند موضع محدَّد. | |
| − | * | + | * الدالة <code>[[Sass/str length|str_length()]]</code>: تعيد عدد أحرف سلسلة نصية محدَّدة. |
| − | * الدالة <code>[[Sass/ | + | * الدالة <code>[[Sass/str slice|str_slice()]]</code>: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد. |
| + | * الدالة <code>[[Sass/str index|str_index()]]</code>: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. | ||
| + | * الدالة <code>[[Sass/unquote|unquote()]]</code>: تزيل علامات الاقتباس من السلسلة النصيَّة الممرَّرة إليها. | ||
== مصادر == | == مصادر == | ||
| − | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#to_lower_case-instance_method قسم الدالة | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#to_lower_case-instance_method قسم الدالة to_lower_case في صفحة الدوال في توثيق Sass الرسمي]. |
| − | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
| − | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:00، 20 مايو 2018
تحوِّل الدالة to_lower_case() جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة (lowercase).
البنية العامة
to_lower_case($string)
المعاملات
$string
السلسلة النصّيَّة المراد تحويل جميع حروفها إلى حالة الحروف الصغيرة.
القيم المعادة
تُعاد السلسلة النصيَّة $string بعد تحويل جميع حروفها إلى حروف صغيرة.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن لم تكن $string سلسلة نصيَّة.
أمثلة
مثال عن استخدام الدالة to_lower_case() لضبط قيمة لون الخلفية (background-color)، لاحظ أنَّ الدالة to_lower_case() تتطلب تمرير سلسلة نصية، لكن الخاصية background-color تتوقع مُعرَّفًا لونيًا وليس سلسلةً نصية، لذا استعنّا بالدالة unquote() لإزالة علامتَي الاقتباس عنها:
.selector {
background-color: unquote(to_lower_case("RED")) // red
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector {
background-color: red; }
انظر أيضًا
- الدالة
to_upper_case(): تحوِّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف كبيرة. - الدالة
str_insert(): تضيف سلسلةً نصيةً داخل أخرى عند موضع محدَّد. - الدالة
str_length(): تعيد عدد أحرف سلسلة نصية محدَّدة. - الدالة
str_slice(): تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد. - الدالة
str_index(): تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. - الدالة
unquote(): تزيل علامات الاقتباس من السلسلة النصيَّة الممرَّرة إليها.