isWindowFocused

Category Elements

Tracks whether the window is focused or not.

Demo

💡 Click somewhere outside the window to lose focus

Usage

<script>
	import { isWindowFocused } from '@sv-use/core';
 
	const isFocused = isWindowFocused();
</script>

Type Definitions

import { type ConfigurableWindow } from '../__internal__/configurable.js';
import type { CleanupFunction } from '../__internal__/types.js';
interface IsWindowFocusedOptions extends ConfigurableWindow {
    /**
     * Whether to automatically cleanup the event listeners or not.
     *
     * If set to `true`, it must run in the component initialization lifecycle.
     * @default true
     */
    autoCleanup?: boolean;
}
type IsWindowFocusedReturn = {
    readonly current: boolean;
    /**
     * Cleans up the event listeners.
     * @note Called automatically if `options.autoCleanup` is `true`.
     */
    cleanup: CleanupFunction;
};
/**
 * Tracks whether the window is focused or not.
 * @param options Additional options to customize the behavior.
 * @see https://svelte-librarian.github.io/sv-use/docs/core/is-window-focused
 */
export declare function isWindowFocused(options?: IsWindowFocusedOptions): IsWindowFocusedReturn;
export {};

Sources

View Source Code • Demo • Docs