chore: consolidate new foundation and archive v1 (#1495)

2026-09-07 12:32:57 -05:00
parent 9a5fbdbda7 5d27700026
commit 127a54fdff
3511 changed files with 727899 additions and 10 deletions
@@ -0,0 +1,64 @@
+---
+category: Elements
+---
+
+# useActiveElement
+
+Reactive `document.activeElement`
+
+## Usage
+
+```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>
+```
+
+## Component Usage
+
+```vue
+<template>
+  <UseActiveElement v-slot="{ element }">
+    Active element is {{ element?.dataset.id }}
+  </UseActiveElement>
+</template>
+```
+
+## Type Declarations
+
+```ts
+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/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>;
+```