本文へ移動
uiify

Carousel

タッチジェスチャーと前後の移動操作に対応するスライドカルーセル。

ブラウザー
Chrome 123+Firefox 121+Safari 17.5+
ティア
2
圧縮後のサイズ
7.17 kB
強制レイアウトの上限
0 ms
axe の上限
0
SSR 対応
はい
公開された契約
テストハーネス

プレイグラウンド

Carousel

注目のカード

矢印で記事を切り替えるか、ドットでスライドを選択します。

レスポンシブなカード列

右から左

ブロック軸

同期するコントロールとネイティブコマンド

停止・開始できる自動再生

フォーカスすると、開始を押すまで自動切り替えを停止します。ホバー中は一時停止します。

任意のマウスドラッグ操作

CSSトランジションによるフェード

API

Carousel

CarouselClient — @gunkin/uiify/components/carousel/client

Prop型既定値説明
defaultValue / valuenumber—初期または制御される項目インデックス。観測した停止確定状態に従ってコントロールが更新されます。
rewindbooleanfalseスライドを複製せず、両端で循環します。
mouseDragbooleanfalse明示的に有効にするマウスドラッグ。タッチとホイールはネイティブのままです。
autoplayboolean | CarouselAutoplayOptionsfalse遅延の既定値は5000msです。オプションはdelay、paused、cycles、stopOnInteractionです。可視の停止・開始操作を含みます。
onSelect / beforeChange / afterChange / onSwipecallbacks—実際に停止が確定した変更とその理由を通知します。制御時と移動中断時の意味はCarouselガイドを参照してください。
refRef<CarouselClientHandle>—next、previous、goTo、start、stop、reset。

FadeCarouselClient — @gunkin/uiify/components/carousel/fade

Prop型既定値説明
swipebooleantrueタッチ・ペンのスワイプ。マウスにはmouseDragが必要です。axis以外のクライアントpropsを継承します。非アクティブなスライドはinertになります。

キーボード

キー操作
Tab / Enterネイティブのスライドリンクにフォーカスして移動、拡張ボタンはSpaceでも実行
Arrow keysビューポートにフォーカスがある間、ネイティブのスクロールを使用

アクセシビリティ

基本のCarouselは、ネイティブのスクロール、スナップ、端で終わるフラグメントナビゲーションを備えたサーバーコンポーネントです。対話的な/clientエントリーはTier 2で、同期するドット、常時表示の矢印、コールバック、自動再生、マウスドラッグにはハイドレーションが必要です。/fadeはCSSの不透明度トランジションを追加します。フォーカスするとStartまで自動再生を停止し、ホバー中は一時停止します。動きを減らす設定では、既定で自動切り替えを無効にします。CSS生成コントロールのラボは実験的なものです。

スタイリングのフック

data-uiify-carouseldata-axisdata-enhanceddata-modedata-carousel-indexdata-statedata-dragging--uiify-carousel-slide-size--uiify-carousel-gap--uiify-carousel-fade-duration