萬盛學電腦網

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

jQuery 實現多輸入框實時同步:一行代碼搞定值同步與事件解耦

核心需求

多個輸入框(如「郵寄地址」與「帳單地址」勾選同步、「確認密碼」實時校驗)需要保持值實時一致。

最簡實現(原文方案)

var $inputs = $('.example-input');
$inputs.keyup(function() {
  $inputs.val($(this).val());
});

問題分析與優化

問題原因解決
光標跳亂val() 重置導致光標移至末尾記錄/恢復 selectionStart/End,或用 input 事件+判斷值是否真正變化
遞歸觸發設置 val() 觸發 change/input 事件,再次進入 handler用 .data('syncing', true) 標記或 off/on 暫時解綁
粘貼/拖拽/自動填充不同步僅綁 keyup改用 input 事件(原生支持所有值變化途徑)
性能:頻繁觸發每次按鍵遍歷所有輸入框節流/防抖,或僅同步「值不同」的框

生產級健壯實現

$.fn.syncInputs = function(options) {
  var opts = $.extend({
    event: 'input',           // 監聽事件
    filter: null,             // 可選:值轉換函數 function(val, $source, $target)
    excludeSelf: true         // 是否排除觸發源
  }, options);
  
  var $inputs = this;
  var syncing = false; // 防遞歸標記
  
  $inputs.on(opts.event, function(e) {
    if (syncing) return;
    syncing = true;
    
    var $src = $(this);
    var val = $src.val();
    
    $inputs.each(function() {
      var $tgt = $(this);
      if (opts.excludeSelf && $tgt.is($src)) return;
      
      var newVal = opts.filter ? opts.filter(val, $src, $tgt) : val;
      
      // 僅在值真正不同時更新,避免光標跳動
      if ($tgt.val() !== newVal) {
        // 保存光標位置
        var start = $tgt[0].selectionStart;
        var end = $tgt[0].selectionEnd;
        
        $tgt.val(newVal).trigger('change'); // 觸發 change 供其他監聽器
        
        // 恢復光標(僅當長度未縮短超出原位置)
        if (start <= newVal.length) {
          $tgt[0].setSelectionRange(start, Math.min(end, newVal.length));
        }
      }
    });
    
    syncing = false;
  });
  
  return this; // 鏈式調用
};

// 使用示例
$('#addr1, #addr2, #addr3').syncInputs();

// 進階:同步但保留各自前綴
$('#prefix1, #prefix2').syncInputs({
  filter: function(val, $src, $tgt) {
    var prefix = $tgt.data('prefix') || '';
    return prefix + val;
  }
});

原生 JavaScript 版(零依賴)

function syncInputs(selector, options) {
  const inputs = Array.from(document.querySelectorAll(selector));
  const { filter = null, event = 'input' } = options || {};
  let syncing = false;
  
  const handler = (e) => {
    if (syncing) return;
    syncing = true;
    const src = e.target;
    const val = src.value;
    
    inputs.forEach(tgt => {
      if (tgt === src) return;
      const newVal = filter ? filter(val, src, tgt) : val;
      if (tgt.value !== newVal) {
        const start = tgt.selectionStart;
        const end = tgt.selectionEnd;
        tgt.value = newVal;
        tgt.dispatchEvent(new Event('input', { bubbles: true }));
        if (start <= newVal.length) {
          tgt.setSelectionRange(start, Math.min(end, newVal.length));
        }
      }
    });
    syncing = false;
  };
  
  inputs.forEach(el => el.addEventListener(event, handler));
  
  return () => inputs.forEach(el => el.removeEventListener(event, handler)); // 返回銷毀函數
}

// 使用
const destroy = syncInputs('.sync-group', {
  filter: (val, src, tgt) => (tgt.dataset.prefix || '') + val
});

Vue/React 框架模式對比

框架模式核心代碼
Vue 2/3雙向綁定同一 ref<input v-model="sharedVal"> <input v-model="sharedVal">
React受控組件共享 stateconst [val, setVal] = useState(''); <input value={val} onChange={e=>setVal(e.target.value)} /> x2
AngularngModel 綁定同一屬性<input [(ngModel)]="model.val"> x2

框架層面通過單一數據源天然解決同步問題,jQuery 場景下需手動維護同步邏輯。

總結

輸入框同步看似簡單,實則涉及光標保持、遞歸防護、事件類型選擇、值轉換擴展等工程細節。推薦使用封裝好的 $.fn.syncInputs 或原生 syncInputs 工具函數,配置化滿足各種業務變體(前綴保留、格式轉換、條件同步)。避免直接複製「一行代碼」到生產環境,造成用戶輸入體驗下降。

copyright © 萬盛學電腦網 all rights reserved