IHTML Interactive HTML

Guide d'Utilisation — IHTML (Interactive HTML)

Tout ce que fait l'éditeur : interface, vecteurs, artboards, timeline, actions, physique, export et import, raccourcis clavier et l'API publique.

1. Premiers pas

  1. Téléchargez et installez IHTML (Windows, macOS, Linux ou Android), ou clonez le dépôt et lancez npm install et npm run dev.
  2. Le canvas central est votre scène (un ou plusieurs artboards, voir plus bas). La barre supérieure a les outils de sélection/création ; la barre latérale gauche affiche vos Layers ; celle de droite est l'Inspector des propriétés de l'élément sélectionné ; en bas se trouve la Timeline.
La fenêtre d'IHTML : panneau d'éléments à gauche, canvas au centre avec un design en dégradé, et inspecteur et timeline tout autour.
La fenêtre d'IHTML : Elements à gauche, canvas au centre, Inspector à droite et Timeline en bas.

Langue et thème

En haut à droite, à côté des outils du canvas, il y a deux sélecteurs :

  • Langue — 8 disponibles (English, Español, Português, Français, Deutsch, Italiano, 日本語, 中文) : traduit toute la navigation principale et l'Inspector complet (Design/Data/Actions/Physique).
  • Thème — six thèmes, clairs et sombres (gris foncé par défaut).

Les deux sont mémorisés entre les sessions (ils restent dans votre navigateur) et sont une préférence de l'éditeur — jamais enregistrés dans le projet .ihtml ni reflétés dans le HTML exporté.

Créer un élément

Utilisez les outils de la barre supérieure (ou le panneau Elements à gauche) pour ajouter du texte, des formes, des boutons, des inputs, des cards, des navbars et d'autres composants déjà conçus. Le nouvel élément apparaît sélectionné, avec sa bounding box visible.

Les outils de la barre supérieure

Outil Ce qu'il fait
Select (V) Sélectionner, glisser ; glisser sur le fond dessine un rectangle de sélection multiple.
Shape (S) Glissez pour dessiner un rectangle vectoriel ; avec Alt, une ellipse apparaît.
Text (T) Un clic crée un élément de texte à cet endroit.
Zoom (Z) Clic pour zoomer, Alt+clic pour dézoomer.
Hand (H) Faire un pan sans devoir maintenir la barre d'espace.
Pen (P) Dessiner un path à la main (voir plus bas).

Shape et Text reviennent seuls à Select après création, pour que le prochain clic ne crée pas un autre élément par erreur.

Vecteurs (formes dessinées)

Les formes de l'outil Shape — et les cards de la catégorie Shapes du panneau Elements (Rectangle, Ellipse, Triangle, Polygon, Star, Spiral) — sont de véritables éléments vectoriels : ils sont exportés comme un <svg> avec un vrai <path>, pas comme une div aux coins arrondis. Triangle/Polygon naissent comme des polygones réguliers (3 et 6 côtés), Star comme une étoile à 5 branches, Spiral comme une spirale ouverte. Le nombre de côtés/branches est fixé à la création ; pour une forme différente, ajustez les nœuds à la main.

  • Fill, Stroke et Stroke width se modifient dans Element Properties, dans l'onglet Data de l'Inspector (ils acceptent none pour supprimer le remplissage ou le contour) — pas dans la section Fill/Background de Design, qui n'apparaît même pas pour un vecteur : cette section peint le fond de la boîte qui enveloppe le dessin, pas le <path> lui-même.
  • Fill et Stroke ont un échantillon de couleur à côté du champ. Le champ de texte reste prioritaire (vous pouvez toujours taper none pour retirer le remplissage).
  • Les champs numériques (Stroke width, min/max d'un slider, buffer d'un Canvas...) peuvent être glissés pour changer la valeur (icône ⇄ à côté du champ) : Shift plus fin, Alt plus grossier.
  • Redimensionner l'élément met le dessin à l'échelle : la géométrie vit dans son propre espace et le viewBox l'étire jusqu'à la boîte.
  • L'ellipse est enregistrée comme quatre vrais segments bézier, pas comme un cercle CSS.
  • Clip children to shape (Data > Element Properties) : les éléments imbriqués dans ce vecteur deviennent invisibles hors de la zone du polygone — un masque de découpe (CSS pur avec clip-path). N'a d'effet que si le vecteur a des enfants.
  • Animate points (bouton ◆ à la fin de ses propriétés) : un vecteur peut animer sa forme entière avec des keyframes. Touchez le bouton à différents points de la Timeline après avoir modifié les nœuds et cette forme sera enregistrée comme keyframe ; l'éditeur interpole chaque nœud séparément (morphing fluide). N'interpole bien qu'entre deux formes ayant le même nombre de nœuds.

L'outil Pen (dessiner un path)

  • Chaque clic sur le canvas ajoute un sommet droit (angle).
  • Cliquer et glisser donne à ce sommet des poignées bézier symétriques — le geste classique pour un nœud « lisse ».
  • Entrée ferme le path comme ouvert (une ligne).
  • Un clic près du premier sommet le ferme comme polygone.
  • Échap annule tout le dessin — aucun élément n'est créé.

