Menu della documentazione

Riferimento del markup dei blocchi

Questa pagina mostra cosa inserisce ogni blocco interattivo nell'HTML inviato e come la risposta di un destinatario arriva a MailInApp. È scritta per gli sviluppatori e per chi esporta l'HTML per inviarlo da un'altra piattaforma. La pagina di ogni blocco descrive cosa vedono i destinatari e cosa ottieni. I livelli sono spiegati in Come funzionano i fallback.

Gli esempi sono abbreviati: l'output reale contiene più stili in linea, una o due classi per la modalità scura e i colori del tuo tema. Ogni link punta al token firmato della vista live del destinatario (/v/[token]), che identifica l'email e, per un invio personalizzato, il destinatario.

Come vengono registrate le risposte

Due strade portano allo stesso endpoint di registrazione e producono lo stesso evento, quindi i risultati non dipendono mai da dove ha risposto un destinatario.

  • Link di conferma. Una risposta con un tocco è un <a href> verso /v/[token]/act con il blocco, l'azione e il valore nella query. La pagina che si apre chiede al destinatario di confermare, ed è l'invio del modulo di conferma a registrare la risposta. Un semplice GET non registra nulla, quindi gli scanner di link e gli strumenti di sicurezza che precaricano ogni link non possono votare. Vedi Registrazione delle interazioni a prova di scanner.
  • Invii di modulo. Un blocco con risposte scritte o multiple invia un <form method="post"> che pubblica su /api/interactions come application/x-www-form-urlencoded. Gmail sul web e le app di Outlook per iOS e Android lo inviano dall'email. Ogni modulo di questo tipo ha anche un link Rispondi sul web, sempre visibile, allo stesso blocco nella vista live, dove è un normale modulo web.

La risposta di un destinatario viene salvata una volta per email, blocco e destinatario, con un id di documento formato dai tre, quindi un tocco ripetuto o una pagina ricaricata non cambia nulla. Le risposte da un'email esportata senza token del destinatario non hanno una persona a cui legarsi, quindi sono limitate per IP, per campagna e per minuto.

Blocchi di feedback

Sondaggio

Ogni opzione è un link di conferma con lo stile di un chip. È sempre visibile, in ogni app di posta.

<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>

Con Consenti più risposte, il sondaggio invia un modulo di caselle che pubblica un optionId per ogni opzione spuntata (salvati come liste parallele option e optionId), più il link Rispondi sul web. Un'opzione Altro è un link al sondaggio nella vista live, dove il destinatario scrive la sua risposta. L'ordine di un sondaggio mescolato deriva dal token del destinatario, quindi è lo stesso a ogni apertura. L'Immagine dei risultati in tempo reale è un <img> da /api/results-image, firmato per opzione del sondaggio, mai per destinatario.

Valutazione

Il modo predefinito Stelle invia un link di conferma per stella, la più alta per prima, in una fila da destra a sinistra. Ogni link contiene una stella vuota e una piena; una regola :hover riempie le stelle fino al puntatore dove l'app lo supporta, e altrove si vedono le stelle vuote. Le immagini delle stelle vengono da /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 link per stella, fino a rating=1 -->
  </div>
</div>

Ogni altro modo (facce emoji, pollici, scala numerata, NPS e i chip di stelle classici) è una fila di link di conferma con rating=<n>. Quando il punteggio è pari o inferiore alla soglia di approfondimento del blocco, la pagina di conferma prosegue verso /v/[token]/followup.

Quiz

Il quiz invia un modulo con un gruppo di radio per domanda, che pubblica q0, q1… (la posizione della domanda alla creazione) su /api/interactions, più il link Rispondi sul 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 gruppo di radio per domanda e un pulsante "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>

Il punteggio si calcola sul server, con le risposte corrette dell'email salvata; un punteggio inviato da un client non viene mai accettato. Il valore dell'evento è {answers, score, total, bucket} per un quiz a punteggio e {answers, outcome, outcomeTitle} per un quiz di personalità. Con Mostra subito se è giusta, l'etichetta di ogni risposta porta una nota nascosta che una regola :checked rivela, quindi le risposte corrette sono nell'HTML inviato. Una schermata iniziale tiene le domande dietro un'ancora :target nella vista live.

Modulo

Un modulo di una pagina invia tutti i campi in un <form> che pubblica su /api/interactions, più il link Rispondi sul web.

