الفرق بين المراجعتين ل"Sass/selector replace"
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة الصفحة وتدقيقها.) |
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_replace</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()selector_replace</code> في Sass}}</noinclude> | ||
| − | تبدِّل الدالة <code>selector_replace()</code> | + | تبدِّل الدالة <code>selector_replace()</code> المعامل <code>$replacement</code> مكان نُسخ (instances) المعامل <code>$original</code> أينما وجدت في المحدِّد <code>$selector</code> المعطى. |
تعمل الدالة عبر استخدام القاعدة <code>[[Sass/@ rules#.D8.A7.D9.84.D9.82.D8.A7.D8.B9.D8.AF.D8.A9 .E2.80.8E.40extend|@extend]]</code> واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة. | تعمل الدالة عبر استخدام القاعدة <code>[[Sass/@ rules#.D8.A7.D9.84.D9.82.D8.A7.D8.B9.D8.AF.D8.A9 .E2.80.8E.40extend|@extend]]</code> واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة. | ||
| سطر 25: | سطر 25: | ||
سيُرمى الخطأ <code>ArgumentError</code> إن فشلت عمليَّة الاستبدال. | سيُرمى الخطأ <code>ArgumentError</code> إن فشلت عمليَّة الاستبدال. | ||
| − | == | + | == أمثلة == |
| − | + | أمثلة نموذجية عن استخدام الدالة <code>selector_replace()</code>:<syntaxhighlight lang="sass"> | |
| − | + | selector_replace(".foo .bar", ".bar", ".baz"); // ".foo .baz" | |
| − | + | selector_replace(".foo.bar.baz", ".foo.baz", ".qux"); // ".bar.qux" | |
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 39: | سطر 39: | ||
== مصادر == | == مصادر == | ||
| − | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_replace-instance_method قسم الدالة selector_replace في صفحة الدوال في توثيق Sass الرسمي. | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_replace-instance_method قسم الدالة selector_replace في صفحة الدوال في توثيق Sass الرسمي]. |
| − | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
| − | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تبدِّل الدالة selector_replace() المعامل $replacement مكان نُسخ (instances) المعامل $original أينما وجدت في المحدِّد $selector المعطى.
تعمل الدالة عبر استخدام القاعدة @extend واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة.
البنية العامة
selector_replace($selector, $original, $replacement)
المعاملات
$selector
المحدِّد الذي سيُبدَّل داخله المحدَّد $original مع المحدِّد $replacement. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.
$original
المحدِّد المراد استبداله. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.
$replacement
المحدِّد الذي سيحل مكان المحدِّد $original أينما وجد. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.
القيم المعادة
تُعاد قائمة من قوائم من سلاسل نصيَّة التي تمثل نتيجة التوسعة، ويكون تنسيقها بنفس تنسيق المحدّد المُعاد باستعمال الرمز &.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن فشلت عمليَّة الاستبدال.
أمثلة
أمثلة نموذجية عن استخدام الدالة selector_replace():
selector_replace(".foo .bar", ".bar", ".baz"); // ".foo .baz"
selector_replace(".foo.bar.baz", ".foo.baz", ".qux"); // ".bar.qux"
انظر أيضًا
- الدالة
selector_append(): تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها. - الدالة
selector_nest(): تُشعّب المحدِّدات. - الدالة
selector_unify(): تُوحّد محدِّدين. - الدالة
selector_extend(): توسّع محدِّدًا معيَّنًا. - الدالة
is_superselector(): تتحقَّق ما إذا كان المحدِّد فائقًا.