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

من موسوعة حسوب
لا ملخص تعديل
لا ملخص تعديل
سطر 11: سطر 11:


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


== الأخطاء والاستثناءات ==
== الأخطاء والاستثناءات ==
سطر 27: سطر 27:
== مثال ==
== مثال ==
مثال عن استخدام الدالة <code>selector_replace()‎</code>:<syntaxhighlight>
مثال عن استخدام الدالة <code>selector_replace()‎</code>:<syntaxhighlight>
selector-replace(".foo .bar", ".bar", ".baz") => ".foo .baz"
selector-replace(".foo .bar", ".bar", ".baz") // ".foo .baz"
selector-replace(".foo.bar.baz", ".foo.baz", ".qux") => ".bar.qux"
selector-replace(".foo.bar.baz", ".foo.baz", ".qux") // ".bar.qux"
</syntaxhighlight>
</syntaxhighlight>



مراجعة 03:29، 22 أبريل 2018

تستبدل الدالة selector_replace()‎ كل عيّنات (instances) الوسيط‎$original بواسطة ‎$replacement في ‎$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()‎: تُوحّد محددَيْن.

مصادر