f5792c40be
Pulled ALL skills from 15 source repositories: - anthropics/skills: 16 (docs, design, MCP, testing) - obra/superpowers: 14 (TDD, debugging, agents, planning) - coreyhaines31/marketingskills: 25 (marketing, CRO, SEO, growth) - better-auth/skills: 5 (auth patterns) - vercel-labs/agent-skills: 5 (React, design, Vercel) - antfu/skills: 16 (Vue, Vite, Vitest, pnpm, Turborepo) - Plus 13 individual skills from various repos Mosaic Stack is not limited to coding — the Orchestrator and subagents serve coding, business, design, marketing, writing, logistics, analysis, and more. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
103 lines
2.1 KiB
Markdown
103 lines
2.1 KiB
Markdown
---
|
|
category: Time
|
|
---
|
|
|
|
# useCountdown
|
|
|
|
Wrapper for `useIntervalFn` that provides a countdown timer.
|
|
|
|
## Usage
|
|
|
|
```ts
|
|
import { useCountdown } from '@vueuse/core'
|
|
|
|
const countdownSeconds = 5
|
|
const { remaining, start, stop, pause, resume } = useCountdown(countdownSeconds, {
|
|
onComplete() {
|
|
|
|
},
|
|
onTick() {
|
|
|
|
}
|
|
})
|
|
```
|
|
|
|
You can use a `ref` to change the initial countdown.
|
|
`start()` and `resume()` also accept a new countdown value for the next countdown.
|
|
|
|
```ts
|
|
import { useCountdown } from '@vueuse/core'
|
|
import { shallowRef } from 'vue'
|
|
|
|
const countdown = shallowRef(5)
|
|
const { start, reset } = useCountdown(countdown, {
|
|
})
|
|
|
|
// change the countdown value
|
|
countdown.value = 10
|
|
|
|
// start a new countdown with 2 seconds
|
|
start(2)
|
|
|
|
// reset the countdown to 4, but do not start it
|
|
reset(4)
|
|
|
|
// start the countdown with the current value of `countdown`
|
|
start()
|
|
```
|
|
|
|
## Type Declarations
|
|
|
|
```ts
|
|
export interface UseCountdownOptions {
|
|
/**
|
|
* Interval for the countdown in milliseconds. Default is 1000ms.
|
|
*/
|
|
interval?: MaybeRefOrGetter<number>
|
|
/**
|
|
* Callback function called when the countdown reaches 0.
|
|
*/
|
|
onComplete?: () => void
|
|
/**
|
|
* Callback function called on each tick of the countdown.
|
|
*/
|
|
onTick?: () => void
|
|
/**
|
|
* Start the countdown immediately
|
|
*
|
|
* @default false
|
|
*/
|
|
immediate?: boolean
|
|
}
|
|
export interface UseCountdownReturn extends Pausable {
|
|
/**
|
|
* Current countdown value.
|
|
*/
|
|
remaining: ShallowRef<number>
|
|
/**
|
|
* Resets the countdown and repeatsLeft to their initial values.
|
|
*/
|
|
reset: (countdown?: MaybeRefOrGetter<number>) => void
|
|
/**
|
|
* Stops the countdown and resets its state.
|
|
*/
|
|
stop: () => void
|
|
/**
|
|
* Reset the countdown and start it again.
|
|
*/
|
|
start: (countdown?: MaybeRefOrGetter<number>) => void
|
|
}
|
|
/**
|
|
* Wrapper for `useIntervalFn` that provides a countdown timer in seconds.
|
|
*
|
|
* @param initialCountdown
|
|
* @param options
|
|
*
|
|
* @see https://vueuse.org/useCountdown
|
|
*/
|
|
export declare function useCountdown(
|
|
initialCountdown: MaybeRefOrGetter<number>,
|
|
options?: UseCountdownOptions,
|
|
): UseCountdownReturn
|
|
```
|