onLoad 在載入事件發生時執行 JavaScript 程式碼——也就是瀏覽器完成載入一個視窗,或 FRAMESET 標籤中所有框架的時候。
適用對象:Image、Layer、Window。實作版本:Navigator 2.0 起,Navigator 3.0 起可作為 Image 的事件處理器。
onLoad="handlerText"
handlerText 為 JavaScript 程式碼,或對某個 JavaScript 函式的呼叫。
在 BODY 或 FRAMESET 標籤中使用,例如 <BODY onLoad="...">。
在 FRAMESET 與 FRAME 的關係中,框架內的 onLoad(寫在 BODY 標籤)會先於 FRAMESET 的 onLoad(寫在 FRAMESET 標籤)發生。這個順序在需要協調多框架初始化時很關鍵。
對圖片而言,onLoad 表示「圖片被顯示時」要執行的腳本。請不要把「顯示圖片」和「載入圖片」搞混:你可以先載入多張圖片,之後透過改變同一個 Image 物件的 src 屬性,把它們逐一顯示出來。用這種方式換圖時,onLoad 每次顯示都會觸發,而不只是在圖片載入記憶體時觸發一次。
若指定 onLoad 的 Image 物件顯示的是循環播放的 GIF 動畫,那麼動畫每循環一次就會觸發一次 onLoad,事件處理器也會跟著執行一次。
利用這個特性,反覆設定 Image 物件的 src 屬性,就能做出 JavaScript 動畫。
type 標明事件類型;target 標明事件原本由哪個物件發出;width 與 height 則是視窗的寬高(僅限視窗事件,不含 layer)。
<BODY onLoad="window.alert('Welcome to the Brave New World home page!'">
下例建立兩個 Image 物件,一個用建構函式、一個用 IMG 標籤,各自掛上 onLoad 處理器去呼叫 displayAlert。用 IMG 標籤建立的那個可以傳入參數並顯示圖片名稱;用 Image 建構函式建立的那個只能指定函式名稱、無法傳參數,因此訊息中不含圖片名。
<SCRIPT>
imageA = new Image(50, 50)
imageA.onload = displayAlert
imageA.src = "cyanball.gif"
function displayAlert(theImage) {
if (theImage == null) {
alert('An image loaded')
} else {
alert(theImage.name + ' has been loaded.')
}
}
</SCRIPT>
<IMG NAME="imageB" SRC="greenball.gif" ALIGN="top" onLoad="displayAlert(this)"><BR>
<SCRIPT>
var cycles = 0
</SCRIPT>
<IMG ALIGN="top" SRC="birdie.gif" BORDER=0 onLoad="++cycles">
<INPUT TYPE="button" VALUE="Count Loops"
onClick="alert('The animation has looped ' + cycles + ' times.')">
這個範例用 onLoad 輪流播放六個 GIF。文件載入時顯示 !anim0.gif,該動畫播完觸發 onLoad,載入 !anim1.gif 取代前者,以此類推;播完最後一個後回到第一個。
注意 changeAnimation 並沒有呼叫自己——因為改變 src 屬性時,圖片的 onLoad 就會自動被觸發,函式自然會再被呼叫一次。這是範例最巧妙的地方,也是最容易寫成無限遞迴的地方。
<SCRIPT>
var whichImage = 0
var maxImages = 5
function changeAnimation(theImage) {
++whichImage
if (whichImage <= maxImages) {
var imageName = "!anim" + whichImage + ".gif"
theImage.src = imageName
} else {
whichImage = -1
return
}
}
</SCRIPT>
<IMG NAME="changingAnimation" SRC="!anim0.gif" BORDER=0 ALIGN="top"
onLoad="changeAnimation(this)">
實務提醒:現代開發中,window 的載入事件請用 window.addEventListener('load', fn);若只是要盡早操作 DOM,用 DOMContentLoaded 會比 load 快得多(不必等圖片下載完)。另外 Layer 是 Netscape 的私有概念,已不復存在。