الدالة ()selector_extend في Sass
تعيد الدالة 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(): تُحلّل محدّدًا من إنتاج المُستخدم إلى قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز&.