异步初始值 | TanStack Form Vue Docs

假设您想要从 API 获取一些数据并将其用作表单的初始值。

虽然这个问题在表面上听起来很简单，但有一些您可能还没有想到的隐藏复杂性。

例如，您可能希望在获取数据时显示加载旋转器，或者您可能希望优雅地处理错误。

同样，您也可能发现自己在寻找一种缓存数据的方法，这样就不必每次渲染表单时都获取数据。

虽然我们可以从头开始实现许多这些功能，但最终看起来会很像我们维护的另一个项目：TanStack Query。

因此，本指南向您展示如何将 TanStack Form 与 TanStack Query 混合搭配以实现所需的行为。

基本用法

vue

<script setup lang="ts">
import { useForm } from '@tanstack/vue-form'
import { useQuery } from '@tanstack/vue-query'
import { watchEffect, reactive } from 'vue'

const { data, isLoading } = useQuery({
  queryKey: ['data'],
  queryFn: async () => {
    await new Promise((resolve) => setTimeout(resolve, 1000))
    return { firstName: 'FirstName', lastName: 'LastName' }
  },
})

const firstName = computed(() => data.value?.firstName || '')
const lastName = computed(() => data.value?.lastName || '')

const defaultValues = reactive({
  firstName,
  lastName,
})

const form = useForm({
  defaultValues,
  onSubmit: async ({ value }) => {
    // 对表单数据进行处理
    console.log(value)
  },
})
</script>

<template>
  <p v-if="isLoading">加载中..</p>
  <form v-else @submit.prevent.stop="form.handleSubmit">
    <!-- ... -->
  </form>
</template>

<script setup lang="ts">
import { useForm } from '@tanstack/vue-form'
import { useQuery } from '@tanstack/vue-query'
import { watchEffect, reactive } from 'vue'

const { data, isLoading } = useQuery({
  queryKey: ['data'],
  queryFn: async () => {
    await new Promise((resolve) => setTimeout(resolve, 1000))
    return { firstName: 'FirstName', lastName: 'LastName' }
  },
})

const firstName = computed(() => data.value?.firstName || '')
const lastName = computed(() => data.value?.lastName || '')

const defaultValues = reactive({
  firstName,
  lastName,
})

const form = useForm({
  defaultValues,
  onSubmit: async ({ value }) => {
    // 对表单数据进行处理
    console.log(value)
  },
})
</script>

<template>
  <p v-if="isLoading">加载中..</p>
  <form v-else @submit.prevent.stop="form.handleSubmit">
    <!-- ... -->
  </form>
</template>

这将显示加载文本，直到获取数据，然后使用获取的数据作为初始值渲染表单。