萬盛學電腦網

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

jQuery val() 與 attr('value') 賦值差異深度解析

現象回顧

在專案中遇到一個經典坑:後端渲染的表單頁面,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 值

核心概念:Attribute vs Property

  • Attribute:HTML 標籤上寫死的屬性(<input value="初始">),對應 defaultValue,可用 getAttribute/setAttribute 存取。
  • Property:DOM 節點在記憶體中的即時屬性(input.value),反映當前使用者看到/編輯的值,表單提交時瀏覽器讀取的是 property。
  • 使用者輸入時,property 變化,attribute 不變(除非手動 setAttribute)。

jQuery 版本演進

  • jQuery < 1.6:.attr() 混雜處理 attribute/property,行為模糊。
  • jQuery 1.6+:明確分離 .prop()(property)與 .attr()(attribute)。.val() 內部使用 .prop()。
  • 現代最佳實踐:統一使用 .val() 讀寫表單控件值,它正確操作 property,符合表單提交機制。

為何舊代碼在 Chrome 失效?

早期 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>

總結

  1. 讀寫表單值請永遠用 .val(),它操作 property,符合表單提交標準。
  2. 僅在需讀取/修改「初始 HTML 屬性」(如 defaultValue、placeholder、自定義 attribute)時使用 .attr()。
  3. 避免直接用 .attr('value', ...) 設定當前值,會造成 attribute/property 不一致,導致後續 .val() 讀取混淆。
  4. 現代瀏覽器(含 Chrome)已修正早期同步問題,只要正確使用 .val() 即可跨瀏覽器一致。
copyright © 萬盛學電腦網 all rights reserved