這個問題困擾過很多 jQuery 使用者:明明有 html() 與 text(),為什麼沒有 outerHTML()?
差別在於範圍。html() 取得的是「該元素內部」的 HTML,不包含元素本身的標籤;而我們有時候需要的是「連標籤一起」的內容。原生 DOM 其實早就提供了 outerHTML 這個屬性(注意大小寫,JavaScript 是分得清楚大小寫的),所以只要透過 jQuery 的 prop() 就能讀寫它。
<div class="test"><p>hello,你好!</p></div>
<script>
$(".test").prop("outerHTML");
// => '<div class="test"><p>hello,你好!</p></div>'
</script>
對照之下,$(".test").html() 只會得到 <p>hello,你好!</p>,外層的 div 不在其中。
$('.test').prop('outerHTML', '<input>');
這行會把整個 .test 元素從文件上換成一個 <input>。要注意的是,替換之後原本 jQuery 物件裡參照的節點已經脫離文件了,後續若再用 $('.test') 會找不到東西,這是設定 outerHTML 與設定 innerHTML 最直觀的差異。
主要是因為 outerHTML 的語意容易誤用。替換元素本身牽涉到事件綁定、資料快取、以及父節點的參照,行為比單純改內部內容複雜許多;jQuery 刻意不包裝它,某種程度上是在避免使用者誤踩。官方的一貫建議是:需要替換元素時,用 replaceWith() 或 replaceWithAll(),語意明確且不會留下懸空參照。
$('.test').replaceWith('<input>');
至於讀取用途,prop('outerHTML') 是現成可用的;若你的專案還在支援很舊的環境,也可以退回使用原生 DOM:document.querySelector('.test').outerHTML。
順帶釐清一個常見混淆。attr() 操作的是 HTML 上的屬性字串,prop() 操作的是 DOM 物件的屬性。像 checked、selected、disabled 這類會隨使用者操作而變化的狀態,就該用 prop();而 outerHTML 屬於 DOM 物件上的原生屬性,自然也歸 prop() 管。