useActiveElement

分类

元素

导出大小

1.19 kB

上次更改

2 个月前

响应式的 document.activeElement

演示

源代码在线演练 (测试版)

选择下面的输入框查看变化

当前活动元素: null

用法

vue

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

const activeElement
 = useActiveElement
()

watch
(activeElement
, (el
) => {
  console
.log
('focus changed to', el
)
})
</script>

组件用法

此函数还通过 @vueuse/components 包提供了一个无渲染组件版本。了解更多用法。

vue

<template>
  <UseActiveElement v-slot="{ element
 }">
    Active element is {{ element
?.dataset.id }}
  </UseActiveElement>
</template>

类型声明

export interface UseActiveElementOptions
  extends ConfigurableWindow,
    ConfigurableDocumentOrShadowRoot {
  /**
   * Search active element deeply inside 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.cn/useActiveElement
 * @param options
 *
 * @__NO_SIDE_EFFECTS__
 */
export declare function useActiveElement
<T
 extends HTMLElement>(
  options
?: UseActiveElementOptions,
): ShallowRef
<T
 | null | undefined, T
 | null | undefined>
export type UseActiveElementReturn
 = ReturnType
<typeof useActiveElement
>