DIV CSS 佈局教程網

ASP.NET TextBox 註冊回車事件並觸發按鈕點擊
編輯:關於JavaScript     

問題從哪裡來

在 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 中處理這類需求最標準的做法。

二、場景 A:回車時處理頁面元素的值

<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, "&#x$2;");
      })
    );
  }
}
</script>

這段程式把中文等全形字元轉為 XML 實體,常見於需要把中文塞進 URL 或 XML 屬性值的場合。

三、場景 B:回車時觸發伺服端 Button 的點擊

<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 方案通常也能解決,值得優先嘗試。

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