Interactions utilisateur
Events
Actions
Ajoutez de l'interactivité à vos applications avec des événements et des actions.
Tour des fonctionnalités (Épisode 5)
Retour à l'Académie
Interactions utilisateur
Résumé express : Créer des composants interactifs avec variables, computed values et événements pour une expérience dynamique.
Introduction aux composants réactifs
Ce tutoriel montre comment utiliser le Visual Scripting pour créer des composants qui réagissent aux interactions utilisateur et calculent des valeurs dynamiquement.
1. Variables de base
Concept
Les variables sont des valeurs qu'on peut modifier et réutiliser partout dans le composant.
Création d'une variable
- Créer un nouveau composant
- Ajouter une variable "name"
- Type : String
- Valeur par défaut : laisser vide
2. Input avec liaison de données
Widget Text Input
- + → Widget → Form → Text Input
- Propriété model : sélectionner la variable "name"
- Chaque modification de l'input met à jour la variable
Test de réactivité
- Ajouter un second Text Input avec la même variable "name"
- En Preview : taper dans un champ met à jour l'autre automatiquement
- Suppression ou modification : synchronisation en temps réel
3. Amélioration de l'interface
Ajouter un label
- Propriété label du Text Input : "name"
- Animation automatique du label au focus
- Interface plus professionnelle
Affichage du message
- Custom Text : "Hello Mister"
- Créer une variable temporaire :
{name} - Lier à la variable "name" avec l'icône éclair
- Affichage dynamique : "Hello Mister [Nom]"
4. Variables computed
Problème à résoudre
Pour "Jean Dupont", afficher "Mr. Dupont" au lieu de "Mr. Jean Dupont".
Créer une computed variable
- + → Computed
- Nom : "LastName"
- Calcul automatique basé sur d'autres variables
- Recalcul automatique quand les dépendances changent
Logique de traitement
- Aller dans l'onglet Logic
- Utiliser GetName pour récupérer la variable "name"
- Ctrl + Espace : vérifier la valeur ("Jean Dupont")
Extraction du nom de famille
- Nœud Split avec séparateur " " (espace)
- Sépare la chaîne en tableau : ["Jean", "Dupont"]
- Nœud Last : récupère le dernier élément
- Connecter à l'output de la computed
Organisation du graphique
- Pas besoin de fil d'exécution pour les nœuds de données
- Garder un graphique propre et aligné pour la lisibilité
- Connexions logiques pour la compréhension
5. Utilisation de la computed
Mise à jour de l'affichage
- Modifier le Custom Text
- Changer la variable de "name" à "LastName"
- Affichage : "Hello Mr. Dupont"
- Test en Preview : taper "Jean Dupont" affiche "Mr. Dupont"
Réactivité complète
La computed se met à jour automatiquement à chaque modification de l'input.
6. Événements utilisateur
Ajouter un événement click
- Sélectionner un élément (div)
- Events → Click
- Edit Logic pour définir l'action
Logique d'événement
- Log pour afficher dans la console
- Utiliser Template pour formatter : "Hello, Mr. {LastName}"
- GetLastName → Template → Log
- Résultat : "Hello, Mr. Dupont"
Test des événements
- Builder mode : événements désactivés
- Preview mode : clic fonctionne et affiche dans la console
- Changer le nom et cliquer : affichage mis à jour
Concepts clés
Variables vs Computed
- Variables : stockage de valeurs modifiables
- Computed : calculs automatiques basés sur d'autres valeurs
Réactivité
- Mise à jour automatique de tous les éléments liés
- Synchronisation en temps réel
- Pas de code manuel nécessaire
Types de nœuds Visual Scripting
- Get/Set : récupération et modification de variables
- Split : division de chaînes
- Last : dernier élément d'un tableau
- Template : formatage de texte avec variables
Événements
- Click : interaction utilisateur
- Logic editing : définir les actions
- Mode Preview requis pour tester
Bonnes pratiques
Organisation du code visual
- Alignement des nœuds pour la lisibilité
- Connexions logiques et claires
- Séparation des responsabilités
Variables et computed
- Variables pour les données utilisateur
- Computed pour les transformations
- Noms explicites et descriptifs
Test et débogage
- Ctrl + Espace : vérifier les valeurs
- Console pour les logs
- Preview mode pour tester les interactions