近期在製作一個影片播放頁面時用到了 HTML5 的 <video> 物件。這個元素支援多種格式的線上播放,也對應了一整套事件,可以透過 JavaScript 控制播放流程。問題出在 ontimeupdate 這個事件上——在 Chrome 裡掛不上去。
timeupdate 事件會隨播放進度持續觸發,回報目前的播放位置。除了單純顯示進度,實務上常見的用法還包括:
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<title>Video Timeupdate Demo</title>
<script type="text/javascript">
function timeUpdate() {
document.getElementById('time').innerHTML = video.currentTime;
}
function durationChange() {
document.getElementById('duration').innerHTML = video.duration;
}
function seekVideo() {
document.getElementById('video').currentTime =
document.getElementById('seekText').value;
}
window.onload = function () {
var videoPlayer = document.getElementById('video');
videoPlayer.ontimeupdate = function () { timeUpdate(); };
};
</script>
</head>
<body>
<div>
<video id="video" controls="controls"
poster="./images/videoground1.png"
src="./videoSource/video1.mp4"
width="450" height="320"
ondurationchange="durationChange()"></video>
</div>
<div>
Time: <span id="time">0</span> of <span id="duration">0</span> seconds.
</div>
<div>
<input type="text" id="seekText" />
<input type="button" id="seekBtn" value="Seek Video" onclick="seekVideo();" />
</div>
</body>
</html>
原本直覺的寫法是這樣:
video.ontimeupdate = function () { getCurrentVideoPosition(); };
但這行在 Chrome 上不會觸發。解法是改用 addEventListener 註冊:
videoPlayer.addEventListener('timeupdate', function () {
getCurrentVideoPosition();
}, false);
這個現象背後有兩個原因疊在一起。
第一,ontimeupdate 這種「on- 開頭的屬性」是早期 DOM Level 0 留下的寫法,屬於事件處理屬性(event handler attribute)。並非所有事件在每個瀏覽器上都有對應的屬性實作,Chrome 對 timeupdate 就沒有提供這個快捷入口,因此指派上去只是替元素加了一個普通屬性,瀏覽器完全不會理會。
第二,addEventListener 是 DOM Level 2 之後的標準事件模型,走的是統一的註冊機制,與是否有 on- 屬性無關。它同時也是唯一支援為同一事件掛多個監聽器的方式——用 on- 屬性指派,後掛的會直接覆蓋前面的。
所以結論很清楚:addEventListener 不只相容 Chrome,在 IE(9 以後)、Firefox、Safari 上也都支援,是更值得養成的習慣。順帶一提,範例中 innerHtml 也是錯的,正確的屬性名是 innerHTML(大小寫有別),這裡一併修正了。
遇到「事件掛不上去」這類問題,先別急著懷疑 API 有 bug。可以依序檢查:屬性名是否拼對、事件名是否正確(timeupdate 而非 ontimeupdate,因為 addEventListener 不接受 on- 前綴)、以及元素是否已經存在於 DOM 中。改用 addEventListener 之後,這類跨瀏覽器的疑慮基本就能消除。