3d-hero-interactions

Faites réagir un modèle 3D héroïque aux interactions utilisateur : parallaxe au pointeur, lueur au survol, états du curseur, réactions au clic (impulsions, explosions de particules, morphing), rotation par glissement, boutons magnétiques et arrière-plans réactifs au curseur.

Qu'est-ce que 3d-hero-interactions ?

Cette compétence permet de transformer un modèle 3D statique en une expérience interactive et vivante. Elle se concentre sur une hiérarchie d'interactions : d'abord répondre au pointeur (parallaxe, inclinaison), puis au clic (impulsions, morphing, particules), et enfin aux mouvements ambiants. La compétence insiste sur le suivi normalisé du pointeur avec amortissement, le raycasting optimisé (uniquement sur les maillages interactifs), et des retours immédiats (<16 ms) au clic pour éviter toute sensation de déconnexion. Elle prend en charge les plateformes Three.js et s'intègre avec des compétences connexes comme threejs-interaction, 3d-physics-simulations et scroll-driven-3d-story. Elle fournit également des directives pour implémenter la rotation par glissement, les boutons magnétiques en DOM, les curseurs personnalisés (uniquement si pertinent), et évite les pièges courants comme le raycasting sur toute la scène à chaque mouvement de pointeur.

Compatible avec~Claude Code~Codex CLI✓Cursor
Part ofReact
npx skills add https://github.com/BLACKNIGHT-cloud12/3d-hero-interactions/tree/HEAD

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Interactions 3D Héroïques

Un modèle héroïque qui se contente de tourner est un économiseur d'écran. La hiérarchie du « donne l'impression d'être vivant » : répondre au curseur (survol) > répondre à l'entrée (clic) > répondre à l'inactivité (mouvement ambiant). Construisez dans cet ordre.

Suivi du pointeur : un vecteur normalisé, amorti partout

Suivez le pointeur une seule fois ; chaque réaction lit le même vecteur NDC via un suiveur amorti. Ne laissez jamais les composants ajouter leurs propres écouteurs.

const pointer = new THREE.Vector2(0, 0);     // brut, -1..1
const smooth = new THREE.Vector2(0, 0);      // amorti
addEventListener('pointermove', e => {
  pointer.set((e.clientX / innerWidth) * 2 - 1, -(e.clientY / innerHeight) * 2 + 1);
});
function tick(dt) {
  smooth.lerp(pointer, 1 - Math.pow(0.001, dt)); // amortissement indépendant de la fréquence d'images
}
  • Parallaxe : décaler la caméra (ou le groupe de la scène) de smooth * 0.3 autour d'un point de visée — illusion de profondeur, 3 lignes de code.
  • Inclinaison : faire pivoter le maillage héroïque vers le curseur avec une limite d'angle faible (±0,15 rad) — perçu comme « il vous regarde ».
  • Constante d'amortissement ~0,001–0,01 : plus bas = plus lourd, plus premium. Un suivi brut semble bon marché.

Survol : lancer de rayons sur une liste restreinte, définir les états du curseur

Lancez les rayons uniquement sur les maillages interactifs du héros (passez un tableau explicite), jamais sur toute la scène — un lancer de rayons de 200 000 triangles par mouvement de pointeur fait chuter les performances des sections héroïques.

raycaster.setFromCamera(pointer, camera);
const hit = raycaster.intersectObjects(interactifs, false)[0];
canvas.style.cursor = hit ? 'pointer' : 'default';
// À l'entrée/sortie : interpoler emissiveIntensity ou l'échelle (1 → 1,04), voir threejs-interaction

Réagissez aux transitions pointerenter/leave avec des interpolations (lerp sur ~150 ms), pas des changements instantanés. Sur les appareils tactiles, il n'y a pas de survol — traitez les tapotements comme des clics et ignorez complètement les états de survol.

Réactions au clic (le niveau amusant)

Choisissez par intention — clic ⇒ la réponse scriptée de cet objet :

  1. Impulsion (corps physique) : applyImpulse — voir 3d-physics-simulations.
  2. Coup de ressort (sans moteur) : déplacement + retour à la position de repos (v += k*(repos - x); v *= amorti). Le motif héroïque le plus robuste.
  3. Explosion de particules : émettre N particules depuis le point d'impact avec vitesses radiales + gravité + fondu, en utilisant un pool InstancedMesh/Points (recycler, jamais allouer). Modèle : 3d-physics-simulations → references/gpgpu-particles.md.
  4. Morphing/assemblage : avancer une valeur de mélange ou réexécuter une animation d'assemblage (GSAP sur les uniforms/cibles de morphing).

Retour ≤16 ms après le clic, sinon la connexion est rompue : commencez la réponse sur pointerdown, pas après la résolution du click.

Rotation par glissement

Distinguer le glissement du clic par un seuil de mouvement (5 px) et la durée d'appui. Faire pivoter le groupe parent du maillage avec une vitesse amortie ; au relâchement, appliquer une inertie puis revenir à la rotation de repos. Désactivez la caméra libre de type OrbitControls sur le héros — la composition doit survivre.

Éléments DOM magnétiques

Les boutons situés à ~80 px du curseur se translatent vers lui (limite 6–8 px) et reviennent en place au départ — s'associent à la parallaxe 3D pour unifier le plan. Même suiveur amorti, appliqué à transform: translate().

Curseur personnalisé

Uniquement s'il apporte du sens (par exemple, devient un indice « attraper » au-dessus du héros) : un petit point + un anneau qui traîne, mix-blend-mode: difference, caché au tactile. Gardez le curseur natif visible jusqu'à ce que les états de survol prouvent que le personnalisé est nécessaire — un curseur personnalisé qui lutte contre le curseur du site est pire que rien.

Erreurs courantes

  • Lancer de rayons à chaque mouvement de pointeur sur toute la scène — liste restreinte des maillages, ou limitez à une fois par image.
  • Écouteurs ajoutés à chaque rechargement à chaud / changement de route — nettoyez au même endroit où vous les enregistrez.
  • Les superpositions du canvas qui mangent les clics destinés au DOM : le canvas reçoit pointer-events: none sauf s'il EST la surface d'interaction ; le DOM flotte au-dessus avec son propre z-index.
  • Les effets de survol sur les appareils à pointerdown uniquement clignotent — conditionnez le code de survol derrière matchMedia('(hover: hover)').
  • Parallaxe superposée à une caméra pilotée par le défilement depuis scroll-driven-3d-story sans un seul propriétaire — ajoutez les décalages à un seul endroit (groupe du rig de la caméra), sinon les battements se battront.

Compétences connexes

  • threejs-interaction — fondamentaux du lancer de rayons/contrôles
  • 3d-physics-simulations — impulsions et explosions
  • scroll-driven-3d-story — la chorégraphie de la caméra dans laquelle cela s'intègre
  • ai-website-aesthetics — à quoi le héros devrait ressembler

Skills associés