text() 取得或設定元素的文字內容,不含任何 HTML 標籤。它與 html() 最大的差異,在於設定時會自動做 HTML 轉義——這個特性讓它成為填入使用者資料時的首選。
<span id="236" class="active" type="teacher" ww="nn"> <input type="checkbox" onclick="event.cancelBubble=true;"> 劉4 </span>
需求是取得顯示文字「劉4」,以及該元素的 id。
$("input:checked", ".simpleTree").each(function () {
var currentNode = $(this).parent();
var isfolder = currentNode.text();
var id = currentNode.attr("id");
alert(isfolder);
});
第一,text() 會把後代所有文字都收集起來。在這個例子中,$(this).parent().text() 拿到的除了「劉4」,還包含 checkbox 本身(input 沒有文字內容,不影響)。但若 span 裡還有巢狀的 <b>、<span> 或註解文字,全都會被串接成一個字串。若你只想要「直接子層的文字節點」,需要自己篩:
var direct = $(this).parent().contents()
.filter(function () { return this.nodeType === 3; })
.text();
第二,那個 onclick="event.cancelBubble=true;" 是舊式寫法。它的目的是阻止勾選事件冒泡到父層(避免觸發樹狀元件的展開/收合)。現代的等效寫法是:
$("input[type=checkbox]").on("click", function (e) {
e.stopPropagation();
});
行內 onclick 屬性在當今的 CSP(內容安全政策)下預設會被阻擋,不應再用於新專案。
text()——讀寫純文字,寫入時自動轉義 HTML。html()——讀寫 HTML 標記,寫入時不轉義。val()——讀寫表單元素的值(input、textarea、select)。關鍵的安全準則:凡是內容來自使用者或外部資料,一律用 text()。
var userInput = "<img src=x onerror=alert(document.cookie)>";
$("#safe").text(userInput); // ✓ 畫面上如實顯示這串字元
$("#unsafe").html(userInput); // ✗ 這段程式碼會執行
這兩行的差別,就是 XSS 與非 XSS 的差別。
text() 在設定時比 html() 快,因為它不必解析 HTML 字串建構 DOM 樹,直接寫入文字節點即可。在大量資料渲染的場景(例如一次填入上千筆列表項目),這個差異是可觀的。
原生對應寫法:
el.textContent = "劉4"; // 等同 $(el).text("劉4")
el.innerText = "劉4"; // 近似,但會觸發 reflow 且尊重 CSS 隱藏
el.innerHTML = "<b>劉4</b>"; // 等同 $(el).html(...)
textContent 是 text() 的正確對應;innerText 會因需計算實際渲染結果而較慢,且不包含隱藏元素的文字,兩者不等價。
範例中的 currentNode.attr("id") 沒問題,但在原生寫法或效能路徑上,直接用 DOM 屬性更快也更清楚:
var id = currentNode[0].id; // 或 currentNode.prop("id")
另外,範例中的 type="teacher" 與 ww="nn" 是不合法的 HTML 屬性。若目的是存放自訂資料,HTML5 的規範做法是 data-type="teacher" 與 data-ww="nn",並以 $(el).data("type") 或 el.dataset.type 讀取。