スクロールシャドウ

コンテンツがスクロールでオーバーフローしたときに、上部と下部に影を適用します。


インストール

npx nextui-cli@latest add scroll-shadow
上記のコマンドは個別インストール専用です。もし @nextui-org/react がグローバルにインストール済みの場合は、このステップをスキップできます。

インポート

使用方法

スクロールバーを非表示にする

hideScrollBar プロパティを使用すると、縦横のスクロールバーを非表示にできます。

カスタムシャドウサイズ

デフォルトでは、シャドウのサイズはピクセル単位で 40 ですが、size プロパティを使用して変更できます。

水平方向

水平スクロールにシャドウを適用する必要がある場合は、orientation プロパティを horizontal に設定できます。

シャドウオフセット

デフォルトでは、シャドウオフセットはピクセル単位で 0 ですが、offset プロパティを使用して変更できます。これにより、特定の場所にシャドウを適用できます。

API

ShadowScrollのプロパティ

属性説明デフォルト
sizenumberシャドウのサイズ(ピクセル単位)。40
offsetnumberシャドウを表示するスクロールオフセット(ピクセル単位)。0
hideScrollBarbooleanスクロールバーを非表示にするかどうか。false
orientationhorizontal | verticalスクロール方向。vertical
isEnabledbooleanシャドウを有効にするかどうか。
可視性ScrollShadowVisibility影の可視性。(制御されます)自動

ShadowScroll イベント

属性説明
onVisibilityChange(visibility: ScrollShadowVisibility) => void影の可視性が変更されたときに呼び出されるコールバック。

スクロール影の可視性

type ScrollShadowVisibility = "auto" | "top" | "bottom" | "left" | "right" | "both" | "none";