الدالة ()to_lower_case في Sass

تحوِّل الدالة 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 الرسمي.