跳到内容

useInterval

分类
导出大小
453 B
最后更改
5 天前

响应式计数器在每个间隔递增

演示

间隔触发次数:0

用法

js
import { useInterval } from '@vueuse/core'

// count will increase every 200ms
const counter = useInterval(200)
ts
const { counter, reset, pause, resume } = useInterval(200, { controls: true })

类型声明

typescript
export interface UseIntervalOptions<Controls extends boolean> {
  /**
   * Expose more controls
   *
   * @default false
   */
  controls?: Controls
  /**
   * Execute the update immediately on calling
   *
   * @default true
   */
  immediate?: boolean
  /**
   * Callback on every interval
   */
  callback?: (count: number) => void
}
export interface UseIntervalControls {
  counter: ShallowRef<number>
  reset: () => void
}
/**
 * Reactive counter increases on every interval
 *
 * @see https://vueuse.org.cn/useInterval
 * @param interval
 * @param options
 */
export declare function useInterval(
  interval?: MaybeRefOrGetter<number>,
  options?: UseIntervalOptions<false>,
): ShallowRef<number>
export declare function useInterval(
  interval: MaybeRefOrGetter<number>,
  options: UseIntervalOptions<true>,
): UseIntervalControls & Pausable

源代码

SourceDemoDocs

贡献者

Anthony Fu
IlyaL
Jelf
Anthony Fu
mohammadhosry
Waleed Khaled
vaakian X
Nurettin Kaya

更新日志

v12.8.0 于 2025/3/5
7432f - feat(types): 弃用 MaybeRef 和 MaybeRefOrGetter,转而使用 Vue 原生类型 (#4636)
v12.0.0-beta.1 于 2024/11/21
0a9ed - feat!: 移除 Vue 2 支持,优化包并清理代码 (#4349)
v10.0.0-beta.4 于 2023/4/13
4d757 - feat(types)!: 将 MaybeComputedRef 重命名为 MaybeRefOrGetter
v9.13.0 于 2023/2/18
db66c - fix: 修复类型
81db6 - feat: 添加 reset 函数 (#2686)

在 MIT 许可证下发布。