Shuhei
Swiper.js 設定項目 早見表【日本語】
2026年07月13日
見出しはありません
要約を生成中...
最近のHP開発でもトレンドのカルーセルの実装についてです。そのライブラリのひとつのSwiper.js は慣れちゃえばかなり簡単にアクティブなカルーセルUIを作れます。このオプションは種類が多く、必要なときに毎回公式ドキュメントを検索するのは地味に手間でした。和訳しても意味わからんこと多かった…。
自分が実務で実際によく使った設定項目を中心に、用途別に整理した早見表としてまとめました。
プロパティ | デフォルト | 説明 |
|---|---|---|
| 1 | 同時に表示するスライド数。数値または |
| 0 | スライド間の余白(px) |
| false | ループ(無限スクロール)を有効化 |
| 300 | スライド切り替えのトランジション時間(ms) |
| 'horizontal' | 'horizontal' または 'vertical' |
| 'slide' | 切り替え演出。slide / fade / cube / coverflow / flip / creative / cards |
| false | アクティブなスライドを中央寄せ表示 |
| - | 画面幅ごとに設定を切り替え(レスポンシブ対応) |
| - | 複数行のグリッド表示(Grid モジュール) |
プロパティ | デフォルト | 説明 |
|---|---|---|
| null | 「次へ」ボタンの要素・CSSセレクタ |
| null | 「前へ」ボタンの要素・CSSセレクタ |
| false | スライダークリックでボタン表示を切り替え |
| swiper-button-disabled | 無効時に付与されるクラス名 |
プロパティ | デフォルト | 説明 |
|---|---|---|
| 'bullets' | 'bullets' / 'fraction' / 'progressbar' / 'custom' |
| false | true でバレット(丸印)クリックによる遷移が可能 |
| false | スライド数が多いとき、表示バレット数を絞る |
| 1 | dynamicBullets 有効時のメインバレット数 |
| null | ページネーションを設置するコンテナ |
プロパティ | デフォルト | 説明 |
|---|---|---|
| 3000 | 次のスライドまでの待機時間(ms) |
| true | false にするとユーザー操作後も自動再生を再開 |
| false | マウスホバー時に一時停止 |
| false | 最終スライドで自動再生を停止(loop時は無効) |
| false | 逆方向に自動再生 |
| true | トランジション完了を待ってから次へ進む |
effect値 | 関連オプション例 |
|---|---|
fade |
|
coverflow |
|
cube |
|
flip |
|
cards |
|
creative |
|
すべてのオプション名・デフォルト値・詳細説明は公式ドキュメント(swiperjs.com)で確認できます。この早見表は実装時によく参照するものを中心に抜粋しています。
const swiper = new Swiper('.swiper', {
slidesPerView: 'auto',
spaceBetween: 16,
loop: true,
navigation: {
nextEl: '.swiper-button-next',
prevEl: '.swiper-button-prev',
},
pagination: {
el: '.swiper-pagination',
clickable: true,
dynamicBullets: true,
},
autoplay: {
delay: 4000,
disableOnInteraction: false,
},
breakpoints: {
768: { slidesPerView: 2 },
1024: { slidesPerView: 3 },
},
});要約
コメント
まだコメントはありません。