useElementSize

分类

元素

导出大小

897 B

上次更改

8 个月前

HTML 元素的响应式大小。ResizeObserver MDN

演示

源代码演示 (beta)

调整盒子大小以查看变化

用法

vue

<script setup lang="ts">
import { useElementSize
 } from '@vueuse/core'
import { useTemplateRef
 } from 'vue'

const el
 = useTemplateRef
('el')
const { width
, height
 } = useElementSize
(el
)
</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-si
ze="onResize
" />
  <!-- with options -->
  <textarea
 v-element-si
ze="[
onResize
, { 
width
: 100, 
height
: 100 }, { 
box
: 'content-box' }]
" />
</template>

类型声明

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