1---
2category: Sensors
3---
4 
5# useTextSelection
6 
7Reactively track user text selection based on [`Window.getSelection`](https://developer.mozilla.org/en-US/docs/Web/API/Window/getSelection).
8 
9## Usage
10 
11```vue
12<script setup lang="ts">
13import { useTextSelection } from '@vueuse/core'
14 
15const state = useTextSelection()
16</script>
17 
18<template>
19  <p>{{ state.text }}</p>
20</template>
21```
22 
23## Type Declarations
24 
25```ts
26export interface UseTextSelectionOptions extends ConfigurableWindow {}
27export interface UseTextSelectionReturn {
28  text: ComputedRef<string>
29  rects: ComputedRef<DOMRect[]>
30  ranges: ComputedRef<Range[]>
31  selection: ShallowRef<Selection | null>
32}
33/**
34 * Reactively track user text selection based on [`Window.getSelection`](https://developer.mozilla.org/en-US/docs/Web/API/Window/getSelection).
35 *
36 * @see https://vueuse.org/useTextSelection
37 *
38 * @__NO_SIDE_EFFECTS__
39 */
40export declare function useTextSelection(
41  options?: UseTextSelectionOptions,
42): UseTextSelectionReturn
43```
44