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

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

تتحقَّق الدالة is_superselector()‎ ما إذا كان المحدِّد ‎$super محدّدًا فائقًا (superselector) للمحدِّد ‎$sub. هذا يعني أنّ المحدِّد ‎$super يُطابق جميع العناصر التي يطابقها ‎$sub بالإضافة إلى عناصر أخرى. عمومًا، تميل المحددات الأبسط إلى أن تكون محدّدات فائقة للمحدِّدات الأكثر تعقيدًا.

البنية العامة

is_superselector($super, $sub)

المعاملات

`‎$selectors`

المحدد الفائق المحتمل. يمكن أن يكون عبارةً عن سلسلة نصية، أو قائمة من سلاسل نصيَّة، أو قائمة من عدَّة قوائم تحوي سلاسل نصيَّة أُعيدت باستعمال &.

`‎$sub`

المُحدّد التحتي (subselector) المحتمل. يمكن أن يكون عبارةً عن سلسلة نصية، أو قائمة من سلاسل نصيَّة، أو قائمة من عدَّة قوائم تحوي سلاسل نصيَّة أُعيدت باستعمال &.

القيم المعادة

تُعاد القيمة TRUE إذا كان المحدِّد ‎$super محدّدًا فائقًا للمحدِّد ‎$sub، أو القيمة FALSE خلاف ذلك.

أمثلة

مثال عن استخدام الدالة is_superselector()‎:

is-superselector(".foo", ".foo.bar") // true
is-superselector(".foo.bar", ".foo") // false
is-superselector(".bar", ".foo .bar") // true
is-superselector(".foo .bar", ".bar") // false

انظر أيضًا

الدالة selector_append()‎: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها.
الدالة selector_extend()‎: توسّع المحدِّد.
الدالة selector_unify()‎: توحّد محددَين.

مصادر

قسم الدالة is_superselector في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()is_superselector</code> في Sass}}</noinclude>
-تعيد الدالة <code>selector_nest()‎</code> محدّدًا جديدًا مع تشعيب جميع المحددات الموجودة في <code>‎$selectors</code>  في بعضها البعض كما لو كانت متشعّبة في ملف الأنماط هكذا ‎<code><nowiki>$selector1 {$selector2 {...}}</nowiki></code>‎.
+تتحقَّق الدالة <code>is_superselector()‎</code> ما إذا كان المحدِّد <code>‎$super</code> محدّدًا فائقًا (superselector) للمحدِّد <code>‎$sub</code>. هذا يعني أنّ المحدِّد <code>‎$super</code> يُطابق جميع العناصر التي يطابقها <code>‎$sub</code> بالإضافة إلى عناصر أخرى. عمومًا، تميل المحددات الأبسط إلى أن تكون محدّدات فائقة للمحدِّدات الأكثر تعقيدًا.
-على عكس معظم دوال المحددات ، فإن الدالة <code>is_superselector()‎</code> تسمح باستخدام المُحدّد الأبوي <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code> في أي مُحدد ما عدا الأول.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-is_superselector($selectors...)
+is_superselector($super, $sub)
 </syntaxhighlight>
@@ سطر 12: / سطر 10: @@
 === <code>‎$selectors</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>‎$sub</code> ===
+المُحدّد التحتي (subselector) المحتمل. يمكن أن يكون عبارةً عن سلسلة نصية، أو قائمة من سلاسل نصيَّة، أو قائمة من عدَّة قوائم تحوي سلاسل نصيَّة أُعيدت باستعمال <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.
 == القيم المعادة ==
-قائمة من قوائم السلاسل النصية التي تمثل نتيجة تشعيب المحددات <code>‎$selectors</code>. وتكون بنفس التنسيق الذي يكون لمحدّد تعيده <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>.
+تُعاد القيمة <code>TRUE</code> إذا كان المحدِّد <code>‎$super</code> محدّدًا فائقًا للمحدِّد <code>‎$sub</code>، أو القيمة <code>FALSE</code> خلاف ذلك.
 == أمثلة ==
-مثال عن استخدام الدالة <code>selector_nest()‎</code>:<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>is_superselector()‎</code>:<syntaxhighlight lang="sass">
-selector-nest(".foo", ".bar", ".baz") // .foo .bar .baz
+is-superselector(".foo", ".foo.bar") // true
-selector-nest(".a .foo", ".b .bar") // .a .foo .b .bar
+is-superselector(".foo.bar", ".foo") // false
-selector-nest(".foo", "&.bar") // .foo.bar
+is-superselector(".bar", ".foo .bar") // true
+is-superselector(".foo .bar", ".bar") // false
 </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 extend|selector_extend()]]</code>‎: توسّع المحدِّد.
-* الدالة <code>[[Sass/selector unify|selector_unify()]]</code>‎: تُوحّد محددَيْن.
+* الدالة <code>[[Sass/selector unify|selector_unify()]]</code>‎: توحّد محددَين.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#is_superselector-instance_method قسم الدالة is_superselector في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#is_superselector-instance_method قسم الدالة is_superselector في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]