在 jQuery 開發中,text() 方法是操作元素文本內容最常用的工具之一。它不僅能獲取元素的純文本內容,還能安全地設置文本,自動轉義 HTML 標籤,有效防止 XSS 攻擊。本文將通過完整實例詳細解析 text() 方法的用法、參數特性及常見應用場景。
// 獲取文本內容
$(selector).text()
// 設置文本內容
$(selector).text(textString)
// 使用函數動態設置文本
$(selector).text(function(index, currentText) { ... })
以下示例展示點擊按鈕後,將 div 元素的文本內容替換為指定字符串:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery text() 方法演示</title>
<style>
.demo-box {
width: 300px;
margin: 20px auto;
padding: 15px;
border: 2px solid #ddd;
border-radius: 4px;
background: #f9f9f9;
}
button {
padding: 8px 16px;
background: #007bff;
color: white;
border: none;
border-radius: 4px;
cursor: pointer;
}
button:hover { background: #0056b3; }
</style>
</head>
<body>
<div id="content" class="demo-box">
初始文本內容 - 點擊按鈕查看變化
<br><br>
<button id="btnChange">修改文本</button>
</div>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(function() {
$('#btnChange').click(function() {
// 使用 text() 設置新文本,HTML 標籤會被轉義顯示
$('#content').text('文本已更新於 ' + new Date().toLocaleTimeString() + '。注意:<strong>HTML 標籤</strong> 會被轉義為實體字符。');
});
});
</script>
</body>
</html>
當需要根據當前索引或現有文本動態生成新內容時,可傳入函數:
<ul id="list">
<li>項目一</li>
<li>項目二</li>
<li>項目三</li>
</ul>
<script>
$('#list li').text(function(index, oldText) {
return '第 ' + (index + 1) + ' 項:' + oldText.toUpperCase();
});
// 結果:
// 第 1 項:項目一
// 第 2 項:項目二
// 第 3 項:項目三
</script>
| 特性 | text() | html() |
|---|---|---|
| 返回內容 | 純文本 (無標籤) | 包含 HTML 標籤 |
| 設置時轉義 | 自動轉義特殊字符 | 直接解析 HTML |
| 安全性 | 高 (防 XSS) | 低 (需手動過濾) |
| 性能 | 略快 | 需解析 DOM |
val() 方法textContent 或虛擬 DOMtext() 會保留源碼中的換行,CSS white-space: pre-wrap 可正確顯示jQuery text() 方法提供了安全、跨瀏覽器的文本操作接口。掌握其「獲取純文本、設置自動轉義、支持函數回調」三大核心能力,能顯著提升前端開發效率與安全性。實際項目中,凡涉及用戶輸入顯示、動態文本生成等場景,優先選用 text() 而非 html(),是防範 XSS 攻擊的重要防線。