الفرق بين المراجعتين لصفحة: «Sass/selector extend»

المراجعة الحالية بتاريخ 07:00، 20 مايو 2018

تعيد الدالة 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 الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()selector_extend</code> في Sass}}</noinclude>
-تعيد الدالة <code>selector_extend()‎</code> محدّدًا جديدًا مع تشعيب جميع المحددات الموجودة في <code>‎$selectors</code>  في بعضها البعض كما لو كانت متشعّبة في ملف الأنماط هكذا ‎<code><nowiki>$selector1 {$selector2 {…}}</nowiki></code>‎.
+تعيد الدالة <code>selector_extend()‎</code> نسخةً جديدةً من المحدِّد <code>‎$selector</code> مع توسعة <code>‎$extendee</code> بواسطة <code>‎$extender</code>. النتيجة تشبه الكود البرمجي التالي:<syntaxhighlight lang="sass">
+$selector { ... }
-على عكس معظم دوال المحددات ، فإن الدالة <code>selector_extend()‎</code> تسمح باستخدام المُحدّد الأبوي  <code>&</code> في أي مُحدد حاشا الأول.
+$extender { @extend $extendee }
+</syntaxhighlight>
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-selector_extend($selectors...)
+selector_extend($selector, $extendee, $extender)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$selectors</code> ===
+=== <code>‎$selector</code> ===
-المحددات التي ستُشعّب. يجب أن يُمرّر محدد واحد على الأقل. يمكن أن تكون كل واحدة منها عبارة عن سلسلة نصية أو قائمة من السلاسل النصية أو قائمة من قوائم السلاسل النصية كما تمت إعادتها من قبل <code>&</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>‎$selectors</code>. وتكون بنفس التنسيق الذي يكون لمحدّد تعيده <code>&</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 append|selector_append()]]</code>‎: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها.
-* الدالة <code>[[Sass/selector extend|selector_extend()]]</code>‎: توسّع المحدد.
+* الدالة <code>[[Sass/selector nest|selector_nest()]]</code>‎: تُشعّب المحدِّدات.
-* الدالة <code>[[Sass/selector unify|selector_unify()]]</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 الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_extend-instance_method قسم الدالة selector_extend في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]