Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Flutter

Afficher les données : FutureBuilder et les états de l'écran

Afficher des données distantes avec FutureBuilder en gérant chargement, erreur, liste vide et actualisation....

0 chapitres 0 QCM Accès gratuit

À propos de ce cours

Afficher des données distantes avec FutureBuilder en gérant chargement, erreur, liste vide et actualisation.

Objectif : afficher dans l'interface des données qui arrivent « plus tard », sans bloquer l'application, et toujours dire à l'utilisateur ce qui se passe.

Observation : regardez vos applications

Ouvrez YouTube ou Instagram avec une connexion lente : vous voyez d'abord des cartes grises qui clignotent (skeleton) ou un cercle de chargement, puis le contenu. En mode avion : un message « Pas de connexion » avec un bouton Réessayer. Ce sont exactement les trois états que tout écran Flutter qui appelle une API doit gérer.

Les états d'un FutureBuilder : chargement, données, erreur
Figure — Les états d'un FutureBuilder : chargement, données, erreur
Un écran sans état de chargement paraît figé, un écran sans état d'erreur reste vide sans explication : les deux donnent l'impression d'une application « buggée ».

Le widget FutureBuilder

FutureBuilder reconstruit son contenu automatiquement selon l'avancement d'un Future. Il fournit un snapshot qui indique l'état :

Propriété Signification
snapshot.connectionState == ConnectionState.waiting La requête est en cours
snapshot.hasError / snapshot.error La requête a échoué (exception levée)
snapshot.hasData / snapshot.data Les données sont arrivées

Exemple complet : la liste des tâches

class TodoListPage extends StatefulWidget {
  const TodoListPage({super.key});
  @override
  State<TodoListPage> createState() => _TodoListPageState();
}

class _TodoListPageState extends State<TodoListPage> {
  late Future<List<Todo>> _futureTodos;

  @override
  void initState() {
    super.initState();
    _futureTodos = fetchTodos(); // ✅ lancé UNE seule fois
  }

  Future<void> _recharger() async {
    setState(() => _futureTodos = fetchTodos());
    await _futureTodos;
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Mes tâches')),
      body: FutureBuilder<List<Todo>>(
        future: _futureTodos,
        builder: (context, snapshot) {
          // 1. Chargement
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          // 2. Erreur
          if (snapshot.hasError) {
            return Center(
              child: Column(mainAxisSize: MainAxisSize.min, children: [
                const Icon(Icons.wifi_off, size: 48),
                const SizedBox(height: 8),
                const Text('Impossible de charger les tâches'),
                TextButton(onPressed: _recharger, child: const Text('Réessayer')),
              ]),
            );
          }
          // 3. Données (avec cas « liste vide »)
          final todos = snapshot.data ?? [];
          if (todos.isEmpty) return const Center(child: Text('Aucune tâche'));

          return RefreshIndicator(          // tirer vers le bas pour actualiser
            onRefresh: _recharger,
            child: ListView.builder(
              itemCount: todos.length,
              itemBuilder: (context, i) {
                final todo = todos[i];
                return ListTile(
                  leading: Icon(todo.completed ? Icons.check_circle : Icons.circle_outlined,
                      color: todo.completed ? Colors.green : null),
                  title: Text(todo.title),
                  subtitle: Text('Utilisateur ${todo.userId}'),
                );
              },
            ),
          );
        },
      ),
    );
  }
}

⚠️ L'erreur n°1 des débutants

// ❌ MAUVAIS : une nouvelle requête à CHAQUE reconstruction de l'écran
FutureBuilder(future: fetchTodos(), builder: ...)

build() peut être appelé des dizaines de fois (clavier qui s'ouvre, rotation, setState…). Si le Future est créé dans build, l'application relance la requête à chaque fois : consommation de données mobiles, clignotements, et parfois blocage par l'API (429 Too Many Requests). Créez toujours le Future dans initState.

Page de détail : passer un identifiant

// Dans la liste
onTap: () => Navigator.push(context,
    MaterialPageRoute(builder: (_) => TodoDetailPage(id: todo.id))),

// Service
Future<Todo> fetchTodo(int id) async {
  final r = await http.get(Uri.parse('https://jsonplaceholder.typicode.com/todos/$id'));
  if (r.statusCode == 200) return Todo.fromJson(jsonDecode(r.body));
  if (r.statusCode == 404) throw Exception('Tâche introuvable');
  throw Exception('Erreur ${r.statusCode}');
}

La page TodoDetailPage utilise elle aussi un FutureBuilder, avec fetchTodo(widget.id) lancé dans initState.

Pour aller plus loin : dans les applications professionnelles, l'état (chargement / données / erreur) est souvent géré par une solution de gestion d'état (Provider, Riverpod, Bloc). Le principe reste identique : trois états à afficher. Pour l'effet « cartes grises » façon YouTube, voir le package shimmer.

Activité 24.5 — « Mini-blog » (1 h)

  1. Créez le modèle Post (id, userId, title, body) et fetchPosts() sur https://jsonplaceholder.typicode.com/posts.
  2. Affichez la liste avec FutureBuilder dans des Card (titre en gras, début du texte sur deux lignes avec maxLines: 2 et overflow: TextOverflow.ellipsis).
  3. Au clic, ouvrez une page de détail qui affiche le post complet et ses commentaires (/posts/{id}/comments).
  4. Ajoutez le « tirer pour actualiser ».
  5. Testez en mode avion : l'écran d'erreur et le bouton Réessayer doivent fonctionner.
  6. Défi : ajoutez un champ de recherche qui filtre les posts par titre (filtrage local de la liste déjà reçue).

Cet article vous a-t-il aidé ?