コンテンツにスキップ

useWindowSize

カテゴリ
エクスポートサイズ
964 B
最終更新
先週

リアクティブなウィンドウサイズ

デモ

無限 x 無限

使用法

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

const { width, height } = useWindowSize()

コンポーネントの使用法

この関数は、@vueuse/components パッケージを介してレンダーレスコンポーネントバージョンも提供します。使用法について詳しくはこちらをご覧ください

vue
<template>
  <UseWindowSize v-slot="{ width, height }">
    Width: {{ width }}
    Height: {{ height }}
  </UseWindowSize>
</template>

型宣言

typescript
export interface UseWindowSizeOptions extends ConfigurableWindow {
  initialWidth?: number
  initialHeight?: number
  /**
   * Listen to window `orientationchange` event
   *
   * @default true
   */
  listenOrientation?: boolean
  /**
   * Whether the scrollbar should be included in the width and height
   * Only effective when `type` is `'inner'`
   *
   * @default true
   */
  includeScrollbar?: boolean
  /**
   * Use `window.innerWidth` or `window.outerWidth`
   *
   * @default 'inner'
   */
  type?: "inner" | "outer"
}
/**
 * Reactive window size.
 *
 * @see https://vueuse.dokyumento.jp/useWindowSize
 * @param options
 */
export declare function useWindowSize(options?: UseWindowSizeOptions): {
  width: Ref<number, number>
  height: Ref<number, number>
}
export type UseWindowSizeReturn = ReturnType<typeof useWindowSize>

ソース

ソースデモドキュメント

貢献者

Anthony Fu
Jelf
Antério Vieira
Anthony Fu
Al-Khawarizmi
Indrek Ardel
Zhousg
vaakian X
vaakian X
Shinigami
wheat
Alex Kozack
Roman Pavlov

変更履歴

v12.0.0-beta.1 2024/11/21
0a9ed - feat!: Vue 2 のサポートを削除、バンドルを最適化、クリーンアップ (#4349)
v11.0.0-beta.2 2024/07/17
bfba3 - feat: ウィンドウの外側のサイズを取得する機能を追加 (#3999)
v10.0.0-beta.3 2023/04/12
4e7b0 - fix!: orientationchange リスナーの代わりにメディアクエリを使用 (#2919)
v9.11.0 2023/01/17
d5321 - fix(components): defineComponent を pure としてマーク (#2623)

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