跳到主要內容

useWindowFocus

類別
匯出大小
590 B
上次變更
3 週前

透過 window.onfocuswindow.onblur 事件,反應式地追蹤視窗焦點。

範例

💡 點擊文件以外的任何位置以取消焦點。

用法

js
import { useWindowFocus } from '@vueuse/core'

const focused = useWindowFocus()

元件用法

此函式也透過 @vueuse/components 套件提供無渲染元件版本。深入了解用法

vue
<template>
  <UseWindowFocus v-slot="{ focused }">
    Document Focus: {{ focused }}
  </UseWindowFocus>
</template>

類型宣告

typescript
/**
 * Reactively track window focus with `window.onfocus` and `window.onblur`.
 *
 * @see https://vueuse.dev.org.tw/useWindowFocus
 */
export declare function useWindowFocus(
  options?: ConfigurableWindow,
): ShallowRef<boolean>

原始碼

原始碼範例文件

貢獻者

Anthony Fu
IlyaL
vaaski
Fernando Fernández
Anthony Fu
vaakian X

變更記錄

v12.4.0 於 2025/1/10
dd316 - feat: 盡可能在任何地方使用被動事件處理器 (#4477)
v12.0.0-beta.1 於 2024/11/21
0a9ed - feat!: 移除 Vue 2 支援、最佳化 bundle 並清理程式碼 (#4349)

以 MIT 授權條款發布。