萬盛學電腦網

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

jQuery 實現元素顯示/隱藏切換:show()/hide()/toggle() 完整指南

基礎 API

方法作用參數
.show()顯示元素duration, easing, complete
.hide()隱藏元素duration, easing, complete
.toggle()切換顯示/隱藏duration, easing, complete

最簡範例

<p id="p1">點擊「隱藏」我會消失。</p>
<button id="hide">隱藏</button>
<button id="show">顯示</button>

<script>
$(function() {
    $('#hide').click(function() { $('#p1').hide(); });
    $('#show').click(function() { $('#p1').show(); });
});
</script>

進階:動畫參數

// 慢速淡入
$('#p1').show('slow');           // 預設 600ms
$('#p1').show(1000);             // 1秒
$('#p1').show(500, 'swing');     // 緩動函數
$('#p1').show(300, function() {  // 完成回調
    console.log('顯示完成');
});

toggle() 進階用法

// 1. 無參數:切換可見狀態
$('#toggle-btn').click(function() { $('#p1').toggle(); });

// 2. 帶布林值:強制狀態 (jQuery 1.3+)
$('#force-show').click(function() { $('#p1').toggle(true);  });
$('#force-hide').click(function() { $('#p1').toggle(false); });

// 3. 回調函數
$('#p1').toggle(400, function() {
    console.log($(this).is(':visible') ? '已顯示' : '已隱藏');
});

核心原理

  • 內部操作 display CSS 屬性:hide() 將 display 設為 none 並記錄原值;show() 恢復原值。
  • 動畫本質:漸變 opacity、width、height、margin、padding 至 0 或目標值。
  • toggle() 根據當前 :visible 狀態決定調用 show 或 hide。

常見陷阱

  • display: none 佔位問題:隱藏後不佔空間,若需佔位用 visibility: hidden 或 opacity: 0。
  • 動畫隊列堆疊:快速連點導致動畫排隊 → 使用 .stop(true, true) 清空隊列並跳至終態。
  • 內聯 display 覆蓋:CSS !important 或內聯 style="display:block" 可能干擾。

現代原生替代

// 顯示/隱藏
el.hidden = true/false;                    // HTML5 hidden 屬性 (無動畫)
el.style.display = 'none' / '';            // 直接操作 display

// 切換
el.hidden = !el.hidden;

// CSS 動畫版 (推薦)
/* CSS */
.fade { opacity: 1; transition: opacity 0.3s; }
.fade.hidden { opacity: 0; pointer-events: none; }

/* JS */
el.classList.toggle('hidden');

結語

show/hide/toggle 是 jQuery 最基礎的視覺控制 API。理解其操作 display 與動畫隊列機制,能避免閃爍、殘留、佈局塌陷等問題。現代專案優先使用 CSS 類別切換 + Transition,將動畫邏輯移出 JS,提升效能與可維護性。

copyright © 萬盛學電腦網 all rights reserved