3DPremium

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é.

model-viewer3DAR

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

Page produit principale — montre de luxe en édition limitée — 3D Product Showcase exemple 1

① Page produit principale — montre de luxe en édition limitée

QuandSection hero d'une page produit dédiée à une pièce unique ou une édition limitée : le modèle 3D occupe toute la largeur disponible, l'overlay en bas à gauche affiche le nom du produit, le prix barré et le prix réduit, et le bouton « Ajouter au panier » est cliquable. Un badge de remise s'affiche en coin haut gauche.
PourquoiUn vrai modèle 3D interactif remplace le carrousel photos statiques et donne aux visiteurs la sensation de tenir le produit en main. L'auto-rotation attire l'œil et distingue la fiche d'une page produit ordinaire ; sur mobile, le bouton AR permet de poser la montre sur un bureau réel.
RéglagesAttributs camera-orbit="25deg 78deg 105%" et field-of-view="30deg" pour un cadrage légèrement en plongée. exposure="1.05" et shadow-intensity="1" pour un éclairage chaud. Badge .p3d-badge avec le taux de remise en coin supérieur gauche.
Grille catalogue — deux cartes produit 3D côte à côte — 3D Product Showcase exemple 2

② Grille catalogue — deux cartes produit 3D côte à côte

QuandListe de produits où chaque carte affiche un modèle 3D en rotation douce, le nom et le prix en overlay. Deux cartes tiennent côte à côte dans 540 px de large, chacune avec son propre [data-p3d] ; la rotation reprend automatiquement pour chaque carte.
PourquoiUne grille de cartes 3D animées attire l'attention sans surcharger la page ; chaque modèle qui tourne doucement donne une impression de profondeur et de qualité bien au-dessus d'une grille de photos plates. Le script ne charge model-viewer qu'une seule fois pour l'ensemble de la page.
Réglagesauto-rotate-delay="600" pour démarrer la rotation après un court délai. rotation-per-second="10deg" pour une rotation lente en catalogue. Overlay minimal : .p3d-name + .p3d-price uniquement, sans badge ni bouton AR.
Page marque — présentation éditoriale du savoir-faire — 3D Product Showcase exemple 3

③ Page marque — présentation éditoriale du savoir-faire

QuandPage « À propos » ou section de storytelling d'une marque artisanale : le modèle 3D occupe une section pleine largeur sur fond sombre, sans overlay de prix, avec un titre et une accroche de marque en surimpression partielle.
PourquoiPoser le modèle dans un contexte éditorial (sans CTA e-commerce) démontre le niveau de finition du produit et la maîtrise technique de la marque — plus puissant qu'une série de photos de studio. La rotation lente et l'éclairage soigné communiquent une promesse de qualité.
RéglagesRetirer .p3d-cta et .p3d-badge. Régler camera-orbit="0deg 90deg 110%" pour une vue frontale. rotation-per-second="6deg" pour une rotation très lente. Fond de scène remplacé par un dégradé sombre plus neutre.

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-controls de 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'attribut auto-rotate du <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 alt de <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-ar est un <button type="button"> natif ; sur les navigateurs sans AR (mv.activateAR absent), le clic n'a aucun effet visible. Pour les masquer proprement, écouter l'événement ar-status de model-viewer ou vérifier mv.canActivateAR après le chargement.
  • Repli sans WebGL : le slot poster garantit un message lisible quand le rendu 3D est indisponible (navigateur trop ancien, GPU absent, permission refusée). Le bouton CTA .p3d-cta reste 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.

Chrome 79+✓ Complet (3D + AR via WebXR, mesuré)
Firefox 72+✓ Vue 3D complète (AR non disponible)
Safari 15.4+✓ Vue 3D + AR Quick Look (non mesuré)
Edge 79+✓ Complet (moteur Chromium)
Mobile iOS 12+✓ Vue 3D + AR Quick Look (non mesuré)
Android Chrome 79+✓ Complet (3D + AR via Scene Viewer)

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) :

index.html — structure
<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éfautEffet
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

Oui. L'attribut 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.
Après le chargement de model-viewer, l'événement 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.
Non. L'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.