الدالة ()selector_replace
في Sass
تبدِّل الدالة 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()
: تتحقَّق ما إذا كان المحدِّد فائقًا.