L'éditeur de code et la mémoire des pages HTML5

Dernière mise à jour le 22 novembre 2026

Mis à jour pour la version 6.0.30

Quand vous écrivez du JavaScript, du CSS ou une page HTML5 dans Celestory, vous le faites dans un éditeur de code complet, aux couleurs de votre thème. Cet article présente ses fonctions utiles, puis explique comment une page HTML5 peut garder des données (un score, un prénom, une étape) avec localStorage et sessionStorage.

Éditeur de code ouvert sur un script JavaScript : barre Code JavaScript avec le bouton plein écran, numéros de ligne, coloration et minimap à droite l'éditeur de code ouvert sur un script JavaScript, avec les numéros de ligne, la minimap à droite et la poignée de hauteur en dessous

À quoi ça sert

  • Écrire ou coller du code confortablement : couleurs de syntaxe, numéros de ligne, parenthèses colorées par niveau, repères d'indentation.
  • Se repérer dans un long code grâce à la minimap (l'aperçu du code, à droite).
  • Profiter de l'aide à la saisie pour celestoryPoints et loadExternalScript dans les scripts JavaScript.
  • Faire en sorte qu'une page HTML5 se souvienne de données entre deux pages, ou entre deux visites.

Où trouver l'éditeur

L'éditeur apparaît partout où vous saisissez du code, notamment :

  • dans l'éditeur de bloc, pour le paramètre « contenu » du bloc HTML5, le paramètre « code » du bloc Exécuter Javascript et le paramètre « style » du bloc CSS ;
  • dans le panneau d'une variable de type Code ;
  • dans le CSS d'un élément de menu.

Le bouton plein écran et l'aide à la saisie des scripts n'existent que dans l'éditeur de bloc. Quand l'éditeur est vide (dans l'éditeur de bloc et pour le CSS d'un élément de menu), un texte gris vous guide : « Écrivez ou collez votre HTML ici », « Écrivez ou collez votre CSS ici » ou « Écrivez votre script ici, celestoryPoints.get et celestoryPoints.set le relient au graphe ».

Les fonctions de l'éditeur

Thème

L'éditeur reprend les couleurs du thème de Celestory que vous avez choisi : fond clair ou sombre, couleur d'accent, couleurs de la syntaxe. Les textes restent lisibles quel que soit le thème, car l'éditeur ajuste lui-même le contraste.

Minimap

Un aperçu du code est affiché à droite. Le curseur de la minimap apparaît quand vous passez la souris dessus.

Hauteur réglable

Sous l'éditeur, une barre de séparation règle la hauteur :

  • faites-la glisser avec la souris ;
  • ou utilisez les flèches haut et bas du clavier (avec Maj pour un grand pas) ;
  • double-cliquez dessus pour rétablir la hauteur d'origine.

Plein écran

Dans l'éditeur de bloc, cliquez sur l'icône Ouvrir l'éditeur en plein écran (au-dessus de l'éditeur, à droite) pour écrire dans une grande fenêtre. Pour revenir, cliquez sur l'icône Quitter le plein écran située dans l'éditeur, en haut à droite, à gauche de la minimap. Votre code est enregistré quand vous quittez le champ ou fermez la fenêtre.

Éditeur de code en plein écran : barre sombre Code JavaScript avec le bouton Quitter le plein écran à droite, éditeur sur toute la page l'éditeur en plein écran avec l'icône Quitter le plein écran en haut à droite

Complétion dans les scripts JavaScript

Dans un script JavaScript, l'éditeur propose des suggestions et affiche l'aide de deux éléments propres à Celestory :

Élément Rôle
celestoryPoints.get(nom, valeurParDéfaut) Crée une entrée dans le graphe et lit sa valeur
celestoryPoints.set(nom, valeur) Crée une sortie dans le graphe et lui donne une valeur
loadExternalScript(identifiant, adresse) Charge un fichier JavaScript externe une seule fois pour un identifiant donné

Raccourcis

L'éditeur reprend les raccourcis habituels de Monaco, le moteur de l'éditeur de Visual Studio Code. Par exemple : Ctrl + Espace pour afficher les suggestions (aussi sur Mac), Ctrl + F pour chercher dans le code et Ctrl + Z pour annuler (sur Mac, Cmd + F et Cmd + Z).

Les pages HTML5 dans le lecteur

Une page HTML5 s'exécute dans un cadre isolé : elle peut lancer ses propres scripts, mais elle ne peut pas atteindre l'éditeur, le lecteur de votre app, ni leur mémoire. Elle communique avec le graphe uniquement par les sorties que vous déclarez (voir Écrire une page HTML5 dans Celestory).

Ce cadre isolé n'a pas d'adresse propre, donc le navigateur ne lui donne ni localStorage ni sessionStorage. Celestory les fournit à la place : votre page les utilise exactement comme d'habitude, et le lecteur garde les données pour elle.

Mémoriser des données

Mémoire Ce qu'elle garde Combien de temps
localStorage Les données de la page Elles restent d'une visite à l'autre dans le même navigateur
sessionStorage Les données de la page Elles durent tant que l'onglet du jeu reste ouvert, même si vous rechargez la page

Ce qu'il faut savoir :

  • la mémoire est commune à toutes les pages HTML5 d'un même projet, et séparée d'un projet à l'autre ;
  • elle est propre à chaque navigateur et à chaque appareil : un joueur ne retrouve pas ses données sur un autre téléphone ;
  • les écritures comme localStorage.score = 5 et localStorage.setItem("score", "5") fonctionnent toutes les deux ;
  • les données sont effacées de votre navigateur quand vous supprimez le projet depuis la page d'accueil du Creator.

Exemple : un score gardé entre deux pages

Dans une première page HTML5, enregistrez le score :

localStorage.setItem("score", "12");

Dans une page HTML5 suivante du même projet, relisez-le :

const score = Number(localStorage.getItem("score") || 0);

Comme les valeurs sont toujours du texte, convertissez-les avec Number(...) si vous en faites un nombre.

Limites

Pour éviter qu'une page ne remplisse la mémoire du lecteur, chaque projet est limité :

Limite Valeur
Nombre de clés 200
Longueur d'une clé 256 caractères
Longueur d'une valeur 100 000 caractères
Taille totale 1 000 000 caractères
Écritures 250 par seconde

Quand une limite est dépassée, setItem déclenche l'erreur QuotaExceededError et la modification est annulée. Le lecteur peut aussi annuler une modification qu'il n'a pas gardée : la page reprend alors la valeur du lecteur, et un message apparaît dans la console du navigateur. Toutes les valeurs sont enregistrées sous forme de texte.

💡 Astuce : ne stockez pas de gros contenus (images, longs textes). Gardez des valeurs courtes et reconstruisez le reste à l'affichage.

Dépannage

Problème Solution
Une donnée enregistrée a disparu Vérifiez que vous testez dans le même navigateur et le même projet ; une navigation privée peut ne rien garder
QuotaExceededError Réduisez le nombre ou la taille des valeurs, ou supprimez celles dont vous n'avez plus besoin avec removeItem ou clear
Le texte gris n'apparaît pas Il ne s'affiche que quand l'éditeur est vide, dans l'éditeur de bloc (HTML, CSS, JavaScript) et pour le CSS d'un élément de menu

Voir aussi