<div id="em-form-1" style="margin:12px 0;background-color:transparent">
  <!-- <form method="post" action="https://mailinapp.com/api/interactions">:
       tutti i campi e un pulsante di invio -->
  <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 modulo su più pagine non invia campi, solo un link con lo stile di un pulsante con la sua Etichetta del pulsante di avvio, verso la procedura guidata del sondaggio in /v/[token]/form/[blockId]. Lì ogni pagina salva una bozza (un'azione form-page che non tocca risultati né webhook), e il submit dell'ultima pagina trasforma la bozza nella risposta. Con Passaggi nell'email, le pagine vengono inviate come un radio per pagina prima del modulo e regole :checked che mostrano una pagina alla volta; le app senza queste regole mostrano tutte le pagine. Un campo file rimanda alla vista live, perché un file si può aggiungere solo da un browser. Le domande condizionali compaiono tutte nel modulo inviato; il server scarta le risposte alle domande che le risposte precedenti del destinatario nascondono.

Il server controlla ogni risposta rispetto al modulo dell'email salvata prima di scrivere qualsiasi cosa. Un browser che ha inviato una risposta non valida torna a /v/[token]?invalid=<fieldId>&why=<problem>, e una chiamata JSON riceve un 400 invalid-answer.

Blocchi di negozio e recensioni

I link di questi blocchi passano da /v/[token]/click, che registra il clic e reindirizza alla destinazione. Le ripetizioni dello stesso link firmato entro cinque minuti contano una volta sola.

Conto alla rovescia

Il conto alla rovescia è un'unica <img> da /api/countdown. La sua URL è firmata su termine e colore, e ogni caricamento disegna dal tempo restante una nuova GIF di 60 fotogrammi, uno al secondo, che poi resta sull'ultimo fotogramma. Le richieste firmate identiche condividono un rendering per dieci secondi al massimo. Il testo alt riporta il tempo restante a parole per i lettori di schermo e per le app che caricano le immagini in ritardo.

<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>

Un termine per contatto (Un tempo dopo l’invio o Una data nei dati del contatto) viene calcolato all'invio e salvato nella riga del destinatario come countdown_ends_<blockId> e nel suo token della vista live, così ogni apertura mostra lo stesso termine. Un conto alla rovescia già scaduto al momento del rendering invia il messaggio di fine come testo al posto dell'immagine. I clic portano il termine del destinatario, così il totale del conto alla rovescia conta ogni clic prima o dopo la scadenza propria di quel destinatario.

Prodotto

Con il checkout MailInApp, Acquista ora è un link di conferma verso /v/[token]/act?action=buy. La pagina di conferma rilegge il prodotto dall'email salvata, e il suo POST crea la sessione Stripe Checkout tramite /api/checkout; un semplice GET non crea nulla. Prezzo, nome e inventario vengono sempre dalla copia del server. Un ordine diventa pagato solo con il webhook firmato di Stripe, che ricontrolla l'inventario in una transazione e rimborsa un pagamento che lo supererebbe. Con un Inventario impostato, la scheda porta un badge di disponibilità da /api/product-status, ridisegnato al massimo una volta al minuto dal numero di pezzi pagati.

<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>

Con Link al checkout di un negozio esterno, Acquista ora è un link di clic alla pagina prodotto (con ?variant= per una variante Shopify importata), oppure a un link di sconto proprio del destinatario, creato all'invio quando Sconto dedicato al prodotto è attivo.

Le varianti inviano un pulsante radio nascosto per valore di opzione prima del prezzo, una riga di chip (.pv-opts, <label for> sui pulsanti radio) e un pannello per variante (.pv-panels) con prezzo e link di acquisto. Regole della forma #<id>-a<i>:checked:not(:disabled) ~ … mostrano i chip e il pannello della variante scelta, e nascondono .pd-price e .pv-list. Dove queste regole non si applicano, compaiono il prezzo e .pv-list: un link per variante, ognuno per acquistare quella variante (&variant=<variantId>). Le immagini in più usano le miniature della galleria di immagini, con piccole immagini collegate come alternativa. Salva per dopo è un link di conferma con action=save, registrato una volta per destinatario.

<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>

Griglia di prodotti

La griglia è una tabella di schede, ognuna una propria tabella con bordo, con celle che si impilano sul telefono. Il pulsante di ogni scheda è un link di clic con l'id della scheda stessa (blockType=product-card). Prezzi e varianti predefinite delle schede importate vengono letti dal catalogo sincronizzato al momento del rendering.

<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>

Con Aggiungi al carrello, il pulsante di una scheda del carrello rimanda invece alla pagina carrello /v/[token]/cart/[blockId]?add=<cardId>. Quella pagina, come la griglia della vista live, invia gli id item scelti e qty_<cardId> a /api/cart, che legge schede e negozio dall'email salvata e reindirizza al permalink del carrello Shopify o al link di checkout WooCommerce. Il checkout viene registrato come un clic sulla griglia, con le schede e le quantità scelte nel suo valore.

Coupon

Il codice è testo semplice in un riquadro con user-select:all, così un tocco o un doppio clic lo seleziona tutto. Il pulsante verso il negozio è un link di clic. Nella vista live, nella casella di posta e nell'app, il riquadro è un <button data-copy> che copia il codice.

<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 codice da un merge tag viene risolto per ogni destinatario; se risulta vuoto, il blocco non viene renderizzato.

Recensioni del negozio

Le recensioni del negozio sono testo statico: le stelle sono caratteri con un aria-label, e il testo di ogni recensione porta dir="auto". Le recensioni vengono scelte al momento del rendering tra le storeReviews sincronizzate e non vengono mai salvate nell'albero dell'email. Con Un prodotto, il link «Leggi tutte le recensioni» è un link di clic alla pagina prodotto.

<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 vista live, la casella di posta e GET /api/v1/liveview/[token] rileggono le recensioni a ogni apertura.

Blocchi di eventi

RSVP e Prenotazione riunioni registrano tramite link di conferma, come i blocchi di feedback. Il pulsante per partecipare di un link alla riunione e il pulsante Iscriviti ora di un'iscrizione al webinar sono link di clic che passano da /v/[token]/click, come i link dei blocchi di negozio.

La riga di stato («Inizia tra …», o «In diretta» una volta passato l'inizio) viene scritta al rendering dell'email. Sotto, un <img> da /api/countdown, firmato come quello del blocco Conto alla rovescia, disegna il tempo che manca a ogni apertura dell'email. Nell'email, il pulsante per partecipare è sempre un link di clic attivo.

<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 vista live, la casella di posta e l'app mobile mostrano il pulsante per partecipare solo da Il link per partecipare si apre prima dell’inizio minuti prima di startsAt, calcolato dalle proprietà del blocco al rendering, senza stato salvato. Fino ad allora mostrano un chip inattivo «Si apre N minuti prima dell’inizio». Un blocco senza startsAt è sempre aperto.

RSVP

Ogni risposta è un link di conferma con response=yes, no o maybe. Con Consenti accompagnatori, Sì porta alla vista live, dove il destinatario sceglie il numero di accompagnatori. Mostra quanti partecipano aggiunge un <img> da /api/rsvp-count, firmato per blocco, colore e larghezza, mai per destinatario, e disegnato dal totale dell'RSVP all'apertura.

<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>

Il controllo della capienza e la deduplicazione per destinatario avvengono in un'unica transazione Firestore, così i posti non vengono mai venduti in eccesso: un sì oltre la capienza è registrato come waitlisted, un no come declined, un forse come maybe senza posto. Le domande dopo un sì vengono inviate come submit sull'id del blocco seguito da __details, che il server accetta solo da un destinatario la cui risposta registrata è un sì, e controlla come le risposte di un modulo.

Prenotazione riunioni

Gli orari sono i prossimi slot liberi del tipo di prenotazione, calcolati al rendering dell'email ed etichettati nel fuso orario del tipo di prenotazione. Nell'email, ogni orario è un link di conferma con action=book&slot=<epoch ms>, e Vedi altri orari apre la pagina di prenotazione live /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>

Con Mostra i giorni come schede, un radio nascosto per giorno (#<id>-d<i>) precede una barra di schede (.bk-bar), e regole della forma #<id>-d<i>:checked:not(:disabled) ~ … mostrano il pannello di un giorno (.bk-p). Dove queste regole non si applicano, ogni pannello compare sotto il titolo del suo giorno (.bk-dh). Nella vista live, nella casella di posta e nell'app, gli orari sono chip radio in un unico modulo che invia action=book con lo slot scelto a /api/interactions.

Prima di prenotare, il server rilegge la disponibilità del calendario e riserva lo slot in una transazione, così uno slot viene prenotato una sola volta. Un destinatario viene prenotato come il proprio contatto, una volta per blocco. Un token senza contatto dietro viene inviato alla pagina di prenotazione, che chiede nome ed email dietro un controllo anti-bot.

Iscrizione al webinar

La scheda è la stessa ovunque. La data è formattata nel fuso orario del blocco con il fuso indicato, e Iscriviti ora è un link di clic alla pagina pubblica della sessione /webinar/<liveSessionId>, costruita dall'id della sessione senza alcuna ricerca all'invio.

<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>

Le iscrizioni sono registrate dalla pagina della sessione, quindi il blocco registra solo il clic.

Blocchi vetrina

Questi blocchi non registrano alcuna risposta. Ciascuno invia il suo contenuto in una forma che si legge bene da sola, poi aggiunge regole :checked che la trasformano nella versione interattiva dove l'app di posta le esegue. Le regole stanno nello <style> dell'<head>, e i campi su cui si basano sono racchiusi in <!--[if !mso]><!-->, così l'Outlook classico non li vede mai.

Due schemi coprono tutti e sette:

  • Gruppi di radio (carosello, schede, galleria di immagini): un radio nascosto per slide, scheda o immagine prima del contenuto, con etichette for quei radio come punti, barra delle schede o miniature. Ogni regola si scrive #<radio>:checked:not(:disabled) ~ …. Un'app che rimuove i campi non ne soddisfa nessuna, e l'alternativa resta.
  • Interruttori a casella (fisarmonica, prima / dopo, punti sull'immagine, menu): una casella di controllo #<id>-k sempre spuntata prima del blocco, e l'interruttore #<id>-t dentro il <label> toccato. Le regole che nascondono qualcosa partono da #<id>-k:checked, così un'app che rimuove il controllo mostra tutto.

I link di questi blocchi passano da /v/[token]/click, come ogni altro link.

Carosello

Ogni slide è disegnata due volte: una in .carousel-fallback (la prima slide e il link Vedi tutte le N slide, oppure tutte le slide in una tabella .carousel-grid) e una come .lv-frame nascosto che le regole di un radio mostrano. La striscia .lv-px carica un beacon di visualizzazione della slide, /v/[token]/nv/<blockId>/<slide>, dalla regola di ogni slide dopo la prima: è così che Insights conta i destinatari andati oltre la prima slide.

<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 &rarr;</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">&nbsp;</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)}

Le frecce sono etichette for i radio vicini dentro ogni riquadro. Le miniature sostituiscono i punti con etichette .lv-tn. La riproduzione automatica aggiunge un altro radio, spuntato per primo, le cui regole spostano i riquadri lungo una .lv-track con un'animazione @keyframes dentro @media (prefers-reduced-motion:no-preference); scegliere una slide lo deseleziona. Prezzo e pulsante di una slide fanno parte della slide, quindi compaiono anche nell'alternativa, e il pulsante porta all'href della slide.

Fisarmonica

Il contenuto di ogni voce sta dentro il <label> della voce, dopo l'interruttore, quindi compare ovunque le regole non vengano eseguite. Nella vista live, nella casella di posta e nell'area di lavoro, ogni voce è invece un <details>/<summary> nativo.

<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}

Schede

I blocchi di ogni scheda sono scritti una volta sola, in un pannello .tb-p che si apre con il titolo della scheda come intestazione .tb-h. Quei pannelli impilati sono l'alternativa. Le regole dei radio mostrano la .tb-bar, nascondono le intestazioni e mostrano un pannello.

<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}

Prima / dopo

Le due immagini stanno in un unico <label>, ciascuna sotto la sua etichetta. Le regole del controllo nascondono l'immagine dopo e mostrano il suggerimento; l'interruttore scambia le due.

<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}

Punti sull'immagine

I punti sono posizionati solo da regole dietro il controllo, mai da un position in linea (che Gmail rimuove). Ogni punto è un <label> attorno alla sua casella e alla sua nota. La .hs-legend numerata sotto l'immagine è l'alternativa, e le regole del controllo la nascondono.

<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}

