عرض مصدر Sass/selector replace

<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_replace</code> في Sass}}</noinclude>
تبدِّل الدالة <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> واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة. 
== البنية العامة ==
<syntaxhighlight lang="sass">
selector_replace($selector, $original, $replacement)
</syntaxhighlight>

== المعاملات ==

=== <code>‎$selector</code> ===
المحدِّد الذي سيُبدَّل داخله المحدَّد <code>‎$original</code> مع المحدِّد <code>‎$replacement</code>. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

=== <code>‎$original</code> ===
المحدِّد المراد استبداله. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

=== <code>‎$replacement</code> ===
المحدِّد الذي سيحل مكان المحدِّد <code>‎$original</code> أينما وجد. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

== القيم المعادة ==
تُعاد قائمة من قوائم من سلاسل نصيَّة التي تمثل نتيجة التوسعة، ويكون تنسيقها بنفس تنسيق المحدّد المُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</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>

== انظر أيضًا ==
* الدالة <code>[[Sass/selector append|selector_append()]]</code>‎: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها.
* الدالة <code>[[Sass/selector nest|selector_nest()]]</code>‎: تُشعّب المحدِّدات.
* الدالة <code>[[Sass/selector unify|selector_unify()]]</code>‎: تُوحّد محدِّدين.
* الدالة <code>[[Sass/selector extend|selector_extend()]]</code>‎: توسّع محدِّدًا معيَّنًا.
* الدالة <code>[[Sass/is superselector|is_superselector()]]</code>‎: تتحقَّق ما إذا كان المحدِّد فائقًا.

== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_replace-instance_method قسم الدالة selector_replace في صفحة الدوال في توثيق Sass الرسمي.]
[[تصنيف:Sass]]
[[تصنيف: Sass Function]]