Sass/selector extend

تعيد الدالة selector_extend()‎ نسخةً جديدةً من المحدِّد ‎$selector مع توسعة ‎$extendee بواسطة ‎$extender. النتيجة تشبه الكود البرمجي التالي:

$selector { ... }
$extender { @extend $extendee }

البنية العامة

selector_extend($selector, $extendee, $extender)

المعاملات

‎$selector

المحدِّد الذي سيُوسع داخله المحدِّد ‎$extendee بواسطة المعامل ‎$extender. يمكن أن يكون عبارةً عن سلسلة نصيَّة، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة مثلما تُعاد باستعمال الرمز &.

‎$extendee

المحدِّد الذي سيُوسع. يمكن أن يكون عبارةً عن سلسلة نصية، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة مثلما تُعاد باستعمال الرمز &.

‎$extender

المحدِّد الذي سيُضاف داخل المحدِّد ‎$selector. يمكن أن يكون عبارةً عن سلسلة نصيَّة، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.

القيم المعادة

تُعاد قائمة من قوائم من سلاسل نصيَّة التي تمثل نتيجة التوسعة، ويكون تنسيقها بنفس تنسيق المحدّد المُعاد باستعمال الرمز &.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن فشلت عمليَّة التوسعة.

أمثلة

مثال نموذجي عن استخدام الدالة selector_extend()‎:

selector_extend(".a .b", ".b", ".foo .bar"); // .a .b, .a .foo .bar, .foo .a .bar

انظر أيضًا

• الدالة selector_append()‎: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها.
• الدالة selector_nest()‎: تُشعّب المحدِّدات.
• الدالة selector_unify()‎: تُوحّد محدِّدين.
• الدالة selector_parse()‎: تُحلّل محدّدًا من إنتاج المُستخدم إلى قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.

مصادر

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