التابع ‎‎.replaceAll()‎‎ في jQuery

من موسوعة حسوب
< jQuery
مراجعة 17:52، 13 يونيو 2018 بواسطة جميل-بيلوني (نقاش | مساهمات)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

‎.replaceAll( target )‎

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

يعيد كائنًا من النوع jQuery.

الوصف

يبدِّل هذا التابع مجموعة العناصر المطابقة مكان كل عنصر من العناصر المحدَّدة.

‎.replaceAll( target )‎

أُضيف مع الإصدار: 1.2.

target

سلسلة نصيِّة تحتوي على محدِّد، أو كائن jQuery، أو عناصر DOM، أو مصفوفة من العناصر تشير جميعها إلى العنصر أو العناصر المراد استبدالها.

يشبه التابع ‎.replaceAll()‎ التابع ‎.replaceWith()‎ ولكنهما متعاكسان بالنسبة للمُستبدل والمُستبدل به. بفرض أنَّ لدينا البنية DOM التالية:

<div class="container">
  <div class="inner first">مرحبًا</div>
  <div class="inner second">ثم</div>
  <div class="inner third">وداعًا</div>
</div>

يمكننا إنشاء عنصر ليحل مكان عناصر أخرى مثل:

$( "<h2>عنوان جديد</h2>" ).replaceAll( ".inner" );

هذا سيؤدي إلى استبدال جميع العناصر:

<div class="container">
  <h2>عنوان جديد</h2>
  <h2>عنوان جديد</h2>
  <h2>عنوان جديد</h2>
</div>

أو يمكننا تحديد عنصرٍ من المجموعة نفسها واستبدال عنصرٍ آخرٍ به:

<div class="container">
  <div class="inner second">ثم</div>
  <div class="inner first">مرحبًا</div>
</div>

نلاحظ من المثال السابق أنَّ عملية الاستبدال قد حصلت بانتقال العنصر من مكانه إلى مكان العنصر المحدَّد وليس بنسخه إلى المكان المستهدف وبقائه في مكانه أيضًا.

ملاحظات إضافية

يحذف التابع ‎.replaceAll()‎ جميع البيانات ومعالجات الحدث المرتبطة بالعقد المحذوفة.

أمثلة

استبدال كلمات معيَّنة بجميع الفقرات <p> الموجودة:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>replaceAll مثالٌ عن استعمال التابع</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
 
<script>
$( "<b>فقرة  </b>" ).replaceAll( "p" );
</script>
 
</body>
</html>

مصادر