萬盛學電腦網

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

jQuery 獲取 DOM 節點標簽名的標準方法與陷阱避坑

jQuery 對象是類數組集合,無直接 tagName 屬性。本文詳細說明獲取節點標簽名的標準方法、常見錯誤、jQuery 對象與原生 DOM 對象轉換規則,並提供通用工具函數封裝。

標準獲取方式

// 方式一:獲取原生 DOM 元素後讀取 tagName (推薦)
$("#elementId").get(0).tagName;      // 返回大寫標簽名,如 "DIV"、"INPUT"
$("#elementId")[0].tagName;          // 等價寫法,更簡潔

// 方式二:使用 prop() (jQuery 1.6+)
$("#elementId").prop("tagName");     // 同樣返回大寫

常見錯誤與誤區

錯誤代碼問題正確寫法
$("#id").tagNamejQuery 對象無此屬性,返回 undefined$("#id")[0].tagName
$("#id").attr("tagName")tagName 是 DOM 屬性,非 HTML attribute,attr 獲取不到.prop("tagName") 或 [0].tagName
$("#id").get(0).tagName.toLowerCase()非錯誤,但注意 tagName 標準返回**大寫** (HTML5 規范)如需小寫自行 .toLowerCase()

jQuery 對象與 DOM 對象轉換速查

// DOM -> jQuery
$(document.getElementById("msg"));  // 單個元素
$("div");                           // 選擇器直接返回 jQuery 對象

// jQuery -> DOM (取第一個/指定索引)
$("#msg")[0];           // 最常用
$("#msg").get(0);       // 等價
$("#msg").eq(0)[0];     // 先篩選再取
$("div").get()[1];      // 獲取所有匹配元素的原生數組,取索引1

// 判斷是否為 jQuery 對象
obj instanceof jQuery; // true/false

通用工具函數封裝

// 獲取單個元素標簽名 (大寫)
function getTagName(selector) {
    var $el = $(selector);
    return $el.length ? $el[0].tagName : null;
}

// 獲取多個元素標簽名數組
function getTagNames(selector) {
    return $(selector).map(function() { return this.tagName; }).get();
}

// 使用
console.log(getTagName("#test"));        // "INPUT"
console.log(getTagNames("div, span"));   // ["DIV", "SPAN", "DIV", ...]

背景知識:tagName vs nodeName

  • tagName:僅 Element 節點擁有,返回標簽名(大寫)。
  • nodeName:所有節點擁有。Element 節點同 tagName;Attribute 節點返回屬性名;Text 節點返回 "#text";Document 節點返回 "#document"。
  • 統一用 tagName 判斷元素類型更語義清晰。

實戰場景:表單驗證中區分 input/select/textarea

function validateForm($form) {
    var valid = true;
    $form.find(":input").each(function() {
        var tag = this.tagName.toLowerCase();
        var $el = $(this);
        if (tag === "input") {
            var type = $el.attr("type");
            if (type === "checkbox" || type === "radio") {
                valid = $el.is(":checked");
            } else {
                valid = $.trim($el.val()) !== "";
            }
        } else if (tag === "select") {
            valid = $el.val() !== "";
        } else if (tag === "textarea") {
            valid = $.trim($el.val()) !== "";
        }
        if (!valid) return false; // 跳出 each
    });
    return valid;
}

掌握 [0].tagName 模式,能讓你在混合原生 DOM 與 jQuery API 的代碼中游刃有餘,避免因對象類型混淆導致的低級錯誤。

copyright © 萬盛學電腦網 all rights reserved