Una nota si apre a sinistra o a destra e in alto o in basso a seconda di dove sta il suo punto: oltre il 60 % in orizzontale o il 65 % in verticale.

Galleria di immagini

La prima immagine sta sempre in .gl-main; le altre sono riquadri nascosti lì. .gl-fallback le mostra in piccolo, ciascuna collegata alla vista live, e le regole dei radio la sostituiscono con la fila .gl-thumbs di etichette. Il blocco Prodotto disegna le sue immagini aggiuntive con gli stessi pezzi.

<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}

I link formano una .mn-row, ciascuno un link di clic con il suo spazio (blockType=menu-item), così Insights nomina ogni link. La .mn-bar e le regole che comprimono la riga stanno dentro @media only screen and (max-width:620px) con Sui telefoni, o al livello superiore con Sempre.

<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">&#9776;</span><span class="mn-close" style="display:none">&#10005;</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&amp;blockType=menu-item&amp;dest=https%3A%2F%2Fshop.example.com%2F&amp;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&amp;blockType=menu-item&amp;dest=https%3A%2F%2Fshop.example.com%2Fnew&amp;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}
}

Blocchi di gioco

I tre giochi condividono la stessa forma. Una casella di controllo #<id>-k, sempre spuntata, precede un <label> che contiene un radio, la copertura (.sc-surface, oppure la ruota .stw-wheel con il suo pulsante .stw-go) e il premio (.sc-prize, .stw-prize). Le regole del controllo mostrano la copertura e nascondono il premio. Un tocco sull'etichetta seleziona il radio, le cui regole nascondono la copertura e mostrano il premio.

