萬盛學電腦網

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

jQuery 獲取與設置 outerHTML 完整指南:prop() 方法妙用

問題背景

jQuery .html() 僅返回元素內部 HTML,不包含元素自身標籤。原生 DOM 提供 outerHTML 屬性可獲取/設置包含自身的完整 HTML。jQuery 無直接方法,但可通過 .prop('outerHTML') 實現。

獲取 outerHTML

<div class="test"><p>Hello</p></div>

var fullHtml = $(".test").prop("outerHTML");
// 返回: '<div class="test"><p>Hello</p></div>'

設置 outerHTML(替換元素)

// 將 .test 替換為 
$(".test").prop("outerHTML", "<input type='text' value='new'>");

等同於原生:element.outerHTML = "<input>"。原元素從 DOM 移除,新元素取其位置。

底層原理

  • .prop() 直接操作 DOM 元素屬性。
  • outerHTML 是 HTMLElement 的標準屬性(IE4+、所有現代瀏覽器支持)。
  • jQuery 內部調用 elem[propName] = value,故能直接設置。

注意事項與坑點

  1. 大小寫敏感:必須用 'outerHTML'(駝峰),'outerHtml' 無效。
  2. 返回值:獲取時返回字符串;設置時返回 jQuery 對象(鏈式調用),但該對象仍指向已被移除的舊元素,後續鏈式操作無效。
  3. 多元素集合:$('.items').prop('outerHTML', '<span/>') 會將集合中每個元素都替換為 <span/>。
  4. 事件處理器:舊元素綁定的事件會隨元素移除而銷毀(若用 .on() 委派則不受影響)。

替代方案對比

方法用途返回值適用場景
.html()獲取/設置內部 HTML字符串 / jQuery修改內容
.prop('outerHTML')獲取/設置完整 HTML字符串 / jQuery(舊元素)整體替換元素
.replaceWith()替換元素jQuery(新元素)推薦:替換後可繼續操作新元素
.wrap() / .unwrap()包裹/解包父層jQuery(原元素)結構調整

推薦:使用 .replaceWith() 替換元素

// 替換並獲得新元素引用
var $newInput = $("");
$(".test").replaceWith($newInput);
// $newInput 現在在 DOM 中,可繼續操作
$newInput.focus();
copyright © 萬盛學電腦網 all rights reserved