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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()simple_selectors</code> في Sass}}</noinclude> تعيد الدالة <code>simple_selectors()‎</code> محدّدًا...'
 
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].'
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()simple_selectors</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()simple_selectors</code> في Sass}}</noinclude>
تعيد الدالة <code>simple_selectors()‎</code> محدّدًا جديدًا مع تشعيب جميع المحددات الموجودة في <code>‎$selectors</code>  في بعضها البعض كما لو كانت متشعّبة في ملف الأنماط هكذا ‎<code><nowiki>$selector1 {$selector2 {...}}</nowiki></code>‎.
تعيد الدالة <code>simple_selectors()‎</code> ا[http://dev.w3.org/csswg/selectors4/#simple لمحدّدات البسيطة] التي يتركّب منها المحدّد المركّب المُمرَّر إليها.


على عكس معظم دوال المحددات ، فإن الدالة <code>selector_nest()‎</code> تسمح باستخدام المُحدّد الأبوي <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code> في أي مُحدد ما عدا الأول.
لاحظ أنّ المحدِّد <code>‎$selector</code> المرَّر إلى الدالة ينبغي أن يكون [http://dev.w3.org/csswg/selectors4/#compound محدِّدًا مركَّبًا]. هذا يعني أنَّه لا يمكن أن يحتوي على فواصل أو مسافات، ويعني ذلك أيضًا أنَّ هذه الدالة لا تقبل سوى سلاسل نصيَّة وليس القوائم بخلاف دوال المحدَّدات الأخرى.


== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="sass">
<syntaxhighlight lang="sass">
simple_selectors($selectors...)
simple_selectors($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>‎$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>simple_selectors()‎</code>:<syntaxhighlight lang="sass">
أمثلة نموذجية عن استخدام الدالة <code>simple_selectors()‎</code>:<syntaxhighlight lang="sass">
selector-nest(".foo", ".bar", ".baz") // .foo .bar .baz
@debug simple_selectors(".foo.bar"); // .foo, .bar
selector-nest(".a .foo", ".b .bar") // .a .foo .b .bar
@debug simple_selectors(".foo.bar.baz"); // .foo, .bar, .baz
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>‎: تتحقَّق ما إذا كان المحدّد فائقًا.


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

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

تعيد الدالة simple_selectors()‎ المحدّدات البسيطة التي يتركّب منها المحدّد المركّب المُمرَّر إليها.

لاحظ أنّ المحدِّد ‎$selector المرَّر إلى الدالة ينبغي أن يكون محدِّدًا مركَّبًا. هذا يعني أنَّه لا يمكن أن يحتوي على فواصل أو مسافات، ويعني ذلك أيضًا أنَّ هذه الدالة لا تقبل سوى سلاسل نصيَّة وليس القوائم بخلاف دوال المحدَّدات الأخرى.

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

simple_selectors($selector)

المعاملات

‎$selector

المُحدد المُركَّب المراد استخراج المحدَّدات البسيطة التي يتركَّب منها.

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

تُعاد قائمة بالمحدِّدات البسيطة الموجودة في المحدِّد المركَّب ‎$selector.

أمثلة

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

@debug simple_selectors(".foo.bar"); // .foo, .bar
@debug simple_selectors(".foo.bar.baz"); // .foo, .bar, .baz

انظر أيضًا

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

مصادر