初心者向けのjQuery入門講座|デザイナー向けのJavaScriptライブラリ

このエントリーをはてなブックマークに追加
索引
Core:コアとなる仕組み
Selectors:セレクタ
Attributes:属性
Traversing:対象の変更
Manipulation:操作
CSS:スタイルシート
Events:イベント
Effects:演出効果
Ajax:xml等との連携
Utilities:ユーティリティ
Data:データ
Miscellaneous:諸々
Deferred:処理管理
Callbacks:コールバック
Internals:内部処理

.mouseenter( )マウスカーソルが要素内(子孫要素は除く)に入った時の処理を設定

構文

マウスカーソルが要素内(子孫要素は除く)に入った時の処理を設定返値:jQueryオブジェクト
jQo.mouseenter( function )ver1.0〜
jQo.mouseenter( )ver1.0〜
jQo.mouseenter( object, function )ver1.4.3〜

機能

jQueryオブジェクトで指定した要素にマウスカーソルが入った時に引数のfunctionを実行します。引数にfunctionを設定しない場合は、要素に設定(バインド)されたfunctionを実行します。

ver1.4.3からは引数にobjectオブジェクトを設定することで、実行するfunctionにデータを渡すことができます(データはイベントオブジェクトのdataプロパティ経由で渡されます)。

mouseenterイベントはバブリングしない(親要素にイベントが伝わらない)ため子孫要素でイベントが発生してもfunctionは実行されません。子孫要素にマウスカーソルが入った時もfunctionを実行したい場合はmouseoverメソッドを利用してください。

※以降「マウスカーソルが要素内(子孫要素は除く)に入った」動作のことをマウスエンターと呼びます。

解説

マウスエンターで実行する処理を設定

サンプル(mouseenter/01.html)を開いてbody内にdiv要素が1つあることを確認してください。jQueryは以下の様に記述され、mouseenterメソッドの引数にfunctionの「enterFunc」が設定されています。

$(function () {
	$("button").mouseenter(enterFunc);
});

mouseenterメソッドの引数に設定するFunctionは以下の様な構文になっています。まず引数(イベントオブジェクト)を受け取ります。そしてマウスエンターしたら実行したい処理を{}の中に書きます、何かをreturnする必要はありません。イベントオブジェクトは別項にまとめてあるので、そちらを確認してください。

mouseenterに設定するFunctionの構文
function 任意の名前(イベントオブジェクト){
 マウスエンターで実行したい処理
}

サンプルmouseenter/01.htmlで利用したenterFuncは以下の様になっており、アラートで「mouseenter」と表示するだけです。このサンプルでは引数(イベントオブジェクト)は利用していません。

function enterFunc(eo){
	alert("mouseenter");
}
結果として、div要素にマウスエンターするとアラートで「mouseenter」と表示されます。
イベントのfunction設定は、無名関数を利用することが多いです。→サンプル(mouseenter/01b.html

$("button").mouseenter(function(){
	alert("mouseenter");
})

他の要素に設定されたマウスエンター時の処理を実行する

mouseenterメソッドは引数を設定しないと、要素に設定されたマウスエンター時の処理を実行します。
サンプル(mouseenter/02.html)を開いてbody内にbutton要素とdiv要素があることを確認してください。

続いてjQueryを確認してください。div要素に設定されたマウスエンター時の処理はmouseenter/01b.htmlと同じですが、以下の処理が追加されています。この処理によってbuttonをクリックするとdiv要素に設定されたマウスエンター時の処理が実行されます。

$("button").click(function(){
	$("div").mouseenter();
})

結果として、buttonを「クリック」するとdiv要素を「マウスエンター」したのと同じようにアラートで「mouseenter」と表示されます。

objectオブジェクトをfunctionに渡す

第1引数にobjectオブジェクトを設定することで、実行するfunctionにデータを渡すことができます。データはイベントオブジェクトのdataプロパティを介して渡されます。サンプル(mouseenter/03.html)を開いてbody内の構成はmouseenter/01.htmlと同じ事を確認してください。

jQueryは以下の様に記述され、mouseenterメソッドの第1引数にtestプロパティが10の値を持ったobjectオブジェクトが設定されています。このデータはイベントオブジェクト(eo)を通してfunctionに渡され、dataプロパティの値として取得できます。

$("div").mouseenter({test:10},function(eo){
	alert(eo.data.test);
})

結果として、div要素にマウスエンターすると第1引数で渡されたtestプロパティの値「10」がアラートで表示されます。

子孫要素には反応しません

mouseenterイベントはバブリングしないため子孫要素からイベントが送られてくることはありません(つまり子孫要素には反応しません)。サンプル(mouseenter/04.html)を開いてbody内にdiv要素が入れ子になって配置(外側はoutのid属性、内側はinのid属性)されていることを確認してください。

<div id="out">
	<div id="in"></div>
</div>

jQueryは以下の様に記述され、mouseenter/01b.htmlとはセレクタが違うだけです。

$("#out").mouseenter(function(){
	alert("mouseenter")	
});

セレクタに「#out」を設定しているので、外側のdiv要素(outのid属性)にマウスエンターした時に「mouseenter」と表示されますが、セレクタで指定されていない内側のdiv要素(inのid属性)にマウスエンターした際は「mouseenter」と表示されません。当たり前のようですが、mouseoverメソッドでは子孫要素に入ったときもアラートが表示されます。mouseoverメソッドのサンプルと比較してみてください。
→サンプル(mouseover/04.html

$("#out").mouseover(function(){
	alert("mouseover")	
});

イベントフローと合わせて覚えておくと良いでしょう
→参考:使い方「イベントフロー(1)」
→参考:使い方「イベントフロー(3)」

関連項目

マウスカーソルが要素外(子孫要素は除く)に出た時の処理を設定したい場合はmouseleaveメソッドを利用します。