Référence du balisage des blocs
Cette page montre ce que chaque bloc interactif place dans le HTML envoyé et comment la réponse d'un destinataire parvient à MailInApp. Elle s'adresse aux développeurs et à ceux qui exportent le HTML pour l'envoyer depuis une autre plateforme. La page de chaque bloc décrit ce que voient les destinataires et ce que vous obtenez. Les niveaux eux-mêmes sont expliqués dans Comment fonctionnent les alternatives.
Les exemples sont abrégés : la sortie réelle contient davantage de styles en ligne, une ou deux classes de mode sombre et les couleurs de votre thème. Chaque lien pointe vers le jeton signé de vue en direct du destinataire (/v/[token]), qui identifie l'e-mail et, pour un envoi personnalisé, le destinataire.
Comment les réponses sont enregistrées
Deux chemins mènent au même point d'enregistrement et produisent le même événement : les résultats ne dépendent donc jamais de l'endroit où un destinataire a répondu.
- Liens de confirmation. Une réponse en un tap est un
<a href>vers/v/[token]/actavec le bloc, l'action et la valeur dans la requête. La page ouverte demande au destinataire de confirmer, et c'est l'envoi du formulaire de confirmation qui enregistre la réponse. Un simple GET n'enregistre rien : les scanners de liens et outils de sécurité qui préchargent chaque lien ne peuvent pas voter. Voir Enregistrement d'interaction à l'épreuve des scanners. - Envois de formulaire. Un bloc à réponses saisies ou multiples envoie un
<form method="post">qui publie vers/api/interactionsenapplication/x-www-form-urlencoded. Gmail sur le web et les applications Outlook pour iOS et Android l'envoient depuis l'e-mail. Chacun de ces formulaires porte aussi un lien Répondre sur le web, toujours visible, vers le même bloc dans la vue en direct, où c'est un formulaire web ordinaire.
La réponse d'un destinataire est enregistrée une fois par e-mail, bloc et destinataire, sous un identifiant de document formé des trois : un tap répété ou une page rechargée ne change rien. Les réponses issues d'un e-mail exporté sans jeton de destinataire n'ont pas de personne à qui se rattacher : elles sont limitées par IP, par campagne et par minute.
Blocs de retours clients
Sondage
Chaque option est un lien de confirmation stylé en puce. Il est toujours visible, dans toute application de messagerie.
<div id="em-poll-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Which do you prefer?</p>
<div>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=poll-1&blockType=poll&action=vote&option=Option+A&optionId=poll-option-2"
style="display:inline-block;margin:0 6px 6px 0;padding:8px 14px;border:1px solid #d1d5db;border-radius:6px;background-color:#ffffff;color:#111827;font-size:14px;text-decoration:none">
Option A
</a>
<a href="...option=Option+B&optionId=poll-option-3" ...>
Option B
</a>
</div>
</div>
Avec Autoriser plusieurs réponses, le sondage envoie un formulaire de cases à cocher qui publie un optionId par option cochée (enregistrés en listes parallèles option et optionId), plus le lien Répondre sur le web. Une option Autre est un lien vers le sondage dans la vue en direct, où le destinataire saisit sa réponse. L'ordre d'un sondage mélangé découle du jeton du destinataire : il est le même à chaque ouverture. L'Image des résultats en direct est un <img> servi par /api/results-image, signé par option du sondage, jamais par destinataire.
Note
La forme par défaut Étoiles envoie un lien de confirmation par étoile, la plus haute d'abord, dans une rangée de droite à gauche. Chaque lien contient une étoile vide et une pleine ; une règle :hover remplit les étoiles jusqu'au pointeur là où l'application le permet, et les étoiles vides s'affichent partout ailleurs. Les images d'étoiles viennent de /api/rating-icon.
<div id="em-rating-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">How did we do?</p>
<div dir="rtl" style="direction:rtl;text-align:left;line-height:0">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rating-1&blockType=rating&action=rate&rating=5"
class="em-rating-1-s" aria-label="5 out of 5 stars" style="display:inline-block;padding:6px;line-height:0">
<img src="https://mailinapp.com/api/rating-icon?f=0&c=f59e0b&s=32" alt="5★" width="32" height="32" class="em-rating-1-o">
<!--[if !mso]><!-->
<img src="https://mailinapp.com/api/rating-icon?f=1&c=f59e0b&s=32" alt="" width="32" height="32" class="em-rating-1-f" style="display:none">
<!--<![endif]-->
</a>
<!-- …un lien par étoile, jusqu'à rating=1 -->
</div>
</div>
Les autres formes (visages emoji, pouces, échelle numérotée, NPS et pastilles d'étoiles classiques) sont une rangée de liens de confirmation portant rating=<n>. Quand le score est inférieur ou égal au seuil de suivi du bloc, la page de confirmation enchaîne sur /v/[token]/followup.
Quiz
Le quiz envoie un formulaire avec un groupe de boutons radio par question, qui publie q0, q1… (la position de la question à sa création) vers /api/interactions, plus le lien Répondre sur le web.
<div style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:700;font-size:18px;color:#111827">
Test your knowledge!
</p>
<!-- <form method="post" action="https://mailinapp.com/api/interactions">:
un groupe de boutons radio par question et un bouton "See my score" -->
<p style="margin:8px 0 0;font-size:13px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci...#em-quiz-1">Answer on the web</a>
</p>
</div>
La notation se fait sur le serveur, d'après les bonnes réponses de l'e-mail enregistré ; un score envoyé par un client n'est jamais repris. La valeur de l'événement est {answers, score, total, bucket} pour un quiz noté et {answers, outcome, outcomeTitle} pour un quiz de personnalité. Avec Indiquer tout de suite si c’est juste, le libellé de chaque réponse porte une note cachée qu'une règle :checked dévoile : les bonnes réponses figurent donc dans le HTML envoyé. Un écran d'accueil garde les questions derrière une ancre :target dans la vue en direct.
Formulaire
Un formulaire d'une page envoie tous les champs dans un <form> qui publie vers /api/interactions, plus le lien Répondre sur le web.
<div id="em-form-1" style="margin:12px 0;background-color:transparent">
<!-- <form method="post" action="https://mailinapp.com/api/interactions">:
tous les champs et un bouton d'envoi -->
<p style="margin:8px 0 0;font-size:13px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci...#em-form-1">Answer on the web</a>
</p>
</div>
Un formulaire sur plusieurs pages n'envoie aucun champ, seulement un lien stylé en bouton portant son Libellé du bouton de démarrage, vers l'assistant d'enquête à /v/[token]/form/[blockId]. Chaque page y enregistre un brouillon (une action form-page qui ne touche ni aux résultats ni aux webhooks), et le submit de la dernière page fait du brouillon la réponse. Avec Étapes dans l'e-mail, les pages sont envoyées avec un bouton radio par page avant le formulaire et des règles :checked qui montrent une page à la fois ; les applications sans ces règles affichent toutes les pages. Un champ fichier renvoie vers la vue en direct, car un fichier ne s'ajoute que depuis un navigateur. Les questions conditionnelles s'affichent toutes dans le formulaire envoyé ; le serveur écarte les réponses aux questions que les réponses précédentes du destinataire masquent.
Le serveur vérifie chaque réponse d'après le formulaire de l'e-mail enregistré avant d'écrire quoi que ce soit. Un navigateur qui a envoyé une réponse non valide est renvoyé vers /v/[token]?invalid=<fieldId>&why=<problem>, et un appel JSON reçoit un 400 invalid-answer.
Blocs de boutique et d'avis
Les liens de ces blocs passent par /v/[token]/click, qui enregistre le clic et redirige vers la destination. Les répétitions du même lien signé dans les cinq minutes comptent une seule fois.
Compte à rebours
Le compte à rebours est une seule <img> servie par /api/countdown. Son URL est signée sur la fin et la couleur, et chaque chargement dessine un nouveau GIF de 60 images à partir du temps restant, une seconde par image, qui s'arrête ensuite sur sa dernière image. Les requêtes signées identiques partagent un rendu pendant dix secondes au plus. Le texte alt porte le temps restant en toutes lettres pour les lecteurs d'écran et pour les applications qui chargent les images tard.
<div style="margin:12px 0">
<p style="margin:0 0 6px;font-size:16px;font-weight:700;color:#111827">Offer ends in</p>
<img src="https://mailinapp.com/api/countdown?t=1753401600000&c=111827&s=9f2a..."
width="207" height="34" alt="Offer ends in 2d 4h"
style="display:block;max-width:100%;height:auto">
</div>
Une fin propre à chaque contact (Une durée après l’envoi ou Une date dans les données du contact) est calculée à l'envoi et enregistrée sur la ligne du destinataire sous countdown_ends_<blockId> et dans son jeton de vue en direct, pour que chaque ouverture affiche la même fin. Un compte à rebours déjà terminé au moment du rendu envoie son message de fin en texte à la place de l'image. Les clics portent la fin du destinataire : l'agrégat du compte à rebours compte chaque clic avant ou après l'échéance propre à ce destinataire.
Produit
Avec le paiement MailInApp, Acheter est un lien de confirmation vers /v/[token]/act?action=buy. La page de confirmation relit le produit dans l'e-mail enregistré, et son POST crée la session Stripe Checkout via /api/checkout ; un simple GET ne crée rien. Le prix, le nom et le stock viennent toujours de la copie du serveur. Une commande ne devient payée que sur le webhook signé de Stripe, qui revérifie le stock dans une transaction et rembourse un paiement qui dépasserait le stock. Avec un Stock réglé, la carte porte un badge de stock servi par /api/product-status, redessiné au plus une fois par minute à partir du nombre d'unités payées.
<div id="em-product-1" style="margin:12px 0;padding:16px;border:1px solid #e5e7eb;border-radius:8px;background-color:#ffffff">
<p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Limited edition tote bag</p>
<p class="pd-price" style="margin:0 0 10px;font-weight:700;font-size:18px">$29.00</p>
<img src="https://mailinapp.com/api/product-status?p=proj123&b=product-1&s=..."
width="180" height="30" alt="" style="display:block;margin-bottom:8px">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=buy"
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
Buy now
</a>
</div>
Avec Lien vers le paiement d’une boutique externe, Acheter est un lien de clic vers la page produit (avec ?variant= pour une variante Shopify importée), ou vers un lien de réduction propre au destinataire, créé à l'envoi quand Réduction propre au produit est activée.
Les variantes envoient un bouton radio caché par valeur d'option avant le prix, une rangée de pastilles (.pv-opts, des <label for> reliés aux boutons radio) et un panneau par variante (.pv-panels) avec son prix et son lien d'achat. Des règles de la forme #<id>-a<i>:checked:not(:disabled) ~ … affichent les pastilles et le panneau de la variante choisie, et masquent .pd-price et .pv-list. Là où ces règles ne s'appliquent pas, le prix et .pv-list s'affichent : un lien par variante, chacun achetant cette variante (&variant=<variantId>). Les images supplémentaires utilisent les miniatures de la galerie d'images, avec de petites images liées comme alternative. Garder pour plus tard est un lien de confirmation avec action=save, enregistré une fois par destinataire.
<div class="pv-list">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=buy&variant=product-variant-2" ...>S / Navy · $56.00</a>
<a href="...&variant=product-variant-3" ...>L / Navy · $60.00</a>
</div>
<p style="margin:10px 0 0;font-size:13px">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=save">♡ Save for later</a>
</p>
Grille de produits
La grille est un tableau de cartes, chacune étant son propre tableau bordé, avec des cellules qui s'empilent sur mobile. Le bouton de chaque carte est un lien de clic sous l'identifiant de la carte (blockType=product-card). Les prix et les variantes par défaut des cartes importées sont lus dans le catalogue synchronisé au moment du rendu.
<td width="181" class="mia-stk" style="width:33%;vertical-align:top">
<table role="presentation" width="100%" style="border:1px solid #e5e7eb;border-radius:8px;background-color:#ffffff">
<tr><td style="padding:12px 12px 0;text-align:center">
<img src="https://shop.example.com/tee.jpg" alt="Linen tee" width="155" style="display:block;width:100%;height:auto">
<p style="margin:0 0 4px;font-weight:600;font-size:15px">Linen tee</p>
<p style="margin:0 0 10px;font-weight:700;font-size:15px">$28.00</p>
</td></tr>
<tr><td style="padding:0 12px 12px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=product-card-1&blockType=product-card&dest=https%3A%2F%2Fshop.example.com%2Fproducts%2Ftee&sig=..." ...>Shop now</a>
</td></tr>
</table>
</td>
Avec Ajouter au panier, le bouton d'une carte du panier renvoie plutôt vers la page panier /v/[token]/cart/[blockId]?add=<cardId>. Cette page, comme la grille de la vue en direct, envoie les identifiants item choisis et les qty_<cardId> à /api/cart, qui lit les cartes et la boutique dans l'e-mail enregistré et redirige vers le lien permanent du panier Shopify ou le lien de paiement WooCommerce. La commande est enregistrée comme un clic sur la grille, avec les cartes et les quantités choisies dans sa valeur.
Coupon
Le code est du texte simple dans un encadré stylé avec user-select:all, pour qu'un tap ou un double-clic le sélectionne en entier. Le bouton vers la boutique est un lien de clic. Dans la vue en direct, la boîte de réception et l'application, l'encadré est un <button data-copy> qui copie le code.
<div style="background-color:#fff7ed;text-align:center">
<p style="margin:0 0 10px;font-size:15px;font-weight:700;color:#111827">Your exclusive discount</p>
<p style="display:inline-block;margin:0;padding:12px 24px;border:2px dashed #4f46e5;border-radius:8px;background-color:#ffffff;font-size:26px;font-weight:800;letter-spacing:3px;color:#4f46e5;-webkit-user-select:all;user-select:all">SAVE20</p>
<p style="margin:12px 0 0;font-size:13px;color:#6b7280">20% off until Sunday. Applied at checkout.</p>
</div>
Un code issu d'une balise de fusion est résolu pour chaque destinataire ; quand il est vide, le bloc n'est pas rendu.
Avis de la boutique
Les avis de la boutique sont du texte statique : les étoiles sont des caractères avec un aria-label, et le texte de chaque avis porte dir="auto". Les avis sont choisis au moment du rendu parmi les storeReviews synchronisés et ne sont jamais enregistrés dans l'arbre de l'e-mail. Avec Un produit, le lien « Lire tous les avis » est un lien de clic vers la page produit.
<p style="margin:0 0 14px;font-size:15px;color:#111827">
<span role="img" aria-label="Rated 4.6 out of 5" style="color:#f59e0b">★★★★★</span> 4.6 from 212 reviews
</p>
<table role="presentation" width="100%">
<tr><td style="padding:0 0 14px;border-bottom:1px solid #e5e7eb">
<p style="margin:0 0 6px"><span role="img" aria-label="Rated 5.0 out of 5" style="color:#f59e0b">★★★★★</span></p>
<p dir="auto" style="margin:0 0 4px;font-weight:700">Bright and floral</p>
<p dir="auto" style="margin:0">Blueberry and jasmine notes, exactly as described.</p>
<p dir="auto" style="margin:6px 0 0;font-size:12px;color:#6b7280">Amira H. · Verified buyer · Nov 2, 2026</p>
</td></tr>
</table>
La vue en direct, la boîte de réception et GET /api/v1/liveview/[token] relisent les avis à chaque ouverture.
Blocs d'événements
RSVP et Prise de rendez-vous enregistrent par des liens de confirmation, comme les blocs de retours clients. Le bouton Rejoindre d'un lien de réunion et le bouton S’inscrire d'une inscription au webinaire sont des liens de clic qui passent par /v/[token]/click, comme les liens des blocs de boutique.
Lien de réunion
La ligne de statut (« Commence dans … », ou « En direct » une fois le début passé) est écrite au rendu de l'e-mail. En dessous, une <img> de /api/countdown, signée comme celle du bloc Compte à rebours, dessine le temps restant à chaque ouverture de l'e-mail. Dans l'e-mail, le bouton Rejoindre est toujours un lien de clic actif.
<div style="margin:12px 0;text-align:left;background-color:transparent">
<p style="margin:0 0 6px;font-size:13px;font-weight:600;color:#111827">Starts in 2d 3h 30m</p>
<img src="https://mailinapp.com/api/countdown?t=1768663800000&c=111827&s=..."
width="357" height="81" alt="Starts in 2d 3h 30m" style="display:inline-block;max-width:100%;height:auto;margin-bottom:8px">
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=meeting-link-1&blockType=meeting-link&dest=https%3A%2F%2Fmeet.google.com%2Fabc-defg-hij&sig=..."
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
Join on Google Meet
</a>
<p style="margin:8px 0 0;font-size:13px;color:#4b5563">Dial in: +1 555-0100, PIN 1234</p>
</div>
La vue en direct, la boîte de réception et l'application mobile n'affichent le bouton Rejoindre qu'à partir de Le lien pour rejoindre s’ouvre avant le début minutes avant startsAt, calculé à partir des propriétés du bloc au moment du rendu, sans état enregistré. D'ici là, elles affichent une puce inactive « Ouvre N minutes avant le début ». Un bloc sans startsAt est toujours ouvert.
RSVP
Chaque réponse est un lien de confirmation portant response=yes, no ou maybe. Avec Autoriser les invités, Oui mène à la vue en direct, où le destinataire choisit un nombre d'invités. Afficher le nombre de participants ajoute une <img> de /api/rsvp-count, signée par bloc, couleur et largeur, jamais par destinataire, et dessinée à partir du cumul du RSVP à son ouverture.
<div id="em-rsvp-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Coming to the launch?</p>
<p style="margin:0 0 10px;font-size:12px;color:#6b7280">Limited to 80 spots</p>
<img src="https://mailinapp.com/api/rsvp-count?p=proj123&b=rsvp-1&c=4f46e5&w=320&s=..."
alt="How many people are going" width="320" height="28" style="display:block;width:100%;max-width:320px;height:auto;border:0">
<div>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=yes" ...>Yes</a>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=maybe" ...>Maybe</a>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=no" ...>No</a>
</div>
</div>
Le contrôle de capacité et la déduplication par destinataire s'exécutent dans une seule transaction Firestore, si bien que les places ne sont jamais survendues : un oui au-delà de la capacité est enregistré waitlisted, un non declined, un peut-être maybe sans place. Les questions après un oui sont envoyées comme un submit sur l'identifiant du bloc suivi de __details, que le serveur n'accepte que d'un destinataire dont la réponse enregistrée est un oui, et vérifie comme les réponses d'un formulaire.
Prise de rendez-vous
Les créneaux sont les prochains créneaux libres du type de rendez-vous, calculés au rendu de l'e-mail et libellés dans le fuseau horaire du type de rendez-vous. Dans l'e-mail, chaque créneau est un lien de confirmation avec action=book&slot=<epoch ms>, et Voir d’autres créneaux ouvre la page de réservation en direct /v/[token]/book/[blockId].
<div id="em-booking-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Book a time with us</p>
<p style="margin:0 0 8px;font-size:13px;color:#6b7280">Times in Eastern Time</p>
<div class="bk-panels">
<div id="em-booking-1-g0" class="bk-p">
<p class="bk-dh" style="margin:6px 0 4px;font-size:12px;font-weight:600;color:#374151">Monday, January 19</p>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=booking-1&blockType=booking&action=book&slot=1768831200000" ...>9:00 AM</a>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=booking-1&blockType=booking&action=book&slot=1768834800000" ...>10:00 AM</a>
</div>
</div>
<p style="margin:8px 0 0;font-size:13px">
<a href="https://mailinapp.com/v/eyJhbGci.../book/booking-1" style="color:inherit;text-decoration:underline">See more times</a>
</p>
</div>
Avec Afficher les jours en onglets, un bouton radio masqué par jour (#<id>-d<i>) précède une barre d'onglets (.bk-bar), et des règles de la forme #<id>-d<i>:checked:not(:disabled) ~ … affichent le panneau d'un jour (.bk-p). Là où ces règles ne s'appliquent pas, chaque panneau s'affiche sous le titre de son jour (.bk-dh). Dans la vue en direct, la boîte de réception et l'application, les créneaux sont des puces radio dans un seul formulaire qui envoie action=book avec le slot choisi à /api/interactions.
Avant de réserver, le serveur relit les disponibilités du calendrier et réserve le créneau dans une transaction, si bien qu'un créneau n'est réservé qu'une fois. Un destinataire est inscrit en tant que son propre contact, une fois par bloc. Un jeton sans contact derrière lui est envoyé vers la page de réservation, qui demande un nom et un e-mail derrière une vérification anti-robot.
Inscription au webinaire
La carte est la même partout. La date est formatée dans le fuseau horaire du bloc avec le fuseau indiqué, et S’inscrire est un lien de clic vers la page publique de la session /webinar/<liveSessionId>, construite à partir de l'identifiant de la session sans aucune recherche à l'envoi.
<div style="margin:12px 0;background-color:transparent">
<img src="https://example.com/webinar-cover.jpg" alt="Office hours"
style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px">
<p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Office hours</p>
<p style="margin:0 0 8px;font-size:13px;color:#6b7280">Mar 1, 2026, 12:00 PM EST</p>
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=webinar-signup-1&blockType=webinar-signup&dest=https%3A%2F%2Fmailinapp.com%2Fwebinar%2Fsess_abc123&sig=..."
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
Register now
</a>
</div>
Les inscriptions sont enregistrées par la page de la session : le bloc lui-même n'enregistre que le clic.
Blocs de vitrine
Ces blocs n'enregistrent aucune réponse. Chacun envoie son contenu sous une forme qui se lit bien seule, puis ajoute des règles :checked qui en font la version interactive là où l'application de messagerie les exécute. Les règles sont dans le <style> du <head>, et les champs sur lesquels elles s'appuient sont entourés de <!--[if !mso]><!-->, si bien qu'Outlook classique ne les voit jamais.
Deux schémas couvrent les sept blocs :
- Groupes de radios (carrousel, onglets, galerie d'images) : un radio masqué par diapositive, onglet ou image avant le contenu, avec des libellés
forces radios en guise de points, de barre d'onglets ou de miniatures. Chaque règle s'écrit#<radio>:checked:not(:disabled) ~ …. Une application qui retire les champs n'en satisfait aucune, et le repli reste en place. - Interrupteurs à case (accordéon, avant / après, points sur image, menu) : une case témoin
#<id>-ktoujours cochée avant le bloc, et l'interrupteur#<id>-tdans le<label>touché. Les règles qui masquent quelque chose partent de#<id>-k:checked, si bien qu'une application qui retire le témoin affiche tout.
Les liens de ces blocs passent par /v/[token]/click, comme tout autre lien.
Carrousel
Chaque diapositive est dessinée deux fois : une fois dans .carousel-fallback (la première diapositive et le lien Voir les N diapositives, ou toutes les diapositives dans un tableau .carousel-grid) et une fois comme un .lv-frame masqué que les règles d'un radio affichent. La bande .lv-px charge une balise de vue de diapositive, /v/[token]/nv/<blockId>/<slide>, depuis la règle de chaque diapositive après la première : c'est ainsi qu'Insights compte les destinataires allés au-delà de la première diapositive.
<div id="em-carousel-g1">
<input type="radio" name="em-carousel-g1" id="em-carousel-g1-s0" checked hidden style="display:none">
<input type="radio" name="em-carousel-g1" id="em-carousel-g1-s1" hidden style="display:none">
<div class="carousel-fallback">
<div class="lv-frame lv-frame-0">
<img src="https://cdn.example.com/slide1.jpg" alt="Slide 1" style="width:100%">
<p style="margin:8px 0 0;font-size:14px;color:#374151">Slide 1</p>
</div>
<p style="margin:8px 0 0;font-size:13px">
<a href="https://mailinapp.com/v/eyJhbGci..." style="color:#4f46e5">See all 2 slides →</a>
</p>
</div>
<div class="lv-frames">
<div class="lv-frame lv-frame-0" style="display:none">…</div>
<div class="lv-frame lv-frame-1" style="display:none">…</div>
</div>
<div class="lv-dots" style="display:none;text-align:center">
<label for="em-carousel-g1-s0" class="lv-dot lv-dot-0" aria-label="Slide 1"></label>
<label for="em-carousel-g1-s1" class="lv-dot lv-dot-1" aria-label="Slide 2"></label>
</div>
<div class="lv-px" style="height:4px"> </div>
</div>
#em-carousel-g1-s1:checked:not(:disabled) ~ .carousel-fallback{display:none!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-dots{display:block!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-frames .lv-frame-1{display:block!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../nv/carousel-g1/1)}
Les flèches sont des libellés for les radios voisins dans chaque cadre. Les miniatures remplacent les points par des libellés .lv-tn. La lecture automatique ajoute un radio de plus, coché en premier, dont les règles déplacent les cadres le long d'une .lv-track avec une animation @keyframes dans @media (prefers-reduced-motion:no-preference) ; choisir une diapositive le décoche. Le prix et le bouton d'une diapositive en font partie, ils s'affichent donc aussi dans le repli, et le bouton pointe vers le href de la diapositive.
Accordéon
Le contenu de chaque élément se trouve dans le <label> de l'élément, après l'interrupteur : il s'affiche donc partout où les règles ne s'exécutent pas. Dans la vue en direct, la boîte de réception et le canevas, chaque élément est plutôt un <details>/<summary> natif.
<div id="em-accordion-item-g2" style="border:1px solid #e5e7eb;border-radius:6px;padding:10px 14px">
<input type="checkbox" id="em-accordion-item-g2-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="checkbox" id="em-accordion-item-g2-t" hidden style="display:none">
<span style="display:block;font-weight:600;font-size:15px">Do you offer refunds?</span>
<div class="acc-content" style="margin:8px 0 0;font-size:14px">Yes, within 30 days of purchase.</div>
</label>
</div>
#em-accordion-item-g2-k:checked ~ label .acc-content{display:none}
#em-accordion-item-g2-t:checked ~ div.acc-content{display:block}
Onglets
Les blocs de chaque onglet sont écrits une seule fois, dans un panneau .tb-p qui commence par le titre de l'onglet en en-tête .tb-h. Ces panneaux empilés sont le repli. Les règles des radios affichent la .tb-bar, masquent les en-têtes et affichent un panneau.
<div id="em-tabs-g1">
<input type="radio" name="em-tabs-g1" id="em-tabs-g1-r0" checked hidden style="display:none">
<input type="radio" name="em-tabs-g1" id="em-tabs-g1-r1" hidden style="display:none">
<div class="tb-bar" role="tablist" style="display:none">
<label for="em-tabs-g1-r0" id="em-tabs-g1-t0" class="tb-t" role="tab">Overview</label>
<label for="em-tabs-g1-r1" id="em-tabs-g1-t1" class="tb-t" role="tab">Details</label>
</div>
<div class="tb-panels">
<div id="em-tabs-g1-p0" class="tb-p"><p class="tb-h" style="font-weight:700">Overview</p>…</div>
<div id="em-tabs-g1-p1" class="tb-p"><p class="tb-h" style="font-weight:700">Details</p>…</div>
</div>
</div>
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-bar{display:block!important}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels .tb-h{display:none!important}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels .tb-p{display:none}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels #em-tabs-g1-p1{display:block!important}
Avant / après
Les deux images sont dans un même <label>, chacune sous son libellé. Les règles du témoin masquent l'image après et affichent l'indication ; l'interrupteur échange les deux.
<div id="em-before-after-g1">
<input type="checkbox" id="em-before-after-g1-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="checkbox" id="em-before-after-g1-t" hidden aria-label="Switch between the before and after pictures" style="display:none">
<div class="ba-before">
<p class="ba-cap">Before</p>
<img src="https://example.com/kitchen-before.jpg" alt="Before: The kitchen" width="568">
<p class="ba-hint" style="display:none">Tap to see after</p>
</div>
<div class="ba-after" style="margin-top:12px">
<p class="ba-cap">After</p>
<img src="https://example.com/kitchen-after.jpg" alt="After: The kitchen" width="568">
<p class="ba-hint" style="display:none">Tap to see before</p>
</div>
</label>
</div>
#em-before-after-g1-k:checked ~ label .ba-after{display:none}
#em-before-after-g1-k:checked ~ label .ba-hint{display:block!important}
#em-before-after-g1-t:checked ~ div.ba-before{display:none}
#em-before-after-g1-t:checked ~ div.ba-after{display:block;margin-top:0!important}
Points sur image
Les repères ne sont placés que par des règles derrière le témoin, jamais par un position en ligne (que Gmail retire). Chaque repère est un <label> autour de sa propre case et de sa note. La .hs-legend numérotée sous l'image est le repli, et les règles du témoin la masquent.
<div id="em-image-hotspots-g4">
<input type="checkbox" id="em-image-hotspots-g4-k" checked hidden style="display:none">
<div class="hs-stage">
<img src="https://example.com/bike.jpg" alt="Our commuter bike" width="568">
<label id="em-image-hotspots-g4-h0" class="hs-pin" style="display:none">
<input type="checkbox" id="em-image-hotspots-g4-h0-t" hidden aria-label="Hydraulic brakes" style="display:none">
<span class="hs-num">1</span>
<span class="hs-note" style="display:none"><strong>Hydraulic brakes</strong>Stop short in the wet.</span>
</label>
</div>
<div class="hs-legend">
<p><strong>1. Hydraulic brakes</strong> — Stop short in the wet.</p>
</div>
</div>
#em-image-hotspots-g4-k:checked ~ div.hs-stage{position:relative}
#em-image-hotspots-g4-k:checked ~ div.hs-legend{display:none}
#em-image-hotspots-g4-k:checked ~ div.hs-stage #em-image-hotspots-g4-h0{display:block!important;position:absolute;left:20%;top:30%;margin:-13px 0 0 -13px}
#em-image-hotspots-g4-h0-t:checked ~ .hs-note{display:block!important;position:absolute;left:-8px;top:32px}
Une note s'ouvre vers la gauche ou la droite et vers le haut ou le bas selon la place de son repère : au-delà de 60 % à l'horizontale ou de 65 % à la verticale.
Galerie d'images
La première image est toujours dans .gl-main ; les autres y sont des cadres masqués. .gl-fallback les montre en petit, chacune liée à la vue en direct, et les règles des radios la remplacent par la rangée .gl-thumbs de libellés. Le bloc Produit dessine ses images supplémentaires avec les mêmes pièces.
<div id="em-image-gallery-g4">
<input type="radio" name="em-image-gallery-g4" id="em-image-gallery-g4-r0" checked hidden style="display:none">
<input type="radio" name="em-image-gallery-g4" id="em-image-gallery-g4-r1" hidden style="display:none">
<div class="gl-main">
<div id="em-image-gallery-g4-f0" class="gl-f"><img src="https://example.com/chair-front.jpg" alt="Chair from the front" width="568"></div>
<div id="em-image-gallery-g4-f1" class="gl-f" style="display:none"><img src="https://example.com/chair-side.jpg" alt="Chair from the side" width="568"></div>
</div>
<div class="gl-fallback">
<a href="https://mailinapp.com/v/eyJhbGci..."><img src="https://example.com/chair-side.jpg" alt="Chair from the side" width="64" height="64"></a>
</div>
<div class="gl-thumbs" style="display:none">
<label for="em-image-gallery-g4-r0" id="em-image-gallery-g4-t0" class="gl-t" aria-label="Picture 1">…</label>
<label for="em-image-gallery-g4-r1" id="em-image-gallery-g4-t1" class="gl-t" aria-label="Picture 2">…</label>
</div>
</div>
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-fallback{display:none!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-thumbs{display:block!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-main .gl-f{display:none!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-main #em-image-gallery-g4-f1{display:block!important}
Menu
Les liens forment une .mn-row, chacun un lien de clic avec son propre emplacement (blockType=menu-item), si bien qu'Insights nomme chaque lien. La .mn-bar et les règles qui replient la rangée sont dans @media only screen and (max-width:620px) avec Sur téléphone, ou au premier niveau avec Toujours.
<div id="em-menu-g5">
<input type="checkbox" id="em-menu-g5-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="checkbox" id="em-menu-g5-t" hidden aria-label="Show or hide the links" style="display:none">
<div class="mn-bar" style="display:none"><span class="mn-open">☰</span><span class="mn-close" style="display:none">✕</span> Menu</div>
<div class="mn-row" style="text-align:center">
<span class="mn-i"><a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=menu-item-g1&blockType=menu-item&dest=https%3A%2F%2Fshop.example.com%2F&sig=...">Shop</a></span>
<span class="mn-sep" aria-hidden="true">|</span>
<span class="mn-i"><a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=menu-item-g2&blockType=menu-item&dest=https%3A%2F%2Fshop.example.com%2Fnew&sig=...">New in</a></span>
</div>
</label>
</div>
@media only screen and (max-width:620px){
#em-menu-g5-k:checked ~ label .mn-bar{display:block!important}
#em-menu-g5-k:checked ~ label .mn-row{display:none}
#em-menu-g5-t:checked ~ div.mn-row{display:block}
#em-menu-g5-t:checked ~ div.mn-row .mn-i{display:block!important}
#em-menu-g5-t:checked ~ div.mn-row .mn-sep{display:none}
}
Blocs de jeux
Les trois jeux partagent une même forme. Une case à cocher de contrôle #<id>-k, toujours cochée, précède un <label> qui contient un bouton radio, la couche (.sc-surface, ou la roue .stw-wheel et son bouton .stw-go) et le lot (.sc-prize, .stw-prize). Les règles du contrôle affichent la couche et masquent le lot. Un geste sur le libellé coche le bouton radio, dont les règles masquent la couche et affichent le lot.
Un bouton radio et non une case à cocher, pour qu'un second geste ne masque pas de nouveau le lot. Les champs sont placés dans <!--[if !mso]><!-->, et une application qui supprime le contrôle affiche ce qui se trouve hors des règles.
Chaque bloc enregistre un reveal. Dans l'e-mail, la règle du bouton radio charge une balise de révélation, /v/[token]/rv/<blockId>, comme fond d'une bande de 4px (.sc-px, .stw-px), et la vue en direct envoie la révélation depuis son script intégré. Les liens de lot passent par /v/[token]/click.
Lots. Avec des enfants game-prize, le serveur choisit le lot de chaque destinataire avant le rendu de l'e-mail : un tirage pondéré dont la graine est un HMAC du projet, du bloc et du destinataire, enregistré une seule fois dans gamePrizes/{projectId}_{blockId}_{recipient} avec son code. Le résultat voyage dans la ligne du destinataire sous prize_<blockId>, prize_label_<blockId>, prize_code_<blockId> et prize_url_<blockId>, si bien que l'e-mail, la vue en direct, la boîte de réception et l'application montrent un seul et même lot.
Le panneau du lot se trouve alors dans la seule partie interactive, et un lien Découvrir mon cadeau vers la vue en direct (.stw-reveal, .sc-reveal) se trouve en dehors, masqué par la règle du contrôle. Un e-mail rendu sans résultat dans la ligne (un export, une attribution échouée) affiche seulement ce lien, et la vue en direct attribue le lot. L'événement de révélation porte le lot enregistré, jamais un lot envoyé par le client.
Roue de la fortune
La roue est un conic-gradient de 240px avec une case égale par lot, libellée en blanc avec une ombre pour rester lisible en mode sombre. Ses @keyframes la font tourner en 3,2 secondes jusqu'à l'angle du lot du destinataire, puis le panneau du lot apparaît en fondu. L'Outlook classique reçoit le lien de révélation sous forme de bouton VML.
<div id="em-spin-to-win-g5" style="text-align:center">
<p style="font-weight:700;font-size:18px">Spin for a summer treat</p>
<!--[if !mso]><!-->
<input type="checkbox" id="em-spin-to-win-g5-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="radio" id="em-spin-to-win-g5-spin" hidden aria-label="Spin the wheel to reveal your prize" style="display:none">
<span class="stw-ptr" aria-hidden="true" style="display:none">▼</span>
<span class="stw-wheel" aria-hidden="true" style="display:none;width:240px;height:240px;border-radius:50%;
background:conic-gradient(#4f46e5 0deg 90deg,#847eed 90deg 180deg,#3b35ac 180deg 270deg,#f59e0b 270deg 360deg)">
<span style="position:absolute;transform:rotate(45deg)">10% off</span>
…
</span>
<span class="stw-go" style="display:none">Spin the wheel</span>
<div class="stw-prize" role="status" style="display:none">
<p style="font-weight:700">You won: 10% off!</p>
<p>Your next order is 10% off.</p>
<p aria-label="Your code" style="border:2px dashed currentColor;font-family:monospace">SPIN10-AB12</p>
</div>
<div class="stw-px" style="height:4px"> </div>
</label>
<!--<![endif]-->
<div class="stw-reveal">
<a href="https://mailinapp.com/v/eyJhbGci...">Reveal my prize</a>
</div>
</div>
#em-spin-to-win-g5-k:checked ~ label .stw-wheel{display:block!important}
#em-spin-to-win-g5-k:checked ~ label .stw-go{display:inline-block!important}
#em-spin-to-win-g5-k:checked ~ .stw-reveal{display:none!important}
#em-spin-to-win-g5-spin:checked ~ span.stw-wheel{animation:stw-em-spin-to-win-g5 3200ms cubic-bezier(.17,.67,.21,1) both}
#em-spin-to-win-g5-spin:checked ~ div.stw-prize{display:block!important;animation:stw-in-em-spin-to-win-g5 .4s ease-out 3200ms both}
#em-spin-to-win-g5-spin:checked ~ .stw-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../rv/spin-to-win-g5)}
@keyframes stw-em-spin-to-win-g5{from{transform:rotate(0deg)}to{transform:rotate(2115deg)}}
Sans lots, la roue est un 🎡 de 64px qui fait deux tours en 0,9 seconde et révèle un bouton suivi vers le Lien du lot. Un second bouton vers le même lien, Découvrez votre lot, se trouve hors de la partie interactive pour toute autre application (un lien vers la vue en direct si le lien du lot est vide). La vue en direct affiche le titre et le bouton du lot.
Carte à gratter
Sans lots, le lot reste hors de la partie interactive : une application qui supprime les règles l'affiche aussitôt. La couche est un <span> en display:none que seule la règle du contrôle affiche : bandes argentées, la Couleur de la couche ou une <img> pour l'Image d’accueil (jamais un url() CSS). Le Bouton Découvrir ajoute un span .sc-go dans le libellé.
<div id="em-scratch-card-g1" style="text-align:center">
<p style="font-weight:700;font-size:18px">Scratch to reveal your prize!</p>
<!--[if !mso]><!-->
<input type="checkbox" id="em-scratch-card-g1-k" checked hidden style="display:none">
<!--<![endif]-->
<label style="display:block;cursor:pointer">
<!--[if !mso]><!-->
<input type="radio" id="em-scratch-card-g1-scratch" hidden aria-label="Scratch to reveal the hidden reward" style="display:none">
<span class="sc-surface" style="display:none;padding:24px;border-radius:8px;
background:repeating-linear-gradient(45deg,#9ca3af,#9ca3af 10px,#d1d5db 10px,#d1d5db 20px)">Scratch here</span>
<div class="sc-px" style="height:4px"> </div>
<!--<![endif]-->
<div class="sc-prize" style="margin-top:10px">
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=scratch-card-g1&blockType=scratch-card&dest=…&sig=…">🎉 20% off your next order!</a>
</div>
</label>
</div>
#em-scratch-card-g1-k:checked ~ label #em-scratch-card-g1-scratch{display:block!important;position:absolute;width:1px;height:1px;opacity:0}
#em-scratch-card-g1-k:checked ~ label .sc-surface{display:block!important}
#em-scratch-card-g1-k:checked ~ label .sc-prize{display:none!important}
#em-scratch-card-g1-scratch:checked ~ span.sc-surface{display:none!important}
#em-scratch-card-g1-scratch:checked ~ div.sc-prize{display:block!important}
#em-scratch-card-g1-scratch:focus ~ .sc-surface{outline:3px solid #4f46e5;outline-offset:2px}
#em-scratch-card-g1-scratch:checked ~ .sc-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../rv/scratch-card-g1)}
La règle du contrôle fait du bouton radio un élément focalisable de 1px : c'est ainsi que Tab atteint la carte et que la barre d'espace la révèle. Avec Bouton sous la carte, le bouton suivi se place après le </label>, hors de toute règle, et se voit donc avant et après le grattage.
Boîte mystère
Le balisage et les règles de la carte à gratter, avec une boîte cadeau pour couche : un 🎁 de 72px (ou l'Image de la boîte) et le texte à toucher. Une règle de plus fait frétiller la boîte tant qu'elle est fermée.
<label style="display:block;cursor:pointer">
<input type="radio" id="em-mystery-box-g1-scratch" hidden aria-label="Open the mystery box to reveal your prize" style="display:none">
<span class="sc-surface" style="display:none;padding:8px 0">
<span class="sc-box" aria-hidden="true" style="display:inline-block;font-size:72px">🎁</span>
<span style="display:block;font-weight:700">Tap the box to open it</span>
</span>
…
</label>
#em-mystery-box-g1-k:checked ~ label .sc-box{animation:mb-em-mystery-box-g1 2.4s ease-in-out infinite}
@keyframes mb-em-mystery-box-g1{0%,70%,100%{transform:rotate(0deg)}76%{transform:rotate(-8deg)}82%{transform:rotate(7deg)}88%{transform:rotate(-4deg)}94%{transform:rotate(2deg)}}
Blocs d'apprentissage
Le jeu de cartes mémoire n'enregistre rien. Le devoir enregistre un rendu par destinataire.
Jeu de cartes mémoire
Chaque carte a la forme d'Avant / après : une case de contrôle #<card>-k toujours cochée, puis un <label> qui contient la case propre à la carte #<card>-f, le recto .fc-front et le verso .fc-back. Les règles du contrôle masquent le verso et les libellés de face .fc-l. Cocher la case de la carte masque le recto et affiche le verso.
Chaque règle nomme :checked : une application qui les ignore affiche le recto et le verso l'un sous l'autre, le verso sous un trait pointillé, chaque face précédée de son libellé (« Q : » et « R : », dans la langue de l'e-mail). Une carte qui commence déjà par son libellé ne le garde qu'une fois. Une carte avec une image au recto seulement garde 200px de hauteur une fois retournée, pour que le jeu ne bouge pas sous le doigt du lecteur. La vue en direct dessine le même balisage, et la partie texte brut écrit chaque carte sur deux lignes.
<div id="em-flashcard-g2" style="border:1px solid #e5e7eb;border-radius:8px;padding:14px;margin-bottom:8px;text-align:center">
<!--[if !mso]><!-->
<input type="checkbox" id="em-flashcard-g2-k" checked hidden style="display:none">
<!--<![endif]-->
<label style="display:block;cursor:pointer">
<!--[if !mso]><!-->
<input type="checkbox" id="em-flashcard-g2-f" hidden style="display:none">
<!--<![endif]-->
<div class="fc-front">
<p style="margin:0;font-weight:600;font-size:16px"><span class="fc-l">Q: </span>What is the powerhouse of the cell?</p>
</div>
<div class="fc-back" style="margin-top:10px;padding-top:10px;border-top:1px dashed #e5e7eb">
<p style="margin:0;font-size:16px"><span class="fc-l">A: </span>The mitochondria</p>
</div>
</label>
</div>
#em-flashcard-g2-k:checked ~ label .fc-back{display:none}
#em-flashcard-g2-k:checked ~ label .fc-l{display:none}
#em-flashcard-g2-f:checked ~ div.fc-front{display:none}
#em-flashcard-g2-f:checked ~ div.fc-back{display:block;margin-top:0!important;padding-top:0!important;border-top:0!important}
Devoir
L'échéance est l'image du bloc Compte à rebours, /api/countdown signée pour l'échéance, sous une ligne « À rendre ». L'e-mail n'écrit pas le temps restant, puisqu'il est lu après avoir été généré, et le texte alternatif de l'image indique « Temps restant avant la date limite ». Un e-mail généré après l'échéance affiche « En retard » à la place. La vue en direct écrit le temps restant (« À rendre dans 2 j 4 h 10 min »). Les liens vers les ressources sont de simples liens, et Points ajoute « (10 pts) » au titre.
Marquer comme fait est un choix comme celui d'un sondage : dans l'e-mail, un lien vers /v/[token]/act?action=complete, où le lecteur confirme. Une réponse courte ou un lien est un <form> qui envoie action: "submit-answer" avec answer (un <textarea> de trois lignes ou un <input type="url">) à /api/interactions, dans <!--[if !mso]>, avec un lien Répondre sur le web vers la vue en direct (#em-<id>) dessous, dans toutes les applications.
Un rendu est dédoublonné par destinataire comme un vote, et la vue en direct le relit : « Marqué comme fait ✓ », ou « Rendu ✓ » avec la réponse. Un rendu postérieur à dueAt est enregistré comme les autres, et Insights en déduit « à temps » ou « en retard » d'après son heure (homeworkBlocks).
<div id="em-assignment-g2">
<p style="margin:0 0 4px;font-weight:700;font-size:18px">Read chapter 4 (10 pts)</p>
<p style="margin:0 0 10px;font-size:14px;color:#4b5563">Summarize the main themes in 2-3 sentences.</p>
<p style="margin:0 0 6px;font-size:13px;font-weight:600">Due</p>
<img src="https://mailinapp.com/api/countdown?t=1768663800000&c=111827&s=…" width="357" height="81"
alt="Time left before it's due" style="display:block;max-width:100%;height:auto;margin-bottom:8px">
<div style="margin:0 0 10px">
<p style="margin:0 0 4px;font-size:13px"><a href="https://example.com/ch4.pdf">Chapter 4 PDF</a></p>
</div>
<div>
<!--[if !mso]><!-->
<form method="post" action="https://mailinapp.com/api/interactions?campaignId=…&blockId=assignment-g2&redirect=…">
<!-- hidden campaignId, blockId, blockType, action=submit-answer, rcpt, redirect -->
<textarea name="answer" rows="3" placeholder="Your answer" required></textarea>
<button type="submit">Submit answer</button>
</form>
<!--<![endif]-->
<p style="margin:8px 0 0;font-size:13px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci...#em-assignment-g2">Answer on the web</a>
</p>
</div>
</div>
Blocs de contenu
Ces blocs n'enregistrent aucune réponse. Vidéo, Audio, Lieu et Ajouter au calendrier sont des emplacements de clic : dans un envoi personnalisé, chaque lien passe par /v/[token]/click?blockId=…&blockType=…&dest=…&sig=…, qui enregistre un click sur le bloc et redirige vers dest. Un e-mail exporté sans jeton de destinataire pointe directement vers la destination. Le balisage envoyé est le même dans toutes les applications de messagerie ; seule la vue en direct diffère, pour la vidéo et l'audio.
Vidéo et audio
L'e-mail dessine une image dans le lien de clic : l'affiche ou la couverture sous forme d'un simple <img> dont l'alt est la description ou, sans image, un panneau sombre avec ▶ ou ♪, la description et, pour une vidéo, la durée au format M:SS. La largeur, la marge intérieure, la bordure et le fond du bloc sont sur le <div> extérieur, si bien que le panneau garde sa propre marge intérieure.
La vue en direct et la boîte de réception MailInApp dessinent un <video controls> avec l'affiche en poster, ou un <audio controls> sous l'<img> de couverture, chacun avec la description en aria-label. L'application mobile ouvre le fichier. Un bloc sans src n'émet rien.
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=video-g1&blockType=video&dest=https%3A%2F%2Fexample.com%2Fpromo.mp4&sig=…">
<div style="box-sizing:border-box;overflow:hidden;width:100%;max-width:100%">
<img src="https://example.com/promo-poster.jpg" alt="Product demo" style="display:block;width:100%;max-width:100%" />
</div>
</a>
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=audio-g2&blockType=audio&dest=https%3A%2F%2Fexample.com%2Fno-cover.mp3&sig=…">
<div style="box-sizing:border-box;overflow:hidden;width:100%;max-width:100%">
<div style="background-color:#111827;color:#ffffff;text-align:center;padding:40px 16px;font-size:18px;font-weight:600">♪ Audio</div>
</div>
</a>
Formule
La formule est un PNG de GET /api/formula. La notation (tronquée à 300 caractères), le mode d'affichage et la couleur sont sérialisés dans la requête signée, si bien que le point d'accès ne lit rien dans Firestore et répond avec un en-tête de cache immuable ; le worker edge le sert. L'émetteur met la formule en page une fois pour écrire le width et le height de l'<img>, afin que l'e-mail ne bouge pas au chargement, et la mise en page réduit l'échelle pour rester dans le budget de taille de l'image. L'alt est la notation elle-même, tout comme la partie texte brut.
L'analyseur est propre à MailInApp (pas de moteur TeX) : une macro inconnue est dessinée comme son texte littéral et le moteur de rendu ne lève jamais d'erreur, si bien qu'une formule n'arrête jamais un envoi. \ce{…} met en indice le nombre d'éléments, en exposant les charges finales et dessine -> comme une flèche. Une notation vide n'émet rien. L'e-mail, la vue en direct et la boîte de réception dessinent la même image ; seule l'origine de l'URL change.
<div style="margin:8px 0;text-align:center">
<img src="https://mailinapp.com/api/formula?d=eyJub3RhdGlvbiI6…&s=…" width="385" height="91"
alt="x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}"
style="display:inline-block;max-width:100%;height:auto;vertical-align:middle" />
</div>
Lieu
La photo, le nom et l'adresse sont du HTML simple, et l'adresse garde ses retours à la ligne. Le lien d'itinéraire est le Lien Google Maps tel que collé, sinon https://maps.google.com/?q=<lat>,<lng> quand les coordonnées sont non nulles et valides, sinon https://maps.google.com/?q=<adresse> ; aucune clé d'API Maps n'intervient. Sans aucun des trois, aucun bouton n'est dessiné. Le bouton est le bouton à toute épreuve de tous les blocs : un v:roundrect VML pour Outlook classique et un <a> avec mso-hide:all pour tous les autres, les deux passant par l'emplacement de clic.
<div style="margin:12px 0">
<img src="https://example.com/venue.jpg" alt="Grand Hall" style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px" />
<p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Grand Hall</p>
<p style="margin:0 0 10px;font-size:14px;color:#4b5563">123 Main St, Springfield</p>
<!--[if mso]><v:roundrect href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&…" …><center>Get Directions</center></v:roundrect><![endif]-->
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&blockType=venue&dest=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D123%2520Main%2520St%252C%2520Springfield&sig=…"
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600;mso-hide:all">Get Directions</a>
</div>
Ajouter au calendrier
Les trois boutons ne sont dessinés qu'avec un Commence le valide ; une fin absente ou antérieure au début devient une heure après celui-ci. Le titre, la description et le lieu sont tronqués à 200, 2 000 et 300 caractères avant la construction des liens, si bien que les trois concordent toujours. Les trois partagent l'unique emplacement de clic du bloc.
- Télécharger le .ics est
GET /api/calendar, avec tout l'événement signé dans la requête (un HMAC sur une entrée préfixée parcalendar:, si bien qu'aucune autre famille d'URL signées n'est vérifiée ici, et sans lecture Firestore). Il renvoie un fichier RFC 5545 avecDTSTART/DTENDen instants UTC (unZfinal, sansVTIMEZONE), si bien que chaque agenda affiche l'heure propre de l'invité. L'UIDest un SHA-256 des champs de l'événement, donc l'enregistrer à nouveau met à jour une seule entrée. Le texte est échappé selon le §3.3.11 et les lignes sont pliées à 75 octets. - Ajouter à Google Calendar est un lien
calendar.google.com/calendar/render?action=TEMPLATE&…et Ajouter à Outlook.com un lienoutlook.live.com/calendar/0/action/compose?…, tous deux construits au rendu.
Avec Afficher seulement après un oui (afterRsvp), l'e-mail n'émet rien ; la vue en direct, la boîte de réception et l'application mobile émettent le bloc dès que le RSVP enregistré du destinataire dans l'e-mail est confirmed. Le canevas du studio, qui n'a pas le secret du serveur, dessine le bouton .ics avec un lien #.
<div style="margin:12px 0">
<p style="margin:0 0 8px;font-weight:600;font-size:16px;color:#111827">Q3 Product Launch, Webinar</p>
<p style="margin:0 0 10px;font-size:14px;color:#4b5563">Join us for the big reveal & Q&A.</p>
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=add-to-calendar-g2&blockType=add-to-calendar&dest=https%3A%2F%2Fmailinapp.com%2Fapi%2Fcalendar%3Fd%3D…&sig=…"
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600;margin:0 8px 8px 0;mso-hide:all">Download .ics</a>
<!-- Add to Google Calendar and Add to Outlook.com follow, each through the same click slot -->
</div>
Blocs de graphiques
Les graphiques, la carte KPI et le classement n'enregistrent rien et ne contiennent aucun lien. L'e-mail, la vue en direct et la boîte de réception de MailInApp écrivent le même balisage ; seule l'origine de l'URL de l'image change. Chaque mot qu'ils ajoutent (en-têtes de tableau, zones de la jauge, colonnes du classement, part Autres) vient de emailBlocks.json chart.* et standings.* dans la langue de l'e-mail.
- L'image. Chaque graphique, et la mini-courbe de la carte, est un PNG de
GET /api/analytics/chart?d=…&s=…&r=2.dest toute la spécification du graphique (type, taille, libellés, valeurs, couleurs) en JSON base64url,sson HMAC surLIVEVIEW_SECRETetrla densité de pixels. Le point d'accès ne lit rien dans Firestore, donc une réponse est une fonction pure de sa requête signée et porte un en-tête de cache immuable ; l'edge worker la dessine et la sert. Une spécification de plus de 6 000 caractères, ou au-delà des limites d'un graphique, est refusée. Les libellés sont coupés à la longueur de libellé de la spécification avant signature. - Le texte à côté de l'image. L'
altde l'<img>nomme le graphique et donne chaque valeur dessinée (« Bar chart: North (Revenue 12,400); … »). Tous les graphiques sauf la jauge le font suivre d'une<table aria-label="<titre>">toujours visible avec les mêmes chiffres, avec une légende là où le graphique en a besoin (plusieurs séries, parts, tuiles ou une échelle de couleur). Le tableau donne ce que l'image dessine, sauf celui du Sankey, qui donne chaque flux saisi. - Graphiques liés. La carte KPI et les graphiques en barres, linéaire et circulaire acceptent un
binding. Une liaison de source de données est regroupée pargroupByFieldet agrégée par série (sum,avg,count,latest;src/lib/charts/aggregate.ts) sur les lignes de la liaison, après lefilterdu bloc, dont les valeurs peuvent contenir des balises de fusion du destinataire. Une liaison@response:lit le cumul des résultats du projet (src/lib/charts/responseSource.ts). Les deux sont résolues au rendu : dans l'e-mail à l'envoi, dans la vue en direct à chaque chargement. Un filtre avec une balise du destinataire donne une spécification, et donc une URL d'image, par destinataire. - Données vides. Un graphique sans ligne utilisable écrit son titre et un avis (
chart.emptyRowset ses variantes) à la place de l'image, donc un bloc à moitié construit n'arrête jamais un envoi.
| Graphique | Colonnes du tableau | Limites |
|---|---|---|
| Barres, linéaire, radar | Catégorie, puis une par série nommée | 24 catégories, 3 séries ; radar de 3 à 8 axes |
| Circulaire, treemap | Catégorie, Valeur, Pourcentage | 8 parts : les 7 plus grandes et Autres |
| Nuage de points | Série, X, Y, et Taille dans un graphique à bulles | 120 points, 8 séries |
| Histogramme | Tranche, Effectif | 500 valeurs, de 2 à 20 classes |
| Carte thermique | Ligne, Colonne, Valeur (cellules saisies seulement) | 12 lignes × 24 colonnes |
| Entonnoir | Étape, Valeur, % de la première, % de la précédente | 8 étapes |
| Cascade | Libellé, Valeur, Type, Total cumulé | 8 barres |
| Sankey | De, Vers, Valeur | 12 nœuds, 24 liens |
Une ligne au-delà d'une limite est écartée, jamais fusionnée, sauf les plus petites parts du circulaire et de la treemap. L'entonnoir et la cascade gardent l'ordre de saisie, qui fait leur sens.
Graphiques avec tableau
<div style="margin:0;padding:0;background-color:#ffffff">
<p style="margin:0 0 8px;font-weight:600;font-size:15px;color:#111827">Revenue by region</p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoiYmFyIi…&s=Ev3iTLfo…&r=2" width="560" height="280"
alt="Bar chart: North (Revenue 12,400); South (Revenue 9,800); East (Revenue 14,200)"
style="display:block;max-width:100%;height:auto;margin:8px 0" />
<table aria-label="Revenue by region" style="width:100%;border-collapse:collapse;margin-top:4px">
<tr><th scope="col" style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280;font-weight:600">Category</th>
<th scope="col" style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280;font-weight:600">Revenue</th></tr>
<tr><td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">North</td>
<td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">12,400</td></tr>
<!-- one row per category -->
</table>
</div>
Carte KPI
Le libellé, la valeur (au format nombre, dollars américains ou pourcentage) et l'évolution sont du texte. L'évolution n'apparaît qu'avec previousValue et trendDirection tous deux définis : le pourcentage est calculé à partir des deux valeurs, tandis que la flèche et sa couleur d'état (hausse verte, baisse rouge, stable ambre) suivent le sens saisi. L'image de la mini-courbe demande au moins deux points et en prend jusqu'à 60 ; sa couleur suit celle de la flèche. Une ligne atténuée reprend le résultat en texte pour les lecteurs d'écran et la partie texte brut.
GET /api/v1/liveview/[token] donne ces mots à l'application mobile sous forme de props ajoutées, calculées par les mêmes kpiDisplay/gaugeDisplay que l'e-mail (attachChartImageUrls, src/lib/liveview/chartImages.ts) : displayValue, displayChange/displayChangeColor ou displayStatus/displayStatusColor, displaySummary, et displayNotice pour une jauge sans nombre. Chaque autre graphique reçoit chartTable, le tableau toujours visible en JSON {headers, rows}, lu dans le même balisage.
<div style="margin:0;padding:0;background-color:#ffffff">
<p style="margin:0 0 4px;font-weight:600;font-size:13px;color:#6b7280">Monthly revenue</p>
<p style="margin:0 0 6px;font-weight:700;font-size:32px;color:#111827">$48,210 <span style="font-size:14px;font-weight:600;color:#16a34a">▲ +17.6%</span></p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoic3BhcmtsaW5lIi…&s=…&r=2" width="160" height="40"
alt="Trend sparkline, upward: 10, 14, 12, 18, 22, 27" style="display:block;max-width:100%;height:auto;margin:4px 0" />
<p style="margin:4px 0 0;font-size:11px;color:#6b7280">Monthly revenue — $48,210 — ▲ +17.6% vs previous</p>
</div>
Jauge
La jauge est le seul graphique sans tableau : sa valeur et sa zone sont du texte à côté du cadran. Par défaut, les zones sont croissantes : value <= goodMax est bon, <= warningMax attention, tout le reste critique, dans les couleurs d'état du thème. Avec higherIsBetter, value >= goodMin est bon, >= warningMin attention et tout ce qui est en dessous critique ; l'image dessine toujours trois bandes croissantes (gaugeSpecBands dans src/lib/charts/gauge.ts lui passe warningMin et goodMin avec les couleurs bonne et critique inversées), donc le format signé ne change pas. Les trois props n'ont pas de valeur par défaut, donc une jauge sans elles part comme avant. min >= max ou des seuils dans le désordre sont ramenés dans les bornes plutôt que refusés. Une valeur qui ne se lit pas comme un nombre (une balise de fusion non résolue, par exemple) écrit chart.emptyGauge à la place du cadran.
<div style="margin:0;padding:0;background-color:#ffffff">
<p style="margin:0 0 4px;font-weight:600;font-size:13px;color:#6b7280">Score</p>
<p style="margin:0 0 6px;font-weight:700;font-size:32px;color:#111827">72 <span style="font-size:14px;font-weight:600;color:#d97706">Warning</span></p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoiZ2F1Z2Ui…&s=…&r=2" width="320" height="200"
alt="Gauge: 72 of 0–100 (Warning)" style="display:block;max-width:100%;height:auto;margin:8px 0" />
<p style="margin:4px 0 0;font-size:11px;color:#6b7280">Score — 72 (Warning) — scale 0–100</p>
</div>
Classement
Une simple <table> sans image. Les lignes sont triées par Points décroissants avec un tri stable, donc les égalités gardent l'ordre de saisie ; les trois premières places affichent 🥇🥈🥉. showDraws: false retire la colonne N de l'en-tête et de chaque ligne. highlightTeamName trouve une équipe sans tenir compte de la casse et met sa ligne en gras et en teinte. Sans équipe, c'est standings.empty qui s'affiche.
<table aria-label="Standings" style="width:100%;border-collapse:collapse">
<tr><th scope="col" style="text-align:left;padding:4px 8px;font-weight:600">#</th>
<th scope="col" style="text-align:left;padding:4px 8px;font-weight:600">Team</th>
<!-- P, W, D, L, PF, PA -->
<th scope="col" style="padding:4px 8px;text-align:right;font-weight:600">Pts</th></tr>
<tr><td style="text-align:left;padding:4px 8px">🥇 1</td>
<td style="text-align:left;padding:4px 8px">Eagles</td>
<!-- 10, 7, 2, 1, 24, 10 -->
<td style="padding:4px 8px;text-align:right">23</td></tr>
</table>