コンテンツにスキップ

useWindowScroll

カテゴリ
エクスポートサイズ
555 B
最終変更日
先週

リアクティブなウィンドウスクロール

デモ

画面の右下隅にスクロール値が表示されます。
スクロール値
x: 0
y: 0

使用方法

js
import { useWindowScroll } from '@vueuse/core'

const { x, y } = useWindowScroll()
console.log(x.value) // read current x scroll value
y.value = 100 // scroll y to 100

型宣言

typescript
export interface UseWindowScrollOptions extends ConfigurableWindow {
  behavior?: ScrollBehavior
}
/**
 * Reactive window scroll.
 *
 * @see https://vueuse.dokyumento.jp/useWindowScroll
 * @param options
 */
export declare function useWindowScroll(options?: UseWindowScrollOptions): {
  x: Ref<number, number>
  y: Ref<number, number>
}
export type UseWindowScrollReturn = ReturnType<typeof useWindowScroll>

ソース

ソースデモドキュメント

貢献者

Anthony Fu
Nurettin Kaya
Antério Vieira
Anthony Fu
Chen
Jelf
webfansplz
Maik Kowol
Shinigami
Alex Kozack

変更履歴

v12.0.0-beta.1 2024/11/21
0a9ed - feat!: Vue 2 サポートの削除、バンドルの最適化、クリーンアップ (#4349)
v10.6.0 2023/11/9
931b2 - feat: スクロールへの書き戻しを許可する (#3500)
v9.13.0 2023/2/18
e490a - fix: `pageXOffset` の代わりに `scrollX` を使用する (#2776)
v9.7.0 2022/12/16
5df0a - fix: 設定されたウィンドウで onScroll を使用する (#2545)

MITライセンスの下でリリースされています。