jQuery slideDown・slideToggleの使い方アコーディオンの作り方
jQueryのslideDown()・slideUp()・slideToggle()の使い方を、アコーディオンの実装例と動作確認つきで解説。連打でキューが溜まる問題のstop()対策、コールバック、aria属性、CSSアニメーションへの置き換えも紹介します。
この記事の目次
- jQuery slideDown・slideToggleの使い方とは
- 基本(構文)
- サンプルコード(実行結果つき)
- 動作確認(検証環境と結果)
- jQuery slideDown・slideToggleの使い方の注意点
- jQuery slideDown・slideToggleの使い方でよくあるミス
- ブラウザ対応・バージョン
- jQuery slideDown・slideToggleの使い方のチェックリスト
- jQuery slideDown・slideToggleの使い方のFAQ(よくある質問)
- 筆者の見解(jQuery slideDown・slideToggleの使い方)
- jQuery slideDown・slideToggleの使い方の関連項目
- 出典(一次情報)
jQuery slideDown・slideToggleの使い方とは
.slideDown() は、非表示の要素を高さを0から元の高さまで変化させながら表示するjQueryのアニメーションです。.slideUp() はその逆で、.slideToggle() は開閉を切り替えます。FAQやメニューの「アコーディオン」で最もよく使われます。
基本(構文)
$(el).slideDown([duration] [, easing] [, complete]);
$(el).slideUp([duration] [, easing] [, complete]);
$(el).slideToggle([duration] [, easing] [, complete]);
| 引数 | 内容 |
|---|---|
duration |
ミリ秒、または 'slow'(600)/ 'fast'(200)。省略は 400 |
easing |
'swing'(既定)または 'linear' |
complete |
アニメーション完了後に呼ばれる関数 |
動かす対象は、あらかじめ CSS で display: none にしておきます。jQuery が display を切り替えたうえで、height・上下の padding・上下の margin を同時に変化させて見せています。
サンプルコード(実行結果つき)
<button class="acc-head" id="h1" aria-expanded="false" aria-controls="b1">配送について</button>
<div class="acc-body" id="b1"><p>ご注文から3営業日以内に発送します。</p></div>
.acc-body { display: none; padding: 12px; background: #eef3fb; border: 1px solid #1a5fb4; }
$(function () {
$('.acc-head').on('click', function () {
const $btn = $(this);
const $panel = $('#' + $btn.attr('aria-controls'));
const open = $btn.attr('aria-expanded') === 'true';
$btn.attr('aria-expanded', String(!open));
$panel.stop(true, true).slideToggle(200);
});
});
aria-expanded と aria-controls を付けておくと、スクリーンリーダーにも開閉状態が伝わります(ボタン要素を使う点も重要です)。
アニメーション中の style 属性を読むと、動きの中身が分かります。
呼び出し直後: display: block; overflow: hidden; height: 0px; padding-top: 0px; ...
完了後: display: block;
高さ・余白を0から戻していき、終わると不要なインラインスタイルが消えて display: block; だけが残ります。
動作確認(検証環境と結果)
- 環境: Microsoft Edge(headless)/ Node.js v24.19.0 / jsdom 30.1.2 / jQuery 3.7.1
- 実行: アニメーションの時間経過は jsdom(
node t6b.js)、画面での開閉の最終状態は Edge(render.ps1 -Html t6.html -Width 390、$.fx.off = true)で確認。検証ログはtestsjquery-slidedown.md。 - jsdom の結果: 完了コールバックの時点で
display: block;のみ。slideUp完了後はdisplay: none;。連続で4回呼ぶとqueue().lengthは4。stop(true, true)を呼ぶと、途中でも最終状態(表示)に移りました。 - Edge の結果(アニメーション無効): クリックで高さ120pxのパネルが開き、
aria-expandedはtrue。もう一度クリックするとdisplay: noneに戻りました。 - 注意: headless Edge の仮想時間(
--virtual-time-budget)ではrequestAnimationFrameが進まず、アニメーションの途中経過を正確に確かめられませんでした。実機での見た目の滑らかさは未検証です。
jQuery slideDown・slideToggleの使い方の注意点
連打するとアニメーションが溜まる
アニメーションはキューに積まれます。ボタンを連打すると、何回も開閉を繰り返してしまいます。上のコードのように .stop(true, true) を前に付けると、キューを空にして現在のアニメーションを最後まで進めてから次を始められます。
動かす要素は display:none または表示中のブロック要素
対象は display: none で隠すか、ブロック要素として表示しておきます。visibility: hidden で隠した要素や display: inline の要素は、高さの変化が期待どおりにならないことがあります(本記事では未検証)。パネルの padding と margin は、上のとおりアニメーション中に一緒に変化します。
3.0 で変わった点
3.0 から、アニメーションは requestAnimationFrame を使います。.show() .hide() .toggle() は、スタイルシートの変更をより尊重するようになりました(アップグレードガイド)。jQuery.fx.interval は非推奨です。
動きを減らす設定への配慮
OSの「視差効果を減らす」設定の利用者に対しては、アニメーションを止めるのが望ましいです。$.fx.off = true を設定すると、アニメーションが無効になり、即座に開閉します。
if (window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
$.fx.off = true;
}
(この matchMedia の分岐そのものは、今回は未検証です。)
jQuery slideDown・slideToggleの使い方でよくあるミス
- 要素に CSS 側で
display: noneを付けず、最初から開いた状態になる。 .slideDown()の直後に高さを読み、途中の値を取ってしまう。値が必要ならcompleteコールバックで読む。.on('click')の中で、毎回新しいハンドラを登録して多重に動く。- リンク
<a href="#">を開閉ボタンにする。キーボード操作とアクセシビリティの面で、<button>のほうが適切です。 - アニメーション中にパネル内のコンテンツ高さが変わり、最終高さが合わない。
ブラウザ対応・バージョン
jQuery 3.x は IE9 以降に対応します。アニメーション自体はJavaScriptで高さを変えているため、古いブラウザでも動きます。新しく書くなら、CSS の transition や、Element.animate()(Web Animations API)でも同等の表現ができ、jQueryなしで済みます。対応状況は MDN で確認してください。
jQuery slideDown・slideToggleの使い方のチェックリスト
- 対象に
display: noneを CSS で付けた。 .stop(true, true)で連打対策をした。- ボタンは
<button>を使い、aria-expandedを更新している。 - 完了後の処理は
completeコールバックに書いた。 - 動きを減らす設定への配慮を検討した。
jQuery slideDown・slideToggleの使い方のFAQ(よくある質問)
slideDown と show の違いは。
.show() は引数なしだと即座に表示します。.slideDown() は高さを変化させながら表示します。
開いたパネルを閉じる処理で、他のパネルも閉じたい。
$('.acc-body').not($panel).stop(true, true).slideUp(200) のように、他のパネルを閉じてから開く書き方ができます。ここは未検証の書き方なので、動作は各自の環境で確認してください。
アニメーションの滑らかさを上げるには。
高さのアニメーションは再描画が発生しやすい処理です。数が多いときは、CSS での実装を検討します。
筆者の見解(jQuery slideDown・slideToggleの使い方)
FAQ のような単純な開閉であれば、HTML の <details> と <summary> で、JavaScriptなしでも実現できます。jQuery を使う場合は、stop(true, true) と aria-expanded の2点を入れておくだけで、実用上の品質がかなり上がると考えます。
PR SkillHacks
ウェブ制作の次の一歩を、動画講座で自分のペースで進められます
独学のまま詰まって、制作の勉強が止まってしまう前に
こんなお悩みはありませんか?
- HTMLとCSSは分かったが、アプリや仕事の受注までの道筋が見えない
- 独学で詰まったとき、聞ける相手がいない
- スクールは高額で、続けられるか不安
プログラミングの独学は、エラーで進めなくなったときに聞く相手がいないと、そのまま止まりがちです。始める前に、質問できる時間帯と方法、受講期間、料金を確認しておくと選びやすくなります。
Programming Hacks(旧Skill Hacks)は、94本以上の動画で基礎からツール・アプリ作成、仕事の受注まで学べる買い切りのオンライン講座です。目安は1日2時間で2か月。質問は24時間LINEで送れます。
選ばれるポイント
- 仕事の受注まで見通せる。基礎からツール・アプリ作成、仕事の受注までを一つの講座で学べる
- 自分の時間割で進められる。動画講義が94本以上あり、目安は1日2時間で2か月
- 期限を気にせず学べる。受講期間は無制限で、修了後の再受講もでき、会員サイトは永久ログイン
- 詰まっても止まりにくい。24時間LINEで質問でき、サポートは無制限に延長と案内されている
- 追加費用を気にせず続けやすい。買い切り型で、料金は公式サイトに記載。支払いはクレジットカード・PayPal・銀行振込
- 講座の中身を確認してから決められる。運営は株式会社スキルハックス。申込前に特定商取引法の表記と最新の料金を公式サイトで確認する
買い切り型で、受講期間の期限はありません。申込前に講座の内容を公式サイトで確認できます
Programming Hacksの講座ページを開きます
【PR】この枠は広告(アフィリエイト)を含みます。内容は2026年11月15日時点の公式サイトの記載です。料金・サポート範囲・返金の可否は変わることがあるため、申込前に公式サイトと特定商取引法の表記で最新の条件をご確認ください。
jQuery slideDown・slideToggleの使い方の関連項目
- jQuery on()
- $(this) と each()
- jQueryを使ってCSSを操作してみよう【 jQuery基礎】
- DOMを操作してHTMLを制御してみよう【 jQuery基礎】
- jQueryから素のJSへの移行
出典(一次情報)
本記事は情報提供を目的としています。ブラウザの仕様やライブラリのバージョンによって動作が異なる場合があるため、実際の開発では公式ドキュメントも合わせてご確認ください。
