Skip to content

useCurrentElement

Category
Export Size
355 B
Last Changed
last month

将当前组件的 DOM 元素作为 ref 返回。

Demo

打开console.log查看元素

用法

ts
import { useCurrentElement } from '@vueuse/core'

const el = useCurrentElement() // ComputedRef<Element>

或者传递一个特定的 Vue 组件

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

const componentRef = ref()

const el = useCurrentElement(componentRef) // ComputedRef<Element>
</script>

<template>
  <div>
    <OtherVueComponent ref="componentRef" />
    <p>Hello world</p>
  </div>
</template>

INFO

仅适用于 Vue 3,因为它在底层使用了 computedWithControl

注意事项

此函数在底层使用 $el

在组件挂载之前,ref 的值将为 undefined

  • 对于具有单个根元素的组件,它将指向该元素。
  • 对于具有文本根的组件,它将指向文本节点。
  • 对于具有多个根节点的组件,它将是 Vue 用于跟踪组件在 DOM 中位置的占位符 DOM 节点。

建议仅对具有 单个根元素 的组件使用此函数。

类型声明

typescript
export declare function useCurrentElement<
  T extends MaybeElement = MaybeElement,
  R extends VueInstance = VueInstance,
  E extends MaybeElement = MaybeElement extends T
    ? IsAny<R["$el"]> extends false
      ? R["$el"]
      : T
    : T,
>(rootComponent?: MaybeElementRef<R>): ComputedRefWithControl<E>

Source

SourceDemoDocs

贡献者

丶远方
Anthony Fu
山吹色御守
空杯
Jessé Correia Lins
vaakian X
Anthony Fu

变更日志

v11.1.0 on 9/16/2024
8e141 - feat: try to infer type from $el (#4202)
v10.8.0 on 2/20/2024
0a9aa - feat: Allow get current element from a specific component (#3750)

Released under the MIT License.