الدالة ()selector_replace في Sass

من موسوعة حسوب

تستبدل الدالة 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()‎: تُوحّد محددَيْن.

مصادر