À la fin, le path passe directement en mode édition des nœuds.

Modifier les nœuds d'un vecteur existant

Double-cliquer sur un élément vectoriel entre en mode édition : un point blanc déplaçable par nœud et un point bleu par poignée bézier.

  • Glisser un nœud (blanc) le déplace — toute la courbe se déplace avec lui.
  • Glisser une poignée (bleue) ne change que cette courbe.
  • Suppr efface le nœud sélectionné (jamais en dessous de ce qu'un path valide nécessite : 2 nœuds ouvert, 3 fermé).
  • Échap quitte le mode édition et revient aux poignées normales.

Déplacer, redimensionner, pivoter

  • Glissez pour déplacer, ou utilisez les flèches (Shift + flèche = 10px). Avec plusieurs sélectionnés, tout le groupe se déplace ensemble.
  • Poignées de la bounding box pour redimensionner : Shift conserve les proportions, Alt depuis le centre, Ctrl aligne sur la grille.
  • La poignée circulaire fait pivoter l'élément.
  • Un élément imbriqué dans un parent pivoté/mis à l'échelle suit la souris ou les flèches sur son propre axe visuel, pas sur l'axe de l'écran.
  • Snapping intelligent : s'accroche seul au bord/centre d'éléments proches ou à des guides manuels, avec une ligne rose/cyan pendant l'accrochage. Ctrl force l'alignement sur la grille (mutuellement exclusif).
  • Règle et guides : glisser depuis la barre grise du haut ou de la gauche du canvas crée un guide manuel (ligne cyan). Double-clic l'efface ; le glisser le repositionne.

Artboards (plusieurs zones de travail)

Vous pouvez avoir plus d'un artboard sur le même canvas, chacun avec sa propre taille et son propre fond. Le bouton « Add Artboard » (ou le menu contextuel du fond) en crée un nouveau à côté de l'actif.

  • Un clic sur le fond d'un artboard l'active (les nouveaux éléments y vont).
  • Glisser son étiquette le déplace ; glisser sa poignée d'angle le redimensionne.
  • Avec les flèches et rien de sélectionné, l'artboard actif se déplace ; Suppr sans sélection l'efface (jamais le dernier restant).
  • Export HTML exporte toujours seulement l'artboard actif, pas tout le projet.

Menu contextuel (clic droit)

Un même menu partagé, avec des options selon l'endroit où vous cliquez : sur un élément (dupliquer, supprimer, copier/coller, avancer/reculer...), sur le fond vide (coller, tout sélectionner, ajouter un artboard), sur le fond d'un artboard précis (renommer, dupliquer, supprimer celui-là), ou sur une card du panneau Elements (l'ajouter au canvas).

  • Avec 2+ sélectionnés : grille d'alignement (gauche/centre/droite, haut/milieu/bas) contre le rectangle qui enveloppe toute la sélection.
  • Avec 3+ : aussi répartir l'espacement horizontal/vertical (le premier et le dernier restent fixes et le reste se répartit avec des espaces identiques).
  • Avec 2+ vecteurs frères : grille d'opérations booléennes (Union, Subtract, Intersect, Exclude) utilisant fill-rule et clip-path natifs du SVG. Le résultat s'affiche exactement et s'anime/s'exporte comme n'importe quel vecteur, mais ne reste pas une seule courbe simple éditable nœud par nœud.

L'Inspector (panneau de droite)

Quatre onglets exclusifs — Design, Data, Actions et Physique : un seul s'affiche à la fois.

  • Design — tout ce qui est visuel dans un seul défilement continu : Position/Taille/ Origine/Espacement, Flex/Grid Layout (apparaît quand Display est réglé sur Flex ou Grid), Apparence (Remplissage, Opacité, Blend Mode, Bordure, Rayon, Ombre), Typographie (inclut une recherche de polices web, couleur de texte, ombre du texte) et Effets (échelle, inclinaison, 3D, filtres CSS). Chaque section est un accordéon qui s'ouvre seulement si elle a déjà une valeur propre. De plus, Remplissage/Opacité/Blend Mode/Bordure/Rayon/Ombre s'adaptent au type d'élément : un vecteur ne montre pas Remplissage/Bordure/Rayon (ils vivent dans Data > Element Properties), un texte ne montre pas Bordure/Blend Mode, une image/vidéo ne montre pas Remplissage. Si une section a déjà une vraie valeur, elle apparaît quand même — vous ne perdez jamais l'accès à quelque chose d'utilisé.
  • Data — propriétés HTML : Element Info (ID/Type/Name), sélecteur d'État (Normal/Hover/Active), CSS Classes, Element Properties, Custom Attributes et Accessibility.
  • Actions — interactions sans code (section 4).
  • Physique — simulation réelle (section 4).
Détail : le sélecteur d'État vit dans Data, mais les styles qu'il enregistre (couleurs, typographie, bordures, effets...) se modifient dans Design — choisissez l'état dans Data, puis passez à Design.

Display (Block/Flex/Grid) se choisit avec 3 boutons d'icône ; les variantes moins courantes (Inline Block/Flex/Grid, None) vivent dans le sélecteur « ··· » à côté. Flex/Grid Layout (Direction, Wrap, Justify, Align, Align Self) et Stroke Style (Solid/Dashed/Dotted/Double) se choisissent aussi avec des boutons d'icône.
Les Columns/Rows de Grid se modifient comme une liste de pistes déplaçables (« + Track » ajoute, le × retire ; minimum 1) ; des valeurs comme auto ou minmax(...) se modifient comme du texte normal.
Un enfant d'un conteneur Flex/Grid respecte vraiment la mise en page du parent et garde sa largeur/hauteur (il ne rétrécit pas silencieusement).

Propriétés propres au type d'élément

Dans Data, sous CSS Classes, Element Properties affiche les vraies propriétés HTML du type sélectionné. Exemples :

Élément Propriétés
Range Slider Min, Max, Step, Value
Meter Min, Max, Value, Low, High, Optimum
Progress Value, Max
Inputs Type, Name, Required, Disabled, Read only
Textarea Name, Rows, Max length, Required, Disabled
Image / Picture Source, Alt text, Fit, Loading
Video / Audio Source, Controls, Autoplay, Loop, Muted, Poster
Link URL, Target, Rel
iFrame et embeds Source, Title, Loading
Details / Dialog Open
Vector Fill, Stroke, Stroke width, Clip children
Marquee Direction, Behavior, Speed, Delay
Canvas Buffer width, Buffer height

La section n'apparaît pas pour les types sans propriétés propres (Div, Text). Ce qui n'est pas dans la liste continue d'être modifiable avec Custom Attributes (data-*, aria-*, role, title...). Une valeur égale à celle par défaut n'est pas enregistrée et n'apparaît pas dans le HTML exporté.

Importer un fichier local (Image/Picture/Video/Audio)

Le champ Source (et Poster pour Video) a un bouton Choose File : le fichier est intégré comme un vrai URI data: — portable entre votre machine et le web sans dépendre de serveurs externes (l'app n'a pas de backend). Vous pouvez aussi coller avec Ctrl+V une image copiée du navigateur ou de l'explorateur de fichiers : si vous avez déjà une Image/Picture/ Video sélectionnée, elle est remplacée ; sinon, une nouvelle Image est créée. Coller un élément copié à l'intérieur de l'éditeur fonctionne toujours pareil (l'éditeur vérifie d'abord s'il y a une image dans le presse-papiers système).

Texte modifiable sur les composants décoratifs

Badge, Avatar, Tooltip, Alert Box, Tab Bar et Breadcrumb modifient leur texte avec le champ Content (Design). Tab Bar et Breadcrumb utilisent une liste séparée par des virgules — Overview,Pricing,FAQ donne trois onglets. Card, Pricing, Navbar et Pagination conservent un contenu d'exemple fixe (ils ont plus d'un texte propre ; une passe dédiée reste à faire). Tooltip est une maquette statique pour concevoir son apparence ; pour un vrai tooltip, associez-le avec Actions (hover → Show / mouseLeave → Hide, avec le Tooltip qui démarre caché).

