Files
upstream-mirror 3a013ccdfe
Some checks failed
autofix.ci / autofix (push) Failing after 4s
Release / Release (push) Has been skipped
GitHub Actions Security Analysis / Run zizmor (push) Failing after 2s
snapshot of https://github.com/TanStack/query.git (main, 2026-09-16; blobs > 131072B omitted)
2026-09-16 01:13:08 +05:00

72 lines
1.7 KiB
Markdown

---
id: query-keys
title: Query Keys
ref: docs/framework/react/guides/query-keys.md
replace:
{
'@tanstack/react-query': '@tanstack/solid-query',
'useMutationState[(]': 'useMutationState(() => ',
'useMutation[(]': 'useMutation(() => ',
'useQuery[(]': 'useQuery(() => ',
'useQueries[(]': 'useQueries(() => ',
'useInfiniteQuery[(]': 'useInfiniteQuery(() => ',
'React Query Keys': 'TanStack Query Keys',
}
---
[//]: # 'Example'
```tsx
// A list of todos
useQuery(() => ({ queryKey: ['todos'], ... }))
// Something else, whatever!
useQuery(() => ({ queryKey: ['something', 'special'], ... }))
```
[//]: # 'Example'
[//]: # 'Example2'
```tsx
// An individual todo
useQuery(() => ({ queryKey: ['todo', 5], ... }))
// An individual todo in a "preview" format
useQuery(() => ({ queryKey: ['todo', 5, { preview: true }], ...}))
// A list of todos that are "done"
useQuery(() => ({ queryKey: ['todos', { type: 'done' }], ... }))
```
[//]: # 'Example2'
[//]: # 'Example3'
```tsx
useQuery(() => ({ queryKey: ['todos', { status, page }], ... }))
useQuery(() => ({ queryKey: ['todos', { page, status }], ...}))
useQuery(() => ({ queryKey: ['todos', { page, status, other: undefined }], ... }))
```
[//]: # 'Example3'
[//]: # 'Example4'
```tsx
useQuery(() => ({ queryKey: ['todos', status, page], ... }))
useQuery(() => ({ queryKey: ['todos', page, status], ...}))
useQuery(() => ({ queryKey: ['todos', undefined, page, status], ...}))
```
[//]: # 'Example4'
[//]: # 'Example5'
```tsx
function Todos(props) {
const todosQuery = useQuery(() => ({
queryKey: ['todos', props.todoId],
queryFn: () => fetchTodoById(props.todoId),
}))
}
```
[//]: # 'Example5'