Referência da marcação dos blocos
Esta página mostra o que cada bloco interativo coloca no HTML enviado e como a resposta de um destinatário chega ao MailInApp. Ela foi escrita para desenvolvedores e para quem exporta o HTML para enviar por outra plataforma. A página de cada bloco descreve o que os destinatários veem e o que você recebe. Os níveis em si são explicados em Como os fallbacks funcionam.
Os exemplos são resumidos: a saída real tem mais estilos inline, uma ou duas classes de modo escuro e as cores do seu tema. Cada link aponta para o token assinado de visualização ao vivo do destinatário (/v/[token]), que identifica o e-mail e, em um envio personalizado, o destinatário.
Como as respostas são registradas
Dois caminhos levam ao mesmo endpoint de registro e produzem o mesmo evento, então os resultados nunca dependem de onde um destinatário respondeu.
- Links de confirmação. Uma resposta de um toque é um
<a href>para/v/[token]/actcom o bloco, a ação e o valor na query. A página aberta pede ao destinatário que confirme, e é o envio do formulário de confirmação que registra a resposta. Um GET simples não registra nada, então scanners de links e ferramentas de segurança que pré-carregam cada link não conseguem votar. Veja Registro de interação à prova de scanners. - Envios de formulário. Um bloco com respostas digitadas ou múltiplas envia um
<form method="post">que publica em/api/interactionscomoapplication/x-www-form-urlencoded. O Gmail na web e os apps do Outlook para iOS e Android o enviam pelo e-mail. Todo formulário assim também traz um link Responder na web, sempre visível, para o mesmo bloco na visualização ao vivo, onde ele é um formulário web comum.
A resposta de um destinatário é guardada uma vez por e-mail, bloco e destinatário, com um id de documento formado pelos três, então um toque repetido ou uma página recarregada não muda nada. Respostas de um e-mail exportado sem token de destinatário não têm uma pessoa a quem se ligar, então são limitadas por IP, por campanha e por minuto.
Blocos de feedback
Enquete
Cada opção é um link de confirmação com estilo de chip. Ele fica sempre visível, em qualquer app de e-mail.
<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>
Com Permitir várias respostas, a enquete envia um formulário de caixas de seleção que publica um optionId por opção marcada (guardados como listas paralelas option e optionId), mais o link Responder na web. Uma opção Outro é um link para a enquete na visualização ao vivo, onde o destinatário digita a resposta. A ordem de uma enquete embaralhada vem do token do destinatário, então é a mesma a cada abertura. A Imagem de resultados ao vivo é um <img> de /api/results-image, assinado por opção da enquete, nunca por destinatário.
Nota
A forma padrão Estrelas envia um link de confirmação por estrela, a mais alta primeiro, em uma fileira da direita para a esquerda. Cada link tem uma estrela vazia e uma cheia; uma regra :hover preenche as estrelas até o ponteiro onde o app permite, e nos demais aparecem as estrelas vazias. As imagens das estrelas vêm 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>
<!-- …um link por estrela, até rating=1 -->
</div>
</div>
As outras formas (rostos emoji, polegares, escala numerada, NPS e as fichas de estrelas clássicas) são uma fileira de links de confirmação com rating=<n>. Quando a nota é igual ou menor que o limite de acompanhamento do bloco, a página de confirmação segue para /v/[token]/followup.
Quiz
O quiz envia um formulário com um grupo de botões de opção por pergunta, que publica q0, q1… (a posição da pergunta ao ser criada) em /api/interactions, mais o link Responder na 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">:
um grupo de botões de opção por pergunta e um botão "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>
A pontuação é calculada no servidor, com as respostas certas do e-mail salvo; uma pontuação enviada por um cliente nunca é aceita. O valor do evento é {answers, score, total, bucket} em um quiz com pontuação e {answers, outcome, outcomeTitle} em um quiz de personalidade. Com Mostrar na hora se está certa, o rótulo de cada resposta leva uma nota oculta que uma regra :checked revela, então as respostas certas estão no HTML enviado. Uma tela de capa mantém as perguntas atrás de uma âncora :target na visualização ao vivo.
Formulário
Um formulário de uma página envia todos os campos em um <form> que publica em /api/interactions, mais o link Responder na web.
<div id="em-form-1" style="margin:12px 0;background-color:transparent">
<!-- <form method="post" action="https://mailinapp.com/api/interactions">:
todos os campos e um botão de envio -->
<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>
Um formulário de várias páginas não envia campos, só um link com estilo de botão e seu Rótulo do botão de início, para o assistente da pesquisa em /v/[token]/form/[blockId]. Lá cada página salva um rascunho (uma ação form-page que não mexe em resultados nem em webhooks), e o submit da última página transforma o rascunho na resposta. Com Etapas no e-mail, as páginas são enviadas como um botão de opção por página antes do formulário e regras :checked que mostram uma página por vez; apps sem essas regras mostram todas as páginas. Um campo de arquivo leva à visualização ao vivo, já que um arquivo só pode ser adicionado de um navegador. As perguntas condicionais aparecem todas no formulário enviado; o servidor descarta as respostas a perguntas que as respostas anteriores do destinatário ocultam.
O servidor confere cada resposta com o formulário do e-mail salvo antes de gravar qualquer coisa. Um navegador que enviou uma resposta inválida volta para /v/[token]?invalid=<fieldId>&why=<problem>, e uma chamada JSON recebe um 400 invalid-answer.
Blocos de loja e avaliações
Os links desses blocos passam por /v/[token]/click, que registra o clique e redireciona ao destino. Repetições do mesmo link assinado em cinco minutos contam uma vez.
Contagem regressiva
A contagem regressiva é uma única <img> de /api/countdown. A URL é assinada sobre o fim e a cor, e cada carregamento desenha a partir do tempo restante um novo GIF de 60 quadros, um por segundo, que depois para no último quadro. Requisições assinadas idênticas compartilham uma renderização por até dez segundos. O texto alt traz o tempo restante por extenso para leitores de tela e para apps que carregam imagens tarde.
<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>
Um fim por contato (Um tempo após o envio ou Uma data nos dados do contato) é calculado no envio e guardado na linha do destinatário como countdown_ends_<blockId> e no token da visualização ao vivo dele, para que cada abertura mostre o mesmo fim. Uma contagem que já terminou na renderização envia a mensagem de fim como texto no lugar da imagem. Os cliques levam o fim do destinatário, então o acumulado da contagem conta cada clique antes ou depois do prazo próprio daquele destinatário.
Produto
Com o checkout MailInApp, Comprar agora é um link de confirmação para /v/[token]/act?action=buy. A página de confirmação relê o produto do e-mail salvo, e o POST dela cria a sessão do Stripe Checkout por /api/checkout; um GET simples não cria nada. Preço, nome e estoque vêm sempre da cópia do servidor. Um pedido só passa a pago pelo webhook assinado da Stripe, que reconfere o estoque numa transação e reembolsa um pagamento que passaria do estoque. Com um Estoque definido, o cartão traz um selo de estoque de /api/product-status, redesenhado no máximo uma vez por minuto a partir das unidades pagas.
<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>
Com Link para o checkout de uma loja externa, Comprar agora é um link de clique para a página do produto (com ?variant= para uma variante importada da Shopify), ou para um link de desconto próprio do destinatário, criado no envio quando Desconto próprio do produto está ativado.
As variantes enviam um botão de rádio oculto por valor de opção antes do preço, uma fileira de chips (.pv-opts, <label for> sobre os botões de rádio) e um painel por variante (.pv-panels) com preço e link de compra. Regras da forma #<id>-a<i>:checked:not(:disabled) ~ … mostram os chips e o painel da variante escolhida, e escondem .pd-price e .pv-list. Onde essas regras não se aplicam, aparecem o preço e .pv-list: um link por variante, cada um comprando aquela variante (&variant=<variantId>). Imagens extras usam as miniaturas da galeria de imagens, com pequenas imagens com link como alternativa. Salvar para depois é um link de confirmação com action=save, registrado uma vez por destinatário.
<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>
Grade de produtos
A grade é uma tabela de cartões, cada um uma tabela própria com borda, com células que se empilham no celular. O botão de cada cartão é um link de clique sob o id do próprio cartão (blockType=product-card). Preços e variantes padrão dos cartões importados são lidos do catálogo sincronizado na renderização.
<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>
Com Adicionar ao carrinho, o botão de um cartão do carrinho leva em vez disso à página do carrinho /v/[token]/cart/[blockId]?add=<cardId>. Essa página, e a grade da visualização ao vivo, enviam os ids item escolhidos e qty_<cardId> para /api/cart, que lê os cartões e a loja do e-mail salvo e redireciona ao link permanente do carrinho da Shopify ou ao link de checkout do WooCommerce. O checkout é registrado como um clique na grade, com os cartões e as quantidades escolhidos no valor.
Cupom
O código é texto simples numa caixa com user-select:all, então um toque ou um clique duplo seleciona tudo. O botão para a loja é um link de clique. Na visualização ao vivo, na caixa de entrada e no app, a caixa é um <button data-copy> que copia o código.
<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>
Um código vindo de uma merge tag é resolvido por destinatário; se ficar vazio, o bloco não é renderizado.
Avaliações da loja
As avaliações da loja são texto estático: as estrelas são caracteres com um aria-label, e o texto de cada avaliação leva dir="auto". As avaliações são escolhidas na renderização entre as storeReviews sincronizadas e nunca ficam guardadas na árvore do e-mail. Com Um produto, o link “Ler todas as avaliações” é um link de clique para a página do produto.
<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>
A visualização ao vivo, a caixa de entrada e GET /api/v1/liveview/[token] releem as avaliações a cada abertura.
Blocos de eventos
RSVP e Agendamento de reuniões registram por links de confirmação, como os blocos de feedback. O botão para entrar de um link da reunião e o botão Inscreva-se de uma inscrição em webinar são links de clique que passam por /v/[token]/click, como os links dos blocos de loja.
Link da reunião
A linha de status (“Começa em …”, ou “Ao vivo agora” depois do início) é escrita na renderização do e-mail. Abaixo dela, uma <img> de /api/countdown, assinada como a do bloco Contagem regressiva, desenha o tempo que falta a cada abertura do e-mail. No e-mail, o botão para entrar é sempre um link de clique ativo.
<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>
A visualização ao vivo, a caixa de entrada e o app móvel mostram o botão para entrar só a partir de O link para entrar abre antes do início minutos antes de startsAt, calculado a partir das propriedades do bloco na renderização, sem estado salvo. Até lá, mostram um chip inativo “Abre N minutos antes do início”. Um bloco sem startsAt está sempre aberto.
RSVP
Cada resposta é um link de confirmação com response=yes, no ou maybe. Com Permitir acompanhantes, Sim leva à visualização ao vivo, onde o destinatário escolhe o número de acompanhantes. Mostrar quantos vão adiciona uma <img> de /api/rsvp-count, assinada por bloco, cor e largura, nunca por destinatário, e desenhada a partir do acumulado do RSVP ao abrir.
<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>
A verificação da capacidade e a deduplicação por destinatário rodam numa única transação do Firestore, então as vagas nunca são vendidas além do limite: um sim acima da capacidade é registrado como waitlisted, um não como declined, um talvez como maybe sem vaga. As perguntas depois de um sim são enviadas como um submit no id do bloco seguido de __details, que o servidor só aceita de um destinatário cuja resposta registrada é um sim, e verifica como as respostas de um formulário.
Agendamento de reuniões
Os horários são os próximos horários livres do tipo de agendamento, calculados na renderização do e-mail e rotulados no fuso horário do tipo de agendamento. No e-mail, cada horário é um link de confirmação com action=book&slot=<epoch ms>, e Ver mais horários abre a página de agendamento ao vivo /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>
Com Mostrar os dias como abas, um rádio oculto por dia (#<id>-d<i>) vem antes de uma barra de abas (.bk-bar), e regras da forma #<id>-d<i>:checked:not(:disabled) ~ … mostram o painel de um dia (.bk-p). Onde essas regras não se aplicam, cada painel aparece sob o título do seu dia (.bk-dh). Na visualização ao vivo, na caixa de entrada e no app, os horários são chips de rádio num único formulário que envia action=book com o slot escolhido para /api/interactions.
Antes de agendar, o servidor lê de novo a disponibilidade da agenda e reserva o horário numa transação, então um horário é agendado uma única vez. Um destinatário é agendado como o próprio contato, uma vez por bloco. Um token sem contato por trás é enviado à página de agendamento, que pede nome e e-mail depois de uma verificação anti-robô.
Inscrição em webinar
O cartão é o mesmo em todo lugar. A data é formatada no fuso horário do bloco com o fuso indicado, e Inscreva-se é um link de clique para a página pública da sessão /webinar/<liveSessionId>, montada a partir do id da sessão sem nenhuma consulta no envio.
<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>
As inscrições são registradas pela página da sessão, então o bloco registra só o clique.
Blocos de vitrine
Estes blocos não registram nenhuma resposta. Cada um envia seu conteúdo em uma forma que se lê bem sozinha e depois adiciona regras :checked que a transformam na versão interativa onde o app de e-mail as executa. As regras ficam no <style> do <head>, e os campos em que elas se apoiam ficam dentro de <!--[if !mso]><!-->, então o Outlook clássico nunca os vê.
Dois padrões cobrem os sete:
- Grupos de rádios (carrossel, abas, galeria de imagens): um rádio oculto por slide, aba ou imagem antes do conteúdo, com rótulos
foresses rádios como pontos, barra de abas ou miniaturas. Cada regra é escrita#<radio>:checked:not(:disabled) ~ …. Um app que remove os campos não atende a nenhuma delas, e a alternativa permanece. - Interruptores de caixa (sanfona, antes / depois, pontos na imagem, menu): uma caixa de controle
#<id>-ksempre marcada antes do bloco, e o interruptor#<id>-tdentro do<label>tocado. As regras que ocultam algo partem de#<id>-k:checked, então um app que remove o controle mostra tudo.
Os links desses blocos passam por /v/[token]/click, como qualquer outro link.
Carrossel
Cada slide é desenhado duas vezes: uma em .carousel-fallback (o primeiro slide e o link Ver todos os N slides, ou todos os slides em uma tabela .carousel-grid) e outra como um .lv-frame oculto que as regras de um rádio mostram. A faixa .lv-px carrega um beacon de visualização de slide, /v/[token]/nv/<blockId>/<slide>, a partir da regra de cada slide depois do primeiro: é assim que o Insights conta os destinatários que passaram do primeiro 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 →</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)}
As setas são rótulos for os rádios vizinhos dentro de cada quadro. As miniaturas trocam os pontos por rótulos .lv-tn. A reprodução automática adiciona mais um rádio, marcado primeiro, cujas regras movem os quadros ao longo de uma .lv-track com uma animação @keyframes dentro de @media (prefers-reduced-motion:no-preference); escolher um slide o desmarca. O preço e o botão de um slide fazem parte dele, então também aparecem na alternativa, e o botão aponta para o href do próprio slide.
Sanfona
O conteúdo de cada item fica dentro do <label> do item, depois do interruptor, então aparece em qualquer lugar onde as regras não rodam. Na visualização ao vivo, na caixa de entrada e na tela, cada item é um <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}
Abas
Os blocos de cada aba são escritos uma única vez, em um painel .tb-p que começa com o título da aba como cabeçalho .tb-h. Esses painéis empilhados são a alternativa. As regras dos rádios mostram a .tb-bar, ocultam os cabeçalhos e mostram um painel.
<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}
Antes / depois
As duas imagens ficam em um único <label>, cada uma sob seu rótulo. As regras do controle ocultam a imagem de depois e mostram a dica; o interruptor troca as duas.
<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}
Pontos na imagem
Os pontos são posicionados apenas por regras atrás do controle, nunca por um position inline (que o Gmail remove). Cada ponto é um <label> em volta da própria caixa e da nota. A .hs-legend numerada abaixo da imagem é a alternativa, e as regras do controle a ocultam.
<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}
Uma nota abre para a esquerda ou a direita e para cima ou para baixo conforme a posição do seu ponto: além de 60% na horizontal ou de 65% na vertical.
Galeria de imagens
A primeira imagem fica sempre em .gl-main; as outras são quadros ocultos ali. .gl-fallback as mostra pequenas, cada uma com link para a visualização ao vivo, e as regras dos rádios a trocam pela fileira .gl-thumbs de rótulos. O bloco Produto desenha suas imagens extras com as mesmas peças.
<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
Os links formam uma .mn-row, cada um um link de clique com seu próprio espaço (blockType=menu-item), então o Insights nomeia cada link. A .mn-bar e as regras que recolhem a linha ficam dentro de @media only screen and (max-width:620px) com Em celulares, ou no nível superior com 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">☰</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}
}
Blocos de jogos
Os três jogos compartilham a mesma forma. Uma caixa de seleção de controle #<id>-k, sempre marcada, vem antes de um <label> que contém um botão de opção, a cobertura (.sc-surface, ou a roleta .stw-wheel com o botão .stw-go) e o prêmio (.sc-prize, .stw-prize). As regras do controle mostram a cobertura e escondem o prêmio. Tocar no rótulo marca o botão de opção, cujas regras escondem a cobertura e mostram o prêmio.
Um botão de opção, e não uma caixa de seleção, para que um segundo toque não esconda o prêmio de novo. Os inputs ficam dentro de <!--[if !mso]><!-->, e um app que remove o controle mostra o que fica fora das regras.
Cada bloco registra um reveal. No e-mail, a regra do botão de opção carrega um beacon de revelação, /v/[token]/rv/<blockId>, como fundo de uma faixa de 4px (.sc-px, .stw-px), e a visualização ao vivo envia a revelação pelo script embutido. Os links de prêmio passam por /v/[token]/click.
Prêmios. Com filhos game-prize, o servidor escolhe o prêmio de cada destinatário antes de gerar o e-mail: um sorteio ponderado cuja semente é um HMAC do projeto, do bloco e do destinatário, registrado uma única vez em gamePrizes/{projectId}_{blockId}_{recipient} com o código. O resultado viaja na linha do destinatário como prize_<blockId>, prize_label_<blockId>, prize_code_<blockId> e prize_url_<blockId>, então o e-mail, a visualização ao vivo, a caixa de entrada e o app mostram o mesmo prêmio.
O painel do prêmio fica então só na parte interativa, e um link Revelar meu prêmio para a visualização ao vivo (.stw-reveal, .sc-reveal) fica de fora, escondido pela regra do controle. Um e-mail gerado sem resultado na linha (uma exportação, uma atribuição que falhou) mostra só esse link, e a visualização ao vivo atribui o prêmio. O evento de revelação leva o prêmio registrado, nunca um enviado pelo cliente.
Roleta de prêmios
A roleta é um conic-gradient de 240px com uma fatia igual por prêmio, escrita em branco com sombra para continuar legível no modo escuro. Os @keyframes dela a giram em 3,2 segundos até o ângulo do prêmio do destinatário, e depois o painel do prêmio aparece aos poucos. O Outlook clássico recebe o link de revelação como um botão 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)}}
Sem prêmios, a roleta é um 🎡 de 64px que dá duas voltas em 0,9 segundo e revela um botão rastreado para o Link do prêmio. Um segundo botão para o mesmo link, Revele seu prêmio, fica fora da parte interativa para qualquer outro app (um link para a visualização ao vivo quando o link do prêmio está vazio). A visualização ao vivo mostra o título e o botão do prêmio.
Raspadinha
Sem prêmios, o prêmio fica fora da parte interativa, então um app que remove as regras o mostra na hora. A cobertura é um <span> com display:none que só a regra do controle mostra: faixas prateadas, a Cor da cobertura ou um <img> para a Imagem da capa (nunca um url() de CSS). O Botão de revelar adiciona um span .sc-go dentro do rótulo.
<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)}
A regra do controle transforma o botão de opção em um elemento focável de 1px, e é assim que Tab chega ao cartão e a barra de espaço o revela. Com Botão abaixo do cartão, o botão rastreado fica depois do </label>, fora de qualquer regra, e aparece antes e depois da raspagem.
Caixa misteriosa
A marcação e as regras da raspadinha, com uma caixa de presente como cobertura: um 🎁 de 72px (ou a Imagem da caixa) e o texto de toque. Mais uma regra faz a caixa balançar enquanto está fechada.
<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)}}
Blocos de aprendizado
O baralho de flashcards não registra nada. A tarefa registra uma entrega por destinatário.
Baralho de flashcards
Cada cartão tem a forma do Antes / depois: uma caixa de seleção de controle #<card>-k sempre marcada, depois um <label> que contém a caixa do próprio cartão #<card>-f, a frente .fc-front e o verso .fc-back. As regras do controle escondem o verso e os rótulos dos lados .fc-l. Marcar a caixa do cartão esconde a frente e mostra o verso.
Toda regra cita :checked, então um app que as descarta mostra a frente e o verso um sobre o outro, o verso sob uma linha tracejada, cada lado começando com o seu rótulo ("P: " e "R: ", no idioma do e-mail). Um cartão que já começa com o rótulo o mantém só uma vez. Um cartão com imagem só na frente mantém 200px de altura quando virado, para o baralho não se mexer sob o dedo do leitor. A visualização ao vivo desenha a mesma marcação, e a parte em texto simples escreve cada cartão em duas linhas.
<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}
Tarefa
O prazo é a imagem do bloco de contagem regressiva, /api/countdown assinada para o prazo, sob uma linha "Prazo". O e-mail não escreve o tempo restante, já que é lido depois de gerado, e o texto alternativo da imagem diz "Tempo restante até o prazo". Um e-mail gerado depois do prazo diz "Atrasado" no lugar. A visualização ao vivo escreve o tempo restante ("Vence em 2 d 4 h 10 min"). Os links para materiais são links simples, e Pontos acrescenta "(10 pts)" ao título.
Marcar como feito é uma opção como a de uma enquete: no e-mail, um link para /v/[token]/act?action=complete, onde o leitor confirma. Uma resposta curta ou com link é um <form> que envia action: "submit-answer" com answer (um <textarea> de três linhas ou um <input type="url">) para /api/interactions, dentro de <!--[if !mso]>, com um link Responder na web para a visualização ao vivo (#em-<id>) abaixo, em todos os apps.
Uma entrega é deduplicada por destinatário como um voto, e a visualização ao vivo a lê de volta: "Marcado como feito ✓", ou "Entregue ✓" com a resposta. Uma entrega depois de dueAt é registrada como qualquer outra, e o Insights lê se foi no prazo ou com atraso pelo horário dela (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>
Blocos de conteúdo
Estes blocos não registram respostas. Vídeo, Áudio, Local e Adicionar à agenda são espaços de clique: em um envio personalizado, cada link passa por /v/[token]/click?blockId=…&blockType=…&dest=…&sig=…, que registra um click no bloco e redireciona para dest. Um e-mail exportado sem token de destinatário aponta direto para o destino. A marcação enviada é a mesma em qualquer app de e-mail; só a visualização ao vivo muda, para vídeo e áudio.
Vídeo e áudio
O e-mail desenha uma imagem dentro do link de clique: o pôster ou a capa como um <img> simples cujo alt é a descrição ou, sem imagem, um painel escuro com ▶ ou ♪, a descrição e, em um vídeo, a duração como M:SS. Largura, espaçamento interno, borda e fundo do bloco ficam no <div> externo, então o painel mantém o próprio espaçamento.
A visualização ao vivo e a caixa de entrada do MailInApp desenham um <video controls> com o pôster como poster, ou um <audio controls> abaixo do <img> da capa, cada um com a descrição como aria-label. O app móvel abre o arquivo. Um bloco sem src não emite nada.
<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>
Fórmula
A fórmula é um PNG de GET /api/formula. A notação (cortada em 300 caracteres), o modo de exibição e a cor vão serializados na query assinada, então o endpoint não lê nada do Firestore e responde com um cabeçalho de cache imutável; o worker de borda o serve. O emissor diagrama a fórmula uma vez para escrever o width e o height do <img>, para o e-mail não se mexer ao carregar, e a diagramação reduz a escala para ficar dentro do orçamento de tamanho da imagem. O alt é a própria notação, assim como a parte em texto simples.
O analisador é do próprio MailInApp (sem motor TeX): uma macro desconhecida é desenhada como seu texto literal e o renderizador nunca lança erro, então uma fórmula nunca interrompe um envio. \ce{…} põe em índice o número de elementos, em expoente as cargas finais e desenha -> como uma seta. Uma notação vazia não emite nada. E-mail, visualização ao vivo e caixa de entrada desenham a mesma imagem; só muda a origem da URL.
<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>
Local
Foto, nome e endereço são HTML simples, e o endereço mantém as quebras de linha. O link do trajeto é o Link do Google Maps como foi colado; senão, https://maps.google.com/?q=<lat>,<lng> quando as coordenadas não são zero e estão no intervalo; senão, https://maps.google.com/?q=<endereço>. Nenhuma chave da API do Maps entra em jogo. Sem nenhum dos três, nenhum botão é desenhado. O botão é o botão à prova de clientes de todos os blocos: um v:roundrect VML para o Outlook clássico e um <a> com mso-hide:all para todos os outros, ambos pelo espaço de clique.
<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>
Adicionar à agenda
Os três botões só são desenhados com um Começa em válido; um fim ausente ou anterior ao início vira uma hora depois. Título, descrição e local são cortados em 200, 2.000 e 300 caracteres antes de montar os links, então os três sempre batem. Os três dividem o único espaço de clique do bloco.
- Baixar .ics é
GET /api/calendar, com o evento inteiro assinado na query (um HMAC sobre uma entrada com o prefixocalendar:, então nenhuma outra família de URLs assinadas é verificada aqui, e sem leitura do Firestore). Ele entrega um arquivo RFC 5545 comDTSTART/DTENDcomo instantes UTC (umZfinal, semVTIMEZONE), então cada agenda mostra o horário do próprio convidado. OUIDé um SHA-256 dos campos do evento, então salvar de novo atualiza uma única entrada. O texto é escapado conforme o §3.3.11 e as linhas são dobradas em 75 octetos. - Adicionar ao Google Calendar é um link
calendar.google.com/calendar/render?action=TEMPLATE&…e Adicionar ao Outlook.com um linkoutlook.live.com/calendar/0/action/compose?…, ambos montados na renderização.
Com Mostrar só depois de um sim (afterRsvp), o e-mail não emite nada; a visualização ao vivo, a caixa de entrada e o app móvel emitem o bloco assim que o RSVP registrado do destinatário no e-mail é confirmed. A tela do estúdio, que não tem o segredo do servidor, desenha o botão .ics com um 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 & 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>
Blocos de gráficos
Os gráficos, o cartão de KPI e a tabela de classificação não registram nada e não têm links. O e-mail, a visualização ao vivo e a caixa de entrada do MailInApp escrevem a mesma marcação; só muda a origem da URL da imagem. Cada palavra que eles acrescentam (títulos da tabela, as zonas do medidor, as colunas da classificação, a fatia Outros) vem de emailBlocks.json chart.* e standings.* no idioma do e-mail.
- A imagem. Cada gráfico, e o minigráfico do cartão, é um PNG de
GET /api/analytics/chart?d=…&s=…&r=2.dé a especificação inteira do gráfico (tipo, tamanho, rótulos, valores, cores) como JSON em base64url,so HMAC dela sobreLIVEVIEW_SECRETera densidade de pixels. O endpoint não lê nada do Firestore, então uma resposta é uma função pura da sua consulta assinada e traz um cabeçalho de cache imutável; o edge worker a desenha e serve. Uma especificação com mais de 6.000 caracteres, ou além dos limites de um gráfico, é recusada. Os rótulos são cortados no tamanho de rótulo da especificação antes da assinatura. - Texto ao lado da imagem. O
altdo<img>nomeia o gráfico e lista cada valor desenhado (“Bar chart: North (Revenue 12,400); …”). Todo gráfico, exceto o medidor, coloca depois uma<table aria-label="<título>">sempre visível com os mesmos números, com uma legenda onde o gráfico precisa (várias séries, fatias, blocos ou uma escala de cor). A tabela traz o que a imagem desenha, exceto a do Sankey, que traz cada fluxo digitado. - Gráficos vinculados. O cartão de KPI e os gráficos de barras, de linhas e de pizza aceitam um
binding. Uma vinculação de fonte de dados é agrupada porgroupByFielde agregada por série (sum,avg,count,latest;src/lib/charts/aggregate.ts) sobre as linhas da vinculação, depois dofilterdo bloco, cujos valores podem ter merge tags do destinatário. Uma vinculação@response:lê o resumo de resultados do projeto (src/lib/charts/responseSource.ts). As duas são resolvidas na renderização: no e-mail, no envio; na visualização ao vivo, a cada carregamento. Um filtro com uma tag do destinatário gera uma especificação, e portanto uma URL de imagem, por destinatário. - Sem dados. Um gráfico sem linhas utilizáveis escreve o título e um aviso (
chart.emptyRowse parecidos) no lugar da imagem, então um bloco pela metade nunca trava um envio.
| Gráfico | Colunas da tabela | Limites |
|---|---|---|
| Barras, linhas, radar | Categoria, depois uma por série com nome | 24 categorias, 3 séries; radar de 3 a 8 eixos |
| Pizza, mapa de árvore | Categoria, Valor, Porcentagem | 8 fatias: as 7 maiores mais Outros |
| Dispersão | Série, X, Y, e Tamanho em um gráfico de bolhas | 120 pontos, 8 séries |
| Histograma | Faixa, Contagem | 500 valores, de 2 a 20 faixas |
| Mapa de calor | Linha, Coluna, Valor (só células digitadas) | 12 linhas × 24 colunas |
| Funil | Etapa, Valor, % da primeira, % da anterior | 8 etapas |
| Cascata | Rótulo, Valor, Tipo, Total acumulado | 8 barras |
| Sankey | De, Para, Valor | 12 nós, 24 ligações |
Uma linha além de um limite é descartada, nunca mesclada, exceto as menores fatias da pizza e do mapa de árvore. O funil e a cascata mantêm a ordem digitada, que é o sentido deles.
Gráficos com tabela
<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>
Cartão de KPI
O rótulo, o valor (formatado como número, dólares americanos ou porcentagem) e a variação são texto. A variação só aparece com previousValue e trendDirection definidos: a porcentagem é calculada a partir dos dois valores, enquanto a seta e sua cor de status (alta verde, baixa vermelha, estável âmbar) seguem a direção digitada. A imagem do minigráfico precisa de pelo menos dois pontos e aceita até 60; a cor dela segue a da seta. Uma linha suave repete o resultado como texto para leitores de tela e a parte em texto simples.
GET /api/v1/liveview/[token] entrega essas palavras ao app para celular como props adicionais, calculadas pelos mesmos kpiDisplay/gaugeDisplay do e-mail (attachChartImageUrls, src/lib/liveview/chartImages.ts): displayValue, displayChange/displayChangeColor ou displayStatus/displayStatusColor, displaySummary e displayNotice para um medidor sem número. Todo outro gráfico recebe chartTable, a tabela sempre visível como JSON {headers, rows}, lida da mesma marcação.
<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>
Medidor
O medidor é o único gráfico sem tabela: o valor e a zona são texto ao lado do mostrador. Por padrão as zonas são crescentes: value <= goodMax é bom, <= warningMax atenção, e todo o resto crítico, nas cores de status do tema. Com higherIsBetter, value >= goodMin é bom, >= warningMin atenção e tudo abaixo crítico; a imagem continua desenhando três faixas crescentes (gaugeSpecBands em src/lib/charts/gauge.ts passa warningMin e goodMin com as cores boa e crítica trocadas), então o formato assinado não muda. As três props não têm padrão, então um medidor sem elas é enviado como antes. min >= max ou limites fora de ordem são ajustados em vez de recusados. Um valor que não se lê como número (uma merge tag não resolvida, por exemplo) escreve chart.emptyGauge no lugar do mostrador.
<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>
Tabela de classificação
Uma <table> simples, sem imagem. As linhas são ordenadas por Pontos do maior para o menor com uma ordenação estável, então os empates mantêm a ordem digitada; as três primeiras posições mostram 🥇🥈🥉. showDraws: false tira a coluna de empates do cabeçalho e de cada linha. highlightTeamName encontra um time sem diferenciar maiúsculas e minúsculas e deixa a linha dele em negrito e sombreada. Sem times, é escrito 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>