jQuery API の wrapAll( wrappingElement ) は、マッチした要素を、wrappingElementに指定した要素で、まるごと包み込むメソッド。追加した要素は、マッチした要素の親要素となる。
記述方法
jQuery( セレクター ) . wrapAll( HTML要素 );
「セレクター」に指定した要素を、「HTML要素」に指定した要素で包み込む。
記述例
jQuery( '.jquery-sample' ) . wrapAll( '<div></div>' );
クラス名が「jquery-sample」の要素を、<div></div>
で、まるごと包み込む。
実装例(サンプル)
実装例(サンプル)の動作について
「wrapAll/unwrap」ボタンをクリックすると、背景色が黄色のdiv要素を、背景色が赤色のdiv要素で、まるごと包み込む。
「wrapAll/unwrap」ボタンを再度クリックすると、背景色が赤色のdiv要素を取り除く。
実装例(サンプル)のソースコード
JavaScript
<script>
<!--
jQuery( function() {
jQuery( '#jquery-sample-button' ) . toggle(
function () {
jQuery( '.jquery-sample' ) . wrapAll( '<div class="jquery-sample-wrapAll"></div>' );
},
function () {
jQuery( '.jquery-sample' ) . unwrap();
}
);
} );
// -->
</script>
<!--
jQuery( function() {
jQuery( '#jquery-sample-button' ) . toggle(
function () {
jQuery( '.jquery-sample' ) . wrapAll( '<div class="jquery-sample-wrapAll"></div>' );
},
function () {
jQuery( '.jquery-sample' ) . unwrap();
}
);
} );
// -->
</script>
CSS
<style type="text/css">
<!--
.jquery-sample {
margin: 10px;
height: 50px;
background-color: yellow;
border-radius: 10px;
}
.jquery-sample-wrapAll {
margin: 10px;
background-color: red;
border: 1px solid darkred;
border-radius: 18px;
}
-->
</style>
<!--
.jquery-sample {
margin: 10px;
height: 50px;
background-color: yellow;
border-radius: 10px;
}
.jquery-sample-wrapAll {
margin: 10px;
background-color: red;
border: 1px solid darkred;
border-radius: 18px;
}
-->
</style>
HTML
<button id="jquery-sample-button">wrapAll/unwrap</button>
<div class="jquery-sample"></div>
<div class="jquery-sample"></div>
<div class="jquery-sample"></div>
<div class="jquery-sample"></div>
<div class="jquery-sample"></div>
<div class="jquery-sample"></div>