.replaceAll( target )Возвращает: jQuery
Описание: Заменяет каждый целевой элемент на набор совпавших элементов.
-
версия добавлена: 1.2.replaceAll( target )
- targetСтрока селектора, объект jQuery, DOM-элемент или массив элементов, указывающий, какой(ие) элемент(ы) заменить.
-
Метод .replaceAll() аналогичен методу .replaceWith(), но с переставленными исходным и целевым элементами. Рассмотрим следующую структуру DOM:
<div class="container"> <div class="inner first">Hello</div> <div class="inner second">And</div> <div class="inner third">Goodbye</div> </div>
Мы можем создать элемент, а затем заменить другие элементы им:
$( "<h2>New heading</h2>" ).replaceAll( ".inner" );
Это приведет к замене всех элементов:
<div class="container"> <h2>New heading</h2> <h2>New heading</h2> <h2>New heading</h2> </div>
Или мы можем выбрать элемент, который будет использоваться в качестве замены:
$( ".first" ).replaceAll( ".third" );
Это приведет к следующей структуре DOM:
<div class="container"> <div class="inner second">And</div> <div class="inner first">Hello</div> </div>
Из этого примера видно, что выбранный элемент заменяет целевой, переместившись со своего прежнего места, а не создав свою копию.
Дополнительные замечания:
- Метод
.replaceAll()удаляет все данные и обработчики событий, связанные с удалёнными узлами.
Пример:
Заменить все абзацы жирным текстом.
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>replaceAll demo</title> <script src="https://code.jquery.com/jquery-3.7.0.js"></script> </head> <body> <p>Hello</p> <p>cruel</p> <p>World</p> <script> $( "<b>Paragraph. </b>" ).replaceAll( "p" ); </script> </body> </html>
