useActiveElement

类别

Elements

导出体积

1.19 kB

上次更改

4 minutes ago

响应式地获取 document.activeElement

示例

源码 playground (beta)

选择下面的 input 查看当前激活的元素

当前激活的元素: null

用法

vue

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

const activeElement = useActiveElement()

watch(activeElement, (el) => {
  console.log('当前活动元素是', el)
})
</script>

组件用法

vue

<template>
  <UseActiveElement v-slot="{ element }">
    当前活动元素是 {{ element.dataset.id }}
  </UseActiveElement>
</template>

类型声明

typescript

export interface UseActiveElementOptions
  extends ConfigurableWindow,
    ConfigurableDocumentOrShadowRoot {
  /**
   * 在 shadow dom 中深度搜索活动元素
   *
   * @default true
   */
  deep?: boolean
  /**
   * Track active element when it's removed from the DOM
   * Using a MutationObserver under the hood
   * @default false
   */
  triggerOnRemoval?: boolean
}
/**
 * Reactive `document.activeElement`
 *
 * @see https://vueuse.org/useActiveElement
 * @param options
 *
 * @__NO_SIDE_EFFECTS__
 */
export declare function useActiveElement<T extends HTMLElement>(
  options?: UseActiveElementOptions,
): ShallowRef<T | null | undefined, T | null | undefined>