الفرق بين المراجعتين لصفحة: «Sass/str slice»
طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة الصفحة وتدقيقها. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()str_slice</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()str_slice</code> في Sass}}</noinclude> | ||
تعيد الدالة <code>str_slice()</code> جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد. | |||
لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 9: | سطر 11: | ||
=== <code>$string</code> === | === <code>$string</code> === | ||
سلسلة | السلسلة النصّيَّة المراد استخراج سلسلة نصيَّة فرعيَّة منها. | ||
=== <code>$start-at</code> === | === <code>$start-at</code> === | ||
موضع الحرف الأول من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع بداية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة <code>$string</code>. | |||
=== <code>$end-at</code> === | === <code>$end-at</code> === | ||
موضع الحرف الأخير من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع نهاية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة <code>$string</code>. القيمة الافتراضية لهذا المعامل هي -1 أي ستكون نهاية السلسلة المعادة هي نهاية السلسلة <code>$string</code>. | |||
== القيم المعادة == | == القيم المعادة == | ||
السلسلة النصية | يُعاد جزء من السلسلة النصية <code>$string</code> الذي يبدأ عند الموقع <code>$start-at</code> وينتهي عند الموقع <code>$end-at</code>. ستكون السلسلة النصية المُعادة مُقتبسة إذا كانت السلسلة <code>$string</code> مُقتبسة فقط. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن كان | سيُرمى الخطأ <code>ArgumentError</code> إن كان أيٌّ من المعاملات من النوع الخطأ. | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>str-slice()</code> لضبط قيمة | مثال عن استخدام الدالة <code>str-slice()</code> لضبط قيمة الخاصِّيَّة <code>[[CSS/content|content]]</code> مع العنصر الزائف <code>[[CSS/::before|::before]]</code>:<syntaxhighlight lang="sass"> | ||
.selector::before { | .selector::before { | ||
content: str-slice("a'b", 2, 2) // "'" | content: str-slice("a'b", 2, 2) // "'" | ||
| سطر 37: | سطر 39: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/str index|str_index()]]</code>: | * الدالة <code>[[Sass/str index|str_index()]]</code>: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. | ||
* الدالة <code>[[Sass/str length|str_length()]]</code>: تعيد عدد أحرف السلسلة النصيَّة الممرَّرة إليها. | |||
* الدالة <code>[[Sass/str | * الدالة <code>[[Sass/str insert|str_insert()]]</code>: تدرج سلسلةً نصيةً داخل أخرى عند موضع محدَّد. | ||
* الدالة <code>[[Sass/str insert|str_insert()]]</code>: | |||
== مصادر == | == مصادر == | ||
مراجعة 17:45، 12 مايو 2018
تعيد الدالة str_slice() جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد.
لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات.
البنية العامة
str_slice($string, $start-at, $end-at: -1)
المعاملات
$string
السلسلة النصّيَّة المراد استخراج سلسلة نصيَّة فرعيَّة منها.
$start-at
موضع الحرف الأول من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع بداية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة $string.
$end-at
موضع الحرف الأخير من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع نهاية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة $string. القيمة الافتراضية لهذا المعامل هي -1 أي ستكون نهاية السلسلة المعادة هي نهاية السلسلة $string.
القيم المعادة
يُعاد جزء من السلسلة النصية $string الذي يبدأ عند الموقع $start-at وينتهي عند الموقع $end-at. ستكون السلسلة النصية المُعادة مُقتبسة إذا كانت السلسلة $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(): تدرج سلسلةً نصيةً داخل أخرى عند موضع محدَّد.