萬盛學電腦網

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

jQuery text() 方法完整使用指南與實例解析

前言

在 jQuery 開發中,text() 方法是操作元素文本內容最常用的工具之一。它不僅能獲取元素的純文本內容,還能安全地設置文本,自動轉義 HTML 標籤,有效防止 XSS 攻擊。本文將通過完整實例詳細解析 text() 方法的用法、參數特性及常見應用場景。

語法概覽

// 獲取文本內容
$(selector).text()

// 設置文本內容
$(selector).text(textString)

// 使用函數動態設置文本
$(selector).text(function(index, currentText) { ... })

核心特性

  • 純文本處理:自動移除所有 HTML 標籤,返回純文本
  • 跨瀏覽器兼容:統一處理 textContent (現代瀏覽器) 與 innerText (IE) 的差異
  • 安全性:設置內容時自動轉義特殊字符,防止腳本注入
  • 鏈式調用:設置操作返回 jQuery 對象,支持鏈式調用

完整實例:按鈕點擊修改 DIV 文本

以下示例展示點擊按鈕後,將 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() vs html() 關鍵差異

特性 text() html()
返回內容 純文本 (無標籤) 包含 HTML 標籤
設置時轉義 自動轉義特殊字符 直接解析 HTML
安全性 高 (防 XSS) 低 (需手動過濾)
性能 略快 需解析 DOM

常見陷阱與最佳實踐

  1. 避免在 input/textarea 上使用:表單元素請用 val() 方法
  2. 大量文本操作優化:頻繁更新時考慮使用原生 textContent 或虛擬 DOM
  3. 保留換行符:text() 會保留源碼中的換行,CSS white-space: pre-wrap 可正確顯示
  4. CDATA 區域處理:XML 文檔中 CDATA 內容可正確獲取

總結

jQuery text() 方法提供了安全、跨瀏覽器的文本操作接口。掌握其「獲取純文本、設置自動轉義、支持函數回調」三大核心能力,能顯著提升前端開發效率與安全性。實際項目中,凡涉及用戶輸入顯示、動態文本生成等場景,優先選用 text() 而非 html(),是防範 XSS 攻擊的重要防線。

copyright © 萬盛學電腦網 all rights reserved