الفرق بين المراجعتين ل"Sass/selector extend"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_extend</code> في Sass}}</noinclude> تعيد الدالة <code>selector_extend()</code> محدّدًا ج...') |
|||
سطر 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 { ... } | |
− | + | $extender { @extend $extendee } | |
+ | </syntaxhighlight> | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
− | selector_extend($ | + | selector_extend($selector, $extendee, $extender) |
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
− | === <code>$ | + | === <code>$selector</code> === |
− | + | المحدد الذي سيُوسع داخلَه المحدد <code>$extendee</code> بواسطة <code>$extender</code>. يمكن أن يكون عبارةً عن سلسلة نصية أو قائمة من السلاسل النصية أو قائمة من قوائم السلاسل النصية كما تُعاد من قبل <code>&</code>. | |
+ | |||
+ | === <code>$extendee</code> === | ||
+ | المحدد الذي سيُوسع. يمكن أن يكون عبارةً عن سلسلة نصية أو قائمة من السلاسل النصية أو قائمة من قوائم السلاسل النصية كما تُعاد من قبل <code>&</code>. | ||
+ | |||
+ | === <code>$selector</code> === | ||
+ | المحدد الذي سيُسلَك داخلَ المحدد <code>$selector</code>. يمكن أن يكون عبارةً عن سلسلة نصية أو قائمة من السلاسل النصية أو قائمة من قوائم السلاسل النصية كما تُعاد من قبل <code>&</code>. | ||
== القيم المعادة == | == القيم المعادة == | ||
− | قائمة من قوائم السلاسل النصية التي تمثل نتيجة | + | قائمة من قوائم السلاسل النصية التي تمثل نتيجة التوسعة. وتكون بنفس التنسيق الذي يكون لمحدّد تُعيده <code>&</code>. |
+ | |||
+ | == الأخطاء والاستثناءات == | ||
+ | سيُرمى الخطأ <code>ArgumentError</code> إن فشلت التوسعة. | ||
+ | |||
+ | == مثال == | ||
+ | مثال عن استخدام الدالة <code>selector_extend()</code>:<syntaxhighlight> | ||
+ | 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 | + | * الدالة <code>[[Sass/selector nest|selector_nest()]]</code>: تُشعّب المحددات. |
* الدالة <code>[[Sass/selector unify|selector_unify()]]</code>: تُوحّد محددَيْن. | * الدالة <code>[[Sass/selector unify|selector_unify()]]</code>: تُوحّد محددَيْن. | ||
مراجعة 18:01، 21 أبريل 2018
تعيد الدالة selector_extend()
نسخة جديدةً من المحدد $selector
مع توسعة $extendee
بواسطة $extender
. النتيجة تشبه الكود البرمجي التالي:
$selector { ... }
$extender { @extend $extendee }
البنية العامة
selector_extend($selector, $extendee, $extender)
المعاملات
$selector
المحدد الذي سيُوسع داخلَه المحدد $extendee
بواسطة $extender
. يمكن أن يكون عبارةً عن سلسلة نصية أو قائمة من السلاسل النصية أو قائمة من قوائم السلاسل النصية كما تُعاد من قبل &
.
$extendee
المحدد الذي سيُوسع. يمكن أن يكون عبارةً عن سلسلة نصية أو قائمة من السلاسل النصية أو قائمة من قوائم السلاسل النصية كما تُعاد من قبل &
.
$selector
المحدد الذي سيُسلَك داخلَ المحدد $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()
: تُوحّد محددَيْن.