萬盛學電腦網

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

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

三大核心方法

方法作用參數回傳值
.show()顯示隱藏元素duration, easing, completejQuery (鏈式)
.hide()隱藏元素duration, easing, completejQuery
.toggle()切換顯示/隱藏duration, easing, complete / booleanjQuery

基礎範例

<!DOCTYPE html>
<html>
<head>
  <title>jQuery Show/Hide/Toggle</title>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
  <script>
    $(document).ready(function() {
      $("#show").click(function() { $("p").show(); });
      $("#hide").click(function() { $("p").hide(2000); }); // 2秒動畫隱藏
      $("#tog").click(function() { $("p").toggle("slow"); }); // 緩慢切換
    });
  </script>
</head>
<body>
  <button id="show">顯示</button>
  <button id="hide">隱藏</button>
  <button id="tog">切換</button>
  <p>這是一個段落這是一個段落這是一個段落這是一個段落這是一個段落這是一個段落</p>
</body>
</html>

參數詳解

// 1. 無參數:立即顯示/隱藏
$("#el").show();
$("#el").hide();

// 2. 速度字串
$("#el").show("slow");   // 600ms
$("#el").hide("fast");   // 200ms
$("#el").toggle("normal"); // 400ms (預設)

// 3. 毫秒數
$("#el").show(300);
$("#el").hide(500);

// 4. 完整參數:速度 + 緩動函數 + 完成回呼
$("#el").show(400, "swing", function() {
  console.log("顯示動畫完成");
});

// 5. toggle 傳入 boolean 強制狀態
$("#el").toggle(true);  // 強制顯示 (等同 show())
$("#el").toggle(false); // 強制隱藏 (等同 hide())

底層原理

  • 記錄元素原本的 `display` 值 (block/inline/inline-block/table-row 等)
  • `hide()`:設定 `display: none`,並將原值存於 `data("olddisplay")`
  • `show()`:恢復原 `display` 值
  • 動畫過程中臨時設定 `overflow: hidden`、調整 `width`/`height`/`opacity`/`padding`/`margin`

進階應用場景

1. 手風琴選單

$(".accordion-header").click(function() {
  $(this).next(".accordion-content").slideToggle(300); // 專門針對高度切換
  $(this).siblings(".accordion-content").slideUp(300);
});

2. 條件式顯示

// 根據條件顯示/隱藏
$("#adminPanel").toggle(user.role === 'admin');

3. 表單驗證錯誤訊息

function showError($field, msg) {
  $field.siblings(".error-msg").text(msg).show(200);
}
function clearError($field) {
  $field.siblings(".error-msg").hide(200);
}

常見坑點

問題原因解決
inline 元素 hide 後 show 變成 blockjQuery 預設恢復為 blockCSS 設定 `display: inline` 或用 `.css('display', 'inline')`
table 行/儲存格 hide 異常display:none 破壞表格布局用 `visibility: hidden` 或 CSS class 切換
動畫中斷導致元素消失未使用 .stop()動畫前加 `.stop(true, true)`

現代替代:CSS Class 切換

.hidden { display: none !important; }
// JS
$("#el").toggleClass("hidden"); // 無動畫
$("#el").addClass("hidden").delay(100).queue(function() { $(this).removeClass("hidden").dequeue(); }); // 簡易延遲

掌握 `show/hide/toggle` 的動畫參數與底層機制,能靈活處理各種顯示切換需求,也是學習 jQuery 動畫系統的入門基石。

copyright © 萬盛學電腦網 all rights reserved