Un radio e non una casella, così un secondo tocco non nasconde di nuovo il premio. Gli input stanno dentro <!--[if !mso]><!-->, e un'app che rimuove il controllo mostra ciò che sta fuori dalle regole.

Ogni blocco registra un reveal. Nell'email, la regola del radio carica un beacon di rivelazione, /v/[token]/rv/<blockId>, come sfondo di una striscia di 4px (.sc-px, .stw-px), e la vista live invia la rivelazione dal suo script inline. I link dei premi passano da /v/[token]/click.

Premi. Con figli game-prize, il server sceglie il premio di ogni destinatario prima di generare l'email: un'estrazione ponderata il cui seme è un HMAC del progetto, del blocco e del destinatario, registrata una sola volta in gamePrizes/{projectId}_{blockId}_{recipient} con il suo codice. Il risultato viaggia nella riga del destinatario come prize_<blockId>, prize_label_<blockId>, prize_code_<blockId> e prize_url_<blockId>, così email, vista live, casella di posta e app mostrano lo stesso premio.

Il pannello del premio sta allora solo nella parte interattiva, e un link Scopri il mio premio alla vista live (.stw-reveal, .sc-reveal) sta fuori, nascosto dalla regola del controllo. Un'email generata senza risultato nella riga (un'esportazione, un'assegnazione non riuscita) mostra solo quel link, e la vista live assegna il premio. L'evento di rivelazione porta il premio registrato, mai uno inviato dal client.

