「在輸入框按 Enter 就送出表單」是使用者預設會有的期待,但瀏覽器的鍵盤事件模型差異,讓這個看似基本的功能經常出錯。本文整理原生 JS 與 jQuery 兩種做法,並說明差異的根源。
<script language="javascript">
function keypress(e)
{
var currKey=0,e=e||event;
if(e.keyCode==13)document.myform.submit();
}
document.onkeypress=keypress;
</script>
關鍵是 e=e||event 這一句:Firefox 把事件物件作為參數傳入,IE 則放在 window.event。用邏輯或的短路特性,一次就解決了兩邊的差異。
<script>
document.onkeydown=function(event)
{
e = event ? event :(window.event ? window.event : null);
if(e.keyCode==13){
//執行的方法
alert('回車檢測到了');
}
}
</script>
這裡改成 keydown,並用三元運算子做同樣的事。差別在於:keydown 對功能鍵(Enter、Esc、方向鍵、F1–F12)支援最完整,而 keypress 在 IE 中根本不會為功能鍵觸發——這點後文會再展開。
$(document).ready(function(){
$("按下回車的控件").keydown(function(e){
var curKey = e.which;
if(curKey == 13){
$("#回車事件按鈕控件").click();
return false;
}
});
});
jQuery 已經幫你把 event 物件正規化了,直接用 e.which 即可,不必再寫相容判斷。注意最後的 return false 同時做了兩件事:阻止事件冒泡並取消預設行為,避免 Enter 觸發額外的送出動作。
$(document).keydown(function(event) {
if (event.keyCode == 13) {
$('form').each(function() {
//你的要運行的代碼
});
}
});
如果能改用 submit 類型的按鈕,就不用看以下程式碼了——submit 天生就有 Enter 觸發的能力。但在無法使用 submit 的情況下,可以這樣做(需先引入 jQuery):
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml" >
<head>
<title>火狐和IE都支持的enter事件</title>
<script src="jquery.1.3.2.js" type="text/javascript" language="javascript"></script>
<script type="text/javascript">
document.onkeydown = function (e) {
var theEvent = window.event || e;
var code = theEvent.keyCode || theEvent.which;
if (code == 13) {
$("#but1").click();
}
}
$(document).ready(function () {
$("#but1").click(function () {
alert("我是enter事件," + "text值:" + $("#text1").val());
})
$("#but2").click(function () {
alert("我是Jquery事件" + "text值:" + $("#text1").val());
})
});
</script>
這裡的 window.event || e 加 keyCode || which 是雙重保險:先取得事件物件,再依瀏覽器提供哪個屬性取值。
作者最初寫的是:
<script language="javascript">
function document.onkeypress()
{
if(event.keyCode==13)document.myloginform.submit();
}
</script>
Firefox 直接報錯:missing ( before formal parameters——因為 document.onkeypress 是屬性而非函式名稱,不能這樣宣告。
改成:
<script language="javascript">
document.onkeypress=function()
{
if(event.keyCode==13)document.myloginform.submit();
}
</script>
又得到 event is not defined——因為函式沒有參數,Firefox 下拿不到 event。這兩個錯誤合起來說明了一件事:事件處理函式必須保留參數,並在函式內做 e || window.event 的正規化。
瀏覽器提供三種按鍵事件,對應 onkeydown、onkeypress、onkeyup。一次完整的按鍵會依序觸發 keydown → keypress → keyup。
其中 keydown 與 keyup 較「低階」,keypress 較「高階」:按下 Shift + 1 時,keypress 會回傳解析後的可列印字元 !,而 keydown / keyup 只記錄了「Shift + 1」這個動作。
但這裡有個關鍵差異:keypress 只對可列印字元有效。對於 F1–F12、Backspace、Enter、Escape、PageUp、PageDown、方向鍵等功能鍵,IE 不會觸發 keypress,只會觸發 keydown 與 keyup。而在 Firefox 中,功能鍵是可以觸發 keypress 的。這就是為什麼單用 keypress 攔 Enter 會在 IE 失效。
若 Alt、Ctrl、Shift 與按鍵同時按下,可透過事件的 altKey、ctrlKey、shiftKey 屬性判斷,這三個屬性在 Firefox 與 IE 中是通用的。
Firefox 與 Opera 的處理函式有一個隱藏參數,慣例用 e 表示,鍵值存在 e.which,轉成字元則用靜態方法:
function keyDown(e) {
var keycode = e.which;
var realkey = String.fromCharCode(e.which);
alert("按鍵碼: " + keycode + " 字符: " + realkey);
}
document.onkeydown = keyDown;
function keyDown() {
var keycode = event.keyCode;
var realkey = String.fromCharCode(event.keyCode);
alert("按鍵碼: " + keycode + " 字符: " + realkey);
}
document.onkeydown = keyDown;
用 navigator.appName 判斷是最直觀的方式(IE 與 Maxthon 回傳 "Microsoft Internet Explorer",Firefox 與 Opera 回傳 "Netscape"):
function keyUp(e) {
if(navigator.appName == "Microsoft Internet Explorer")
{
var keycode = event.keyCode;
var realkey = String.fromCharCode(event.keyCode);
}else
{
var keycode = e.which;
var realkey = String.fromCharCode(e.which);
}
alert("按鍵碼: " + keycode + " 字符: " + realkey);
}
document.onkeyup = keyUp;
不過更簡潔(也更推薦)的做法是特性偵測而非瀏覽器嗅探:
function keyUp(e) {
var currKey=0,e=e||event;
currKey=e.keyCode||e.which||e.charCode;
var keyName = String.fromCharCode(currKey);
alert("按鍵碼: " + currKey + " 字符: " + keyName);
}
document.onkeyup = keyUp;
兩行的原理:e=e||event 處理事件物件的取得差異;e.keyCode||e.which||e.charCode 則依瀏覽器實際提供哪個屬性取值。這比判斷瀏覽器名稱可靠得多,因為它測試的是「能力」而非「身分」。
按鍵事件的鍵碼在不同瀏覽器、不同事件類型下的存放位置並不一致:
keyCode,且含義依事件而異——keydown 存按鍵碼,keypress 存字元碼。which 與 charCode 永遠是 undefined。keyCode 恆為 0。keydown / keyup 時 charCode 為 0、which 為按鍵碼;keypress 時 which 與 charCode 數值相同,存的是字元碼。keyCode 與 which 恆相同——keydown / keyup 時存按鍵碼,keypress 時存字元碼。charCode 未定義。實務結論:keydown 對功能鍵最有用,keypress 對可列印字元最有用。因此合理策略是用 keypress 取字元、用 keydown 補功能鍵。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><TITLE>js 按鍵記錄</TITLE>
<META NAME="Generator" CONTENT="EditPlus">
<META NAME="Author" CONTENT="羽殇仁">
<META NAME="Keywords" CONTENT="js 按鍵記錄">
<META NAME="Description" CONTENT="js 按鍵記錄">
</HEAD>
<BODY>
<script type="text/javascript">
var keystring = "";//記錄按鍵的字符串
function $(s){return document.getElementById(s)?document.getElementById(s):s;}
function keypress(e)
{
var currKey=0,CapsLock=0,e=e||event;
currKey=e.keyCode||e.which||e.charCode;
CapsLock=currKey>=65&&currKey<=90;
switch(currKey)
{
//屏蔽了退格、制表、回車、空格、方向鍵、刪除鍵
case 8: case 9:case 13:case 32:case 37:case 38:case 39:case 40:case 46:keyName = "";break;
default:keyName = String.fromCharCode(currKey); break;
}
keystring += keyName;
}
function keydown(e)
{
var e=e||event;
var currKey=e.keyCode||e.which||e.charCode;
if((currKey>7&&currKey<14)||(currKey>31&&currKey<47))
{
switch(currKey)
{
case 8: keyName = "[退格]"; break;
case 9: keyName = "[制表]"; break;
case 13:keyName = "[回車]"; break;
case 32:keyName = "[空格]"; break;
case 33:keyName = "[PageUp]"; break;
case 34:keyName = "[PageDown]"; break;
case 35:keyName = "[End]"; break;
case 36:keyName = "[Home]"; break;
case 37:keyName = "[方向鍵左]"; break;
case 38:keyName = "[方向鍵上]"; break;
case 39:keyName = "[方向鍵右]"; break;
case 40:keyName = "[方向鍵下]"; break;
case 46:keyName = "[刪除]"; break;
default:keyName = ""; break;
}
keystring += keyName;
}
$("content").innerHTML=keystring;
}
function keyup(e)
{
$("content").innerHTML=keystring;
}
document.onkeypress=keypress;
document.onkeydown =keydown;
document.onkeyup =keyup;
</script>
<input type="text" />
<input type="button" value="清空記錄" onclick="$('content').innerHTML = '';keystring = '';"/>
<br/>請按下任意鍵查看鍵盤響應鍵值:<span id="content"></span>
</BODY>
</HTML>
程式碼結構:$() 依 id 取元素;keypress 攔截字元碼(並屏蔽功能鍵,因為那些交給 keydown);keydown 負責功能鍵;keyup 更新畫面顯示。
原文最後提到這段程式碼「還可以實現添加剪切板的功能,監控刪除的功能等等」。這裡必須明確說明:在未取得使用者知情的情況下記錄他人按鍵,在大多數國家的法律中屬於違法行為(涉及電腦犯罪、隱私侵害等),也可能違反網站服務條款與個資保護規範。這類程式碼只應應用於正當目的,例如:
另外,這份程式碼本身也有明顯限制:它只能記錄英文字元,對中文無能為力(中文輸入涉及 IME 組字,鍵盤事件拿不到最終字元)。若確實需要取得使用者輸入的中文,應該直接讀取 input 元素的值,並搭配 compositionstart / compositionend 事件處理組字過程。
<script language="javascript">
function keypress(e)
{
var currKey=0,e=e||event;
if(e.keyCode==13)document.myform.submit();
}
document.onkeypress=keypress;
</script>
加上參數 e 與正規化 e=e||event 之後,IE 與 Firefox 都能正常運作。
而在今天的專案裡,最乾淨的答案是:把按鈕改成 type="submit",瀏覽器天生就會處理 Enter 送出,一行 JavaScript 都不用寫。只有在特殊需求(例如同一表單多個送出意圖、Enter 要觸發非送出行為)時,才需要自己攔 keydown。