萬盛學電腦網

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

jQuery 判斷元素是否存在:length 屬性與原生方法對比

前言

jQuery 選擇器永遠返回 jQuery 對象 (類數組),即使元素不存在也返回空對象 (`length === 0`),而非 `null`。這導致傳統 `if ($('#id'))` 判斷失效。本文講解正確判斷方法及最佳實踐。

一、錯誤寫法 ❌


// 錯誤!永遠為 true,因為 $() 返回對象 (truthy)
if ($('#myId')) { 
    console.log('存在'); // 即使元素不存在也會執行
}

二、正確寫法 ✅

1. 判斷 length 屬性 (標準 jQuery 方式)


if ($('#myId').length > 0) {
    console.log('元素存在');
} else {
    console.log('元素不存在');
}

// 簡寫 (0 為 falsy)
if ($('#myId').length) { ... }

2. 封裝通用函數


$.fn.exists = function() {
    return this.length > 0;
};

// 使用
if ($('#myId').exists()) { ... }

3. 原生 JavaScript 方法 (無依賴、性能最優)


// 方法一:getElementById (最快,僅限 ID)
if (document.getElementById('myId')) { ... }

// 方法二:querySelector (支持任意選擇器)
if (document.querySelector('#myId')) { ... }
if (document.querySelector('.my-class')) { ... }

// 方法三:getElementsByClassName / getElementsByTagName
if (document.getElementsByClassName('my-class').length) { ... }

三、性能對比

方法性能適用場景
document.getElementById⚡️ 最快 (原生、哈希查找)已知 ID、高頻調用
document.querySelector快 (原生、選擇器引擎)複雜選擇器、單個元素
$().length中等 (jQuery 封裝開銷)已在 jQuery 鏈式調用中、複雜選擇器

四、常見陷阱

1. 隱藏元素 vs 不存在


// display:none / visibility:hidden / opacity:0 仍然「存在」
$('#hidden').length === 1; // true

// 判斷可見性需額外檢查
$('#hidden').is(':visible'); // false

2. 動態添加的元素


// AJAX 載入後才存在的元素
$.get('/data', function(html) {
    $('#container').html(html);
    // 此時才能判斷
    if ($('#dynamic-element').length) { ... }
});

3. iframe 跨域元素


// 無法直接訪問跨域 iframe 內元素
// 需 postMessage 通信或同域下:
var iframeDoc = $('#myIframe')[0].contentDocument;
if (iframeDoc.getElementById('innerId')) { ... }

五、完整示例


<html>
<head>
    <script src="jquery-3.6.0.min.js"></script>
    <script>
    $(function() {
        // 正確判斷
        if ($('#exist').length) console.log('存在');
        else console.log('不存在');
        
        if ($('#not-exist').length) console.log('存在');
        else console.log('不存在'); // 輸出此行
        
        // 原生對比
        if (document.getElementById('exist')) console.log('原生: 存在');
    });
    </script>
</head>
<body>
    <div id="exist">我存在</div>
</body>
</html>

六、總結

  • jQuery 判斷存在:**必須檢查 `.length > 0`**
  • 僅需判斷 ID 存在:**首選 `document.getElementById()`**,性能最佳、無依賴
  • 複雜選擇器用 `document.querySelector()`
  • 區分「存在於 DOM」與「用戶可見」 (`:visible`)
  • 動態內容需在渲染完成後判斷 (回調、Promise、事件監聽)
copyright © 萬盛學電腦網 all rights reserved