wrapAll( wrappingElement )

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>

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>

HTML

<button id="jquery-sample-button">wrapAll/unwrap</button>
<div class="jquery-sample"></div>
<div class="jquery-sample"></div>
<div class="jquery-sample"></div>

スポンサード リンク

カテゴリー: API, DOM挿入, DOM操作, JavaScript, jQuery, 取り囲む タグ: パーマリンク