useActiveElement

カテゴリ

要素

エクスポートサイズ

712 B

最終更新日

先週

リアクティブなdocument.activeElement

デモ

ソースコード

以下の入力項目を選択して変更を確認してください。

現在のアクティブ要素: null

使用方法

JavaScript

import { useActiveElement } from '@vueuse/core'

const activeElement = useActiveElement()

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

コンポーネントでの使用方法

この関数は、`@vueuse/components` パッケージを介してレンダーレスコンポーネントバージョンも提供します。使用方法の詳細はこちら。

Vue

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

型定義

TypeScript

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.dokyumento.jp/useActiveElement
 * @param options
 */
export declare function useActiveElement<T extends HTMLElement>(
  options?: UseActiveElementOptions,
): Ref<T | null | undefined, T | null | undefined>