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

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

‎.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>

مصادر