Ruota della fortuna

La ruota è un conic-gradient di 240px con uno spicchio uguale per premio, scritto in bianco con un'ombra perché resti leggibile in modalità scura. I suoi @keyframes la girano in 3,2 secondi fino all'angolo del premio del destinatario, poi il pannello del premio compare in dissolvenza. Outlook classico riceve il link di rivelazione come pulsante 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">&nbsp;</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)}}

Senza premi, la ruota è un 🎡 di 64px che fa due giri in 0,9 secondi e svela un pulsante tracciato al Link del premio. Un secondo pulsante allo stesso link, Scopri il tuo premio, sta fuori dalla parte interattiva per ogni altra app (un link alla vista live se il link del premio è vuoto). La vista live mostra il titolo e il pulsante del premio.

Gratta e vinci

Senza premi, il premio resta fuori dalla parte interattiva, così un'app che rimuove le regole lo mostra subito. La copertura è uno <span> con display:none che solo la regola del controllo mostra: strisce argentate, il Colore della copertura o un <img> per l'Immagine iniziale (mai un url() CSS). Il Pulsante Scopri aggiunge uno span .sc-go dentro l'etichetta.

<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">&nbsp;</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 regola del controllo trasforma il radio in un elemento focalizzabile di 1px: così Tab raggiunge la carta e la barra spaziatrice la svela. Con Pulsante sotto la carta, il pulsante tracciato sta dopo il </label>, fuori da ogni regola, e si vede prima e dopo la grattata.

Scatola misteriosa

Il markup e le regole del gratta e vinci, con una scatola regalo come copertura: un 🎁 di 72px (o l'Immagine della scatola) e il testo da toccare. Una regola in più fa dondolare la scatola finché è chiusa.

<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)}}

Blocchi di formazione

Il mazzo di flashcard non registra nulla. Il compito registra una consegna per destinatario.

Mazzo di flashcard

