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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_parse</code> في Sass}}</noinclude> تعيد الدالة <code>selector_parse()‎</code> محدّدًا جد...'
 
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].'
 
(5 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_parse</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_parse</code> في Sass}}</noinclude>
تعيد الدالة <code>selector_parse()‎</code> محدّدًا جديدًا مع تشعيب جميع المحددات الموجودة في <code>‎$selectors</code>  في بعضها البعض كما لو كانت متشعّبة في ملف الأنماط هكذا ‎<code><nowiki>$selector1 {$selector2 {...}}</nowiki></code>‎.
تحلِّل الدالة <code>selector_parse()‎</code> محدّدًا عرّفه المُستخدم (user-provided) إلى قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</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">
<syntaxhighlight lang="sass">
selector_parse($selectors...)
selector_parse($selector)
</syntaxhighlight>
</syntaxhighlight>


== المعاملات ==
== المعاملات ==


=== <code>‎$selectors</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>‎$selectors</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>.


== أمثلة ==
== أمثلة ==
مثال عن استخدام الدالة <code>selector_parse()‎</code>:<syntaxhighlight lang="sass">
مثال نموذجي عن استخدام الدالة <code>selector_parse()‎</code>:<syntaxhighlight lang="sass">
selector-nest(".foo", ".bar", ".baz") // .foo .bar .baz
selector_parse(".foo .bar, .baz .bang"); // ('.foo' '.bar', '.baz' '.bang')
selector-nest(".a .foo", ".b .bar") // .a .foo .b .bar
 
selector-nest(".foo", "&.bar") // .foo.bar
</syntaxhighlight>
</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>‎: تُوحّد محدِّدين.
* الدالة <code>[[Sass/is superselector|is_superselector()]]</code>‎: تتحقَّق ما إذا كان المحدِّد فائقًا.
* الدالة <code>[[Sass/simple selectors|simple_selectors()‎]]</code>: تعيد المحدّدات البسيطة التي يتركّب منها المحدّد المركّب المُمرَّر إليها.


== مصادر ==
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_parse-instance_method قسم الدالة selector_parse في صفحة الدوال في توثيق Sass الرسمي.]
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_parse-instance_method قسم الدالة selector_parse في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

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

تحلِّل الدالة selector_parse()‎ محدّدًا عرّفه المُستخدم (user-provided) إلى قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.

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

selector_parse($selector)

المعاملات

‎$selector

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

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

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

أمثلة

مثال نموذجي عن استخدام الدالة selector_parse()‎:

selector_parse(".foo .bar, .baz .bang"); // ('.foo' '.bar', '.baz' '.bang')

انظر أيضًا

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

مصادر