DIV CSS 佈局教程網

setTimeout() 用法詳解:參數、計時器與帶參呼叫的正確寫法
編輯:關於JavaScript     

setTimeout() 是最常被使用、也最常被用錯的 API 之一。特別是「想傳參數給計時器裡的函式」這件事,寫錯了會靜默失效,很難 debug。本文從一個計時器範例出發,把用法與陷阱一次講完。

範例:一個可開始、可停止的秒錶

效果圖:

 <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312" />
<title>setTimeout 計時器</title>
<script type="text/javascript">
var timer;      // 計時器識別碼,宣告在全域以便 stop 使用
var i = 0;      // 已經過的秒數

// 開始計時
function start() {
    var obj = document.getElementById("result");
    var str = "該程序已經運行了" + i + "秒!";
    i++;                        // 等價於 i = i + 1
    obj.value = str;            // 表單元素的內容用 value 寫入

    // 10 毫秒後再次呼叫自己,形成循環
    timer = window.setTimeout("start()", 10);
}

// 停止計時
function stop() {
    window.clearTimeout(timer);
}
</script>
</head>
<body>
<input type="button" id="result" value="該程序已經運行了0秒!" /><br />
<input type="button" onclick="start()" value="開始" />
<input type="button" onclick="stop()" value="停止" />
</body>
</html> 

這裡有兩個實務要點。第一,timer 必須存在外層。如果宣告在 start() 內部,stop() 就拿不到它的識別碼,無從取消。第二,寫入內容的方式取決於元素類型。表單元素用 value,其餘標記用 innerHTML,兩者不能混用。

參數說明

setTimeout(code, millisec) 有兩個必要參數:

code:要執行的函式,或一段 JavaScript 程式碼字串。

millisec:執行前的等待毫秒數。

請記住:setTimeout 只執行一次。若要重複執行,得用 setInterval(),或像上面範例那樣讓 code 自己再呼叫一次 setTimeout。這也是為什麼「計時器」通常要自己接成迴圈。

一個 5 秒後跳提示的小例子

 <html>
<head>
<script type="text/javascript">
function timedMsg() {
    var t = setTimeout("alert('5 seconds!')", 5000);
}
</script>
</head>
<body>
<form>
<input type="button" value="Display timed alert box!" onClick="timedMsg()">
</form>
<p>Click on the button above. An alert box will be displayed after 5 seconds.</p>
</body>
</html> 

帶入參數:最容易寫錯的地方

假設訊息存在一個變數裡,希望 1 秒後跳出來:

 var msg = '1s has passed!'; 

這兩種寫法都不會如 your 預期:

 setTimeout(alert(msg), 1000);   // alert(msg) 會被立即執行,計時形同虛設
setTimeout("alert(msg)", 1000); // 報錯 msg is not defined 

原因值得說明。計時器會努力把你的 code 轉換成一個函式物件:第一種寫法裡,alert(msg) 在傳参當下就已經被執行並回傳 undefined,計時器拿到的是空東西;第二種寫法雖然成功包裝出函式,但字串形式的程式碼是在全域作用域中被求值的,那時候它看不到區域的 msg,於是報未定義。

推薦的解法是傳入匿名函式:

 var msg = '1s has passed!';
setTimeout(function () {
    alert(msg);
}, 1000);

這樣第一個參數是一個真正的函式物件,它透過閉包持有 msg 的參考,帶參問題自然解決。如果有多個參數要傳,也可以利用第三個起的額外參數:setTimeout(fn, 1000, arg1, arg2)(舊版 IE 不支援,需要時可改用 fn.bind(null, arg1, arg2))。

順帶一提:一個每秒刷新的時鐘

 function clockon(bgclock) {
    var now = new Date();
    var year = now.getFullYear();
    var month = now.getMonth() + 1;
    var date = now.getDate();
    var day = now.getDay();
    var hour = now.getHours();
    var minu = now.getMinutes();
    var sec = now.getSeconds();

    // 補零,讓 9 顯示成 09
    if (month < 10) month = "0" + month;
    if (date < 10) date = "0" + date;
    if (hour < 10) hour = "0" + hour;
    if (minu < 10) minu = "0" + minu;
    if (sec < 10) sec = "0" + sec;

    var week;
    switch (day) {
        case 1: week = "星期一"; break;
        case 2: week = "星期二"; break;
        case 3: week = "星期三"; break;
        case 4: week = "星期四"; break;
        case 5: week = "星期五"; break;
        case 6: week = "星期六"; break;
        default: week = "星期日"; break;
    }

    var time = year + "年" + month + "月" + date + "日" + week + " " + hour + ":" + minu + ":" + sec;
    if (document.all) {
        bgclock.innerHTML = "系統公告:[" + time + "]";
    }
    // 200 毫秒後再次呼叫自己,維持連續更新
    var timer = setTimeout("clockon(bgclock)", 200);
} 

注意 getMonth() 回傳的是 0 到 11,所以必須加一才是人類看懂的月份;getDay() 回傳 0 代表星期日,因此 switch 的 default 落在週日上。這些零起的索引是日期處理中最常見的疏漏來源。

總結一句:setTimeout 只跑一次,需要循環就自己接;要帶參數就傳函式,不要傳字串。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved