fn
useLocalStorage
v0.0.12testeddemoReactive localStorage binding — creates a ref synced with `window.localStorage`
Examples
ts
const count = useLocalStorage('my-count', 0);ts
const state = useLocalStorage('my-state', { hello: 'world' });Demo
Loading demo…
Signatures
ts
export function useLocalStorage<T extends string>(key: MaybeRefOrGetter<string>, initialValue: MaybeRefOrGetter<T>, options?: UseStorageOptions<T>): RemovableRef<T>;ts
export function useLocalStorage<T extends number>(key: MaybeRefOrGetter<string>, initialValue: MaybeRefOrGetter<T>, options?: UseStorageOptions<T>): RemovableRef<T>;ts
export function useLocalStorage<T extends boolean>(key: MaybeRefOrGetter<string>, initialValue: MaybeRefOrGetter<T>, options?: UseStorageOptions<T>): RemovableRef<T>;ts
export function useLocalStorage<T>(key: MaybeRefOrGetter<string>, initialValue: MaybeRefOrGetter<T>, options?: UseStorageOptions<T>): RemovableRef<T>;ts
export function useLocalStorage<T = unknown>(key: MaybeRefOrGetter<string>, initialValue: MaybeRefOrGetter<null>, options?: UseStorageOptions<T>): RemovableRef<T>;Type Parameters
TParameters
| Parameter | Type | Description |
|---|---|---|
key | MaybeRefOrGetter<string> | The storage key (can be reactive) |
initialValue | MaybeRefOrGetter<T> | The initial/default value |
options? | UseStorageOptions<T> | Options |
Returns
RemovableRef<T>A reactive ref synced with localStorage