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

من موسوعة حسوب

تستخرج الدالة str_slice()‎ سلسلةً نصيةً من ‎$string، ستبدأ السلسلة المُستخرجة من المؤشر رقم ‎$start-atوتنتهي عند ‎$end-at. لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في لغة Sass هو 1، والثاني رقمه 2، وهكذا.

البنية العامة

str_slice($string, $start-at, $end-at: -1)

المعاملات

‎$string 

سلسلة نصّية.

‎$start-at

مؤشر الحرف الأول من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية ‎‎$string.

‎$end-at

مؤشر الحرف الأخير من السلسلة الفرعية. إذا كان هذا سلبيًا ، يتم حسابه من نهاية ‎‎$string. قيمته الافتراضية هي ‎.-1

القيم المعادة

السلسلة النصية الناتجة ستكون مُقتبسة إذا وفقط إذا كانت ‎‎$string مُقتبسة.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن كان أيّ من المعاملات من النوع الخطأ.

أمثلة

مثال عن استخدام الدالة str-slice()‎  لضبط قيمة الخاصية content مع العنصر الزائف ‎::before:

.selector::before {
  content: str-slice("a'b", 2, 2) // "'"
}

سيُصرّف المثال السابق إلى شيفرة CSS الآتية:

.selector::before {
  content: "'";
}

انظر أيضًا

  • الدالة str_index()‎: تُدرج سلسة نصية في أخرى.
  • الدالة str-length()‎: تُعيد عدد احرف سلسلةنصية.
  • الدالة str_insert()‎: تُدرج الدالة سلسلةً نصيةً داخل أخرى.

مصادر