[Функция] wrapAll(html)
Раздел "Manipulation"
Создать вокруг всех подобранных элементов единственный обарачивающий элемент.
html: Строка HTML кода, который будт создан на "лету" и обернёт объект .
Функция отличается от функции .wrap() тем, что в последней каждый выбранный элемент помещается в новый элемент. В данной функции все выбранные элементы помещаются в один единственный элемент. Данная функция наиболее полезна для добавления дополнительной структуры в документ, без разрушения изначальной семантики документа. Функция начинает создавать структуру с первого установленного элемента (который создаётся на лету, через подготовленный HTML код) и находит самый последний элемент потомок в структуре – это обеспечивает предотвращение охвата других элементов.
Пример:
Создать новый элемент div вокруг всех параграфов.
"HTML"
<p>Hello</p>
<p>cruel</p>
<p>World</p>
"CSS"
div { border: 2px solid blue; }
p { background:yellow; margin:4px; }
"Живой пример jQuery"
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<link href="http://test-drupal.ru/themes/slyweb/css/jqueryiframe.css"
rel="stylesheet" type="text/css"/>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
<script>
$(document).ready(function(){
$("p").wrapAll("<div></div>");
});
</script>
</head>
<body class="iframe">
<p>Hello</p>
<p>cruel</p>
<p>World</p>
</body>
</html>
<style>
div { border: 2px solid blue; }
p { background:yellow; margin:4px; }
</style>
Пример:
Создать заново структуру объектов вокруг объекта span. Учтите всё, что находтися между элементами span не войдёт в структуру, например элемент strong. Пробел так же не войдёт в структру.
"jQuery"
$("span").wrapAll("<div><div><p><em><b></b></em></p></div></div>");
"HTML"
<span>Span Text</span>
<strong>What about me?</strong>
<span>Another One</span>
"CSS"
div { border:2px blue solid; margin:2px; padding:2px; }
p { background:yellow; margin:2px; padding:2px; }
strong { color:red; }
"Живой пример jQuery"
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<link href="http://test-drupal.ru/themes/slyweb/css/jqueryiframe.css"
rel="stylesheet" type="text/css"/>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
<script>
$(document).ready(function(){
$("span").wrapAll("<div><div><p><em><b></b></em></p></div></div>");
});
</script>
</head>
<body class="iframe">
<span>Span Text</span>
<strong>What about me?</strong>
<span>Another One</span>
</body>
</html>
<style>
div { border:2px blue solid; margin:2px; padding:2px; }
p { background:yellow; margin:2px; padding:2px; }
strong { color:red; }
</style>
Версия jQuery 1.4.2
Документ создан 2010-08-21