萬盛學電腦網

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

JavaScript 全方位過濾輸入特殊字元:鍵盤、貼上、拖曳事件整合

需求場景

檔案/資料夾命名、表單輸入限制,需攔截鍵盤輸入、貼上、拖曳放入三種途徑的非法字元:/ \ : * ? " < > | & ,。

統一驗證核心

// 非法字元正則(根據需求調整)
const FORBIDDEN_REGEX = /[\\/:*?"<>|&,]/; // 需轉義 \ ] ^ $ 等

function getErrorMessage(lang = "zh-TW") {
    return lang === "zh-TW"
        ? "名稱不能包含:/ \\ : * ? \" < > | & ,"
        : "Name cannot contain: / \\ : * ? \" < > | & ,";
}

事件綁定策略

function bindInputFilter(inputEl, options = {}) {
    const {lang = "zh-TW", onInvalid = () => {}} = options;

    // 1. 鍵盤輸入:keydown 攔截字元鍵
    inputEl.addEventListener("keydown", e => {
        // 忽略控制鍵
        if (e.key.length > 1 && !e.key.startsWith("Dead")) return; // Backspace, Enter, Arrow 等
        if (e.ctrlKey || e.metaKey || e.altKey) return; // 組合鍵

        if (FORBIDDEN_REGEX.test(e.key)) {
            e.preventDefault();
            onInvalid(e.key, "keydown");
        }
    });

    // 2. 輸入法合成中文/日文等:compositionend 時檢查最終字串
    inputEl.addEventListener("compositionend", e => {
        if (FORBIDDEN_REGEX.test(e.data)) {
            // 移除非法字元
            inputEl.value = inputEl.value.replace(FORBIDDEN_REGEX, "");
            onInvalid(e.data, "composition");
        }
    });

    // 3. 貼上:clipboardData
    inputEl.addEventListener("paste", e => {
        const text = e.clipboardData.getData("text");
        if (FORBIDDEN_REGEX.test(text)) {
            e.preventDefault();
            // 可選:清理後貼上
            const clean = text.replace(FORBIDDEN_REGEX, "");
            document.execCommand("insertText", false, clean); // 或手動插入
            onInvalid(text, "paste");
        }
    });

    // 4. 拖曳放入:DataTransfer
    inputEl.addEventListener("drop", e => {
        e.preventDefault(); // 防止瀏覽器預設導向/打開檔案
        const text = e.dataTransfer.getData("text");
        if (FORBIDDEN_REGEX.test(text)) {
            onInvalid(text, "drop");
            return;
        }
        // 允許:手動插入或讓瀏覽器處理(需手動處理插入點)
        const start = inputEl.selectionStart;
        const end = inputEl.selectionEnd;
        inputEl.value = inputEl.value.slice(0, start) + text + inputEl.value.slice(end);
        inputEl.setSelectionRange(start + text.length, start + text.length);
    });

    // 5. 輸入後最終防線(防繞過)
    inputEl.addEventListener("input", () => {
        if (FORBIDDEN_REGEX.test(inputEl.value)) {
            inputEl.value = inputEl.value.replace(FORBIDDEN_REGEX, "");
            onInvalid(inputEl.value, "input-sanitize");
        }
    });
}

使用範例

<input type="text" id="folderName" placeholder="資料夾名稱">
<div id="errorMsg" style="color:red; display:none; font-size:12px;"></div>

<script>
const input = document.getElementById("folderName");
const errEl = document.getElementById("errorMsg");

bindInputFilter(input, {
    lang: "zh-TW",
    onInvalid: (char, source) => {
        errEl.textContent = `偵測到非法字元 (${source}):${char} — 已自動移除`;
        errEl.style.display = "block";
        setTimeout(() => errEl.style.display = "none", 3000);
    }
});
</script>

進階:表單提交前二次驗證

form.addEventListener("submit", e => {
    const inputs = form.querySelectorAll("input[required], textarea[required]");
    for (const input of inputs) {
        if (FORBIDDEN_REGEX.test(input.value)) {
            e.preventDefault();
            alert("欄位包含非法字元:" + input.name);
            input.focus();
            return;
        }
    }
});

注意事項

  • execCommand("insertText") 已棄用但廣泛支援;新標準為 InputEvent / beforeinput 事件(支援度逐漸提升)。
  • 中文輸入法組合期間 keydown 不會觸發字元鍵,必須靠 compositionend + input 事件。
  • drop 事件必須 preventDefault(),否則瀏覽器可能導向檔案/連結。
  • 正則中 - 在字元類別中間需轉義或放首尾,避免被解讀為範圍。
copyright © 萬盛學電腦網 all rights reserved