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,40 @@
+---
+category: Sensors
+---
+
+# useTextSelection
+
+Reactively track user text selection based on [`Window.getSelection`](https://developer.mozilla.org/en-US/docs/Web/API/Window/getSelection).
+
+## Usage
+
+```vue
+<script setup lang="ts">
+import { useTextSelection } from '@vueuse/core';
+
+const state = useTextSelection();
+</script>
+
+<template>
+  <p>{{ state.text }}</p>
+</template>
+```
+
+## Type Declarations
+
+```ts
+/**
+ * Reactively track user text selection based on [`Window.getSelection`](https://developer.mozilla.org/en-US/docs/Web/API/Window/getSelection).
+ *
+ * @see https://vueuse.org/useTextSelection
+ *
+ * @__NO_SIDE_EFFECTS__
+ */
+export declare function useTextSelection(options?: ConfigurableWindow): {
+  text: ComputedRef<string>;
+  rects: ComputedRef<DOMRect[]>;
+  ranges: ComputedRef<Range[]>;
+  selection: ShallowRef<Selection | null, Selection | null>;
+};
+export type UseTextSelectionReturn = ReturnType<typeof useTextSelection>;
+```