在專案中遇到一個經典坑:後端渲染的表單頁面,input 已有 value 屬性(預設值)。使用 jQuery $('#input').val('新值') 修改後,在 Chrome 中取值 $('#input').val() 正常,但提交表單時後端收到的仍是舊值;IE 則正常。改用 $('#input').attr('value', '新值') 後雙瀏覽器表現一致。
| 方法 | 操作對象 | 影響範圍 | 瀏覽器表現差異 |
|---|---|---|---|
.val(value) |
DOM Property value(即時狀態) |
只修改 JS 屬性,不改變 HTML attribute | Chrome 表單提交取的是 attribute(某些情況),導致不同步;IE 同步較好 |
.attr('value', value) |
HTML Attribute value(初始值) |
修改 attribute,property 會同步更新(輸入框未被使用者編輯前) | 雙瀏覽器一致,但使用者手動修改後,attribute 不再跟隨 property 變化 |
.prop('value', value) 推薦 |
DOM Property value |
標準化 property 操作,jQuery 1.6+ 推薦 | 現代瀏覽器行為一致,表單提交取 property 值 |
<input value="初始">),對應 defaultValue,可用 getAttribute/setAttribute 存取。input.value),反映當前使用者看到/編輯的值,表單提交時瀏覽器讀取的是 property。.attr() 混雜處理 attribute/property,行為模糊。.prop()(property)與 .attr()(attribute)。.val() 內部使用 .prop()。.val() 讀寫表單控件值,它正確操作 property,符合表單提交機制。早期 jQuery 版本或特定瀏覽器(舊 Chrome)在序列化表單(form.serialize()、原生提交)時,可能讀取 attribute 而非 property。此外,若 input 為 type="hidden" 或未渲染完成就賦值,可能觸發瀏覽器同步 bug。解決方案:升級 jQuery、改用 .val()、確保 DOM 就緒後操作。
<input id="test" type="text" value="初始值" />
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
// 測試 val()
$('#test').val('val修改');
console.log('val() 讀取:', $('#test').val()); // "val修改"
console.log('attr value:', $('#test').attr('value')); // "初始值" (attribute 未變)
console.log('prop value:', $('#test').prop('value')); // "val修改"
console.log('DOM value:', document.getElementById('test').value); // "val修改"
// 測試 attr()
$('#test').attr('value', 'attr修改');
console.log('--- attr 後 ---');
console.log('val():', $('#test').val()); // "attr修改" (property 同步)
console.log('attr:', $('#test').attr('value')); // "attr修改"
console.log('prop:', $('#test').prop('value')); // "attr修改"
</script>
.val(),它操作 property,符合表單提交標準。defaultValue、placeholder、自定義 attribute)時使用 .attr()。.attr('value', ...) 設定當前值,會造成 attribute/property 不一致,導致後續 .val() 讀取混淆。.val() 即可跨瀏覽器一致。