UI, prefabs et composants récurrents
Frontière
Cette page décrit uniquement les briques UI réellement communes. Les écrans Data-Driven Accounting vont dans By Module; les écrans de cycle annuel vont dans By Year; les prefabs propres à un jeu restent dans sa page game-specific.
Dossiers
Assets/Src/UI/: base commune des contrôles;Assets/Src/UI/SimByModule/: spécialisation By Module;Assets/Src/UI/SimByYear/: spécialisation By Year;Assets/GameSpecific/<gameUid>/Resources/Prefabs/UI/: prefabs propres au jeu.
Composants communs importants
| Famille | Classes représentatives |
|---|---|
| Navigation / panels | MainControlStudent, MainControlTeacher, MainContentPanel, SimPanel, SubPanelBase |
| Popups / wizards | WizardPopupControlBase, WizardPageControlBase, YesNoPopupControl, popups d'édition |
| Inputs | FormattedTMPInputFieldBase, inputs nombres/percentages/positifs, date picker, autocomplete |
| Sélecteurs | SelectorControl, grouped/non-grouped, dropdown overlays, toggles |
| Profil / équipes | ProfilePopupControl, StudentCardControl, GroupStudentsControl, GroupTeamsControl |
| Communication | ChatPopupControl, NotificationsListPopupControl, toasters |
| Scénario | ScenarioPanelControlBase, ScenarioPopupControl, ScenarioItemControl |
| Tooltips / tables | Tooltip base, table rows/cells, scroll helpers et layout helpers |
Règle de prefab
Un prefab commun doit rester générique. S'il commence à contenir des références spécifiques à Accounting, MK1, HR1, etc., créer/maintenir une variante dans le dossier approprié plutôt que d'ajouter des branches GameUid au prefab commun.
Diagnostic UI
- Identifier le prefab instancié.
- Repérer le contrôle C# attaché.
- Remonter vers sa classe Base.
- Identifier le controller/model qui fournit les données.
- Vérifier
TextLoadersi le souci est textuel. - Vérifier le message RTT si l'UI est seulement désynchronisée.
Créer un composant UI commun de A à Z
1. Vérifier qu'il est réellement commun
Si le contrôle connaît un modulePageUid, un segment MK, un employee HR ou une règle ENT, il n'est probablement pas commun. Le mettre dans la famille ou le GameSpecific concerné.
2. Créer le script de contrôle
Placer le C# sous Assets/Src/UI/ dans le dossier logique existant. Exposer les références Unity avec [SerializeField] lorsque possible plutôt que des Find() runtime.
3. Créer/modifier le prefab
Le prefab réutilisable doit vivre dans les Resources/prefabs communs adaptés. Ne pas modifier une instance de scène sans propager les changements au prefab.
4. Brancher les textes
Utiliser TextLoader ou Game.Texts; ne pas hardcoder un texte utilisateur dans le prefab. Ajouter FR/EN via le pipeline Textes.
5. Ajouter les events/listeners
Les listeners de buttons doivent être ajoutés dans Start/OnEnable selon le lifecycle du contrôle et retirés dans OnDestroy/OnDisable lorsqu'ils ciblent des events statiques/globaux.
6. Si le composant doit être ciblable par un tutoriel
Ajouter TutorialUIObject ou TutorialUIButton au prefab avec un UID stable. Voir la page Tutoriels — création de A à Z et architecture.
7. Si la donnée est live
L'UI ne devrait pas écouter BrainCloud directement. Le controller reçoit le RTT, modifie le modèle, puis l'UI observe l'event/controller.
Checklist prefab
- références sérialisées non null;
- anchors/Canvas adaptés aux résolutions WebGL;
- TextLoader/UIDs présents;
- aucune dépendance game-specific cachée;
- listeners nettoyés;
- état initial correct lors d'une réouverture du popup/panel;
- test dans prefab variant et scene réelle;
- build si prefab/asset modifié.
Debug UI
Si l'UI affiche une mauvaise valeur : inspecter d'abord le modèle/controller. Si le modèle est correct, inspecter le binding/control. Si le modèle est faux seulement en live, suivre le RTT. Si le contrôle fonctionne en Editor mais pas WebGL, vérifier les références sérialisées et les exceptions dans la console navigateur.