الفرق بين المراجعتين لصفحة: «Sass/selector replace»

مراجعة 15:46، 12 مايو 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()‎: تتحقَّق ما إذا كان المحدِّد فائقًا.

مصادر

قسم الدالة selector_replace في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()selector_replace</code> في Sass}}</noinclude>
-تبدِّل الدالة <code>selector_replace()‎</code> كل نُسخ (instances) المعامل <code>‎$original</code> مع المعامل <code>‎$replacement</code> في المحدِّد <code>‎$selector</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> واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة.