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

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

تعيد الدالة selector_nest()‎ محدِّدًا جديدًا مع تشعيب جميع المحدِّدات الموجودة في المعامل ‎$selectors في بعضها بعضًا كما لو كانت متشعّبة في ملف الأنماط بالشكل ‎$selector1 {$selector2 {...}}‎.

تسمح الدالة selector_nest()‎، على عكس معظم دوال المحدِّدات، باستخدام المُحدّد الأب & في أي مُحدِّد ممرَّر باستثناء المحدِّد الأول.

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

selector_nest($selectors...)

المعاملات

`‎$selectors`

المحدِّدات المراد تشعيبها، ويجب أن يُمرّر محدَّد واحد على الأقل. يمكن أن يكون كل واحد منهم عبارة عن سلسلة نصيّة، أو قائمة من سلاسل نصية، أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.

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

تُعاد قائمة من قوائم من سلاسل نصيَّة التي تمثل نتيجة تشعيب المحدِّدات ‎$selectors. ويكون تنسيقها بنفس تنسيق المحدّد المُعاد باستعمال الرمز &.

أمثلة

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

selector_nest(".foo", ".bar", ".baz"); // .foo .bar .baz
selector_nest(".a .foo", ".b .bar"); // .a .foo .b .bar
selector_nest(".foo", "&.bar"); // .foo.bar

انظر أيضًا

الدالة selector_append()‎: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها.
الدالة selector_extend()‎: توسّع محددًا معيَّنًا.
الدالة selector_unify()‎: توحِّد محدَّدين.
الدالة selector_replace()‎: تبدِّل محدِّد معين مع محدِّد آخر في محدِّد معطى.
الدالة is_superselector()‎: تتحقَّق ما إذا كان المحدّد فائقًا.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()selector_nest</code> في Sass}}</noinclude>
-تعيد الدالة <code>selector_nest()‎</code> قائمة مكونةً من مفاتيح القاموس.
+تعيد الدالة <code>selector_nest()‎</code> محدِّدًا جديدًا مع تشعيب جميع المحدِّدات الموجودة في المعامل <code>‎$selectors</code> في بعضها بعضًا كما لو كانت متشعّبة في ملف الأنماط بالشكل ‎<code><nowiki>$selector1 {$selector2 {...}}</nowiki></code>‎.
+تسمح الدالة <code>selector_nest()‎</code>، على عكس معظم دوال المحدِّدات، باستخدام المُحدّد الأب <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code> في أي مُحدِّد ممرَّر باستثناء المحدِّد الأول.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-selector_nest($map)
+selector_nest($selectors...)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$map</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>‎$selectors</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>‎$map</code> قاموسًا.
 == أمثلة ==
-مثال عن استخدام الدالة <code>selector_nest()‎</code>:<syntaxhighlight>
+مثال عن استخدام الدالة <code>selector_nest()‎</code>:<syntaxhighlight lang="sass">
-map-keys(("foo": 1, "bar": 2)) => "foo", "bar"
+selector_nest(".foo", ".bar", ".baz"); // .foo .bar .baz
+selector_nest(".a .foo", ".b .bar"); // .a .foo .b .bar
+selector_nest(".foo", "&.bar"); // .foo.bar
+</syntaxhighlight>
-</syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/map merge|map_merge()]]</code>‎: تدمج قاموسين في قاموس واحدٍ.
+* الدالة <code>[[Sass/selector append|selector_append()]]</code>‎: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها.
+* الدالة <code>[[Sass/selector extend|selector_extend()]]</code>‎: توسّع محددًا معيَّنًا.
-* الدالة <code>[[Sass/map remove|map_remove()]]</code>‎: تعيد قاموسًا جديدًا بعد حذف المفاتيح.
+* الدالة <code>[[Sass/selector unify|selector_unify()]]</code>‎: توحِّد محدَّدين.
-* الدالة <code>[[Sass/map values|map_values()]]</code>‎: تُعيد قائمة مكونة من قيم القاموس.
+* الدالة <code>[[Sass/selector replace|selector_replace()‎]]</code>: تبدِّل محدِّد معين مع محدِّد آخر في محدِّد معطى.
+* الدالة <code>[[Sass/is superselector|is_superselector()]]</code>‎: تتحقَّق ما إذا كان المحدّد فائقًا.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_nest-instance_method قسم الدالة selector_nest في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_nest-instance_method قسم الدالة selector_nest في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]