الفرق بين المراجعتين ل"Sass/selector extend"
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
|||
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_extend</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()selector_extend</code> في Sass}}</noinclude> | ||
− | تعيد الدالة <code>selector_extend()</code> | + | تعيد الدالة <code>selector_extend()</code> نسخةً جديدةً من المحدِّد <code>$selector</code> مع توسعة <code>$extendee</code> بواسطة <code>$extender</code>. النتيجة تشبه الكود البرمجي التالي:<syntaxhighlight lang="sass"> |
$selector { ... } | $selector { ... } | ||
$extender { @extend $extendee } | $extender { @extend $extendee } | ||
سطر 13: | سطر 13: | ||
=== <code>$selector</code> === | === <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>$extendee</code> === | ||
− | + | المحدِّد الذي سيُوسع. يمكن أن يكون عبارةً عن سلسلة نصية، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة مثلما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>. | |
− | === <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>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 | |
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[Sass/selector append|selector_append()]]</code>: تضيف | + | * الدالة <code>[[Sass/selector append|selector_append()]]</code>: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها. |
− | * الدالة <code>[[Sass/selector nest|selector_nest()]]</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}}]] |
المراجعة الحالية بتاريخ 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()
: تُحلّل محدّدًا من إنتاج المُستخدم إلى قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز&
.