Conteneurs sémantiques (Header, Footer, Aside, Nav, Main...)

La catégorie Semantic (Header, Nav, Main, Aside, Footer, Section, Article, Figure, Figcaption) exporte avec sa vraie balise HTML (<header>, <aside> ...) — important pour le SEO/l'accessibilité. Les cinq landmarks (Header/Nav/Main/Aside/Footer) naissent en occupant un vrai bord de l'artboard ; ce n'est qu'un point de départ : ils se modifient comme n'importe quel autre élément et n'ont ni couleur ni bordure d'origine.

Accessibilité

Sous Custom Attributes, la section Accessibility s'applique à tout élément : ARIA Label, ARIA Role (avec des rôles courants et « (automatic) »), Hide from screen readers (aria-hidden) et Keyboard focusable (tabindex="0"). Les quatre sortent comme de vrais attributs HTML — sur le canvas et dans le fichier exporté — sans une seule ligne de JavaScript. Pour quelque chose de plus spécifique (aria-describedby, aria-live...), vous avez toujours Custom Attributes.

Remplissage (Fill) : couleur unie, dégradé ou image

Le champ Fill est un bouton-résumé (échantillon + libellé) qui ouvre un popover avec des onglets — Solid / Linear / Radial / Conic / Image :

  • Solid — une couleur, avec le sélecteur.
  • Linear / Radial / Conic — liste de points (2+ couleurs avec une position 0-100 %, « + Add Stop »), plus Angle (Linear/Conic) ou Center X/Y (Radial).
  • Image — une URL ou importer un fichier local (URI data:).

