⚗️ Vue Query Nuxt

🚀 欢迎来到 Vue Query Nuxt！

此 Nuxt 模块会自动为您的 Nuxt 应用程序安装和配置 Vue Query。它开箱即用，无需配置，并且极其轻量。

特性

开箱即用，无需配置
所有配置选项均可用
Vue Query composables 的自动导入

有关 Vue Query 的更多信息，请参阅 Vue Query 文档。

📦 如何使用

1. 使用 npm、pnpm 或 yarn 安装依赖项。

# npm
npm i @hebilicious/vue-query-nuxt @tanstack/vue-query  
# pnpm
pnpm i @hebilicious/vue-query-nuxt @tanstack/vue-query  
# yarn
yarn add @hebilicious/vue-query-nuxt @tanstack/vue-query

2. 将模块添加到您的 Nuxt 模块中

在 nuxt.config.ts 中

export default defineNuxtConfig({
  modules: ["@hebilicious/vue-query-nuxt"]
})

3. 立即使用

在 vue 组件中

<script setup lang="ts">
// Access QueryClient instance
const queryClient = useQueryClient()

// Query
const { isLoading, isError, data, error } = useQuery({
  queryKey: ['todos'],
  queryFn: () => $fetch("/api/todos"), // Use $fetch with your api routes to get typesafety 
})

// Mutation
const { mutate } = useMutation({
  mutationFn: (newTodo) => $fetch("/api/todos", { method: "POST", body: newTodo })
  onSuccess: () => {
    // Invalidate and refetch
    queryClient.invalidateQueries({ queryKey: ['todos'] })
  },
})

function onButtonClick() {
   mutate({
    id: Date.now(),
    title: 'Do Laundry',
  })
}
</script>

<template>
  <span v-if="isLoading">Loading...</span>
  <span v-else-if="isError">Error: {{ error.message }}</span>
  <!-- We can assume by this point that `isSuccess === true` -->
  <ul v-else>
    <li v-for="todo in data" :key="todo.id">{{ todo.title }}</li>
  </ul>
  <button @click="onButtonClick">Add Todo</button>
</template>

4. 高级配置

您可以在 nuxt.config.ts 文件中的 vueQuery 键下指定选项。一切都是类型化的。

在 nuxt.config.ts 中

export default defineNuxtConfig({
  modules: ["@hebilicious/vue-query-nuxt"],
  vueQuery: {
    // useState key used by nuxt for the vue query state.
    stateKey: "vue-query-nuxt", // default
    // If you only want to import some functions, specify them here.
    // You can pass false or an empty array to disable this feature.
    // default: ["useQuery", "useQueries", "useInfiniteQuery", "useMutation", "useIsFetching", "useIsMutating", "useQueryClient"]
    autoImports: ["useQuery"],
    // Pass the vue query client options here ...
    queryClientOptions: {
      defaultOptions: { queries: { staleTime: 5000 } } // default
    },
    // Pass the vue query plugin options here ....
    vueQueryPluginOptions: {}
  }
})

如果您需要修改安装 vue query 的插件，您可以在项目的根目录创建一个 vue-query.config.ts 文件。

在 vue-query.config.ts 中

import { library } from "@example/libray"

export default defineVueQueryPluginHook(({ queryClient, nuxt }) => {
  console.log(queryClient, nuxt) // You can access the queryClient here
  return {
    pluginReturn: { provide: { library, test: console } }, // nuxt plugin return value
    vueQueryPluginOptions: { queryClient } // You can pass dynamic options
  }
})

此钩子将在模块安装的 nuxt 插件中运行，因此您可以使用它来 provide 某些内容或替换 vue query 选项。如果您需要在安装 queryClient 时运行自定义逻辑，这会很有用。

📦 贡献

欢迎贡献、提交问题和提出功能请求！

Fork 这个仓库
安装 node 和 pnpm 使用 corepack enable && corepack prepare pnpm@latest --activate 轻松安装 pnpm
在 mono-repo 根目录使用 pnpm i。
进行修改并遵循常规提交。
打开一个 PR 🚀🚀🚀