jQuery 對象是類數組集合,無直接 tagName 屬性。本文詳細說明獲取節點標簽名的標準方法、常見錯誤、jQuery 對象與原生 DOM 對象轉換規則,並提供通用工具函數封裝。
// 方式一:獲取原生 DOM 元素後讀取 tagName (推薦)
$("#elementId").get(0).tagName; // 返回大寫標簽名,如 "DIV"、"INPUT"
$("#elementId")[0].tagName; // 等價寫法,更簡潔
// 方式二:使用 prop() (jQuery 1.6+)
$("#elementId").prop("tagName"); // 同樣返回大寫
| 錯誤代碼 | 問題 | 正確寫法 |
|---|---|---|
$("#id").tagName | jQuery 對象無此屬性,返回 undefined | $("#id")[0].tagName |
$("#id").attr("tagName") | tagName 是 DOM 屬性,非 HTML attribute,attr 獲取不到 | .prop("tagName") 或 [0].tagName |
$("#id").get(0).tagName.toLowerCase() | 非錯誤,但注意 tagName 標準返回**大寫** (HTML5 規范) | 如需小寫自行 .toLowerCase() |
// 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:僅 Element 節點擁有,返回標簽名(大寫)。nodeName:所有節點擁有。Element 節點同 tagName;Attribute 節點返回屬性名;Text 節點返回 "#text";Document 節點返回 "#document"。tagName 判斷元素類型更語義清晰。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 的代碼中游刃有餘,避免因對象類型混淆導致的低級錯誤。