Consultando com @Query
Busque e ordene dados persistidos nas visualizações.
Consultando com @Query é uma aula grátis de SwiftUI Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de SwiftUI Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de SwiftUI Academy inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Fetching Saved Data
To show stored records in a view, you fetch them with @Query. It reads from your container and keeps the view fresh. 🔍
The @Query Property
Declare an array property with @Query and SwiftData fills it with every matching record. No manual loading needed.
@Query private var tasks: [Task]Showing Results in a List
Pair @Query with a List to render rows from your data. Each saved object becomes one line on screen.
List(tasks) { task in
Text(task.title)
}Live Updates
A @Query view updates by itself when data changes. Insert a record and the list redraws with no extra work.
Sorting Results
Pass a sort key path to order your results. Here tasks come back alphabetically by title every time.
@Query(sort: \.title) var tasks: [Task]Sort Direction
Add order to sort ascending or descending. Newest-first lists feel natural for things like recent notes.
@Query(sort: \.due, order: .reverse)
var tasks: [Task]Filtering with Predicates
A #Predicate narrows results to records that match a rule. Only the rows you care about reach the view.
#Predicate<Task> { $0.isDone == false }Applying a Filter
Pass your predicate to @Query to fetch a filtered set. This view shows only the tasks still left to do.
@Query(filter: #Predicate<Task> {
!$0.isDone })
var open: [Task]Multiple Sort Keys
Give an array of SortDescriptor values to sort by more than one field. Tie-breaks make long lists feel ordered.
@Query(sort: [SortDescriptor(\.priority)])
var tasks: [Task]Counting and Empty States
Check the array's isEmpty to show a friendly placeholder. A clear empty state guides new users gently.
if tasks.isEmpty {
Text("No tasks yet")
}Queries Stay in Sync
Because @Query watches the store, your UI never drifts from the data. Save once and every query reflects it.
Quick Check
Quick check on querying data.
Recap: Querying
You used @Query to fetch, sort, and filter saved data, and watched the view stay live. Reading from SwiftData is now second nature. 🎯
Aprenda Swift com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Consultando com @Query” é grátis?
Sim — o texto completo de “Consultando com @Query” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de SwiftUI Academy, atualize para CoddyKit PRO. O curso de SwiftUI Academy inclui 4 aulas no total.
O que vou aprender em “Consultando com @Query”?
Busque e ordene dados persistidos nas visualizações. Você pratica SwiftUI Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar SwiftUI Academy?
Nenhuma experiência prévia é necessária. SwiftUI Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Consultando com @Query”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de SwiftUI Academy?
Sim. Cada aula de SwiftUI Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Definindo Tipos @Model
- O Contêiner e o Contexto do Modelo
- Consultando com @Query
- Inserindo, Atualizando e Excluindo