Ogni scheda ha la forma di Prima / dopo: una casella di controllo #<card>-k sempre spuntata, poi un <label> che contiene la casella della scheda #<card>-f, il fronte .fc-front e il retro .fc-back. Le regole del controllo nascondono il retro e le etichette dei lati .fc-l. Spuntare la casella della scheda nasconde il fronte e mostra il retro.

Ogni regola nomina :checked, quindi un'app che le scarta mostra fronte e retro uno sopra l'altro, il retro sotto una linea tratteggiata, ogni lato preceduto dalla sua etichetta ("D: " e "R: ", nella lingua dell'email). Una scheda che inizia già con la sua etichetta la mantiene una sola volta. Una scheda con un'immagine solo sul fronte mantiene 200px di altezza quando è girata, così il mazzo non si sposta sotto il dito del lettore. La vista live disegna lo stesso markup, e la parte in testo semplice scrive ogni scheda su due righe.

<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}

Compito

La scadenza è l'immagine del blocco conto alla rovescia, /api/countdown firmata per la scadenza, sotto una riga "Scadenza". L'email non scrive il tempo rimasto, perché viene letta dopo essere stata generata, e il testo alternativo dell'immagine dice "Tempo rimasto alla scadenza". Un'email generata dopo la scadenza dice invece "Scaduto". La vista live scrive il tempo rimasto ("Scade tra 2 g 4 h 10 min"). I link alle risorse sono link semplici, e Punti aggiunge "(10 pt)" al titolo.

Segna come fatto è una scelta come quella di un sondaggio: nell'email, un link a /v/[token]/act?action=complete, dove il lettore conferma. Una risposta breve o con link è un <form> che invia action: "submit-answer" con answer (una <textarea> di tre righe o un <input type="url">) a /api/interactions, dentro <!--[if !mso]>, con un link Rispondi sul web alla vista live (#em-<id>) sotto, in ogni app.

Una consegna è deduplicata per destinatario come un voto, e la vista live la rilegge: "Segnato come fatto ✓", oppure "Consegnato ✓" con la risposta. Una consegna dopo dueAt è registrata come le altre, e Insights ne ricava "in tempo" o "in ritardo" dal suo orario (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>

Blocchi di contenuto

Questi blocchi non registrano risposte. Video, Audio, Luogo e Aggiungi al calendario sono slot di clic: in un invio personalizzato, ogni link passa da /v/[token]/click?blockId=…&blockType=…&dest=…&sig=…, che registra un click sul blocco e reindirizza a dest. Un'email esportata senza token del destinatario punta direttamente alla destinazione. Il markup inviato è lo stesso in ogni app di posta; solo la vista live cambia, per video e audio.

Video e audio

L'email disegna un'immagine dentro il link di clic: l'anteprima o la copertina come un semplice <img> il cui alt è la descrizione oppure, senza immagine, un riquadro scuro con ▶ o ♪, la descrizione e, per un video, la durata come M:SS. Larghezza, spaziatura interna, bordo e sfondo del blocco stanno sul <div> esterno, così il riquadro mantiene la propria spaziatura.

La vista live e la casella di posta di MailInApp disegnano un <video controls> con l'anteprima come poster, oppure un <audio controls> sotto l'<img> della copertina, ciascuno con la descrizione come aria-label. L'app mobile apre il file. Un blocco senza src non emette nulla.

<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=video-g1&amp;blockType=video&amp;dest=https%3A%2F%2Fexample.com%2Fpromo.mp4&amp;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&amp;blockType=audio&amp;dest=https%3A%2F%2Fexample.com%2Fno-cover.mp3&amp;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>

Formula

La formula è un PNG di GET /api/formula. La notazione (tagliata a 300 caratteri), la modalità di visualizzazione e il colore sono serializzati nella query firmata, così l'endpoint non legge nulla da Firestore e risponde con un header di cache immutabile; lo serve il worker edge. L'emitter impagina la formula una volta per scrivere width e height dell'<img>, così l'email non si sposta durante il caricamento, e l'impaginazione riduce la scala per restare nel budget di dimensione dell'immagine. L'alt è la notazione stessa, come la parte in testo semplice.

Il parser è di MailInApp (nessun motore TeX): una macro sconosciuta viene disegnata come testo letterale e il renderer non lancia mai errori, così una formula non ferma mai un invio. \ce{…} mette a pedice il numero di elementi, ad apice le cariche finali e disegna -> come una freccia. Una notazione vuota non emette nulla. Email, vista live e casella di posta disegnano la stessa immagine; cambia solo l'origine dell'URL.

<div style="margin:8px 0;text-align:center">
  <img src="https://mailinapp.com/api/formula?d=eyJub3RhdGlvbiI6…&amp;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>

Luogo

Foto, nome e indirizzo sono HTML semplice, e l'indirizzo mantiene i suoi a capo. Il link delle indicazioni è il Link a Google Maps così come incollato, altrimenti https://maps.google.com/?q=<lat>,<lng> quando le coordinate non sono zero e sono valide, altrimenti https://maps.google.com/?q=<indirizzo>; non entra in gioco alcuna chiave API di Maps. Senza nessuno dei tre, non viene disegnato alcun pulsante. Il pulsante è il pulsante a prova di client di tutti i blocchi: un v:roundrect VML per Outlook classico e un <a> con mso-hide:all per tutti gli altri, entrambi attraverso lo slot di 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&amp;…" …><center>Get Directions</center></v:roundrect><![endif]-->
  <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&amp;blockType=venue&amp;dest=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D123%2520Main%2520St%252C%2520Springfield&amp;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>

Aggiungi al calendario

I tre pulsanti vengono disegnati solo con un Inizia il valido; una fine mancante o precedente all'inizio diventa un'ora dopo. Titolo, descrizione e luogo sono tagliati a 200, 2.000 e 300 caratteri prima di costruire i link, così i tre coincidono sempre. Tutti e tre condividono l'unico slot di clic del blocco.

  • Scarica .ics è GET /api/calendar, con l'intero evento firmato nella query (un HMAC su un input con prefisso calendar:, così nessun'altra famiglia di URL firmati viene verificata qui, e nessuna lettura da Firestore). Restituisce un file RFC 5545 con DTSTART/DTEND come istanti UTC (una Z finale, nessun VTIMEZONE), così ogni calendario mostra l'ora dell'ospite. L'UID è uno SHA-256 dei campi dell'evento, quindi salvarlo di nuovo aggiorna una sola voce. Il testo è codificato secondo il §3.3.11 e le righe sono piegate a 75 ottetti.
  • Aggiungi a Google Calendar è un link calendar.google.com/calendar/render?action=TEMPLATE&… e Aggiungi a Outlook.com un link outlook.live.com/calendar/0/action/compose?…, entrambi costruiti al rendering.

