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