DIV CSS 佈局教程網

jQuery text() 方法:取出標籤內的純文字內容
編輯:JQuery特效代碼     

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()、val() 該用哪個

  • 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() 的效能特性

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 會因需計算實際渲染結果而較慢,且不包含隱藏元素的文字,兩者不等價。

取得 id 的補充

範例中的 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 讀取。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved