useQueries
useQueries hook 可用于获取可变数量的查询。
tsx
const ids = [1, 2, 3]
const results = useQueries(() => {
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
staleTime: Infinity,
})),
})
const ids = [1, 2, 3]
const results = useQueries(() => {
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
staleTime: Infinity,
})),
})
选项
useQueries hook 接受一个选项对象，其中包含一个 queries 键，其值是一个包含查询选项对象的数组，这些对象与 useQuery hook 中的对象完全相同（不包括 queryClient 选项 - 因为 QueryClient 可以在顶层传递）。
- queryClient?: QueryClient
- 使用此选项提供自定义 QueryClient。否则，将使用最近的上下文中的 QueryClient。
- combine?: (result: UseQueriesResults) => TCombinedResult
- 使用此选项将查询结果合并为单个值。
在查询对象数组中多次出现相同的查询键可能会导致某些数据在查询之间共享。为避免这种情况，请考虑对查询进行去重，并将结果映射回所需的结构。
placeholderData
placeholderData 选项也存在于 useQueries 中，但它不像 useQuery 那样从先前渲染的查询中获取信息，因为 useQueries 的输入在每次渲染时都可以是不同数量的查询。
Returns (返回)
useQueries hook 返回一个包含所有查询结果的数组。返回的顺序与输入顺序相同。
组合
如果您想将结果中的 data（或其他查询信息）合并为一个值，可以使用 combine 选项。结果将在结构上共享，以实现尽可能高的引用稳定性。
tsx
const ids = [1, 2, 3]
const combinedQueries = useQueries(() => {
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
})),
combine: (results) => {
return {
data: results.map((result) => result.data),
pending: results.some((result) => result.isPending),
}
},
})
const ids = [1, 2, 3]
const combinedQueries = useQueries(() => {
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
})),
combine: (results) => {
return {
data: results.map((result) => result.data),
pending: results.some((result) => result.isPending),
}
},
})
在上例中，combinedQueries 将是一个包含 data 和 pending 属性的对象。请注意，查询结果的所有其他属性都将丢失。
记忆化
combine 函数仅在以下情况重新运行时：
- combine 函数本身在引用上已更改
- 任何查询结果已更改
这意味着，如上所示的内联 combine 函数将在每次渲染时运行。为避免这种情况，您可以将 combine 函数包装在 useCallback 中，或者将其提取到一个稳定的函数引用中，如果它没有任何依赖项。
