التابع .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>