Skip to content

useInterval

类别
导出体积
453 B
上次更改
5 days ago

在每个间隔上增加的响应式计数器

示例

间隔: 0

使用方法

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

// 每200ms计数增加一次
const counter = useInterval(200)
ts
const { counter, reset, pause, resume } = useInterval(200, { controls: true })

类型声明

typescript
export interface UseIntervalOptions<Controls extends boolean> {
  /**
   * 暴露更多控制选项
   *
   * @default false
   */
  controls?: Controls
  /**
   * 在调用时立即执行更新
   *
   * @default true
   */
  immediate?: boolean
  /**
   * 每个间隔上的回调函数
   */
  callback?: (count: number) => void
}
export interface UseIntervalControls {
  counter: ShallowRef<number>
  reset: () => void
}
export type UseIntervalReturn =
  | Readonly<ShallowRef<number>>
  | Readonly<UseIntervalControls & Pausable>
/**
 * 每个间隔上增加的响应式计数器
 *
 * @see https://vueuse.org/useInterval
 * @param interval
 * @param options
 */
export declare function useInterval(
  interval?: MaybeRefOrGetter<number>,
  options?: UseIntervalOptions<false>,
): Readonly<ShallowRef<number>>
export declare function useInterval(
  interval: MaybeRefOrGetter<number>,
  options: UseIntervalOptions<true>,
): Readonly<UseIntervalControls & Pausable>

源码

源码演示文档

贡献者

Anthony Fu
一纸忘忧
IlyaL
Jelf
Robin
Anthony Fu
mohammadhosry
Waleed Khaled
vaakian X
Nurettin Kaya

更新日志

c1d6e - feat(shared): ensure return types exists (#4659)
7432f - feat(types): deprecate MaybeRef and MaybeRefOrGetter in favor of Vue's native (#4636)
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)
4d757 - feat(types)!: rename MaybeComputedRef to MaybeRefOrGetter