Skip to main content

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 TextLoader si 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.

      Back to top