萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 攔截 Enter 鍵提交表單並執行自訂邏輯的標準寫法

核心邏輯

在輸入框 keydown 事件中檢測 event.key === 'Enter' (或 keyCode === 13),執行自訂函式並 阻止預設提交行為 (preventDefault())。

現代標準寫法 (推薦)

// 綁定在表單上,利用事件冒泡統一處理所有輸入框
$('#myForm').on('keydown', 'input, textarea, select', function(e) {
    if (e.key === 'Enter' && e.target.tagName !== 'TEXTAREA') {
        e.preventDefault(); // 關鍵:阻止表單預設提交
        
        // 執行自訂邏輯
        var $field = $(this);
        validateField($field);      // 1. 即時驗證
        moveToNextField($field);    // 2. 焦點移至下一欄 (可選)
        // search();                 // 3. 觸發搜尋/查詢
    }
});

// 輔助函式
function validateField($field) {
    var valid = $field[0].checkValidity(); // HTML5 原生驗證
    $field.toggleClass('is-invalid', !valid);
    return valid;
}

function moveToNextField($current) {
    var $fields = $('#myForm').find('input, select, textarea').filter(':visible:not([readonly])');
    var idx = $fields.index($current);
    if (idx >= 0 && idx < $fields.length - 1) {
        $fields.eq(idx + 1).trigger('focus');
    }
}

舊版相容寫法 (IE8-9)

// 傳統 onkeydown 寫法 (需掛在各 input 上)
function handleEnter(e) {
    e = e || window.event;
    var key = e.which || e.keyCode;
    if (key === 13) {
        e.returnValue = false; // IE 阻止預設
        if (e.preventDefault) e.preventDefault(); // 標準
        
        // 自訂邏輯
        validateInputText('yyyy');
        changeym();
    }
}

// HTML: 

常見場景與對策

場景Enter 行為實作重點
搜尋框觸發搜尋綁定 keydown → preventDefault → search()
多欄位表單跳至下一欄綁定 keydown → preventDefault → focusNext()
可編輯表格進入編輯/儲存當列區分編輯模式與瀏覽模式
聊天輸入框發送訊息 (Shift+Enter 換行)if (e.key==='Enter' && !e.shiftKey) { send(); e.preventDefault(); }
Modal 確認對話框觸發確認按鈕綁定 keydown → $('.btn-confirm').click()

進階:表單級別統一管理

class FormEnterHandler {
    constructor(formSelector, options = {}) {
        this.$form = $(formSelector);
        this.onEnter = options.onEnter || $.noop; // 自訂 Enter 回呼
        this.submitSelector = options.submitSelector || '[type="submit"]';
        this._bind();
    }
    
    _bind() {
        this.$form.on('keydown', 'input, select, textarea', (e) => {
            if (e.key !== 'Enter') return;
            if (e.target.tagName === 'TEXTAREA' && !e.shiftKey) return; // Textarea: Enter換行, Shift+Enter提交
            if ($(e.target).is(this.submitSelector)) return; // 提交按鈕本身不攔截
            
            e.preventDefault();
            this.onEnter(e, $(e.target), this.$form);
        });
        
        // 表單原生提交 (點擊按鈕/JS submit) 仍正常觸發 submit 事件
        this.$form.on('submit', (e) => {
            if (!this.validateAll()) e.preventDefault();
        });
    }
    
    validateAll() {
        var valid = true;
        this.$form.find('[required]').each((i, el) => {
            if (!el.checkValidity()) { $(el).addClass('is-invalid'); valid = false; }
            else $(el).removeClass('is-invalid');
        });
        return valid;
    }
}

// 使用
new FormEnterHandler('#searchForm', {
    onEnter: (e, $field, $form) => $form.trigger('submit') // Enter 直接提交
});

new FormEnterHandler('#editForm', {
    onEnter: (e, $field, $form) => moveToNextField($field) // Enter 跳下一欄
});

無障礙 (a11y) 注意事項

  • 不要在 `