map-generator/DIAGNOSTIC.md

Guide de diagnostic - Carte qui ne s'affiche pas

🔍 Étapes de diagnostic

1. Ouvrir la console du navigateur

• Chrome/Edge: F12 ou Ctrl+Shift+I (Windows/Linux) / Cmd+Option+I (Mac)
• Firefox: F12 ou Ctrl+Shift+K
• Safari: Cmd+Option+C (activer d'abord le menu Développement dans Préférences)

2. Vérifier les erreurs JavaScript

Cherchez les messages d'erreur en rouge dans l'onglet Console.

3. Vérifier les logs de debug

Vous devriez voir ces messages dans la console :

DOM chargé, vérification des données...
mapData défini: true
Données de la carte: {id: 5, name: "Carte de test", ...}
Création de MapEditor...
MapEditor: Initialisation en cours...
Canvas element: div#mapCanvas
Container element: div.map-canvas-container
Map dimensions: 5 x 5
MapEditor: Début du rendu de la carte...
MapEditor: 25 hexagones créés
MapEditor: Initialisation terminée avec succès

🐛 Problèmes courants

Le canvas n'est pas trouvé

Symptôme: Canvas element: null Solution: Vérifier que l'élément <div id="mapCanvas"> existe dans le HTML

Le conteneur n'est pas trouvé

Symptôme: Container element: null Solution: Vérifier que l'élément <div class="map-canvas-container"> existe

mapData n'est pas défini

Symptôme: mapData non défini Solution: Vérifier que la carte a bien été chargée côté serveur

Les hexagones ne s'affichent pas

Symptôme: Les logs indiquent que tout fonctionne mais rien n'apparaît Solutions possibles:

1. Vérifier le CSS (z-index, position, overflow)
2. Vérifier que le loader a bien disparu
3. Inspecter les éléments DOM pour voir si les hexagones sont créés

🧪 Page de test

Une page de test simplifiée est disponible à : https://map-generator/test-map.html

Cette page contient une version minimaliste de l'éditeur pour identifier rapidement les problèmes.

📝 Informations à fournir pour le debug

Si le problème persiste, notez :

1. Les messages d'erreur exacts de la console
2. Les logs de debug affichés
3. Le navigateur et sa version
4. Si la page de test fonctionne ou non