多個輸入框(如「郵寄地址」與「帳單地址」勾選同步、「確認密碼」實時校驗)需要保持值實時一致。
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;
}
});
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 2/3 | 雙向綁定同一 ref | <input v-model="sharedVal"> <input v-model="sharedVal"> |
| React | 受控組件共享 state | const [val, setVal] = useState(''); <input value={val} onChange={e=>setVal(e.target.value)} /> x2 |
| Angular | ngModel 綁定同一屬性 | <input [(ngModel)]="model.val"> x2 |
框架層面通過單一數據源天然解決同步問題,jQuery 場景下需手動維護同步邏輯。
輸入框同步看似簡單,實則涉及光標保持、遞歸防護、事件類型選擇、值轉換擴展等工程細節。推薦使用封裝好的 $.fn.syncInputs 或原生 syncInputs 工具函數,配置化滿足各種業務變體(前綴保留、格式轉換、條件同步)。避免直接複製「一行代碼」到生產環境,造成用戶輸入體驗下降。