Le sélecteur de couleur (le même dans Fill, Border, Shadow, Text Color, Text Shadow et les points) propose un carré Saturation/Luminosité, un curseur de Teinte et d'Alpha (avec fond à damier), et un champ de texte qui cycle HEX → RGBA → HSLA d'un clic — coller n'importe lequel des trois formats fonctionne aussi. Dans Fill/Border/Text Color/Vector Fill-Stroke, avec Solid actif, le sélecteur s'affiche seul, collé juste en dessous du popover — un seul clic pour le voir entier, sans devoir ouvrir le petit échantillon à part.

Ligne de dégradé directement sur le canvas (avec un élément à Fill Linear ou Radial) : vous glissez la ligne directement sur le dessin, façon Affinity Designer. Avec la case Automatique du popover activée (par défaut), choisir Linear ou Radial l'affiche déjà toute seule, sans rien appuyer d'autre ; revenir à Solid la masque. La touche G continue de fonctionner comme bascule manuelle d'affichage, en plus de cela. Linear = deux extrémités déplaçables (la ligne n'est plus liée au centre de la boîte, une vraie limitation de la syntaxe CSS contournée avec un dégradé SVG en dessous) ; Radial = une poignée centrale et une de bord (un cercle, pas une ellipse) ; dans les deux modes il y a un point par arrêt (glissez-le pour le déplacer, double-clic sur la ligne ajoute un arrêt) ; Échap quitte. Taper un nombre dans Angle/Center X/Y revient au mode centré habituel. Conic garde le champ d'angle numérique.

États : Normal / Hover / Active

Dans l'onglet Data, au-dessus de CSS Classes, il y a un sélecteur à trois boutons. Tant que vous êtes sur Hover ou Active, tout ce que vous modifiez dans Typography/Colors/ Borders/Effects/Layout (dans Design) est enregistré pour cet état. Le canvas l'affiche en direct (l'élément sélectionné est « forcé » à montrer l'état). C'est exporté comme une vraie règle CSS — #id:hover{...} / #id:active{...} — sans JavaScript.

Limites : Position/Size/Origin ne font jamais partie d'un état ; et dans quelques types ayant leur propre contenu (Button, Link, Badge et similaires, qui ont leur propre <button>/<a> interne) la couleur/le fond de ce contenu interne ne peut pas être changé par état ni par classe partagée. Un Div ou un Text n'ont pas ce problème.

2. Calques

Le panneau de gauche (onglet Layers) affiche la hiérarchie des éléments. Vous pouvez regrouper, dégrouper, promouvoir/rétrograder et réordonner par z-index (avancer / reculer).

  • Un clic normal sélectionne un seul élément.
  • Ctrl/Cmd+clic ajoute ou retire un élément précis.
  • Shift+clic sélectionne la plage visible (respecte l'imbrication).

Ctrl+C / Ctrl+X / Ctrl+V copient, coupent et collent (avec le focus sur le canvas ou sur Layers). Copier un parent avec son enfant conserve le lien au collage. Coller plusieurs fois espace chaque copie légèrement au lieu de les empiler.

Glisser pour imbriquer : déposer un élément sur un autre en fait son enfant, sauf si la cible est un vrai « void element » (<img>, <input>, <br>, <hr>... — ils ne peuvent pas avoir de contenu) ; le déposer là le réordonne comme frère. Tout autre type (<div>, <button>, <section>, <a>...) peut bien être un parent.

Verrouiller les calques et Guide Layers (style After Effects)

  • Verrouiller (cadenas sur chaque ligne de Layers) : empêche de sélectionner, déplacer, redimensionner ou pivoter CET élément depuis le canvas — vous pouvez toujours le sélectionner depuis le panneau Layers lui-même.
  • Marquer comme Guide Layer (menu contextuel) : visible et modifiable dans l'éditeur, mais totalement exclu du HTML exporté (avec tout enfant qu'il aurait) — utile pour des règles, notes ou références de design.

3. Animation (Timeline)

Avec beaucoup de calques, la liste de gauche (noms) et les pistes de droite (keyframes) défilent verticalement ensemble, dans leur bande à hauteur fixe.

Plusieurs animations nommées indépendantes

IHTML permet des timelines séparées et indépendantes :

  • Le sélecteur de l'en-tête affiche l'animation active ; à côté se trouvent « + » (Add Animation) — qui en crée une nouvelle et demande un nom —, le crayon (Rename) et la corbeille (Delete). Impossible de supprimer la dernière (le bouton reste désactivé) ; en supprimer une fait perdre ses keyframes sur tous les éléments et demande une confirmation.
  • Loop et Auto sont propres à l'animation sélectionnée : Loop recommence en arrivant à la fin (désactivé, elle s'arrête sur le dernier frame) ; Auto démarre seule au chargement de la page exportée. Une nouvelle animation ne démarre pas seule : l'intérêt d'en avoir plusieurs est de les déclencher avec des actions Play Timeline.
  • Les keyframes ne sont liés QU'à l'animation active : la même propriété peut avoir un keyframing différent dans chaque animation.
  • Changer d'animation actualise la Timeline, le canvas et la tête de lecture.

Marqueurs d'action sur la Timeline

