萬盛學電腦網

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

jQuery attr() / removeAttr() 完整指南:屬性操作、JSON 批量設置、移除屬性實戰詳解

核心 API 對照表

方法用途參數形式返回值關鍵特性
.attr(name)讀取屬性值字串字串 / undefined只讀取集合中第一個元素
.attr(name, value)設置單一屬性字串, 字串/數值/函數jQuery 物件 (鏈式)值為函數時接收 (index, 當前值)
.attr(object)批量設置 (JSON)物件 {key: value}jQuery 物件一次設置多個屬性,效能更好
.removeAttr(name)移除屬性字串 (可空格分隔多個)jQuery 物件移除 HTML 屬性及對應 DOM property
.prop()操作 DOM Property同上同上布林屬性必用 prop (checked, disabled, selected...)

完整互動範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>jQuery attr/removeAttr 示範</title>
  <style>
    .container { max-width: 600px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
    .box { width: 200px; height: 80px; border: 2px solid #ddd; border-radius: 8px; margin: 10px auto; display: flex; align-items: center; justify-content: center; font-family: monospace; font-size: 13px; transition: all 0.2s; }
    .controls { display: flex; gap: 10px; justify-content: center; flex-wrap: wrap; margin: 20px 0; }
    button { padding: 8px 16px; background: #1976d2; color: white; border: none; border-radius: 4px; cursor: pointer; }
    button.secondary { background: #757575; }
    button.danger { background: #e53935; }
    .log { background: #263238; color: #aed581; padding: 12px; border-radius: 4px; font-family: monospace; font-size: 13px; white-space: pre-wrap; min-height: 80px; }
  </style>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
  <div class="container">
    <h2 style="text-align:center;">attr() / removeAttr() 互動示範</h2>
    <div id="div1" class="box">div1 - 無屬性</div>
    <div id="div2" class="box">div2 - 無屬性</div>
    
    <div class="controls">
      <button id="btnSetSingle">1. 單個設置 attr('data-x', 'val')</button>
      <button id="btnSetJson">2. JSON 批量設置 attr({...})</button>
      <button id="btnGetAttr" class="secondary">3. 讀取第一個元素屬性</button>
      <button id="btnRemove" class="danger">4. 移除 div2 的 data-age</button>
      <button id="btnClear" class="secondary">清除日誌</button>
    </div>
    <div class="log" id="log">操作日誌...</div>
  </div>

  <script>
  $(function() {
    const $divs = $('div.box');
    const $log = $('#log');
    const log = (msg) => $log.prepend(`[${new Date().toLocaleTimeString()}] ${msg}\n`);

    // 1. 單個設置
    $('#btnSetSingle').on('click', () => {
      $divs.eq(0).attr('data-role', 'admin').attr('data-level', 99);
      $divs.eq(1).attr('data-role', 'user').attr('data-level', 1);
      log('已單個設置 data-role, data-level');
    });

    // 2. JSON 批量設置 (推薦)
    $('#btnSetJson').on('click', () => {
      $divs.eq(0).attr({ 'data-role': 'admin', 'data-level': 99, 'data-active': 'true' });
      $divs.eq(1).attr({ 'data-role': 'user', 'data-level': 1, 'data-active': 'false' });
      log('已 JSON 批量設置 3 個屬性');
    });

    // 3. 讀取屬性 (只取第一個)
    $('#btnGetAttr').on('click', () => {
      const role = $divs.attr('data-role'); // 只讀取第一個 div 的
      const level = $divs.attr('data-level');
      log(`讀取第一個元素: data-role="${role}", data-level="${level}"`);
      log(`提示: .attr() 只返回集合中第一個元素的值`);
    });

    // 4. 移除屬性
    $('#btnRemove').on('click', () => {
      $divs.eq(1).removeAttr('data-level data-active'); // 空格分隔移除多個
      log('已移除 div2 的 data-level, data-active');
      log(`驗證: data-level="${$divs.eq(1).attr('data-level')}" (應為 undefined)`);
    });

    $('#btnClear').on('click', () => $log.text('操作日誌...'));
  });
  </script>
</body>
</html>

關鍵細節深度解析

1. .attr() 讀取只取第一個元素

<div id="a" data-x="1"></div>
<div id="b" data-x="2"></div>

$('div').attr('data-x'); // "1" (只取第一個)
$('div').map((_, el) => el.getAttribute('data-x')).get(); // ["1", "2"] 取所有值

2. JSON 批量設置的優勢

  • 單次 DOM 操作,減少重排/重繪
  • 程式碼更簡潔、可讀性更高
  • 屬性名可含連字號:{'data-user-id': 123} (字串鍵名)

3. removeAttr() 的副作用:同步移除 DOM Property

<input type="checkbox" checked>
$('input').removeAttr('checked');
// 結果:HTML 移除 checked 屬性,DOM property checked 變為 false
// 視覺上核取方塊變為未勾選

這是刻意設計:removeAttr 會將對應的 DOM property 設為預設值 (布林屬性為 false)。

4. attr vs prop 鐵律

屬性類型正確方法例子
HTML 標準屬性 (id, class, name, href, src, data-*, ...).attr()attr('href'), attr('data-id')
布林屬性 (checked, disabled, selected, readonly, required, ...).prop()prop('checked', true)
動態狀態 (value, scrollTop, scrollLeft, ...).prop() / .val()val('text'), prop('scrollTop', 100)
表單元素屬性 (type, tagName, nodeName, ...).prop() (唯讀)prop('tagName')

5. 使用函數值動態計算屬性

// 為每個元素根據索引設置不同 data-index
$('li').attr('data-index', function(index) {
  return index + 1;
});

// 根據現有屬性計算新值
$('a').attr('href', function(i, oldHref) {
  return oldHref + '?track=click';
});

實戰場景:自定義資料屬性 (data-*)

<div data-user='{"id":1,"name":"Alice","roles":["admin"]}'></div>

// jQuery .data() 會自動解析 JSON (僅首次)
const data = $('div').data('user'); // {id:1, name:"Alice", roles:["admin"]} (物件)

// .attr() 返回原始字串
const raw = $('div').attr('data-user'); // '{"id":1,"name":"Alice","roles":["admin"]}' (字串)

// 寫入 .data() 不會更新 HTML 屬性
$('div').data('user', {id:2}); // 只更新內部快取
$('div').attr('data-user', JSON.stringify({id:2})); // 同步更新 HTML

總結

  • .attr() 處理 HTML 屬性,.prop() 處理 DOM Property —— 分清這兩者是前端進階的分水嶺
  • 批量設置用 JSON 物件:.attr({key1: val1, key2: val2})
  • 移除屬性用 .removeAttr('attr1 attr2'),空格分隔多個
  • 讀取集合中所有元素的屬性值,用 .map((_, el) => el.getAttribute('attr')).get()
  • 布林屬性 (checked/disabled/selected) 永遠用 .prop()
copyright © 萬盛學電腦網 all rights reserved