الفرق بين المراجعتين لصفحة: «Sass/str insert»
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 28: | سطر 28: | ||
مثال عن استخدام الدالة <code>str-insert()</code> لضبط قيمة لون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass"> | مثال عن استخدام الدالة <code>str-insert()</code> لضبط قيمة لون الخلفية (<code>[[CSS/background-color|background-color]]</code>):<syntaxhighlight lang="sass"> | ||
.selector { | .selector { | ||
background-color: | background-color: str_insert(ed, "r", 1); // 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 index|str_index()]]</code>: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. | * الدالة <code>[[Sass/str index|str_index()]]</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 slice|str_slice()]]</code>: تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد. | ||
مراجعة 09:05، 19 مايو 2018
تُدرج الدالة str_insert() سلسلةً نصيةً داخل أخرى عند موضع محدَّد.
لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات.
البنية العامة
str_insert($string, $insert, $index)
المعاملات
$string
السلسلة النصّيَّة التي سيضاف إليها سلسلة نصيَّة أخرى.
$insert
السلسلة النصّية المراد إضافتها.
$index
الموضع الذي ستُدرج فيه السلسلة $insert ضمن السلسلة $string. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع إضافة السلسلة النصيَّة $insert بدءًا من نهاية السلسلة $string. إن كانت القيمة المعطاة تشير إلى موضع خارج حدود السلسلة النصيَّة $string، فستُدرج السلسلة $insert في بداية السلسلة أو نهايتها.
القيم المعادة
تُعاد السلسلة النصيَّة الناتجة عن إضافة السلسلة $insert إلى السلسلة $string في الموضع $index. ستكون تلك السلسلة المُعادة مُقتبسة إذا كانت السلسلة $string مُقتبسة فقط.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن كان أيّ من المعاملات من النوع الخطأ.
أمثلة
مثال عن استخدام الدالة str-insert() لضبط قيمة لون الخلفية (background-color):
.selector {
background-color: str_insert(ed, "r", 1); // red
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector {
background-color: red; }
انظر أيضًا
- الدالة
str_index(): تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. - الدالة
str_length(): تعيد عدد أحرف سلسلة نصيَّة محدَّدة. - الدالة
str_slice(): تعيد جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد. - الدالة
unquote(): تزيل علامات الاقتباس من سلسلة نصيَّة مُقتبسة. - الدالة
to_lower_case(): تحوّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف صغيرة.