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

من موسوعة حسوب
ط مراجعة الصفحة وتدقيقها.
ط استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}'
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 19: سطر 19:


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


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


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


</syntaxhighlight>
</syntaxhighlight>
سطر 40: سطر 40:


== مصادر ==
== مصادر ==
* [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}}]]

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

مصادر