Skip to content

useElementBounding

Category
Export Size
1.15 kB
Last Changed
last year

获取 HTML 元素的响应式 边界框

Demo

调整框大小以查看更改

用法

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

export default {
  setup() {
    const el = ref(null)
    const { x, y, top, right, bottom, left, width, height }
        = useElementBounding(el)

    return {
      el,
      /* ... */
    }
  },
}
</script>

<template>
  <div ref="el" />
</template>

组件用法

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

类型声明

typescript
export interface UseElementBoundingOptions {
  /**
   * 在组件卸载时将值重置为 0
   *
   * @default true
   */
  reset?: boolean
  /**
   * 监听窗口大小调整事件
   *
   * @default true
   */
  windowResize?: boolean
  /**
   * 监听窗口滚动事件
   *
   * @default true
   */
  windowScroll?: boolean
  /**
   * 组件挂载时立即调用更新
   *
   * @default true
   */
  immediate?: boolean
}
/**
 * HTML 元素的响应式边界框。
 *
 * @see https://vueuse.org/useElementBounding
 * @param target
 */
export declare function useElementBounding(
  target: MaybeComputedElementRef,
  options?: UseElementBoundingOptions,
): {
  height: Ref<number>
  bottom: Ref<number>
  left: Ref<number>
  right: Ref<number>
  top: Ref<number>
  width: Ref<number>
  x: Ref<number>
  y: Ref<number>
  update: () => void
}
export type UseElementBoundingReturn = ReturnType<typeof useElementBounding>

Source

SourceDemoDocs

贡献者

Anthony Fu
Jelf
wheat
丶远方
huiliangShen
vaakian X
Ducz01
hsyq
Hebilicious
webfansplz
Ciro Lo Sapio
Shinigami
Alex Kozack

变更日志

v10.7.1 on 12/27/2023
70dbd - fix: trigger by css or style (#3664)
v9.11.0 on 1/17/2023
d5321 - fix(components): mark defineComponent as pure (#2623)
v9.10.0 on 1/3/2023
268a6 - fix: update on scroll (#2596)

Released under the MIT License.

Build faster with AI
New Masterclass to help you leverage AI in your Vue workflow.
Get Early Access