译零 TransZero · TanStack Query 中文文档
主站

useIsMutating

更新于 2026-11-02 Vue 查看英文原文 ↗
TypeScript
1function useIsMutating(filters?: UseIsMutatingFilters, queryClient?: QueryClient): Ref<number>;

定义于:packages/vue-query/src/useMutationState.ts:55

useIsMutating 组合式函数返回一个 ref,指向你的应用当前正在 pending 的 number(适用于全应用范围的加载指示器)。

filters 可以是一个普通对象、MaybeRefDeep 或一个响应式 getter(() => ({ ... }));若过滤条件本身依赖其他响应式状态,请传入 getter。

参数

filters?

UseIsMutatingFilters = {}

用于缩小匹配范围的 MutationFilters。

queryClient?

QueryClient

使用此参数可指定自定义的 QueryClient;否则将使用 VueQueryPlugin 提供的 QueryClient。

返回值

Ref<number>

一个 ref,指向你的应用当前正在 pending 的 number。

示例

HTML
1<script setup lang="ts">2import { useIsMutating } from '@tanstack/vue-query'34// How many mutations matching the posts prefix are in progress?5const isMutatingPosts = useIsMutating({ mutationKey: ['posts'] })6</script>7 8<template>9  <span v-if="isMutatingPosts">Saving posts...</span>10</template>

本页为 TanStack Query 文档(Vue 版)的非官方中文翻译,原文由上游团队维护,遵循 MIT 许可。 译文如有偏差,以英文原文为准。

译自上游 59d11de