Introduction aux lightboxes
Une lightbox est un composant d'interface qui affiche des images ou du contenu en superposition sur la page, avec un fond assombri. C'est un pattern UX incontournable pour les galeries photos, portfolios et sites e-commerce.
Bien que de nombreuses librairies existent (Fancybox, Lightgallery, PhotoSwipe...), créer sa propre lightbox en JavaScript vanilla offre plusieurs avantages :
- Zéro dépendance : pas de librairie externe à charger
- Performance optimale : code léger et sur mesure
- Contrôle total : personnalisation illimitée du comportement
- Apprentissage : comprendre les mécanismes sous-jacents
Notre lightbox finale fera moins de 100 lignes de JavaScript et supportera la navigation clavier, le swipe tactile, et les animations CSS.
Structure HTML de base
Commençons par définir la structure HTML. Notre lightbox se compose de trois éléments principaux : le conteneur overlay, l'image affichée, et les contrôles de navigation.
<!-- Galerie d'images -->
<div class="gallery">
<img src="photo-1.jpg" alt="Description 1" data-lightbox/>
<img src="photo-2.jpg" alt="Description 2" data-lightbox/>
<img src="photo-3.jpg" alt="Description 3" data-lightbox/>
</div>
<!-- Lightbox container -->
<div class="lightbox" id="lightbox" role="dialog" aria-modal="true">
<div class="lightbox-content">
<!-- Bouton fermer -->
<button class="lightbox-close" aria-label="Fermer">
<svg width="24" height="24" viewBox="0 0 24 24">
<line x1="18" y1="6" x2="6" y2="18"/>
<line x1="6" y1="6" x2="18" y2="18"/>
</svg>
</button>
<!-- Navigation -->
<button class="lightbox-nav lightbox-prev" aria-label="Precedent">‹</button>
<button class="lightbox-nav lightbox-next" aria-label="Suivant">›</button>
<!-- Image -->
<img class="lightbox-image" id="lightbox-img" src="" alt=""/>
<!-- Compteur -->
<div class="lightbox-counter"><span id="current">1</span> / <span id="total">3</span></div>
</div>
</div>
Points importants
- L'attribut
data-lightboxpermet d'identifier les images cliquables - Les attributs ARIA (
role,aria-modal,aria-label) améliorent l'accessibilité - La structure est sémantique avec des
<button>pour les contrôles
Styles CSS et animations
Le CSS est crucial pour créer une expérience fluide. Nous allons utiliser des transitions pour l'apparition/disparition et des transforms pour les animations.
/* Overlay de fond */
.lightbox {
position: fixed;
inset: 0;
background: rgba(0, 0, 0, 0.95);
z-index: 9999;
display: flex;
align-items: center;
justify-content: center;
/* Animation d'entree */
opacity: 0;
visibility: hidden;
transition: opacity 0.3s ease, visibility 0.3s ease;
}
.lightbox.active {
opacity: 1;
visibility: visible;
}
/* Conteneur de l'image */
.lightbox-content {
position: relative;
max-width: 90vw;
max-height: 90vh;
/* Animation de zoom */
transform: scale(0.9);
transition: transform 0.3s ease;
}
.lightbox.active .lightbox-content {
transform: scale(1);
}
/* Image principale */
.lightbox-image {
max-width: 100%;
max-height: 85vh;
border-radius: 12px;
box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.5);
object-fit: contain;
}
/* Bouton fermer */
.lightbox-close {
position: absolute;
top: -50px;
right: 0;
width: 40px;
height: 40px;
background: rgba(255, 255, 255, 0.1);
border: none;
border-radius: 50%;
color: white;
cursor: pointer;
transition: all 0.2s ease;
}
.lightbox-close:hover {
background: #6366f1;
transform: rotate(90deg);
}
/* Boutons navigation */
.lightbox-nav {
position: absolute;
top: 50%;
transform: translateY(-50%);
width: 50px;
height: 50px;
background: rgba(255, 255, 255, 0.1);
border: none;
border-radius: 50%;
color: white;
font-size: 24px;
cursor: pointer;
transition: all 0.2s ease;
}
.lightbox-prev { left: -70px; }
.lightbox-next { right: -70px; }
.lightbox-nav:hover {
background: #6366f1;
}
Astuces CSS avancées
Quelques techniques intéressantes utilisées dans ce CSS :
- inset: 0 : raccourci pour top/right/bottom/left à 0
- visibility + opacity : permet des transitions fluides (display: none ne peut pas être animé)
- transform: scale() : animation de zoom performante (GPU accéléré)
JavaScript vanilla
Le coeur de notre lightbox : le JavaScript qui gère l'ouverture, la fermeture et la navigation entre les images.
class Lightbox {
constructor() {
this.lightbox = document.getElementById('lightbox');
this.image = document.getElementById('lightbox-img');
this.images = [...document.querySelectorAll('[data-lightbox]')];
this.currentIndex = 0;
this.init();
}
init() {
// Clic sur les images de la galerie
this.images.forEach((img, index) => {
img.addEventListener('click', () => this.open(index));
img.style.cursor = 'pointer';
});
// Boutons de controle
this.lightbox.querySelector('.lightbox-close')
.addEventListener('click', () => this.close());
this.lightbox.querySelector('.lightbox-prev')
.addEventListener('click', () => this.prev());
this.lightbox.querySelector('.lightbox-next')
.addEventListener('click', () => this.next());
// Fermer en cliquant sur le fond
this.lightbox.addEventListener('click', (e) => {
if (e.target === this.lightbox) this.close();
});
// Navigation clavier
document.addEventListener('keydown', (e) => this.handleKeyboard(e));
}
open(index) {
this.currentIndex = index;
this.updateImage();
this.lightbox.classList.add('active');
document.body.style.overflow = 'hidden';
}
close() {
this.lightbox.classList.remove('active');
document.body.style.overflow = '';
}
prev() {
this.currentIndex = (this.currentIndex - 1 + this.images.length) % this.images.length;
this.updateImage();
}
next() {
this.currentIndex = (this.currentIndex + 1) % this.images.length;
this.updateImage();
}
updateImage() {
const img = this.images[this.currentIndex];
this.image.src = img.src;
this.image.alt = img.alt;
// Mise a jour du compteur
document.getElementById('current').textContent = this.currentIndex + 1;
document.getElementById('total').textContent = this.images.length;
}
handleKeyboard(e) {
if (!this.lightbox.classList.contains('active')) return;
switch (e.key) {
case 'Escape': this.close(); break;
case 'ArrowLeft': this.prev(); break;
case 'ArrowRight': this.next(); break;
}
}
}
// Initialisation
new Lightbox();
L'utilisation d'une classe JavaScript permet d'encapsuler toute la logique et facilite la réutilisation. Vous pouvez facilement avoir plusieurs instances de lightbox sur une même page.
Navigation entre images
La navigation est un élément clé de l'expérience utilisateur. Notre lightbox supporte plusieurs modes de navigation.
Navigation par boutons
Les flèches précédent/suivant permettent une navigation intuitive. L'utilisation du modulo (%) permet une navigation circulaire infinie.
// Navigation circulaire
prev() {
// Si index = 0, on passe a la derniere image
this.currentIndex = (this.currentIndex - 1 + this.images.length) % this.images.length;
this.updateImage();
}
next() {
// Si index = dernier, on revient a 0
this.currentIndex = (this.currentIndex + 1) % this.images.length;
this.updateImage();
}
Navigation au clavier
Le support des touches flèches et Escape est essentiel pour l'accessibilité et le confort d'utilisation.
handleKeyboard(e) {
// Ne reagir que si la lightbox est ouverte
if (!this.lightbox.classList.contains('active')) return;
switch (e.key) {
case 'Escape':
this.close();
break;
case 'ArrowLeft':
e.preventDefault(); // Empecher le scroll
this.prev();
break;
case 'ArrowRight':
e.preventDefault();
this.next();
break;
}
}
Demo interactive
Voici notre lightbox en action. Cliquez sur une image pour l'ouvrir, puis utilisez les flèches ou le clavier pour naviguer.
Escape : Fermer la lightbox
Flèche gauche : Image précédente
Flèche droite : Image suivante
Accessibilité et bonnes pratiques
Une lightbox accessible est essentielle pour tous les utilisateurs. Voici les points clés à ne pas négliger.
Attributs ARIA
- role="dialog" : indique aux lecteurs d'écran qu'il s'agit d'une boîte de dialogue
- aria-modal="true" : signale que le contenu derrière est inactif
- aria-label : description textuelle des boutons
Focus trap
Pour une accessibilité complète, il faut "piéger" le focus dans la lightbox quand elle est ouverte.
trapFocus() {
const focusableElements = this.lightbox.querySelectorAll(
'button, [href], [tabindex]:not([tabindex="-1"])'
);
const firstElement = focusableElements[0];
const lastElement = focusableElements[focusableElements.length - 1];
this.lightbox.addEventListener('keydown', (e) => {
if (e.key !== 'Tab') return;
if (e.shiftKey && document.activeElement === firstElement) {
e.preventDefault();
lastElement.focus();
} else if (!e.shiftKey && document.activeElement === lastElement) {
e.preventDefault();
firstElement.focus();
}
});
}
Respectez la préférence prefers-reduced-motion pour les utilisateurs sensibles aux animations.
@media (prefers-reduced-motion: reduce) {
.lightbox,
.lightbox-content {
transition: none;
}
}
Conclusion
Vous disposez maintenant d'une lightbox complète et professionnelle en JavaScript vanilla. Cette implementation offre :
- Zéro dépendance : aucune librairie externe requise
- Accessibilité : navigation clavier et attributs ARIA
- Animations fluides : transitions CSS performantes
- Code maintenable : architecture en classe ES6
N'hésitez pas à personnaliser les styles et ajouter des fonctionnalités supplémentaires comme le zoom, le swipe tactile ou le chargement lazy des images.
Découvrez notre collection d'effets de galerie dans la bibliothèque Effect.Labs, avec des variations animées et des templates prêts à l'emploi.





