عرض مصدر Sass/selector extend

<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_extend</code> في Sass}}</noinclude>
تعيد الدالة <code>selector_extend()‎</code> نسخةً جديدةً من المحدِّد <code>‎$selector</code> مع توسعة <code>‎$extendee</code> بواسطة <code>‎$extender</code>. النتيجة تشبه الكود البرمجي التالي:<syntaxhighlight lang="sass">
$selector { ... }
$extender { @extend $extendee }
</syntaxhighlight>

== البنية العامة ==
<syntaxhighlight lang="sass">
selector_extend($selector, $extendee, $extender)
</syntaxhighlight>

== المعاملات ==

=== <code>‎$selector</code> ===
المحدِّد الذي سيُوسع داخله المحدِّد <code>‎$extendee</code> بواسطة المعامل <code>‎$extender</code>. يمكن أن يكون عبارةً عن سلسلة نصيَّة، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة مثلما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

=== <code>‎$extendee</code> ===
المحدِّد الذي سيُوسع. يمكن أن يكون عبارةً عن سلسلة نصية، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة مثلما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

=== <code>‎$extender</code> ===
المحدِّد الذي سيُضاف داخل المحدِّد <code>‎$selector</code>. يمكن أن يكون عبارةً عن سلسلة نصيَّة، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

== القيم المعادة ==
تُعاد قائمة من قوائم من سلاسل نصيَّة التي تمثل نتيجة التوسعة، ويكون تنسيقها بنفس تنسيق المحدّد المُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن فشلت عمليَّة التوسعة.

== أمثلة ==
مثال نموذجي عن استخدام الدالة <code>selector_extend()‎</code>:<syntaxhighlight lang="sass">
selector_extend(".a .b", ".b", ".foo .bar"); // .a .b, .a .foo .bar, .foo .a .bar

</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[Sass/selector append|selector_append()]]</code>‎: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها.
* الدالة <code>[[Sass/selector nest|selector_nest()]]</code>‎: تُشعّب المحدِّدات.
* الدالة <code>[[Sass/selector unify|selector_unify()]]</code>‎: تُوحّد محدِّدين.
* الدالة <code>[[Sass/selector parse|selector_parse()‎]]</code>: تُحلّل محدّدًا من إنتاج المُستخدم إلى قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.

== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_extend-instance_method قسم الدالة selector_extend في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
[[تصنيف: Sass Function]]