Referencia del marcado de los bloques
Esta página muestra lo que cada bloque interactivo pone en el HTML enviado y cómo llega a MailInApp la respuesta de un destinatario. Está escrita para desarrolladores y para quien exporta el HTML para enviarlo desde otra plataforma. La página de cada bloque describe lo que ven los destinatarios y lo que recibes. Los niveles en sí se explican en Cómo funcionan las alternativas.
Los ejemplos están recortados: la salida real lleva más estilos en línea, una o dos clases de modo oscuro y los colores de tu tema. Cada enlace apunta al token firmado de vista en vivo del destinatario (/v/[token]), que identifica el correo y, en un envío personalizado, al destinatario.
Cómo se registran las respuestas
Dos caminos llevan al mismo endpoint de registro y producen el mismo evento, así que los resultados nunca dependen de dónde respondió un destinatario.
- Enlaces de confirmación. Una respuesta de un toque es un
<a href>hacia/v/[token]/actcon el bloque, la acción y el valor en la consulta. La página que abre pide al destinatario que confirme, y es el envío del formulario de confirmación el que registra la respuesta. Un GET simple no registra nada, así que los escáneres de enlaces y las herramientas de seguridad que precargan cada enlace no pueden votar. Consulta Registro de interacciones a prueba de escáneres. - Envíos de formulario. Un bloque con respuestas escritas o múltiples envía un
<form method="post">que publica en/api/interactionscomoapplication/x-www-form-urlencoded. Gmail en la web y las apps de Outlook para iOS y Android lo envían desde el correo. Cada formulario de este tipo lleva además un enlace Responder en la web, siempre visible, al mismo bloque en la vista en vivo, donde es un formulario web normal.
La respuesta de un destinatario se guarda una vez por correo, bloque y destinatario, con un id de documento formado por los tres, así que un toque repetido o una página recargada no cambia nada. Las respuestas de un correo exportado sin token de destinatario no tienen persona a la que asociarse, así que se limitan por IP, por campaña y por minuto.
Bloques de comentarios
Encuesta
Cada opción es un enlace de confirmación con estilo de chip. Siempre es visible, en cualquier app de correo.
<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 Permitir varias respuestas, la encuesta envía un formulario de casillas que publica un optionId por cada opción marcada (guardados como listas paralelas option y optionId), más el enlace Responder en la web. Una opción Otro es un enlace a la encuesta en la vista en vivo, donde el destinatario escribe su respuesta. El orden de una encuesta mezclada se deriva del token del destinatario, así que es el mismo en cada apertura. La Imagen de resultados en directo es un <img> de /api/results-image, firmado por opción de la encuesta, nunca por destinatario.
Valoración
La forma predeterminada Estrellas envía un enlace de confirmación por estrella, la más alta primero, en una fila de derecha a izquierda. Cada enlace contiene una estrella vacía y una rellena; una regla :hover rellena las estrellas hasta el puntero donde la app lo admite, y en las demás se ven las estrellas vacías. Las imágenes de las estrellas vienen de /api/rating-icon.
<div id="em-rating-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">How did we do?</p>
<div dir="rtl" style="direction:rtl;text-align:left;line-height:0">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rating-1&blockType=rating&action=rate&rating=5"
class="em-rating-1-s" aria-label="5 out of 5 stars" style="display:inline-block;padding:6px;line-height:0">
<img src="https://mailinapp.com/api/rating-icon?f=0&c=f59e0b&s=32" alt="5★" width="32" height="32" class="em-rating-1-o">
<!--[if !mso]><!-->
<img src="https://mailinapp.com/api/rating-icon?f=1&c=f59e0b&s=32" alt="" width="32" height="32" class="em-rating-1-f" style="display:none">
<!--<![endif]-->
</a>
<!-- …un enlace por estrella, hasta rating=1 -->
</div>
</div>
Las demás formas (caras emoji, pulgares, escala numerada, NPS y las fichas de estrellas clásicas) son una fila de enlaces de confirmación con rating=<n>. Cuando la puntuación es igual o inferior al umbral de seguimiento del bloque, la página de confirmación continúa hacia /v/[token]/followup.
Cuestionario
El cuestionario envía un formulario con un grupo de radios por pregunta, que publica q0, q1… (la posición de la pregunta al crearla) en /api/interactions, más el enlace Responder en la 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 grupo de radios por pregunta y un botón "See my score" -->
<p style="margin:8px 0 0;font-size:13px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci...#em-quiz-1">Answer on the web</a>
</p>
</div>
La puntuación se calcula en el servidor, con las respuestas correctas del correo guardado; nunca se acepta una puntuación enviada por un cliente. El valor del evento es {answers, score, total, bucket} en un cuestionario con puntuación y {answers, outcome, outcomeTitle} en uno de personalidad. Con Mostrar enseguida si es correcta, la etiqueta de cada respuesta lleva una nota oculta que una regla :checked muestra, así que las respuestas correctas están en el HTML enviado. Una pantalla de portada mantiene las preguntas tras un ancla :target en la vista en vivo.
Formulario
Un formulario de una página envía todos los campos en un <form> que publica en /api/interactions, más el enlace Responder en la web.
<div id="em-form-1" style="margin:12px 0;background-color:transparent">
<!-- <form method="post" action="https://mailinapp.com/api/interactions">:
todos los campos y un botón de envío -->
<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 formulario de varias páginas no envía campos, solo un enlace con estilo de botón con su Etiqueta del botón de inicio, hacia el asistente de encuestas en /v/[token]/form/[blockId]. Allí cada página guarda un borrador (una acción form-page que no toca los resultados ni los webhooks), y el submit de la última página convierte el borrador en la respuesta. Con Pasos en el correo, las páginas se envían como un radio por página antes del formulario y reglas :checked que muestran una página cada vez; las apps sin esas reglas muestran todas las páginas. Un campo de archivo enlaza a la vista en vivo, ya que un archivo solo puede añadirse desde un navegador. Las preguntas condicionales se muestran todas en el formulario enviado; el servidor descarta las respuestas a preguntas que las respuestas anteriores del destinatario ocultan.
El servidor comprueba cada respuesta con el formulario del correo guardado antes de escribir nada. Un navegador que envió una respuesta no válida vuelve a /v/[token]?invalid=<fieldId>&why=<problem>, y una llamada JSON recibe un 400 invalid-answer.
Bloques de tienda y reseñas
Los enlaces de estos bloques pasan por /v/[token]/click, que registra el clic y redirige al destino. Las repeticiones del mismo enlace firmado en cinco minutos cuentan una vez.
Cuenta atrás
La cuenta atrás es una sola <img> de /api/countdown. Su URL va firmada sobre el final y el color, y cada descarga dibuja un GIF nuevo de 60 fotogramas a partir del tiempo restante, uno por segundo, que luego se queda en su último fotograma. Las solicitudes firmadas idénticas comparten un renderizado durante diez segundos como máximo. El texto alt lleva el tiempo restante en palabras para los lectores de pantalla y las aplicaciones que cargan las imágenes 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>
Un final por contacto (Un tiempo después del envío o Una fecha de los datos del contacto) se calcula al enviar y se guarda en la fila del destinatario como countdown_ends_<blockId> y en su token de vista en vivo, para que cada apertura muestre el mismo final. Una cuenta atrás que ya terminó al renderizar envía su mensaje de final como texto en lugar de la imagen. Los clics llevan el final del destinatario, así que el acumulado de la cuenta atrás cuenta cada clic antes o después de la fecha límite propia de ese destinatario.
Producto
Con el proceso de pago de MailInApp, Comprar ahora es un enlace de confirmación a /v/[token]/act?action=buy. La página de confirmación vuelve a leer el producto del correo guardado, y su POST crea la sesión de Stripe Checkout a través de /api/checkout; un GET sin más no crea nada. El precio, el nombre y el inventario salen siempre de la copia del servidor. Un pedido pasa a pagado solo con el webhook firmado de Stripe, que vuelve a comprobar el inventario en una transacción y reembolsa un pago que superaría las existencias. Con un Inventario configurado, la tarjeta lleva una insignia de existencias de /api/product-status, redibujada como mucho una vez por minuto a partir de las unidades pagadas.
<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 Enlace al proceso de pago de una tienda externa, Comprar ahora es un enlace de clic a la página del producto (con ?variant= para una variante de Shopify importada), o a un enlace de descuento propio de cada destinatario, creado al enviar cuando Descuento propio del producto está activado.
Las variantes envían un botón de opción oculto por valor de opción antes del precio, una fila de chips (.pv-opts, <label for> sobre los botones de opción) y un panel por variante (.pv-panels) con su precio y su enlace de compra. Reglas de la forma #<id>-a<i>:checked:not(:disabled) ~ … muestran los chips y el panel de la variante elegida, y ocultan .pd-price y .pv-list. Donde esas reglas no se aplican, se muestran el precio y .pv-list: un enlace por variante, cada uno para comprar esa variante (&variant=<variantId>). Las imágenes adicionales usan las miniaturas de la galería de imágenes, con pequeñas imágenes enlazadas como alternativa. Guardar para más tarde es un enlace de confirmación con action=save, registrado una vez por 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>
Cuadrícula de productos
La cuadrícula es una tabla de tarjetas, cada una con su propia tabla con borde, con celdas que se apilan en el móvil. El botón de cada tarjeta es un enlace de clic bajo el id de la propia tarjeta (blockType=product-card). Los precios y las variantes por defecto de las tarjetas importadas se leen del catálogo sincronizado al renderizar.
<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 Añadir al carrito, el botón de una tarjeta del carrito enlaza en su lugar a la página del carrito /v/[token]/cart/[blockId]?add=<cardId>. Esa página, y la cuadrícula de la vista en vivo, envían los ids item elegidos y qty_<cardId> a /api/cart, que lee las tarjetas y la tienda del correo guardado y redirige al enlace permanente del carrito de Shopify o al enlace de pago de WooCommerce. El pago se registra como un clic en la cuadrícula, con las tarjetas y cantidades elegidas en su valor.
Cupón
El código es texto plano en un recuadro con user-select:all, así que un toque o un doble clic lo selecciona entero. El botón a la tienda es un enlace de clic. En la vista en vivo, la bandeja de entrada y la app, el recuadro es un <button data-copy> que copia el 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>
Un código de una etiqueta de combinación se resuelve para cada destinatario; si queda vacío, el bloque no se renderiza.
Reseñas de la tienda
Las reseñas de la tienda son texto estático: las estrellas son caracteres con un aria-label, y el texto de cada reseña lleva dir="auto". Las reseñas se eligen al renderizar entre las storeReviews sincronizadas y nunca se guardan en el árbol del correo. Con Un producto, el enlace «Leer todas las reseñas» es un enlace de clic a la página del producto.
<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 en vivo, la bandeja de entrada y GET /api/v1/liveview/[token] vuelven a leer las reseñas en cada apertura.
Bloques de eventos
RSVP y Reserva de reuniones registran mediante enlaces de confirmación, como los bloques de comentarios. El botón para unirse de un enlace de reunión y el botón Inscribirme de un registro a webinar son enlaces de clic que pasan por /v/[token]/click, como los enlaces de los bloques de tienda.
Enlace de reunión
La línea de estado («Empieza en …», o «En directo» una vez pasado el inicio) se escribe al renderizar el correo. Debajo, una <img> de /api/countdown, firmada como la del bloque Cuenta atrás, dibuja el tiempo que falta cada vez que se abre el correo. En el correo, el botón para unirse es siempre un enlace de clic activo.
<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 en vivo, la bandeja de entrada y la app móvil muestran el botón para unirse solo desde El enlace para unirse se abre antes del inicio minutos antes de startsAt, calculado a partir de las propiedades del bloque al renderizar, sin estado guardado. Hasta entonces muestran un chip inactivo «Se abre N minutos antes del inicio». Un bloque sin startsAt está siempre abierto.
RSVP
Cada respuesta es un enlace de confirmación con response=yes, no o maybe. Con Permitir acompañantes, Sí lleva a la vista en vivo, donde el destinatario elige el número de acompañantes. Mostrar cuántos asistirán añade una <img> de /api/rsvp-count, firmada por bloque, color y ancho, nunca por destinatario, y dibujada a partir del acumulado del RSVP al abrirse.
<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>
La comprobación del aforo y la deduplicación por destinatario se ejecutan en una sola transacción de Firestore, así que las plazas nunca se venden de más: un sí por encima del aforo se registra como waitlisted, un no como declined, un quizás como maybe sin plaza. Las preguntas tras un sí se envían como un submit sobre el id del bloque seguido de __details, que el servidor solo acepta de un destinatario cuya respuesta registrada es un sí, y comprueba como las respuestas de un formulario.
Reserva de reuniones
Las horas son los próximos huecos libres del tipo de reserva, calculados al renderizar el correo y rotulados en la zona horaria del tipo de reserva. En el correo, cada hora es un enlace de confirmación con action=book&slot=<epoch ms>, y Ver más horarios abre la página de reserva en 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>
Con Mostrar los días como pestañas, un radio oculto por día (#<id>-d<i>) va antes de una barra de pestañas (.bk-bar), y reglas de la forma #<id>-d<i>:checked:not(:disabled) ~ … muestran el panel de un día (.bk-p). Donde esas reglas no se aplican, cada panel aparece bajo el encabezado de su día (.bk-dh). En la vista en vivo, la bandeja de entrada y la app, las horas son chips de radio en un único formulario que envía action=book con el slot elegido a /api/interactions.
Antes de reservar, el servidor vuelve a leer la disponibilidad del calendario y reclama el hueco en una transacción, así que un hueco se reserva una sola vez. Un destinatario se reserva como su propio contacto, una vez por bloque. Un token sin contacto detrás se envía a la página de reserva, que pide un nombre y un correo tras una verificación antibots.
Registro a webinar
La tarjeta es la misma en todas partes. La fecha se formatea en la zona horaria del bloque con la zona indicada, e Inscribirme es un enlace de clic a la página pública de la sesión /webinar/<liveSessionId>, construida a partir del id de la sesión sin ninguna consulta al enviar.
<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>
Los registros los guarda la página de la sesión, así que el bloque solo registra el clic.
Bloques de escaparate
Estos bloques no registran ninguna respuesta. Cada uno envía su contenido en una forma que se lee bien por sí sola y luego añade reglas :checked que la convierten en la versión interactiva donde la aplicación de correo las ejecuta. Las reglas están en el <style> del <head>, y los campos en los que se apoyan van envueltos en <!--[if !mso]><!-->, así que el Outlook clásico nunca los ve.
Dos patrones cubren los siete:
- Grupos de radios (carrusel, pestañas, galería de imágenes): un radio oculto por diapositiva, pestaña o imagen antes del contenido, con etiquetas
foresos radios como puntos, barra de pestañas o miniaturas. Cada regla se escribe#<radio>:checked:not(:disabled) ~ …. Una aplicación que elimina los campos no cumple ninguna, y la alternativa se queda. - Interruptores de casilla (acordeón, antes / después, puntos sobre imagen, menú): una casilla de control
#<id>-ksiempre marcada antes del bloque, y el interruptor#<id>-tdentro del<label>que se toca. Las reglas que ocultan algo parten de#<id>-k:checked, así que una aplicación que elimina el control lo muestra todo.
Los enlaces de estos bloques pasan por /v/[token]/click, como cualquier otro enlace.
Carrusel
Cada diapositiva se dibuja dos veces: una en .carousel-fallback (la primera diapositiva y el enlace Ver las N diapositivas, o todas las diapositivas en una tabla .carousel-grid) y otra como un .lv-frame oculto que muestran las reglas de un radio. La franja .lv-px carga una baliza de vista de diapositiva, /v/[token]/nv/<blockId>/<slide>, desde la regla de cada diapositiva después de la primera; así cuenta Insights a los destinatarios que pasaron de la primera diapositiva.
<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)}
Las flechas son etiquetas for los radios vecinos dentro de cada marco. Las miniaturas sustituyen los puntos por etiquetas .lv-tn. La reproducción automática añade un radio más, marcado primero, cuyas reglas mueven los marcos a lo largo de una .lv-track con una animación @keyframes dentro de @media (prefers-reduced-motion:no-preference); elegir una diapositiva lo desmarca. El precio y el botón de una diapositiva forman parte de ella, así que también aparecen en la alternativa, y el botón enlaza al href propio de la diapositiva.
Acordeón
El contenido de cada elemento va dentro de su <label>, después del interruptor, así que aparece en cualquier sitio donde las reglas no se ejecutan. En la vista en vivo, la bandeja de entrada y el lienzo, cada elemento es en cambio 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}
Pestañas
Los bloques de cada pestaña se escriben una sola vez, en un panel .tb-p que empieza con el título de la pestaña como encabezado .tb-h. Esos paneles apilados son la alternativa. Las reglas de los radios muestran la .tb-bar, ocultan los encabezados y muestran un panel.
<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 / después
Las dos imágenes van dentro de un <label>, cada una bajo su etiqueta. Las reglas del control ocultan la imagen de después y muestran la pista; el interruptor intercambia las dos.
<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}
Puntos sobre imagen
Los puntos se colocan solo mediante reglas detrás del control, nunca con un position en línea (que Gmail elimina). Cada punto es un <label> alrededor de su propia casilla y su nota. La .hs-legend numerada bajo la imagen es la alternativa, y las reglas del control la ocultan.
<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 se abre hacia la izquierda o la derecha y hacia arriba o abajo según dónde esté su punto: más allá del 60 % en horizontal o del 65 % en vertical.
Galería de imágenes
La primera imagen está siempre en .gl-main; las demás son marcos ocultos allí. .gl-fallback las muestra en pequeño, cada una enlazada a la vista en vivo, y las reglas de los radios la cambian por la fila .gl-thumbs de etiquetas. El bloque de producto dibuja sus imágenes adicionales con las mismas piezas.
<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}
Menú
Los enlaces forman una .mn-row, cada uno un enlace de clic con su propio espacio (blockType=menu-item), así Insights nombra cada enlace. La .mn-bar y las reglas que pliegan la fila van dentro de @media only screen and (max-width:620px) con En teléfonos, o en el nivel superior con Siempre.
<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}
}
Bloques de juegos
Los tres juegos comparten una misma forma. Una casilla de verificación de control #<id>-k, siempre marcada, va antes de un <label> que contiene una radio, la cubierta (.sc-surface, o la ruleta .stw-wheel con su botón .stw-go) y el premio (.sc-prize, .stw-prize). Las reglas del control muestran la cubierta y ocultan el premio. Tocar la etiqueta marca la radio, cuyas reglas ocultan la cubierta y muestran el premio.
Una radio, no una casilla, para que un segundo toque no vuelva a ocultar el premio. Las entradas van dentro de <!--[if !mso]><!-->, y una app que elimina el control muestra lo que queda fuera de las reglas.
Cada bloque registra un reveal. En el correo, la regla de la radio carga una baliza de revelación, /v/[token]/rv/<blockId>, como fondo de una franja de 4px (.sc-px, .stw-px), y la vista en vivo envía la revelación desde su script en línea. Los enlaces de premio pasan por /v/[token]/click.
Premios. Con hijos game-prize, el servidor elige el premio de cada destinatario antes de generar el correo: una elección ponderada cuya semilla es un HMAC del proyecto, el bloque y el destinatario, registrada una sola vez en gamePrizes/{projectId}_{blockId}_{recipient} con su código. El resultado viaja en la fila del destinatario como prize_<blockId>, prize_label_<blockId>, prize_code_<blockId> y prize_url_<blockId>, así que el correo, la vista en vivo, la bandeja de entrada y la app muestran un mismo premio.
El panel del premio queda entonces solo en la parte interactiva, y un enlace Descubrir mi premio a la vista en vivo (.stw-reveal, .sc-reveal) queda fuera, oculto por la regla del control. Un correo generado sin resultado en la fila (una exportación, una asignación fallida) muestra solo ese enlace, y la vista en vivo asigna el premio. El evento de revelación lleva el premio registrado, nunca uno enviado.
Ruleta de premios
La ruleta es un conic-gradient de 240px con una casilla igual por premio, rotulada en blanco con sombra para que el modo oscuro la deje legible. Sus @keyframes la giran en 3,2 segundos hasta el ángulo del premio del destinatario, y después aparece el panel del premio. El Outlook clásico recibe el enlace de revelación como botón 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)}}
Sin premios, la ruleta es un 🎡 de 64px que da dos vueltas en 0,9 segundos y descubre un botón con seguimiento al Enlace del premio. Un segundo botón al mismo enlace, Descubre tu premio, queda fuera de la parte interactiva para cualquier otra app (un enlace a la vista en vivo si el enlace del premio está vacío). La vista en vivo muestra el título y el botón del premio.
Rasca y gana
Sin premios, el premio queda fuera de la parte interactiva, así que una app que elimina las reglas lo muestra enseguida. La cubierta es un <span> con display:none que solo muestra la regla del control: franjas plateadas, el Color de la cubierta o un <img> para la Imagen de portada (nunca un url() de CSS). El Botón para descubrir añade un span .sc-go dentro de la etiqueta.
<div id="em-scratch-card-g1" style="text-align:center">
<p style="font-weight:700;font-size:18px">Scratch to reveal your prize!</p>
<!--[if !mso]><!-->
<input type="checkbox" id="em-scratch-card-g1-k" checked hidden style="display:none">
<!--<![endif]-->
<label style="display:block;cursor:pointer">
<!--[if !mso]><!-->
<input type="radio" id="em-scratch-card-g1-scratch" hidden aria-label="Scratch to reveal the hidden reward" style="display:none">
<span class="sc-surface" style="display:none;padding:24px;border-radius:8px;
background:repeating-linear-gradient(45deg,#9ca3af,#9ca3af 10px,#d1d5db 10px,#d1d5db 20px)">Scratch here</span>
<div class="sc-px" style="height:4px"> </div>
<!--<![endif]-->
<div class="sc-prize" style="margin-top:10px">
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=scratch-card-g1&blockType=scratch-card&dest=…&sig=…">🎉 20% off your next order!</a>
</div>
</label>
</div>
#em-scratch-card-g1-k:checked ~ label #em-scratch-card-g1-scratch{display:block!important;position:absolute;width:1px;height:1px;opacity:0}
#em-scratch-card-g1-k:checked ~ label .sc-surface{display:block!important}
#em-scratch-card-g1-k:checked ~ label .sc-prize{display:none!important}
#em-scratch-card-g1-scratch:checked ~ span.sc-surface{display:none!important}
#em-scratch-card-g1-scratch:checked ~ div.sc-prize{display:block!important}
#em-scratch-card-g1-scratch:focus ~ .sc-surface{outline:3px solid #4f46e5;outline-offset:2px}
#em-scratch-card-g1-scratch:checked ~ .sc-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../rv/scratch-card-g1)}
La regla del control convierte la radio en un elemento enfocable de 1px, y así Tab llega a la tarjeta y la barra espaciadora la descubre. Con Botón debajo de la tarjeta, el botón con seguimiento va después del </label>, fuera de toda regla, así que se ve antes y después del raspado.
Caja sorpresa
El marcado y las reglas del rasca y gana, con una caja de regalo como cubierta: un 🎁 de 72px (o la Imagen de la caja) y el texto para tocar. Una regla más hace que la caja se mueva mientras está cerrada.
<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)}}
Bloques de aprendizaje
El mazo de tarjetas no registra nada. La tarea registra una entrega por destinatario.
Mazo de tarjetas
Cada tarjeta tiene la forma de antes / después: una casilla de control #<card>-k siempre marcada, y luego un <label> que contiene la casilla propia de la tarjeta #<card>-f, el anverso .fc-front y el reverso .fc-back. Las reglas del control ocultan el reverso y las etiquetas de cada cara .fc-l. Marcar la casilla de la tarjeta oculta el anverso y muestra el reverso.
Cada regla nombra :checked, así que una aplicación que las descarta muestra el anverso y el reverso uno encima del otro, el reverso bajo una línea discontinua, y cada cara empieza con su etiqueta («P: » y «R: », en el idioma del correo). Una tarjeta que ya empieza con su etiqueta la conserva una sola vez. Una tarjeta con imagen solo en el anverso conserva 200px de altura al girarse, para que el mazo no se mueva bajo el dedo del lector. La vista en vivo dibuja el mismo marcado, y la parte de texto plano escribe cada tarjeta en dos líneas.
<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}
Tarea
La fecha de entrega es la imagen del bloque de cuenta atrás, /api/countdown firmada para el plazo, bajo una línea «Entrega». El correo no escribe el tiempo restante, ya que se lee después de generarse, y el texto alternativo de la imagen dice «Tiempo que queda para la entrega». Un correo generado después del plazo dice «Vencido» en su lugar. La vista en vivo escribe el tiempo restante («Vence en 2 d 4 h 10 min»). Los enlaces a recursos son enlaces simples, y Puntos añade «(10 pts)» al título.
Marcar como hecho es una opción como la de una encuesta: en el correo, un enlace a /v/[token]/act?action=complete, donde el lector confirma. Una respuesta de texto corta o con enlace es un <form> que envía action: "submit-answer" con answer (un <textarea> de tres líneas o un <input type="url">) a /api/interactions, dentro de <!--[if !mso]>, con un enlace Responder en la web a la vista en vivo (#em-<id>) debajo en todas las aplicaciones.
Una entrega se deduplica por destinatario como un voto, y la vista en vivo la vuelve a leer: «Marcado como hecho ✓», o «Entregado ✓» con la respuesta. Una entrega posterior a dueAt se registra como cualquier otra, e Insights lee si llegó a tiempo o con retraso a partir de su hora (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>
Bloques de contenido
Estos bloques no registran respuestas. Vídeo, Audio, Lugar y Añadir al calendario son espacios de clic: en un envío personalizado, cada enlace pasa por /v/[token]/click?blockId=…&blockType=…&dest=…&sig=…, que registra un click en el bloque y redirige a dest. Un correo exportado sin token de destinatario enlaza directamente al destino. El marcado enviado es el mismo en cualquier aplicación de correo; solo la vista en vivo cambia, para el vídeo y el audio.
Vídeo y audio
El correo dibuja una imagen dentro del enlace de clic: la portada como un <img> sencillo cuyo alt es la descripción o, sin ella, un panel oscuro con ▶ o ♪, la descripción y, en un vídeo, la duración como M:SS. El ancho, el relleno, el borde y el fondo del bloque van en el <div> exterior, así el panel conserva su propio relleno.
La vista en vivo y la bandeja de entrada de MailInApp dibujan un <video controls> con la portada como poster, o un <audio controls> bajo el <img> de la portada, cada uno con la descripción como aria-label. La app móvil abre el archivo. Un bloque sin src no 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
La fórmula es un PNG de GET /api/formula. La notación (recortada a 300 caracteres), el modo de visualización y el color van serializados en la consulta firmada, así que el endpoint no lee nada de Firestore y responde con una cabecera de caché inmutable; lo sirve el worker de borde. El emisor maqueta la fórmula una vez para escribir el width y el height del <img>, de modo que el correo no se recoloca al cargar, y la maquetación reduce la escala para quedarse dentro del presupuesto de tamaño de la imagen. El alt es la propia notación, igual que la parte de texto plano.
El analizador es propio de MailInApp (no hay motor TeX): una macro desconocida se dibuja como su texto literal y el renderizador nunca lanza un error, así que una fórmula nunca detiene un envío. \ce{…} pone en subíndice los números de elementos, en superíndice las cargas finales y dibuja -> como una flecha. Una notación vacía no emite nada. El correo, la vista en vivo y la bandeja de entrada dibujan la misma imagen; solo cambia el origen de la 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>
Lugar
La foto, el nombre y la dirección son HTML sencillo, y la dirección conserva sus saltos de línea. El enlace de indicaciones es el Enlace de Google Maps tal como se pegó; si no, https://maps.google.com/?q=<lat>,<lng> cuando las coordenadas no son cero y están en rango; si no, https://maps.google.com/?q=<dirección>. No interviene ninguna clave de la API de Maps. Sin ninguno de los tres, no se dibuja botón. El botón es el botón a prueba de balas que usan todos los bloques: un v:roundrect VML para el Outlook clásico y un <a> con mso-hide:all para el resto, ambos a través del espacio de clic.
<div style="margin:12px 0">
<img src="https://example.com/venue.jpg" alt="Grand Hall" style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px" />
<p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Grand Hall</p>
<p style="margin:0 0 10px;font-size:14px;color:#4b5563">123 Main St, Springfield</p>
<!--[if mso]><v:roundrect href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&…" …><center>Get Directions</center></v:roundrect><![endif]-->
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&blockType=venue&dest=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D123%2520Main%2520St%252C%2520Springfield&sig=…"
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600;mso-hide:all">Get Directions</a>
</div>
Añadir al calendario
Los tres botones se dibujan solo con un Empieza el válido; un final que falta o que es anterior al inicio pasa a una hora después. El título, la descripción y la ubicación se recortan a 200, 2.000 y 300 caracteres antes de construir ningún enlace, así los tres siempre coinciden. Los tres comparten el único espacio de clic del bloque.
- Descargar .ics es
GET /api/calendar, con todo el evento firmado en la consulta (un HMAC sobre una entrada con el prefijocalendar:, así que ninguna otra familia de URL firmadas se verifica aquí, y sin lectura de Firestore). Devuelve un archivo RFC 5545 conDTSTART/DTENDcomo instantes UTC (unaZfinal, sinVTIMEZONE), de modo que cada calendario muestra la hora propia del invitado. ElUIDes un SHA-256 de los campos del evento, así que volver a guardarlo actualiza una sola entrada. El texto se escapa según el §3.3.11 y las líneas se pliegan a 75 octetos. - Añadir a Google Calendar es un enlace
calendar.google.com/calendar/render?action=TEMPLATE&…y Añadir a Outlook.com un enlaceoutlook.live.com/calendar/0/action/compose?…, ambos construidos al renderizar.
Con Mostrar solo tras un sí (afterRsvp), el correo no emite nada; la vista en vivo, la bandeja de entrada y la app móvil emiten el bloque en cuanto el RSVP registrado del destinatario en el correo es confirmed. El lienzo del estudio, que no tiene el secreto del servidor, dibuja el botón .ics con un enlace #.
<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>
Bloques de gráficos
Los gráficos, la tarjeta de KPI y la clasificación no registran nada ni llevan enlaces. El correo, la vista en vivo y la bandeja de entrada de MailInApp escriben el mismo marcado; solo cambia el origen de la URL de la imagen. Cada palabra que añaden (encabezados de tabla, las zonas del indicador, las columnas de la clasificación, la porción Otros) viene de emailBlocks.json chart.* y standings.* en el idioma del correo.
- La imagen. Cada gráfico, y el minigráfico de la tarjeta, es un PNG de
GET /api/analytics/chart?d=…&s=…&r=2.des toda la especificación del gráfico (tipo, tamaño, etiquetas, valores, colores) como JSON en base64url,ssu HMAC sobreLIVEVIEW_SECRETyrla densidad de píxeles. El endpoint no lee nada de Firestore, así que una respuesta es una función pura de su consulta firmada y lleva una cabecera de caché inmutable; el edge worker la dibuja y la sirve. Se rechaza una especificación de más de 6.000 caracteres o que supere los límites de un gráfico. Las etiquetas se recortan a la longitud de etiqueta de la especificación antes de firmar. - Texto junto a la imagen. El
altdel<img>nombra el gráfico y da cada valor dibujado («Bar chart: North (Revenue 12,400); …»). Todos los gráficos salvo el indicador añaden después una<table aria-label="<título>">siempre visible con las mismas cifras, con una leyenda donde el gráfico la necesita (varias series, porciones, recuadros o una escala de color). La tabla da lo que dibuja la imagen, salvo la del Sankey, que da cada flujo escrito. - Gráficos vinculados. La tarjeta de KPI y los gráficos de barras, líneas y circular admiten un
binding. Una vinculación de fuente de datos se agrupa porgroupByFieldy se agrega por serie (sum,avg,count,latest;src/lib/charts/aggregate.ts) sobre las filas de la vinculación, tras elfilterdel bloque, cuyos valores pueden llevar etiquetas de combinación del destinatario. Una vinculación@response:lee el resumen de resultados del proyecto (src/lib/charts/responseSource.ts). Ambas se resuelven al renderizar: en el correo al enviarse, en la vista en vivo en cada carga. Un filtro con una etiqueta del destinatario da una especificación, y por tanto una URL de imagen, por destinatario. - Sin datos. Un gráfico sin filas utilizables escribe su título y un aviso (
chart.emptyRowsy sus variantes) en lugar de la imagen, así que un bloque a medio hacer nunca detiene un envío.
| Gráfico | Columnas de la tabla | Límites |
|---|---|---|
| Barras, líneas, radar | Categoría, luego una por serie con nombre | 24 categorías, 3 series; radar de 3 a 8 ejes |
| Circular, mapa de árbol | Categoría, Valor, Porcentaje | 8 porciones: las 7 más grandes y Otros |
| Dispersión | Serie, X, Y, y Tamaño en un gráfico de burbujas | 120 puntos, 8 series |
| Histograma | Rango, Recuento | 500 valores, de 2 a 20 intervalos |
| Mapa de calor | Fila, Columna, Valor (solo celdas escritas) | 12 filas × 24 columnas |
| Embudo | Etapa, Valor, % de la primera, % de la anterior | 8 etapas |
| Cascada | Etiqueta, Valor, Tipo, Total acumulado | 8 barras |
| Sankey | Desde, Hasta, Valor | 12 nodos, 24 enlaces |
Una fila que supera un límite se descarta, nunca se fusiona, salvo las porciones más pequeñas del circular y del mapa de árbol. El embudo y la cascada conservan el orden escrito, que es su significado.
Gráficos con tabla
<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>
Tarjeta de KPI
La etiqueta, el valor (con formato de número, dólares estadounidenses o porcentaje) y el cambio son texto. El cambio aparece solo con previousValue y trendDirection definidos: el porcentaje se calcula a partir de los dos valores, y la flecha y su color de estado (al alza verde, a la baja rojo, estable ámbar) siguen la dirección escrita. La imagen del minigráfico necesita al menos dos puntos y admite hasta 60; su color sigue el de la flecha. Una línea atenuada repite el resultado como texto para los lectores de pantalla y la parte de texto plano.
GET /api/v1/liveview/[token] entrega a la app móvil estas palabras como props añadidas, calculadas por los mismos kpiDisplay/gaugeDisplay que usa el correo (attachChartImageUrls, src/lib/liveview/chartImages.ts): displayValue, displayChange/displayChangeColor o displayStatus/displayStatusColor, displaySummary y displayNotice para un indicador sin número. Cada otro gráfico recibe chartTable, la tabla siempre visible como JSON {headers, rows}, leída del mismo marcado.
<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>
Indicador
El indicador es el único gráfico sin tabla: su valor y su zona son texto junto al dial. Por defecto las zonas son ascendentes: value <= goodMax es bien, <= warningMax atención, y todo lo demás crítico, en los colores de estado del tema. Con higherIsBetter, value >= goodMin es bien, >= warningMin atención y todo lo de abajo crítico; la imagen sigue dibujando tres bandas ascendentes (gaugeSpecBands en src/lib/charts/gauge.ts le pasa warningMin y goodMin con los colores bueno y crítico intercambiados), así que el formato firmado no cambia. Las tres props no tienen valor por defecto, así que un indicador sin ellas se envía como antes. min >= max o umbrales desordenados se ajustan en lugar de rechazarse. Un valor que no se lee como número (una etiqueta de combinación sin resolver, por ejemplo) escribe chart.emptyGauge en lugar del dial.
<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>
Clasificación
Una <table> simple sin imagen. Las filas se ordenan por Puntos de mayor a menor con un orden estable, así que los empates mantienen el orden escrito; los tres primeros puestos muestran 🥇🥈🥉. showDraws: false quita la columna de empates del encabezado y de cada fila. highlightTeamName encuentra un equipo sin distinguir mayúsculas y pone su fila en negrita y sombreada. Sin equipos se escribe 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>