占位符查询数据 | TanStack Query Solid Docs

什么是占位符数据？

占位符数据允许查询表现得好像它已经有数据一样，类似于 initialData 选项，但数据不会持久化到缓存中。这对于您有足够的局部（或伪造）数据以成功渲染查询，同时实际数据在后台获取的情况非常有用。

示例：单个博客文章查询可以从父博客文章列表中提取“预览”数据，该列表仅包含标题和文章正文的一小段。您不希望将此部分数据持久化到单个查询的查询结果中，但在实际查询完成获取整个对象时，它对于尽快显示内容布局非常有用。

有几种方法可以在需要之前为查询的缓存提供占位符数据：

声明式：
- 为查询提供 placeholderData 以在缓存为空时预填充其缓存
命令式：
- 使用 queryClient 和 placeholderData 选项预取或获取数据

当我们使用 placeholderData 时，我们的查询将不会处于 pending 状态——它将以 success 状态开始，因为我们有要显示的 data——即使该数据只是“占位符”数据。为了将其与“真实”数据区分开来，我们还将在查询结果上将 isPlaceholderData 标志设置为 true。

作为值的占位符数据

tsx

function Todos() {
  const result = useQuery(() => ({
    queryKey: ['todos'],
    queryFn: () => fetch('/todos'),
    placeholderData: placeholderTodos,
  }))
}

function Todos() {
  const result = useQuery(() => ({
    queryKey: ['todos'],
    queryFn: () => fetch('/todos'),
    placeholderData: placeholderTodos,
  }))
}

占位符数据记忆化

如果访问查询占位符数据的过程很密集，或者只是您不想在每次渲染时都执行的操作，则可以对值进行记忆化：

tsx

function Todos() {
  const placeholderData = createMemo(() => generateFakeTodos())
  const result = useQuery(() => ({
    queryKey: ['todos'],
    queryFn: () => fetch('/todos'),
    placeholderData: placeholderData(),
  }))
}

function Todos() {
  const placeholderData = createMemo(() => generateFakeTodos())
  const result = useQuery(() => ({
    queryKey: ['todos'],
    queryFn: () => fetch('/todos'),
    placeholderData: placeholderData(),
  }))
}

作为函数的占位符数据

placeholderData 也可以是一个函数，您可以在其中访问“先前”成功查询的数据和查询元信息。这对于您希望将一个查询的数据用作另一个查询的占位符数据的情况非常有用。当 QueryKey 更改时，例如从 ['todos', 1] 更改为 ['todos', 2]，我们可以继续显示“旧”数据，而不必在数据从一个查询_转换_到下一个查询时显示加载微调器。��关更多信息，请参阅分页查询。

tsx

const result = useQuery(() => ({
  queryKey: ['todos', id()],
  queryFn: () => fetch(`/todos/${id()}`),
  placeholderData: (previousData, previousQuery) => previousData,
}))

const result = useQuery(() => ({
  queryKey: ['todos', id()],
  queryFn: () => fetch(`/todos/${id()}`),
  placeholderData: (previousData, previousQuery) => previousData,
}))

来自缓存的占位符数据

在某些情况下，您可能能够从另一个查询的缓存结果中为您的查询提供占位符数据。一个很好的例子是从博客文章列表查询中搜索文章的预览版本，然后将其用作单个文章查询的占位符数据：

tsx

function Todo({ blogPostId }) {
  const queryClient = useQueryClient()
  const result = useQuery(() => ({
    queryKey: ['blogPost', blogPostId],
    queryFn: () => fetch(`/blogPosts/${blogPostId}`),
    placeholderData: () => {
      // 使用来自“blogPosts”查询的较小/预览版本的 blogPost
      // 作为此 blogPost 查询的占位符数据
      return queryClient
        .getQueryData(['blogPosts'])
        ?.find((d) => d.id === blogPostId)
    },
  }))
}

function Todo({ blogPostId }) {
  const queryClient = useQueryClient()
  const result = useQuery(() => ({
    queryKey: ['blogPost', blogPostId],
    queryFn: () => fetch(`/blogPosts/${blogPostId}`),
    placeholderData: () => {
      // 使用来自“blogPosts”查询的较小/预览版本的 blogPost
      // 作为此 blogPost 查询的占位符数据
      return queryClient
        .getQueryData(['blogPosts'])
        ?.find((d) => d.id === blogPostId)
    },
  }))
}

进一步阅读

有关占位符数据和初始数据之间的比较，请参阅社区资源。