Vérifications quand une image ou une vidéo ne s'affiche pas – ZenBlocks buttonBasic
Conclusion
Si une image/vidéo ne s’affiche pas, la cause est généralement l’une des suivantes: **média non défini, chemin invalide, overlay trop opaque ou mauvais réglage de taille/position**. Les points à vérifier changent selon le type de média (fond image, fond vidéo, vignette).
—
Causes
1. **Média non configuré**: aucun fichier sélectionné ou URL vide.
2. **Fichier supprimé ou déplacé**: la référence existe encore dans le bloc, mais le fichier n’est plus disponible.
3. **Overlay opaque**: alpha réglé sur 1.0, ce qui masque totalement le média.
4. **Taille/position incorrecte**: taille nulle ou position hors zone du bouton.
5. **Affichage désactivé**: certains éléments sont masqués dans les réglages d’affichage.—
Procédure
### Étape 1: vérifier le média défini
**Pour image/vidéo de fond:**
1. Ouvrez les paramètres d’arrière-plan.
2. Vérifiez que l’URL image/vidéo est bien définie.
3. Vérifiez que le fichier existe encore dans la médiathèque.
4. Testez avec un autre média pour isoler le problème.**Pour la vignette:**
1. Ouvrez les paramètres de vignette.
2. Vérifiez qu’une image est sélectionnée.
3. Vérifiez que le toggle d’affichage est activé.### Étape 2: vérifier l’overlay
1. Ouvrez la section overlay des paramètres d’arrière-plan.
2. Vérifiez l’**alpha** de la couleur d’overlay.
3. Avec alpha à 1.0, le média est entièrement masqué.
4. Ajustez vers 0.3-0.6 pour conserver de la lisibilité sans masquer le fond.### Étape 3: vérifier taille et position
1. Vérifiez `Background Size` (`cover` / `contain` / custom).
2. Vérifiez `Background Position` (`center center` est généralement sûr).
3. En mode custom, vérifiez qu’aucune valeur n’est à `0px` ou `0%`.### Étape 4: vérifier navigateur et cache
1. Ouvrez les DevTools (F12), onglet Network.
2. Vérifiez que les requêtes médias ne retournent pas de 404.
3. Videz le cache CSS/navigateur puis retestez.—
Points d’attention
– Vignette et image de fond sont indépendantes. La vignette est une image interne au bouton, le fond couvre l’ensemble du bouton.
– Pour les vidéos de fond, les restrictions d’autoplay mobile s’appliquent. Voir aussi [FAQ: vidéo de fond non lue sur mobile](../faq-mobile-video-background/).—
Paramètres liés
– [Paramètres d’arrière-plan](../06-background-settings.md)
– [Paramètres de vignette](../08-thumbnail-settings.md)
– [Paramètres de style](../04-style-settings.md)