Le bouton éclair (ou double-clic sur la bande fine sous la règle) ajoute un marqueur à la position de la tête de lecture : il déclenche une action quand la lecture atteint cette milliseconde, sans que le visiteur touche à rien.

  • Il se modifie dans le même panneau Actions de l'Inspector (mêmes types ; la ligne Trigger disparaît : le « quand » est la position du marqueur).
  • Il se glisse pour le déplacer et se supprime avec Suppr dans le même panneau.
  • Se déclenche une fois par passage (avec Loop, se redéclenche à chaque boucle).

Pour créer un keyframe pour une propriété

  1. Choisissez (ou créez) l'animation sur laquelle vous voulez travailler.
  2. Sélectionnez un élément et cliquez sur le losange (◆) à côté de la propriété à animer (position, opacité, couleur, échelle...) pour activer le suivi de keyframes de cette propriété.
  3. Déplacez-vous vers un autre point de la timeline (en glissant la tête de lecture) et changez la valeur : un keyframe est créé automatiquement si le mode Auto-Keyframe (bouton rouge ◆, raccourci R) est activé ; sinon, utilisez « Add Keyframe at Playhead ».
  4. Double-clic sur un keyframe fait défiler sa courbe d'easing (linear, ease-in/out, cubique, back, bounce, élastique...).
  5. Espace lit/met en pause ; les boutons de frame précédent/suivant avancent frame par frame ; la durée totale se contrôle dans le champ Dur (par animation).
La section des propriétés de la Timeline : sous-pistes « Position X » et « Opacité » avec leurs keyframes en forme de losange, la valeur actuelle et un chip d'easing par arrêt.
Quand vous sélectionnez un élément, ses propriétés animées apparaissent sous sa ligne : chacune avec ses keyframes, sa valeur à la tête de lecture et sa courbe d'easing.

Enregistrement automatique (REC / Auto-Keyframe)

Avec R activé, IHTML crée un keyframe au temps de la tête de lecture chaque fois que vous modifiez une propriété déjà suivie — cela inclut les nœuds et poignées d'un vecteur (glisser un point ou sa poignée bézier enregistre tout le nœud). Pendant que REC est actif, un badge rouge clignotant (« ● REC ») apparaît en haut à droite.

