在 ASP.NET Web Forms 中,若 TextBox 的 Tab 順序在提交按鈕之前,游標停在文字框裡按 Enter,瀏覽器會自動把焦點移到後面的按鈕並觸發它的點擊事件。這是多數情況下的預期行為。
但在某些宿主環境(例如嵌入在 Lync 用戶端中的 Web 頁面)裡,這個自動轉焦點的行為會失效,Enter 按下去什麼也不發生。
更棘手的是,伺服端的 TextBox 控制項並未提供 OnKeyPress 或 OnKeyDown 這類事件,無法直接在後端攔截回車並呼叫 Button 的點擊事件。
於是目標變成兩件事:在 TextBox 的回車事件中執行 JavaScript,以及在同一個事件中觸發伺服端 Button 的點擊。
protected void Page_Load(object sender, EventArgs e)
{
MessageTxt.Attributes.Add("onkeypress", "EnterTextBox()");
MessageTxt.Attributes.Add("onkeydown", "EnterTextBox()");
}
在 Page_Load 中用 Attributes.Add 把前端事件掛上去,是 Web Forms 中處理這類需求最標準的做法。
<script language="javascript">
function EnterTextBox() {
// 按下回車,且文本框有值
if (event.keyCode == 13 && document.all["MessageTxt"].value != "") {
$("#<%=hidKeywords.ClientID%>").val(
$("#<%=MessageTxt.ClientID%>").val().replace(/[^\u0000-\u00FF]/g, function ($0) {
return escape($0).replace(/(%u)(\w{4})/gi, "$2;");
})
);
}
}
</script>
這段程式把中文等全形字元轉為 XML 實體,常見於需要把中文塞進 URL 或 XML 屬性值的場合。
<script language="javascript">
function EnterTextBox() {
// 注意:必須用原生 DOM 取得按鈕,jQuery 選到的物件沒有 click() 以外的行為差異,
// 但這裡刻意用 getElementById 配合 ClientID,最保險
var button = document.getElementById('<%=btnSearch.ClientID%>');
if (event.keyCode == 13) {
button.click();
event.returnValue = false; // 阻止瀏覽器自己的預設送出,避免觸發兩次
}
}
</script>
event.returnValue = false 這一句不可省。少了它,瀏覽器可能既執行 button.click() 又自行送出表單,導致查詢跑兩次。
event 是 IE 的全域物件,不是標準。請把事件物件當參數傳入並改用 e.key:
function EnterTextBox(e) {
e = e || window.event;
if (e.key === 'Enter' || e.keyCode === 13) {
document.getElementById('<%=btnSearch.ClientID%>').click();
e.preventDefault();
return false;
}
}
然後在註冊時寫成 Attributes.Add("onkeydown", "EnterTextBox(event)")。
document.all 也不是標準 API。它是 IE 的遺留物,請一律改用 getElementById。
只掛一個事件就好。原範例同時註冊 onkeypress 與 onkeydown,兩個都會被觸發,等於同一段邏輯跑兩遍。選 onkeydown 即可,它對所有按鍵都會觸發,時序也更早。
Server-side 的替代方案。Web Forms 其實有內建機制:把 TextBox 與 Button 包在同一個 <asp:Panel> 裡並設定 DefaultButton,或用 <form defaultbutton>,瀏覽器就會自動把 Enter 導向該按鈕,一行 JavaScript 都不必寫。若宿主環境的問題是「焦點轉移失效」,Panel 方案通常也能解決,值得優先嘗試。