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

المراجعة الحالية بتاريخ 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()‎: تزيل علامات الاقتباس من السلسلة النصيَّة الممرَّرة إليها.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()to_lower_case</code> في Sass}}</noinclude>
-تحوّل الدالة <code>to_lower_case'''()‎'''</code> لسلسة '''نصيةً إلى الحروف الكبيرة'''.
+تحوِّل الدالة <code>to_lower_case()‎</code> جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة (lowercase).
 == البنية العامة ==
 <syntaxhighlight lang="sass">
@@ سطر 9: / سطر 9: @@
 === <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>)، لاحظ أنَّ الدالة <code>to_lower_case()‎</code> تتطلب تمرير سلسلة نصية، لكن الخاصية <code>[[CSS/background-color|background-color]]</code> تتوقع مُعرَّفًا لونيًا وليس سلسلةً نصية، لذا استعنّا بالدالة <code>[[Sass/unquote|unquote()‎]]</code> لإزالة علامتَي الاقتباس عنها:<syntaxhighlight lang="sass">
+.selector {
+  background-color: unquote(to_lower_case("RED")) // red
+}
+</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
+.selector {
+  background-color: red; }
+</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/str length|str_length()]]</code>‎: تعيد عدد أحرف سلسلة نصية محدَّدة.
+* الدالة <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_upper_case-instance_method قسم الدالة  في صفحة الدوال في توثيق 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}}]]