الفرق بين المراجعتين ل"Sass/selector replace"
سطر 11: | سطر 11: | ||
=== <code>$selector</code> === | === <code>$selector</code> === | ||
− | المحدد الذي سيُستبدل داخلَه <code>$original</code> بواسطة <code>$replacement</code>. يمكن أن يكون عبارةً عن سلسلة نصية أو قائمة من السلاسل النصية أو قائمة من قوائم السلاسل النصية كما تُعاد من قبل <code>&</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>&</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>&</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>&</code>. | + | قائمة من قوائم السلاسل النصية التي تمثل نتيجة التوسعة. وتكون بنفس التنسيق الذي يكون لمحدّد تُعيده <code>[[Sass/SassScript#.D8.A7.D9.84.D8.B1.D9.85.D8.B2 .26 .D9.81.D9.8A SassScript|&]]</code>. |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سطر 27: | سطر 27: | ||
== مثال == | == مثال == | ||
مثال عن استخدام الدالة <code>selector_replace()</code>:<syntaxhighlight> | مثال عن استخدام الدالة <code>selector_replace()</code>:<syntaxhighlight> | ||
− | selector-replace(".foo .bar", ".bar", ".baz") | + | selector-replace(".foo .bar", ".bar", ".baz") // ".foo .baz" |
− | selector-replace(".foo.bar.baz", ".foo.baz", ".qux") | + | selector-replace(".foo.bar.baz", ".foo.baz", ".qux") // ".bar.qux" |
</syntaxhighlight> | </syntaxhighlight> | ||
مراجعة 03:29، 22 أبريل 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()
: تُوحّد محددَيْن.