الفرق بين المراجعتين لصفحة: «Sass/to lower case»
< Sass
لا ملخص تعديل |
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].' |
||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 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> لضبط قيمة لون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<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: to_lower_case(RED) // red | 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|str_insert()]]</code>: | * الدالة <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 قسم الدالة to_lower_case في صفحة الدوال في توثيق Sass الرسمي. | * [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(): تزيل علامات الاقتباس من السلسلة النصيَّة الممرَّرة إليها.