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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
سطر 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>
  

مراجعة 08:58، 19 مايو 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()‎: تتحقَّق ما إذا كان المحدِّد فائقًا.

مصادر