error(fn)
version 1.0 以降
解説
マッチした要素のerrorイベントに、イベントハンドラをバインドします。
bind("error", fn) のヘルパイベントです。
エラーイベントの発生
error イベントの標準規格は存在しません。
しかし、多くのブラウザは、例えば次のような場合にerror イベントが引き起こされます。
- ページ上でJavaScriptのエラーが発生したとき。→
window オブジェクトのerror イベントが引き起こされます。
img 要素のsrc 属性に、存在しないファイルや壊れた画像データなど、不正な値を設定されたとき。→img オブジェクトのerror イベントが引き起こされます。
window エラーイベント
window オブジェクトによってerror イベントが投げられた場合、イベントハンドラ関数には3つの引数が渡されます。
error イベントの説明("varName is not defined", "missing operator in expression"など)
- エラーが発生したページのURL
- エラーが発生した行番号
エラーイベントの制御
イベントハンドラ関数がtrue を返すと、error イベントが処理されたものとみなされ、ブラウザはerror を上げません。
error イベントのより詳細な情報は、以下を参照してください。
引数
-
fn
Function: error イベントにバインドするイベントハンドラ関数
戻り値
関連
例
例1:URLをクリックすると、画像を表示します。画像が存在しない場合は、メッセージを表示します。
$("#test_result li").click(function(){
var elem = this;
$("#display").empty().append(
$("<img/>")
.attr("src", $(elem).text())
.error(function(e){
$(this).hide();
$("#display").text(
$(elem).text() + " の読み込みに失敗しました。"
);
return true;
})
);
});
- http://stacktrace.jp/img/folder.gif
- http://stacktrace.jp/img/report.gif
- http://stacktrace.jp/img/xxxxx.gif
------------------------------------------
|