Stimulus (Symfony UX)

Ce qu'il fait

Cette compétence documente comment utiliser le framework Stimulus JS au sein de Symfony UX pour attacher des comportements côté client au HTML rendu par le serveur via des attributs data-*. Elle couvre les squelettes de contrôleurs, les cibles, les valeurs, les actions, la gestion des classes, les outlets pour la communication entre contrôleurs, le chargement paresseux et les modèles d'intégration Symfony/Twig.

Quand l'utiliser

Utilisez cette compétence lors de l'implémentation d'éléments d'interface utilisateur interactifs dans des applications Symfony : gestionnaires de clics, modales, menus déroulants, gestion de formulaires, raccourcis clavier, graphiques/éditeurs chargés paresseusement, et encapsulation de bibliothèques JS avec des contrôleurs. À éviter pour les mises à jour partielles purement côté serveur (utilisez Turbo ou LiveComponent à la place).

Ce qui est inclus

• Scripts : aucun script intégré (le dossier references contient l'API et les modèles)
• Références : references/api.md, references/patterns.md, references/gotchas.md pour des conseils plus approfondis
• Instructions : exemples de squelettes de contrôleurs, exemples de câblage HTML, typage des valeurs, actions, outlets, chargement paresseux, assistants Symfony Twig et meilleures pratiques

Agents compatibles

Utile pour les agents assistants de code pouvant éditer des actifs frontend et des templates (Copilot/Codex/Gemini).