萬盛學電腦網

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

jQuery 與原生 JS 控制元素顯示/隱藏的完整指南

前言

控制元素可見性是前端基礎操作。jQuery 提供 show()/hide()/toggle(),原生 JS 則操作 CSS display 與 visibility。兩者行為差異直接影響佈局流與無障礙存取,本文系統整理。

一、jQuery 方法

方法行為適用場景
$('#id').show()恢復元素原有 display 值(或預設 block)一般顯示
$('#id').hide()設 display: none,元素從文檔流移除,不佔空間完全隱藏
$('#id').toggle()切換顯示/隱藏開關切換
$('#id').fadeIn/Out()漸變動畫,結束時同 show/hide需要過渡效果
$('#id').slideDown/Up()高度動畫,結束時同 show/hide摺疊面板
注意:原文中 隱藏 示例錯誤寫為 show(),正確應為 hide()。

二、原生 JS:display vs visibility

1. display: none(推薦)

// 隱藏
element.style.display = 'none';
// 顯示:恢復預設或指定值
element.style.display = ''; // 移除 inline style,回歸 CSS 規則
// 或
element.style.display = 'block'; // 明確指定
  • 元素完全從渲染樹移除,不佔據空間,不可點擊,螢幕閱讀器忽略。
  • 切換時會觸發回流,動畫需配合 opacity + transition 或 requestAnimationFrame。

2. visibility: hidden

element.style.visibility = 'hidden'; // 隱藏
element.style.visibility = 'visible'; // 顯示
  • 元素仍佔據佈局空間,只是不可見。
  • 子元素可設 visibility: visible 獨立顯示(display:none 子元素無法顯示)。
  • 適合佔位、防止佈局跳動、需保持焦點順序的場景。

3. opacity: 0 + pointer-events: none

element.style.opacity = '0';
element.style.pointerEvents = 'none'; // 禁用點擊/hover
// 顯示
element.style.opacity = '1';
element.style.pointerEvents = 'auto';
  • 支援 CSS Transition 動畫,元素仍在文檔流佔位。
  • 螢幕閱讀器仍可讀取,需搭配 aria-hidden 控制。

三、對比總結表

特性display:nonevisibility:hiddenopacity:0jQuery hide()
佔據空間否是是否
可點擊/聚焦否否(但可 Tab 聚焦)是(需 pointer-events)否
螢幕閱讀器讀取否否是否
子元素可顯示否是是否
觸發回流是否否是
可動畫需技巧否是 (transition)內建動畫

四、最佳實踐建議

  1. 預設用 display: none / jQuery hide():語意最清晰,效能最好(移除渲染)。
  2. 需保持佈局穩定(如載入中佔位):用 visibility: hidden。
  3. 需淡入淡出動畫:用 opacity + transition,或 jQuery fadeIn/Out。
  4. 無障礙:切換時同步設置 aria-hidden="true/false",焦點管理參考 WAI-ARIA Dialog Pattern。
  5. 避免:原文示例中 style="visibility: none;" 是無效寫法(visibility 無 none 值)。

五、現代封裝範例(原生 JS)

const Visibility = {
  hide(el, { mode = 'display' } = {}) {
    if (!el) return;
    if (mode === 'display') el.style.display = 'none';
    else if (mode === 'visibility') el.style.visibility = 'hidden';
    else if (mode === 'opacity') { el.style.opacity = '0'; el.style.pointerEvents = 'none'; }
    el.setAttribute('aria-hidden', 'true');
  },
  show(el, { mode = 'display', display = '' } = {}) {
    if (!el) return;
    if (mode === 'display') el.style.display = display || '';
    else if (mode === 'visibility') el.style.visibility = 'visible';
    else if (mode === 'opacity') { el.style.opacity = '1'; el.style.pointerEvents = 'auto'; }
    el.setAttribute('aria-hidden', 'false');
  },
  toggle(el, options) {
    const isHidden = el.style.display === 'none' || el.style.visibility === 'hidden' || el.getAttribute('aria-hidden') === 'true';
    this[isHidden ? 'show' : 'hide'](el, options);
  }
};

// 使用
Visibility.hide(document.getElementById('box'), { mode: 'opacity' });
Visibility.show(document.getElementById('box'), { mode: 'opacity' });

總結

理解 display、visibility、opacity 的本質差異,能根據業務場景選擇最適合的隱藏策略。jQuery 封裝了常見行為,但原生 JS 配合 CSS Transition 能實現更高效、可控的動畫體驗。

copyright © 萬盛學電腦網 all rights reserved