الفرق بين المراجعتين لصفحة: «Sass/selector replace»
< Sass
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة الصفحة وتدقيقها. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()selector_replace</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()selector_replace</code> في Sass}}</noinclude> | ||
تبدِّل الدالة <code>selector_replace()</code> كل نُسخ (instances) المعامل <code>$original</code> مع المعامل <code>$replacement</code> في المحدِّد <code>$selector</code> المعطى. | |||
تعمل الدالة عبر استخدام <code> | تعمل الدالة عبر استخدام القاعدة <code>[[Sass/@ rules#.D8.A7.D9.84.D9.82.D8.A7.D8.B9.D8.AF.D8.A9 .E2.80.8E.40extend|@extend]]</code> واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 11: | سطر 11: | ||
=== <code>$selector</code> === | === <code>$selector</code> === | ||
المحدِّد الذي سيُبدَّل داخله المحدَّد <code>$original</code> مع المحدِّد <code>$replacement</code>. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>. | |||
=== <code>$original</code> === | === <code>$original</code> === | ||
المحدِّد المراد استبداله. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>. | |||
=== <code>$replacement</code> === | === <code>$replacement</code> === | ||
المحدِّد الذي سيحل مكان المحدِّد <code>$original</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>ArgumentError</code> إن فشلت | سيُرمى الخطأ <code>ArgumentError</code> إن فشلت عمليَّة الاستبدال. | ||
== مثال == | == مثال == | ||
| سطر 32: | سطر 32: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/selector append|selector_append()]]</code>: تضيف | * الدالة <code>[[Sass/selector append|selector_append()]]</code>: تضيف المحدِّدات إلى بعضها بعضًا دون مسافات بينها. | ||
* الدالة <code>[[Sass/selector nest|selector_nest()]]</code>: تُشعّب | * الدالة <code>[[Sass/selector nest|selector_nest()]]</code>: تُشعّب المحدِّدات. | ||
* الدالة <code>[[Sass/selector unify|selector_unify()]]</code>: تُوحّد | * الدالة <code>[[Sass/selector unify|selector_unify()]]</code>: تُوحّد محدِّدين. | ||
* الدالة <code>[[Sass/selector extend|selector_extend()]]</code>: توسّع محدِّدًا معيَّنًا. | |||
* الدالة <code>[[Sass/is superselector|is_superselector()]]</code>: تتحقَّق ما إذا كان المحدِّد فائقًا. | |||
== مصادر == | == مصادر == | ||
مراجعة 15:13، 12 مايو 2018
تبدِّل الدالة selector_replace() كل نُسخ (instances) المعامل $original مع المعامل $replacement في المحدِّد $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(): تتحقَّق ما إذا كان المحدِّد فائقًا.