3D Product Showcase
Modèle 3D .glb interactif dans votre page produit : rotation 360° au drag, AR sur mobile, chargement différé et CTA intégré.
Mis à jour le
Cet effet fait partie d'Effect.Labs — 846 effets vanilla, une partie gratuite, une partie premium. 3D comprend 50 effets, dont 8 gratuits. Découvrir la catégorie →
3 exemples d'usage



Comment ça marche
Le composant central est une balise <model-viewer> (Custom Element enregistré par model-viewer.min.js) placée dans .p3d-scene. L'attribut camera-controls active la rotation au glisser (souris ou toucher) ; auto-rotate déclenche la rotation automatique dès le chargement, avec rotation-per-second="22deg" ; auto-rotate-delay="0" supprime le délai initial. disable-zoom bloque le pincement pour ne pas parasiter le défilement vertical de la page ; touch-action="pan-y" garantit que le défilement natif reste actif sur mobile.
model-viewer.min.js est un module ES (poids ~530 Ko) chargé à la demande : un IntersectionObserver avec rootMargin="200px" surveille chaque [data-p3d] et injecte la balise <script type="module"> dès que la scène approche de la fenêtre — puis se déconnecte. Un drapeau booléen loaded empêche le double chargement quand plusieurs scènes coexistent dans la page. Sur les navigateurs sans IntersectionObserver, le script est injecté immédiatement au chargement de la page.
L'attribut ar sur <model-viewer>, combiné à ar-modes="webxr scene-viewer quick-look", active le bouton AR. Sur clic, le script appelle mv.activateAR() : WebXR en priorité (Android Chrome 79+), puis Scene Viewer (Android avec Google Play Services), puis Quick Look (iOS Safari 12+). Le bouton AR (.p3d-ar) est un <button> ordinaire positionné en absolu ; il peut être masqué si mv.canActivateAR est false.
Le slot poster contient l'état de chargement affiché pendant le téléchargement et le parsing du .glb. --poster-color: transparent supprime le fond blanc par défaut du slot. Les attributs exposure="1.05", shadow-intensity="1" et camera-orbit="25deg 78deg 105%" règlent l'éclairage global, l'ombre de contact et la position initiale de la caméra ; field-of-view="30deg" réduit la distorsion de perspective pour un rendu proche d'un objectif téléphoto.
Accessibilité
- Navigation au clavier :
camera-controlsde model-viewer expose un focus visible et accepte les touches directionnelles (gauche/droite : rotation yaw, haut/bas : altitude) pour faire tourner le modèle — aucun ARIA supplémentaire nécessaire. - Réduction de mouvement : sous
prefers-reduced-motion: reduce, le script retire l'attributauto-rotatedu<model-viewer>avant le premier rendu — la pièce 3D reste interactive et rotative au drag, mais la rotation automatique est désactivée. - Description du modèle : l'attribut
altde<model-viewer>est annoncé par les lecteurs d'écran à la place du rendu visuel. Le texte doit décrire le produit de manière concise (ex. « Montre chronographe en acier brossé, vue 3D 360° »). - Bouton AR : le bouton
.p3d-arest un<button type="button">natif ; sur les navigateurs sans AR (mv.activateARabsent), le clic n'a aucun effet visible. Pour les masquer proprement, écouter l'événementar-statusde model-viewer ou vérifiermv.canActivateARaprès le chargement. - Repli sans WebGL : le slot
postergarantit un message lisible quand le rendu 3D est indisponible (navigateur trop ancien, GPU absent, permission refusée). Le bouton CTA.p3d-ctareste accessible à tout moment car il est en dehors du composant model-viewer.
Compatibilité navigateur
model-viewer utilise WebGL (et WebGL 2.0 pour certains effets d'éclairage) pour le rendu. Le composant est disponible comme Custom Element dans tous les navigateurs à Chromium moderne. AR : WebXR (Chrome Android 79+), Scene Viewer (Android avec Google Play Services), Quick Look (Safari iOS 12+). IntersectionObserver depuis Chrome 51, Firefox 55, Safari 12.1.
Sans WebGL ou sans réseau, model-viewer reste bloqué à l'écran du slot poster — le message de chargement et le bouton CTA restent visibles. Sans IntersectionObserver, le script model-viewer est chargé immédiatement au lieu d'être différé.
Le code
Structure HTML à coller dans votre page (le CSS + JS sont inclus avec votre achat) :
<div class="fx-0809-root">
<div class="p3d-scene" data-p3d="">
<span class="p3d-badge">…</span>
<button type="button" class="p3d-ar" data-p3d-ar="">…</button>
<model-viewer class="p3d-mv" data-p3d-mv=""
src="/assets/models/watch.glb"
alt="…"
camera-controls="" auto-rotate="" auto-rotate-delay="0" rotation-per-second="22deg"
interaction-prompt="none" disable-zoom="" touch-action="pan-y"
shadow-intensity="1" exposure="1.05" camera-orbit="25deg 78deg 105%" field-of-view="30deg"
ar="" ar-modes="webxr scene-viewer quick-look">
<div class="p3d-poster" slot="poster" aria-hidden="true">
<span class="p3d-emoji">…</span>
<span>…</span>
</div>
</model-viewer>
<div class="p3d-overlay">
<div class="p3d-name">…</div>
<div class="p3d-price"><s>…</s>…</div>
<button type="button" class="p3d-cta">…</button>
</div>
<div class="p3d-hint" aria-hidden="true">…</div>
</div>
</div>
Paiement unique, sans abonnement — le code est à toi pour toujours
Personnaliser
Options passées à l'API ou attributs data-* :
| Option / propriété | Défaut | Effet |
|---|---|---|
Fichier 3D — attribut src de <model-viewer> |
/assets/models/watch.glb | Remplacer par n'importe quel fichier .glb ou .gltf hébergé sur le même domaine (ou CORS activé). Les formats .usdz sont pris en charge pour Quick Look iOS via l'attribut ios-src. |
Badge de promotion — contenu de .p3d-badge |
−40% | Texte libre : taux de remise, « Nouveau », « Exclusif »… Laisser vide ou retirer la balise pour masquer le badge. |
Vitesse de rotation — attribut rotation-per-second |
22deg | Réduire à 8deg pour une rotation quasi imperceptible sur une page éditoriale ; augmenter à 40deg pour un effet de démo dynamique. |
Position de la caméra — attribut camera-orbit |
25deg 78deg 105% | Trois valeurs : azimut (rotation autour de l'axe vertical), inclinaison, distance. "0deg 90deg 100%" donne une vue frontale neutre ; "45deg 60deg 90%" une perspective haute en diagonale. |
Éclairage — attributs exposure et shadow-intensity |
1.05 / 1 | exposure de 0,8 à 1,2 règle la luminosité globale. shadow-intensity de 0 à 2 pilote l'ombre de contact au sol (0 = aucune ombre). |
Activation de l'AR — attribut ar sur <model-viewer> |
présent | Retirer l'attribut ar désactive complètement l'AR et masque le bouton .p3d-ar. Sur un site sans HTTPS, l'AR ne fonctionne pas de toute façon (exigence du navigateur). |
Poster de chargement — slot poster |
émoji ⌚ + « Chargement du produit 3D… » | Remplacer par une image PNG ou JPG haute résolution du produit pour un rendu immédiat avant que le .glb soit prêt. Préférer une image au ratio du viewport du model-viewer. |
FAQ
src de <model-viewer> accepte n'importe quel fichier .glb ou .gltf hébergé sur le même domaine (ou avec CORS autorisé). Pour l'AR sur iOS, ajouter un fichier .usdz via l'attribut ios-src. Les outils de création 3D courants (Blender, Cinema 4D, Sketchfab) exportent en .glb.load sur le <model-viewer> expose mv.canActivateAR (booléen). Écouter cet événement et afficher ou masquer le bouton en conséquence : mv.addEventListener('load', () => { arBtn.hidden = !mv.canActivateAR; }). Sur HTTPS requis par l'AR, le bouton peut aussi être masqué côté serveur selon le User-Agent.IntersectionObserver avec rootMargin="200px" ne déclenche le chargement de model-viewer que lorsque la scène s'approche de la fenêtre visible. Si le visiteur quitte la page sans jamais atteindre la section, le fichier model-viewer.min.js (~530 Ko) et le .glb ne sont pas téléchargés.