FutureBuilder: memuat, berhasil, dan galat

build tidak bisa ditandai async, jadi Future ditampilkan lewat widget FutureBuilder. Ia butuh dua hal: future yang ditunggu, dan fungsi builder(context, snapshot) yang dijalankan ulang setiap keadaan future berubah. snapshot.hasData bernilai true hanya bila future selesai dengan data yang tidak null. snapshot.hasError bernilai true bila future melempar galat, dan snapshot.error berisi galat itu. Selama keduanya false, builder menampilkan penanda memuat, misalnya CircularProgressIndicator.

class _JadwalState extends State<Jadwal> {
  late Future<List<Shift>> _jadwal;

  @override
  void initState() {
    super.initState();
    _jadwal = ambilJadwal(); // dibuat sekali
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<List<Shift>>(
      future: _jadwal,
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          return ListView(children: [for (final s in snapshot.data!) Text(s.hari)]);
        } else if (snapshot.hasError) {
          return Text('${snapshot.error}');
        }
        return const CircularProgressIndicator();
      },
    );
  }
}

Future dibuat di initState dan disimpan di field State. Bila ambilJadwal() ditulis langsung di parameter future di dalam build, setiap kali build berjalan, misalnya karena setState lain di layar itu, permintaan baru terkirim dan FutureBuilder menunggu dari awal. Menyimpan Future di State membuat permintaan dijalankan sekali dan hasilnya dipakai ulang di setiap build. Resep resmi Flutter memberi alasannya: build dipanggil setiap kali tampilan perlu berubah, dan itu terjadi sangat sering.