Con Mostra solo dopo un sì (afterRsvp), l'email non emette nulla; la vista live, la casella di posta e l'app mobile emettono il blocco appena l'RSVP registrato del destinatario nell'email è confirmed. L'area di lavoro dello studio, che non ha il segreto del server, disegna il pulsante .ics con un link #.

<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 &amp; Q&amp;A.</p>
  <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=add-to-calendar-g2&amp;blockType=add-to-calendar&amp;dest=https%3A%2F%2Fmailinapp.com%2Fapi%2Fcalendar%3Fd%3D…&amp;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>

Blocchi grafici

I grafici, la scheda KPI e la classifica non registrano nulla e non contengono link. L'email, la vista live e la casella di posta di MailInApp scrivono lo stesso markup; cambia solo l'origine dell'URL dell'immagine. Ogni parola che aggiungono (intestazioni della tabella, le zone dell'indicatore, le colonne della classifica, la fetta Altro) viene da emailBlocks.json chart.* e standings.* nella lingua dell'email.

  • L'immagine. Ogni grafico, e il minigrafico della scheda, è un PNG di GET /api/analytics/chart?d=…&s=…&r=2. d è l'intera specifica del grafico (tipo, dimensioni, etichette, valori, colori) come JSON base64url, s il suo HMAC su LIVEVIEW_SECRET e r la densità di pixel. L'endpoint non legge nulla da Firestore, quindi una risposta è una funzione pura della sua query firmata e porta un'intestazione di cache immutabile; l'edge worker la disegna e la serve. Una specifica oltre i 6.000 caratteri, o oltre i limiti di un grafico, viene rifiutata. Le etichette vengono tagliate alla lunghezza prevista dalla specifica prima della firma.
  • Il testo accanto all'immagine. L'alt dell'<img> nomina il grafico ed elenca ogni valore disegnato («Bar chart: North (Revenue 12,400); …»). Ogni grafico tranne l'indicatore lo fa seguire da una <table aria-label="<titolo>"> sempre visibile con gli stessi dati, con una legenda dove il grafico ne ha bisogno (più serie, fette, riquadri o una scala di colore). La tabella riporta ciò che l'immagine disegna, tranne quella del Sankey, che riporta ogni flusso scritto.
  • Grafici associati. La scheda KPI e i grafici a barre, a linee e a torta accettano un binding. Un'associazione a una fonte dati viene raggruppata per groupByField e aggregata per serie (sum, avg, count, latest; src/lib/charts/aggregate.ts) sulle righe dell'associazione, dopo il filter del blocco, i cui valori possono contenere tag di unione del destinatario. Un'associazione @response: legge il riepilogo dei risultati del progetto (src/lib/charts/responseSource.ts). Entrambe si risolvono al rendering: nell'email all'invio, nella vista live a ogni caricamento. Un filtro con un tag del destinatario dà una specifica, e quindi un URL d'immagine, per destinatario.
  • Dati vuoti. Un grafico senza righe utilizzabili scrive il suo titolo e un avviso (chart.emptyRows e simili) al posto dell'immagine, così un blocco a metà non ferma mai un invio.
GraficoColonne della tabellaLimiti
Barre, linee, radarCategoria, poi una per serie con nome24 categorie, 3 serie; radar da 3 a 8 assi
Torta, treemapCategoria, Valore, Percentuale8 fette: le 7 più grandi più Altro
DispersioneSerie, X, Y, e Dimensione in un grafico a bolle120 punti, 8 serie
IstogrammaIntervallo, Conteggio500 valori, da 2 a 20 classi
Mappa di caloreRiga, Colonna, Valore (solo celle scritte)12 righe × 24 colonne
ImbutoFase, Valore, % della prima, % della precedente8 fasi
CascataEtichetta, Valore, Tipo, Totale progressivo8 barre
SankeyDa, A, Valore12 nodi, 24 collegamenti

Una riga oltre un limite viene scartata, mai unita, tranne le fette più piccole della torta e della treemap. Imbuto e cascata mantengono l'ordine scritto, che è il loro significato.

Grafici con tabella

<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…&amp;s=Ev3iTLfo…&amp;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>

Scheda KPI

L'etichetta, il valore (formattato come numero, dollari statunitensi o percentuale) e la variazione sono testo. La variazione compare solo con previousValue e trendDirection entrambi impostati: la percentuale si calcola dai due valori, mentre la freccia e il suo colore di stato (in salita verde, in discesa rosso, stabile ambra) seguono la direzione scritta. L'immagine del minigrafico richiede almeno due punti e ne accetta fino a 60; il suo colore segue quello della freccia. Una riga attenuata ripete il risultato come testo per gli screen reader e la parte di solo testo.

GET /api/v1/liveview/[token] passa all'app mobile queste parole come props aggiuntive, calcolate dagli stessi kpiDisplay/gaugeDisplay dell'email (attachChartImageUrls, src/lib/liveview/chartImages.ts): displayValue, displayChange/displayChangeColor oppure displayStatus/displayStatusColor, displaySummary e displayNotice per un indicatore senza numero. Ogni altro grafico riceve chartTable, la tabella sempre visibile come JSON {headers, rows}, letta dallo stesso markup.

<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…&amp;s=…&amp;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>

Indicatore

L'indicatore è l'unico grafico senza tabella: il suo valore e la sua zona sono testo accanto al quadrante. Per impostazione predefinita le zone sono crescenti: value <= goodMax è buono, <= warningMax attenzione, tutto il resto critico, nei colori di stato del tema. Con higherIsBetter, value >= goodMin è buono, >= warningMin attenzione e tutto ciò che sta sotto critico; l'immagine disegna sempre tre bande crescenti (gaugeSpecBands in src/lib/charts/gauge.ts le passa warningMin e goodMin con i colori buono e critico scambiati), quindi il formato firmato non cambia. Le tre props non hanno valori predefiniti, quindi un indicatore senza di esse parte come prima. min >= max o soglie fuori ordine vengono riportati nei limiti invece di essere rifiutati. Un valore che non si legge come numero (un tag di unione non risolto, per esempio) scrive chart.emptyGauge al posto del quadrante.

<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…&amp;s=…&amp;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>

Classifica

Una semplice <table> senza immagine. Le righe sono ordinate per Punti decrescenti con un ordinamento stabile, quindi i pari merito mantengono l'ordine scritto; le prime tre posizioni mostrano 🥇🥈🥉. showDraws: false toglie la colonna dei pareggi dall'intestazione e da ogni riga. highlightTeamName trova una squadra senza distinguere maiuscole e minuscole e ne mette la riga in grassetto e colorata. Senza squadre viene scritto standings.empty.

<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>

Pagine correlate