萬盛學電腦網

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

jQuery 設定元素內容完整指南:text()、html()、val() 與回調函數

三大核心方法對比

方法用途處理 HTML適用元素
.text()純文字內容轉義(顯示原始標籤)所有元素
.html()HTML 內容解析渲染所有元素
.val()表單欄位值不處理input、select、textarea

基本設定範例

// 設定純文字
$('#btn1').click(function() {
  $('#test1').text('Hello world!');
});

// 設定 HTML(會渲染粗體)
$('#btn2').click(function() {
  $('#test2').html('<b>Hello world!</b>');
});

// 設定表單值
$('#btn3').click(function() {
  $('#test3').val('Dolly Duck');
});

進階:回調函數動態設定

三個方法都支援回調函數,參數:(index, oldValue),回傳新值。

text() 回調:累加舊內容

$('#btn1').click(function() {
  $('#test1').text(function(i, origText) {
    return 'Old text: ' + origText + ' New text: Hello world! (index: ' + i + ')';
  });
});

html() 回調:包裹原內容

$('#btn2').click(function() {
  $('#test2').html(function(i, origHtml) {
    return '<div class="wrapped">' + origHtml + '</div>';
  });
});

val() 回調:轉換表單值

$('#uppercase').click(function() {
  $('input:text').val(function(i, val) {
    return val.toUpperCase();
  });
});

實戰常見場景

場景 1:防 XSS 的安全輸出

// ❌ 危險:直接 html() 使用者輸入
$('#output').html(userInput);

// ✅ 安全:text() 自動轉義
$('#output').text(userInput);

// ✅ 需保留安全標籤:使用 DOMPurify 庫

場景 2:批量初始化表單

var formData = {
  username: 'john',
  email: 'john@example.com',
  role: 'admin'
};

$.each(formData, function(key, val) {
  $('#' + key).val(val);
});

場景 3:動態產生清單

var items = ['Apple', 'Banana', 'Orange'];
var $list = $('#fruitList');

$list.html('');  // 清空
$.each(items, function(i, fruit) {
  $list.append('<li>' + fruit + '</li>');
});

// 或更簡潔:
$list.html(items.map(function(fruit) {
  return '<li>' + fruit + '</li>';
}).join(''));

效能提示

  • 大量 DOM 操作時,先 .detach() 離線操作,最後 .append() 回文檔
  • 避免在迴圈中重複 .html(),改用陣列 join() 一次寫入
  • .text() 比 .html() 快(無需解析 HTML)

總結

  • .text():安全輸出純文字、防 XSS 首選
  • .html():插入 HTML 結構、動態渲染
  • .val():表單值獲取/設定唯一標準 API
  • 善用回調函數實現「基於舊值計算新值」的聲明式邏輯
copyright © 萬盛學電腦網 all rights reserved