useElementSize

カテゴリ

要素

エクスポートサイズ

955 B

最終変更日

先週

HTML要素のリアクティブサイズ。 ResizeObserver MDN

デモ

ソース

ボックスのサイズを変更して変化を確認してください。

使用方法

Vue

<script>
import { useElementSize } from '@vueuse/core'
import { ref } from 'vue'

export default {
  setup() {
    const el = ref(null)
    const { width, height } = useElementSize(el)

    return {
      el,
      width,
      height,
    }
  }
}
</script>

<template>
  <div ref="el">
    Height: {{ height }}
    Width: {{ width }}
  </div>
</template>

コンポーネントの使用

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

Vue

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

ディレクティブの使用

この関数は、@vueuse/componentsパッケージを介して、ディレクティブバージョンも提供します。使用方法の詳細はこちら。

Vue

<script setup lang="ts">
import { vElementSize } from '@vueuse/components'
function onResize({ width, height }: { width: number, height: number }) {
  console.log(width, height)
}
</script>

<template>
  <textarea v-element-size="onResize" />
  <!-- with options -->
  <textarea v-element-size="[onResize, { width: 100, height: 100 }, { box: 'content-box' }]" />
</template>

型宣言

TypeScript

export interface ElementSize {
  width: number
  height: number
}
/**
 * Reactive size of an HTML element.
 *
 * @see https://vueuse.dokyumento.jp/useElementSize
 */
export declare function useElementSize(
  target: MaybeComputedElementRef,
  initialSize?: ElementSize,
  options?: UseResizeObserverOptions,
): {
  width: Ref<number, number>
  height: Ref<number, number>
  stop: () => void
}
export type UseElementSizeReturn = ReturnType<typeof useElementSize>