Menampilkan data di SwiftUI terasa mudah sampai daftar mulai panjang dan isinya bercampur status kosong, loading, serta error. Tips menampilkan data di SwiftUI untuk pemula berikut membandingkan komponen yang tersedia dan kapan sebaiknya memakai masing-masing.
Mulai dari bentuk data, bukan dari komponen
Sebelum menulis tampilan, tentukan dulu apakah data punya identitas unik, apakah jumlahnya bisa ratusan baris, dan apakah tiap baris punya aksi sendiri. Jawaban itu yang menentukan pilihan komponen. Kalau kamu memulai dari komponen, biasanya berakhir dengan ScrollView berisi VStack yang memuat semua baris sekaligus, termasuk yang belum terlihat di layar.
Model data sebaiknya memakai Identifiable. SwiftUI memakai id itu untuk menentukan baris mana yang berubah, sehingga animasi dan pembaruan tetap rapi saat daftar disaring atau diurutkan ulang.
struct Catatan: Identifiable {
let id = UUID()
var judul: String
var tanggal: Date
}
List vs LazyVStack vs Grid: perbandingan singkat
Ketiganya bisa menampilkan banyak item, tetapi perilakunya berbeda. Berikut perbandingan yang bisa langsung dipakai sebagai patokan.
| Komponen | Cocok untuk | Catatan |
|---|---|---|
List |
Daftar baris standar, pengaturan, kotak masuk | Sudah membawa gaya baris, pemisah, dan gestur hapus |
LazyVStack |
Tampilan baris kustom yang tidak ingin dibungkus gaya List | Butuh ScrollView di luar dan pengaturan pemisah manual |
LazyVGrid |
Galeri foto, kartu produk, kisi dua sampai empat kolom | Tentukan jumlah kolom lewat GridItem |
List menjadi pilihan default karena SwiftUI sudah menangani tinggi baris, aksesibilitas, dan pemuatan bertahap. Pindah ke LazyVStack hanya ketika kamu butuh kendali penuh atas latar dan jarak antar baris, misalnya pada layar yang seluruhnya memakai desain kustom.
Satu hal yang sering terlewat: VStack biasa di dalam ScrollView membuat semua baris dibuat saat layar pertama muncul. Untuk data lebih dari beberapa puluh item, biaya itu terasa di perangkat lama.
Pilih penyimpanan sebelum menyusun tampilan
Tampilan daftar selalu bergantung pada sumber data. Kalau isinya kecil, seperti daftar pengaturan, penyimpanan sederhana sudah cukup. Untuk data yang bertambah dan perlu disaring, SwiftData atau Core Data lebih masuk akal karena menyediakan kueri dan pembaruan otomatis. Perbandingan pilihan penyimpanan lokal di Swift bisa jadi titik awal sebelum kamu menulis kode tampilan.
Kesalahan umum pemula adalah menyimpan array hasil kueri ke dalam @State lalu menyaringnya manual. Hasilnya, daftar tidak ikut berubah saat data di belakang berubah. Pakai @Query atau @FetchRequest agar tampilan langsung mengikuti isi penyimpanan.
Tangani empat keadaan: kosong, loading, error, dan terisi
Daftar yang hanya menangani keadaan terisi akan terlihat rusak saat pertama dibuka. Buat satu penampung yang memutuskan apa yang ditampilkan berdasarkan keadaan tersebut, supaya logika tidak tersebar di banyak tempat.
- Loading hanya muncul pada pemuatan pertama, bukan setiap kali daftar diperbarui.
- Kosong butuh pesan yang menjelaskan langkah berikutnya, bukan sekadar teks “tidak ada data”.
- Error sebaiknya menyertakan tombol coba lagi dan pesan yang bisa ditindaklanjuti.
- Terisi menampilkan daftar, biasanya dengan animasi halus saat item bertambah.
Untuk keadaan loading, pertimbangkan memakai kerangka abu-abu alih-alih spinner di tengah layar. Kerangka mempertahankan tata letak sehingga layar tidak melompat saat data muncul.
Batasi kerja di dalam body tampilan
body dipanggil berkali-kali. Format tanggal, pengurutan, atau penggabungan string di dalamnya akan diulang setiap kali state berubah. Lakukan pengurutan sekali di tempat data dihasilkan, atau bungkus dalam properti terpisah yang hanya dihitung ulang ketika sumbernya berubah.
var catatanTerurut: [Catatan] {
catatan.sorted { $0.tanggal > $1.tanggal }
}
Formatter juga sebaiknya dibuat sekali dan disimpan, karena membuat DateFormatter baru untuk setiap baris termasuk pemborosan. Untuk kebutuhan format yang lebih luas, ada baiknya memahami pilihan format tanggal dan angka sebelum menulis tampilan daftar yang menampilkan waktu di setiap baris.
Jika daftar terasa berat saat digulir, cek apakah setiap baris memuat gambar ukuran penuh atau memicu permintaan jaringan. Optimasi performa aplikasi macOS dengan SwiftUI membahas pola serupa yang berlaku di kedua platform.
Pakai kunci yang stabil dan animasi yang tenang
Saat baris bisa disisipkan atau dihapus, bungkus perubahan data dalam withAnimation agar SwiftUI tahu cara memindahkan baris. Kunci identitas harus benar-benar unik dan tidak berubah, karena UUID() yang dibuat ulang setiap render akan membuat daftar berkedip.
Untuk daftar yang bisa dihapus, tambahkan .onDelete pada ForEach di dalam List. Pemula sering menulis tombol hapus sendiri padahal gestur geser standar sudah tersedia dan lebih dikenal pengguna iOS.
Aturan praktis: kalau sebuah baris punya aksi berbeda dari baris lain, pindahkan aksi itu ke layar detail. Daftar yang penuh tombol sulit dipakai di layar sempit.
Uji dengan data yang tidak rapi
Data contoh yang sempurna menyembunyikan masalah. Coba isi daftar dengan judul sangat panjang, teks kosong, karakter non-Latin, dan tanggal yang sama persis. Baris yang tidak diberi lineLimit akan mendorong tata letak dan membuat tinggi baris melompat.
Uji juga di Dynamic Type terbesar. Banyak tata letak baris gagal ketika ukuran teks diperbesar karena label dan tombol berebut ruang horizontal. Solusi biasanya mengubah susunan dari horizontal ke vertikal pada ukuran aksesibilitas tertentu.
Untuk aplikasi yang menampilkan konten dari jaringan, misalnya feed berita atau daftar acara, pertimbangkan juga bagaimana pengguna membuka konten di luar aplikasi. Kebiasaan menjaga privasi saat mengakses konten streaming olahraga punya pola serupa: pengguna perlu tahu ke mana data mereka pergi sebelum menekan tautan.
Ringkasan
Mulai dari bentuk data, pilih List sebagai default, dan hanya beralih ke LazyVStack atau LazyVGrid ketika desain menuntutnya. Tangani keadaan kosong, loading, dan error dalam satu tempat, lalu jaga agar body tidak melakukan pengurutan atau pemformatan berulang. Sisanya adalah pengujian dengan data yang berantakan.
Pertanyaan yang Sering Diajukan
Kapan sebaiknya memakai List dibanding LazyVStack?
Pakai List untuk daftar baris standar karena ia sudah menangani pemisah, gestur hapus, dan aksesibilitas. Pilih LazyVStack jika kamu butuh latar dan jarak antar baris yang sepenuhnya kustom, dan siap mengatur sendiri detail yang biasanya sudah disediakan List.
Bagaimana cara menampilkan pesan kosong tanpa membuat daftar berkedip?
Tampilkan pesan kosong hanya setelah pemuatan pertama selesai. Jika kamu menampilkan pesan kosong bersamaan dengan proses muat, layar akan berganti dari pesan kosong ke daftar terisi dalam sekejap, dan itu terlihat seperti kesalahan.
Apakah setiap baris perlu memiliki model sendiri?
Tidak selalu. Baris sederhana bisa langsung membaca nilai dari array. Model terpisah berguna ketika baris punya state lokal, seperti status terpilih atau hasil pemuatan gambar, agar state itu tidak mengganggu tampilan induk.
More Stories
Memilih Penyimpanan Lokal di Swift: UserDefaults, File, atau
7 Cara Menyimpan Token Login di iOS dan macOS
Memilih Platform Backend untuk Aplikasi iOS: Perbandingan