الفرق بين المراجعتين ل"Sass/str slice"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
|||
| (9 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 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"> | ||
| سطر 10: | سطر 10: | ||
== المعاملات == | == المعاملات == | ||
| − | === <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>. القيمة الافتراضية لهذا المعامل هي <code>-1</code> أي ستكون نهاية السلسلة المعادة هي نهاية السلسلة <code>$string</code>. | |
== القيم المعادة == | == القيم المعادة == | ||
| − | السلسلة النصية | + | يُعاد جزء من السلسلة النصية <code>$string</code> الذي يبدأ عند الموقع <code>$start-at</code> وينتهي عند الموقع <code>$end-at</code>. ستكون السلسلة النصية المُعادة مُقتبسة إذا كانت السلسلة <code>$string</code> مُقتبسة فقط. |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيُرمى الخطأ <code>ArgumentError</code> إن كان | + | سيُرمى الخطأ <code>ArgumentError</code> إن كان أيٌّ من المعاملات من النوع الخطأ. |
== أمثلة == | == أمثلة == | ||
| − | مثال عن استخدام الدالة <code> | + | أمثلة نموذجية عن الدالة <code>str_slice()</code>:<syntaxhighlight lang="sass"> |
| − | selector { | + | str_slice("abcd", 2, 3); // "bc" |
| − | + | str_slice("abcd", 2); // "bcd" | |
| + | str_slice("abcd", -3, -2); // "bc" | ||
| + | str_slice("abcd", 2, -2); // "bc" | ||
| + | |||
| + | </syntaxhighlight>مثال عن استخدام الدالة <code>str_slice()</code> لضبط قيمة الخاصِّيَّة <code>[[CSS/content|content]]</code> مع العنصر الزائف <code>[[CSS/::before|::before]]</code>:<syntaxhighlight lang="sass"> | ||
| + | .selector::before { | ||
| + | content: str_slice("a'b", 2, 2) // "'" | ||
} | } | ||
| + | |||
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css"> | </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css"> | ||
| − | selector { | + | .selector::before { |
| − | + | content: "'"; } | |
| − | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[Sass/str index| | + | * الدالة <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>: | ||
== مصادر == | == مصادر == | ||
| − | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_slice-instance_method قسم الدالة | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_slice-instance_method قسم الدالة str_slice في صفحة الدوال في توثيق Sass الرسمي]. |
| − | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
| − | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:00، 20 مايو 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():
str_slice("abcd", 2, 3); // "bc"
str_slice("abcd", 2); // "bcd"
str_slice("abcd", -3, -2); // "bc"
str_slice("abcd", 2, -2); // "bc"
مثال عن استخدام الدالة str_slice() لضبط قيمة الخاصِّيَّة content مع العنصر الزائف ::before:
.selector::before {
content: str_slice("a'b", 2, 2) // "'"
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector::before {
content: "'"; }
انظر أيضًا
- الدالة
str_index(): تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. - الدالة
str_length(): تعيد عدد أحرف السلسلة النصيَّة الممرَّرة إليها. - الدالة
str_insert(): تدرج سلسلةً نصيةً داخل أخرى عند موضع محدَّد.