.unload()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.unload()

分类:建议弃用 > 建议弃用于1.8 | 事件 > 文档载入

返回: jQuery
弃用于:1.8

.unload( handler )

描述:把某个事件处理函数绑定到JavaScript事件“unload”上。

加入于: 1.0
.unload( handler )
  • handler
    类型:FunctionEvent eventObject )
    一个函数,在触发事件时执行它。
加入于: 1.4.3
.unload( [eventData ], handler )
  • eventData
    类型:Anything
    要传递给事件处理函数的数据纯对象。
  • handler
    类型:FunctionEvent eventObject )
    一个函数,在每次事件被触发时执行它。

这个方法是.on( "unload", handler )的简写。

当用户导航离开网页的时候,unload事件被发送到window元素上。这可能意味着很多事件。用户可以点击一个链接以离开这个网页,也可能是在地址栏中输入一个新URL。前进和后退按钮也会触发这个事件。关闭浏览器窗口也会触发这个事件。甚至重载一个网页也会先触发unload事件。

unload事件的严格的处理方式会因浏览器的不同而不同。举个例子,有些Firefox版本会在打开一个链接时触发该事件,但是在关闭窗口时不会触发该事件。在实际使用中,这个行为必须对所有支持的浏览器作测度,并与专有的beforeunload事件作对比。

任何unload事件处理函数必须绑定到window对象上:

$( window ).unload(function() {
  return "Handler for .unload() called.";
});

这个事件是可用的,当用户离开页面时,脚本可以执行清理。大多数浏览器将忽略该事件处理函数内对alert()confirm()prompt()的调用。你返回的这个字符串可以用在一个确认对话框里,但是并不是所有的浏览器都支持它。不能用.preventDefault()来取消unload事件。

其它说明

  • 因为.unload()方法是.on( "unload", handler )的简写,所以可以用.off( "unload" )来分离。

示例

当离开页面的时候,显示一个提示框。

$( window ).unload(function() {
  return "Bye now!";
});

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/unload.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。