الفرق بين المراجعتين ل"Sass/selector replace"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].')
 
(مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين)
سطر 25: سطر 25:
 
سيُرمى الخطأ <code>ArgumentError</code> إن فشلت عمليَّة الاستبدال.
 
سيُرمى الخطأ <code>ArgumentError</code> إن فشلت عمليَّة الاستبدال.
  
== مثال ==
+
== أمثلة ==
مثال عن استخدام الدالة <code>selector_replace()‎</code>:<syntaxhighlight lang="sass">
+
أمثلة نموذجية عن استخدام الدالة <code>selector_replace()‎</code>:<syntaxhighlight lang="sass">
selector-replace(".foo .bar", ".bar", ".baz") // ".foo .baz"
+
selector_replace(".foo .bar", ".bar", ".baz"); // ".foo .baz"
selector-replace(".foo.bar.baz", ".foo.baz", ".qux") // ".bar.qux"
+
selector_replace(".foo.bar.baz", ".foo.baz", ".qux"); // ".bar.qux"
 
</syntaxhighlight>
 
</syntaxhighlight>
  
سطر 39: سطر 39:
  
 
== مصادر ==
 
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_replace-instance_method قسم الدالة selector_replace في صفحة الدوال في توثيق Sass الرسمي.]
+
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#selector_replace-instance_method قسم الدالة selector_replace في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
+
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
+
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

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

تبدِّل الدالة selector_replace()‎ المعامل ‎$replacement مكان نُسخ (instances) المعامل ‎$original أينما وجدت في المحدِّد ‎$selector المعطى.

تعمل الدالة عبر استخدام القاعدة ‎@extend واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة.

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

selector_replace($selector, $original, $replacement)

المعاملات

‎$selector

المحدِّد الذي سيُبدَّل داخله المحدَّد ‎$original مع المحدِّد ‎$replacement. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &.

‎$original

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

‎$replacement

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

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

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

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن فشلت عمليَّة الاستبدال.

أمثلة

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

selector_replace(".foo .bar", ".bar", ".baz"); // ".foo .baz"
selector_replace(".foo.bar.baz", ".foo.baz", ".qux"); // ".bar.qux"

انظر أيضًا

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

مصادر