萬盛學電腦網

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

JavaScript 控制輸入框字符類型完全指南:正則實時過濾方案

核心原理:input 事件 + 正則替換

在 <input> 上監聽 input 事件(兼容性優於 keyup,支持粘貼、拖拽、輸入法合成),用正則將非法字符替換為空串:

<input 
  oninput="value=value.replace(/[^允許字符正則]/g, '')" 
  onpaste="setTimeout(()=>value=value.replace(/[^允許字符正則]/g, ''), 0)">

關鍵點:onpaste 需 setTimeout 待瀏覽器完成粘貼後再過濾;oninput 已涵蓋鍵盤輸入、拖拽、自動填充等所有值變化途徑。

常用字符集正則速查表

需求正則字符類完整 oninput 代碼
僅數字0-9 或 \doninput="value=value.replace(/[^\d]/g,'')"
數字 + 小數點0-9.oninput="value=value.replace(/[^0-9.]/g,'')"
僅英文字母a-zA-Zoninput="value=value.replace(/[^a-zA-Z]/g,'')"
英文 + 數字a-zA-Z0-9oninput="value=value.replace(/[^a-zA-Z0-9]/g,'')"
僅中文\u4E00-\u9FA5oninput="value=value.replace(/[^\u4E00-\u9FA5]/g,'')"
中文 + 英文 + 數字a-zA-Z0-9\u4E00-\u9FA5oninput="value=value.replace(/[^a-zA-Z0-9\u4E00-\u9FA5]/g,'')"
中英數 + 空格a-zA-Z0-9\u4E00-\u9FA5\soninput="value=value.replace(/[^a-zA-Z0-9\u4E00-\u9FA5\s]/g,'')"
中英數 + 小數點a-zA-Z0-9\u4E00-\u9FA5.oninput="value=value.replace(/[^a-zA-Z0-9\u4E00-\u9FA5.]/g,'')"
自定義:中英數 + @ + .a-zA-Z0-9\u4E00-\u9FA5@.oninput="value=value.replace(/[^a-zA-Z0-9\u4E00-\u9FA5@.]/g,'')"

進階場景:小數位數限制(金額輸入)

<input type="text" 
  oninput="value=value.replace(/[^\d.]/g,'').replace(/^(\d*\.\d{2}).*/,'$1').replace(/\.{2,}/g,'.')"
  placeholder="最多兩位小數">

邏輯鏈:

  1. [^\d.] 只保留數字和點
  2. ^(\d*\.\d{2}).* 捕獲「整數部分.兩位小數」,其餘截斷
  3. \.{2,} 多點合併為單點

禁止右鍵菜單與粘貼(按需使用)

<input 
  oncontextmenu="return false" 
  onpaste="return false"
  oninput="...">

警告:這會嚴重損害用戶體驗(無法複製粘貼長郵箱/地址),極不推薦常規業務使用,僅限極高安全要求場景(如密碼輸入框)。

現代最佳實踐:指令/組件封裝

Vue 2/3 指令

// v-filter="regex" 或 v-filter="[regex, maxLen]"
app.directive('filter', {
  mounted(el, binding) {
    const regex = Array.isArray(binding.value) ? binding.value[0] : binding.value;
    const maxLen = Array.isArray(binding.value) ? binding.value[1] : null;
    
    el.addEventListener('input', () => {
      let val = el.value.replace(regex, '');
      if (maxLen && val.length > maxLen) val = val.slice(0, maxLen);
      if (val !== el.value) el.value = val;
      el.dispatchEvent(new Event('input')); // 觸發 v-model 更新
    });
  }
});

// 使用
<input v-model="amount" v-filter="[/^\\d*\\.?\\d{0,2}$/, 10]">

React 受控組件模式

function FilteredInput({ pattern, maxLength, value, onChange, ...props }) {
  const handleChange = (e) => {
    let val = e.target.value.replace(pattern, '');
    if (maxLength && val.length > maxLength) val = val.slice(0, maxLength);
    onChange(val);
  };
  return <input value={value} onChange={handleChange} {...props} />;
}

// 使用
<FilteredInput 
  pattern={/[^a-zA-Z0-9\u4E00-\u9FA5]/g} 
  maxLength={20}
  value={form.name}
  onChange={v => setForm({...form, name: v})}
/>

原生 JS 通用工具函數

function createInputFilter(inputEl, options) {
  const { 
    pattern = /[^\d]/g,      // 預設只能輸入數字
    maxLength = null,
    onChange = null 
  } = options || {};
  
  const filter = () => {
    let val = inputEl.value.replace(pattern, '');
    if (maxLength && val.length > maxLength) val = val.slice(0, maxLength);
    if (val !== inputEl.value) {
      inputEl.value = val;
      if (onChange) onChange(val);
    }
  };
  
  inputEl.addEventListener('input', filter);
  inputEl.addEventListener('paste', () => setTimeout(filter, 0));
  
  // 返回銷毀函數
  return () => {
    inputEl.removeEventListener('input', filter);
    inputEl.removeEventListener('paste', filter);
  };
}

// 使用
const destroy = createInputFilter(document.getElementById('phone'), {
  pattern: /[^\d]/g,
  maxLength: 11
});

避坑指南

  1. 輸入法合成事件:中文輸入法拼音階段會觸發 input,直接替換會打斷輸入。解決:監聽 compositionstart/end 標記合成狀態,合成期間跳過過濾。
  2. type="number" 原生步長限制:<input type="number" step="0.01"> 配合 inputmode="decimal" 可獲取原生數字鍵盤,但無法完全禁止字母輸入(需 JS 輔助)。
  3. 無障礙訪問:oncontextmenu="return false" 會阻礙屏幕閱讀器右鍵功能,違反 WCAG。
  4. 性能:極長字符串(萬字級)頻繁 replace 會卡頓,考慮 requestAnimationFrame 節流或 Web Worker 離屏處理。

總結

「正則替換 + input 事件」是控制輸入字符類型最通用、兼容性最好的方案。通過封裝為指令/組件/工具函數,可在 Vue/React/原生項目中複用。務必克制「禁用粘貼/右鍵」的衝動,優秀的輸入體驗應當是:允許自由輸入,實時智能過濾,錯誤友好提示。

copyright © 萬盛學電腦網 all rights reserved