Sélectionner, glisser et copier/coller des keyframes

  • Cliquer sur un keyframe le sélectionne ; Shift+clic ajoute/retire ; un marquee sur un espace vide sélectionne tous ceux qu'il touche.
  • La barre plate entre deux keyframes consécutifs est aussi sélectionnable et déplaçable : elle déplace tout le segment en conservant l'intervalle.
  • Glisser près de la tête de lecture ou d'un autre keyframe accroche exactement à ce temps (guide vert).
  • Ctrl+C/Ctrl+V copient/collent le(s) keyframe(s) sélectionné(s) au temps de la tête de lecture (en plus des boutons Copier/Coller/Dupliquer à côté du sélecteur d'easing) ; avec plusieurs, leur espacement relatif est conservé.
  • Sur un keyframe : Copier, Dupliquer, Supprimer, Interpolation (grille visuelle de courbes) et Déplacer vers la tête de lecture.
  • Sur le segment : Copier, Dupliquer, Supprimer (s'appliquent aux deux extrémités comme un groupe).
  • Sur un espace vide d'une piste : Coller, au temps sous le curseur.
  • Sur le nom d'un élément : le même menu d'élément que Layers et le canvas.
  • Sur la règle : « Extend +1s » ajoute une seconde à la durée totale.
Exporté : la première animation de la liste se lance seule dès que la page se charge ; toute autre reste en pause jusqu'à ce qu'une action « Play Timeline » la déclenche. Un projet avec une seule animation se comporte comme avant.

Fichiers (connecté à votre vrai dossier)

À côté de l'onglet Timeline se trouve Files : un gestionnaire connecté DIRECTEMENT à un vrai dossier de votre ordinateur, comme le panneau FileSystem de Godot/Unreal/Unity. Choose folder demande le dossier système (une fois par session) ; cliquer sur une image, vidéo ou audio de l'arbre l'ajoute directement au canvas comme nouvel élément. Utilise la File System Access API : Chrome/Edge/Opera seulement pour l'instant — sous Firefox ou Safari, le bouton apparaît désactivé avec une note.

4. Actions interactives (sans code)

Dans l'onglet Actions de l'inspecteur, vous définissez ce qui se passe quand l'utilisateur interagit avec un élément dans le HTML exporté, sans écrire de JavaScript :

  • Déclencheurs : clic, survol, mouse enter/leave, double-clic, On Drag Start / On Drag End (un simple clic sans mouvement ne compte pas comme un glissement), touche pressée, scroll, entrer dans le viewport, après un délai, au chargement de la page.
  • Actions : afficher/masquer/basculer la visibilité, ajouter/retirer/basculer une classe CSS, animer une propriété CSS, jouer / mettre en pause / aller à un temps d'une animation nommée précise (champ « Animation »), défiler vers un élément, fixer un style inline, aller à une Page.
  • Cible : l'élément lui-même, son conteneur parent, tous les éléments, ou un élément précis choisi par nom (le sélecteur Target liste, sous les trois options fixes, tous les éléments de Layers). Ne s'applique pas à Play/Pause/Go to Time, Set Variable ni Go to Page : ils sont globaux au projet.
Key Down utilise le champ Key : ne se déclenche qu'avec cette touche, et jamais tant que le focus est dans un champ de texte. After Delay compte à partir du chargement de la page ; In Viewport se déclenche chaque fois que l'élément entre à l'écran.

Pages (scènes)

L'onglet Pages de la barre latérale gauche liste les Artboards comme des pages navigables — ce n'est pas une nouvelle donnée, juste une vue dédiée. Clic droit : le même menu Activer/Renommer/Dupliquer/Supprimer que le fond d'un artboard.

  • « + New page » ouvre un menu : Blank page ou un préréglage responsive (Tablet vertical/horizontal, Mobile vertical/horizontal).
  • Un préréglage Tablet/Mobile créé avec une autre page sélectionnée devient groupé comme variante responsive de cette page (indenté dans Pages et Layers). Une page vierge n'est jamais imbriquée. Dupliquer une variante conserve la page parente ; supprimer une page avec des variantes les fait remonter à la racine.
  • Par défaut, seule la page sélectionnée est visible (et seulement ses calques dans Layers). Le bouton « Selected only » / « All visible » change les deux vues : avec « All visible », les autres pages apparaissent sur le canvas comme un rectangle vide (position/taille, déplaçable, redimensionnable, activable d'un clic) sans leur vrai contenu.
  • L'action Go to Page masque la page actuelle et en affiche une autre avec une transition : Fade, Slide (4 directions) ou instantanée (None), avec sa durée en ms. Dans le HTML exporté, seulement si le projet utilise Go to Page quelque part TOUTES les pages sont empaquetées ensemble (cachées sauf la page initiale) — un projet avec plusieurs artboards qui n'utilise pas Go to Page s'exporte exactement comme d'habitude.

Variables du projet (compteurs et calculs)

Au-dessus de la liste d'actions : Project Variables — des valeurs numériques nommées, pour tout le projet. Utiles pour des compteurs, des scores, des étapes de formulaire, etc.

  1. Créer la variable avec « + Add Variable » (nom + valeur initiale ; le nom est réduit aux lettres, chiffres et underscores et ne peut pas casser la syntaxe).
  2. La modifier avec Set Variable (math) : quelle variable, quelle opération (= Set to, + Add, − Subtract, × Multiply by, ÷ Divide by, % Remainder of, ⌃ Clamp min, ⌄ Clamp max) et avec quel nombre. Diviser par zéro laisse la valeur inchangée.
  3. L'afficher en écrivant {{nom}} dans le champ Content de n'importe quel élément : on voit la valeur actuelle sur le canvas et sur la page exportée, et elle se met à jour seule. Un nom ne correspondant à aucune variable reste visible tel quel, pour que l'erreur soit remarquée.

Un compteur complet : variable score = 0, un bouton avec click → Set Variable → score → + Add → 1, et un texte Score : {{score}}. Si aucune action ne modifie une variable, sa valeur est figée dans le HTML exporté sans une ligne de JavaScript. Les éléments affichant une variable ne sont repeints en direct que s'ils n'ont pas d'enfants imbriqués.

Physique (simulation réelle — gravité, collisions, rebond)

L'onglet Physique de l'Inspector donne à n'importe quel élément un comportement physique réel, avec le moteur Matter.js :

  1. Activer la physique : lance la simulation pour cet élément.
  2. Type de corps : Dynamique (tombe, rebondit, entre en collision avec d'autres corps et avec les bords du canvas) ou Statique (fixe — utile comme sol, mur ou plateforme).
  3. Forme : Rectangle ou Cercle (la forme de collision, pas l'apparence visuelle).
  4. Rebond, Friction et Densité : élasticité, glissance et poids.
  • Les corps restent enfermés dans leur page/artboard : les quatre bords agissent comme des murs invisibles.
  • Un corps Dynamique peut être saisi et glissé sur la page exportée ou en Preview ; en le relâchant, il continue avec la vraie physique. Un Statique ne bouge pas même si vous le « saisissez ».
  • Important : la physique n'est pas simulée en direct pendant l'édition (l'élément s'affiche à sa position X/Y, pour ne pas entrer en conflit avec le glisser) ; elle démarre en Preview ou à l'ouverture du HTML exporté. Un projet sans Physique ne télécharge aucune bibliothèque en plus.

5. Code personnalisé

Deux boutons de code dans la barre supérieure, avec des portées différentes :

  • 💻 Code Editor — CSS/JS pour l'élément sélectionné : du CSS ajouté en inline à l'élément, ou un script qui s'exécute au clic sur lui dans le HTML exporté.
  • `</>` Live HTML/CSS — vue en direct du HTML et CSS de tout le projet, modifiable : vous écrivez et touchez « Apply Changes » pour l'enregistrer dans le projet.
    • Une balise avec un id existant met à jour cet élément (contenu, attributs, classes, parent).
    • Une nouvelle balise a besoin de data-type="..." pour être créée comme un vrai élément ; sans ça elle est ignorée avec un avertissement.
    • Supprimer une balise supprime cet élément.
    • Les styles que vous supprimez du CSS ne sont pas retirés tout seuls de l'élément — utilisez le bouton de reset de cette section dans l'Inspector.
    • Un dégradé/filtre/transform écrit à la main qui ne correspond pas exactement au format que le panneau génère est ignoré (ce n'est pas un parseur CSS complet, c'est une vue aller-retour du modèle de données).
    • « Refresh » annule tout changement non appliqué.

6. Exporter

Il y a deux chemins : Export HTML pour publier sur le web, et Export (.ihtml) pour envoyer un document qui s'ouvre avec IHTML Mirror.

  • 🌐 Export HTML — pour le web (hébergement, CMS, <iframe>...) : un dialogue avec Single HTML file (un unique fichier .html standard et autonome, avec le moteur embarqué, SANS données de projet — plus léger) ou Separate HTML + CSS + JS. Ce .html fonctionne dans n'importe quel navigateur et hébergement.
  • 💾 Export — télécharge project.ihtml : le document d'IHTML. Il embarque le projet ENTIER (éléments, animations, keyframes, actions, calques, polices, images, vidéo). C'est à la fois le résultat et la source : qui le reçoit l'ouvre avec IHTML Mirror (l'app gratuite, bureau ou Android) et vous le rouvrez avec Import pour continuer exactement où vous en étiez. Un fichier .ihtml n'est pas fait pour un double-clic dans Chrome : c'est Mirror qui l'ouvre, car il comprend le format. Si vous avez besoin que ça s'affiche dans un navigateur sans rien installer, utilisez Export HTML.
  • ▶ Preview — ouvre le résultat dans un nouvel onglet sans rien télécharger, à partir de l'état actuel de l'éditeur.
  • 🖼 Exporter image / GIF / vidéo — rastérise l'artboard : image fixe (PNG, WebP, JPEG), GIF animé ou vidéo (MP4, WebM). Vous choisissez le FPS et l'échelle.
  • 📱 Aperçu mobile — affiche un QR code ; scannez avec votre téléphone et voyez le projet en direct (même réseau, se recharge seul en éditant).
Forfaits : le forfait Gratuit exporte une image fixe (PNG/WebP/JPEG). Le forfait Complet ajoute l'export .html et .ihtml, GIF et vidéo, Preview et l'aperçu par QR sur mobile. S'active avec une clé de licence dans Settings › Plan.

Les deux sont indépendants de l'éditeur : ils n'embarquent qu'un runtime minimal généré à partir du même moteur d'animation, donc le résultat s'anime exactement comme l'aperçu.

Ouvrir un fichier .ihtml : depuis IHTML Mirror (bouton « Ouvrir un projet », ou en le glissant sur la fenêtre). Sur Android, en recevant le fichier (par exemple via WhatsApp), choisissez IHTML Mirror dans « Ouvrir avec ». Dans l'Éditeur, Import l'ouvre pour le modifier.

7. Importer

📂 Import accepte aussi bien .ihtml (détecte automatiquement le projet embarqué) qu'un .json exporté par des versions antérieures de l'éditeur (compatibilité rétroactive). Si le fichier n'a pas la forme attendue (il manque elements, ou ce n'est pas un JSON/.ihtml valide), l'éditeur le rejette avec un message expliquant ce qui ne va pas, sans toucher au projet que vous aviez ouvert.

De plus, IHTML peut reconstruire un design à partir d'autres formats et l'importer comme des éléments modifiables sur un nouvel artboard :

  • Du vrai HTML (clic droit sur un .html dans le Gestionnaire de fichiers) : il est mesuré avec un iframe et chaque nœud devient son élément IHTML, en conservant hiérarchie et styles.
  • Du SVG (formes, texte et images) — le chemin recommandé pour importer un frame de Figma (exportez-le en SVG).
  • Des designs de Sketch (.sketch), Penpot (.penpot) et des livres EPUB.

8. Format du projet (embarqué dans .ihtml, ou l'ancien .json)

Référence rapide de la structure :

// project: name, version, artboards[], animations[], grid, classes
{
  "project": { "name": "Mon Projet", "artboards": [ ... ], "animations": [ ... ], ... },
  "activeArtboardId": "artboard-1",
  "activeAnimationId": "anim-1",
  "elements": [
    {
      "id": "elem-172...-a1b2c", "type": "text",
      "parentId": null, "artboardId": "artboard-1",
      "styles": { "left": 100, "top": 50, "width": 300, ... },
      "keyframes": { "anim-1": { "opacity": [
        { "time": 0, "value": 0, "easing": "linear" },
        { "time": 1000, "value": 1, "easing": "easeOutCubic" } ] } },
      "actions": [ { "trigger": "click", "type": "toggleClass", ... } ]
    }
  ]
}

Toutes les valeurs numériques de styles/keyframes sont sans unité (left: 100, pas "100px") ; l'éditeur ajoute px/deg/ etc. À l'import, l'éditeur normalise les valeurs avec unité et migre automatiquement les anciens projets (artboard unique, animations plates).

9. Raccourcis clavier

Raccourci Action
V / H / T / S / P / Z Outil : Select / Hand / Text / Shape / Pen / Zoom
Espace Lire / mettre en pause
← → ↑ ↓ Avec sélection : déplace l'/les élément(s) de 1px (en respectant son propre axe si dans un parent pivoté). Sans sélection : déplace l'artboard actif ; ←/→ avancent/reculent aussi d'un frame de la timeline
Shift + flèche Déplacer l'/les élément(s) ou l'artboard de 10px au lieu de 1px
Ctrl + glisser Aligner sur la grille (au lieu du snapping intelligent)
Home / End Aller au début / à la fin de la timeline
Ctrl+D Dupliquer la sélection
Ctrl+C / Ctrl+X / Ctrl+V Copier / couper / coller la sélection. Avec des keyframes sélectionnés sur la Timeline, copie/ colle CES keyframes (prioritaire)
Suppr / Retour arrière Supprimer la sélection (sans sélection, supprime l'artboard actif — jamais le dernier)
Ctrl+Z / Ctrl+Shift+Z (ou Ctrl+Y) Annuler / rétablir
Ctrl+A Sélectionne tous les éléments du canvas (dans un champ de texte, sélectionne le texte du champ)
R Basculer le mode Auto-Keyframe
Ctrl + molette de la souris Zoom du canvas
Clic droit Menu contextuel (élément, fond d'artboard, ou card du panneau Elements)
Dans Layers : Ctrl/Cmd+clic, Shift+clic Sélection multiple (ajouter/retirer un élément, ou une plage)

10. API publique en temps réel

Quand le projet a une animation ou une action, le HTML/.ihtml exporté expose window.ihtmlDocument — une API publique, stable et documentée pour le contrôler depuis L'EXTÉRIEUR du no-code lui-même (votre propre script, une page qui l'embarque, ou l'automatisation de navigateur) :

ihtmlDocument.playTimeline('Bounce'); // joue cette animation nommée
ihtmlDocument.pauseTimeline('Bounce');
ihtmlDocument.gotoTimeInTimeline(500, 'Bounce'); // ms, nom
ihtmlDocument.isTimelinePlaying('Bounce'); // true/false
ihtmlDocument.timelineNames(); // ['Animation 1', 'Bounce', ...]
ihtmlDocument.getElementById('elem-172...'); // le vrai nœud DOM
ihtmlDocument.triggerAction('elem-172...', 'click'); // déclenche ses actions "click"
ihtmlDocument.triggerAction('elem-172...', 'keydown', 'Escape');

ihtmlDocument.getVariable('score'); // valeur actuelle
ihtmlDocument.setVariable('score', 10); // la change et repeint les {{score}}
ihtmlDocument.variableNames(); // ['score', ...]

Les noms sont ceux que vous avez mis dans l'éditeur (sélecteur de la Timeline, panneau Project Variables), pas les ids internes.

Embarqué via un <iframe> de même origine (la page qui l'embarque et le fichier exporté sont servis depuis le même domaine) :

const win = document.getElementById('monIframe').contentWindow;
win.ihtmlDocument.playTimeline('Bounce');
Si l'iframe est sur un autre domaine, le navigateur bloque cet accès direct pour des raisons de sécurité (ce n'est pas une limitation d'IHTML) — il faut alors postMessage, pas encore implémenté.

11. MCP — contrôle par agents IA

IHTML expose un serveur MCP (Model Context Protocol) qui donne à un agent IA — Claude Code ou un autre client MCP — un contrôle direct sur l'éditeur déjà ouvert (le navigateur en développement, ou l'app de bureau), sans simuler de clics de souris sur une fenêtre : le même modèle déjà utilisé par des éditeurs comme Godot ou Blender.

Pour l'activer, un fichier .mcp.json à la racine du projet pointe vers le serveur :

{
  "mcpServers": {
    "ihtml-editor": { "command": "node", "args": ["bridge/mcp-server.js"] }
  }
}

Avec l'éditeur ouvert (navigateur ou app de bureau), l'agent peut déjà appeler des outils comme :

  • get_scene — lit l'artboard actif et tous les éléments.
  • add_element / set_text / set_style / delete_element — crée et modifie des éléments (set_style accepte un breakpoint pour écrire une surcharge responsive au lieu de la valeur de base).
  • set_breakpoint / select_element — change le breakpoint actif ou la sélection, comme un vrai clic.
  • set_canvas_size / fit_canvas_height — redimensionne l'artboard (hauteur propre par breakpoint) ou l'ajuste au contenu réel.
  • apply_template — charge un modèle du catalogue.
  • get_html — renvoie le HTML/CSS/JS que le projet exporterait, sans écrire aucun fichier.
Couverture actuelle : création/édition basique d'éléments, breakpoints et export. Timeline/ keyframes, Actions, Physique, Symbols, Pages, Vectors et Data n'ont pas encore leurs propres outils MCP.