模块标记参考
本页说明每个互动模块会在发送的 HTML 中写入什么,以及收件人的回答如何到达 MailInApp。它面向开发者,以及导出 HTML 并通过其他平台发送的用户。收件人看到什么、你能得到什么,在各模块自己的页面中说明。各层级本身在降级机制如何工作中解释。
示例经过精简:实际输出包含更多内联样式、一两个深色模式类以及你的主题颜色。每个链接都指向收件人的签名实时预览令牌(/v/[token]),它标识这封邮件,在个性化发送中还标识收件人。
回答如何被记录
两条路径通向同一个记录端点,并产生相同的事件,因此结果从不取决于收件人在哪里作答。
- **确认链接。**一键作答是一个指向
/v/[token]/act的<a href>,查询参数中带有模块、操作和值。打开的页面请收件人确认,由确认表单的提交来记录回答。单纯的 GET 不会记录任何内容,因此预先访问每个链接的链接扫描器和安全工具无法投票。参见防扫描器互动记录。 - **表单提交。**需要输入或多选的模块会发送一个
<form method="post">,以application/x-www-form-urlencoded提交到/api/interactions。网页版 Gmail 以及 iOS 和 Android 版 Outlook 应用会直接从邮件提交。每个这样的表单还带有一个始终可见的 在网页上回答 链接,指向实时预览中的同一模块,在那里它是一个普通的网页表单。
收件人的回答在每封邮件、每个模块、每位收件人下只保存一次,文档 ID 由这三者组成,因此重复点击或重新加载页面不会改变任何东西。来自没有收件人令牌的导出邮件的回答无法关联到具体的人,因此改为按 IP、按活动、按分钟限制次数。
反馈模块
投票
每个选项都是一个标签样式的确认链接,在任何邮件应用中都始终可见。
<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>
开启 允许多选 后,投票会以复选框表单发送,每个勾选的选项提交一个 optionId(保存为并列的 option 和 optionId 列表),并附上 在网页上回答 链接。其他 选项是指向实时预览中该投票的链接,收件人在那里输入答案。打乱顺序的投票,其顺序由收件人的令牌决定,因此每次打开都相同。实时结果图片 是来自 /api/results-image 的 <img>,按投票选项签名,从不按收件人签名。
评分
默认的 星级 方式为每颗星发送一个确认链接,从高分开始,按从右到左排列。每个链接包含一颗空心星和一颗实心星;在支持的应用中,:hover 规则会把星星点亮到指针所在位置,其他应用则显示空心星。星星图片来自 /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>
<!-- …每颗星一个链接,直到 rating=1 -->
</div>
</div>
其他方式(表情脸、赞或踩、数字量表、NPS 和经典星级标签)是一排带 rating=<n> 的确认链接。分数不高于模块的追问阈值时,确认页面会继续跳转到 /v/[token]/followup。
测验
测验以表单发送,每道题一组单选按钮,把 q0、q1……(题目创建时的位置)提交到 /api/interactions,并附上 在网页上回答 链接。
<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">:
每道题一组单选按钮,以及一个 "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>
计分在服务器上进行,依据已保存邮件中的正确答案;客户端发来的分数一律不予采用。事件的值在计分测验中是 {answers, score, total, bucket},在性格测试中是 {answers, outcome, outcomeTitle}。开启 立即显示对错 后,每个答案的标签里都有一条由 :checked 规则显示的隐藏说明,因此正确答案包含在发送的 HTML 中。封面会在实时预览中把题目放在一个 :target 锚点之后。
表单
单页表单把所有字段放在一个提交到 /api/interactions 的 <form> 中发送,并附上 在网页上回答 链接。
<div id="em-form-1" style="margin:12px 0;background-color:transparent">
<!-- <form method="post" action="https://mailinapp.com/api/interactions">:
所有字段和一个提交按钮 -->
<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>
多页表单不发送任何字段,只发送一个带 开始按钮文字 的按钮样式链接,指向 /v/[token]/form/[blockId] 的问卷向导。在向导中,每一页都会保存一份草稿(一个不影响结果和 Webhook 的 form-page 操作),最后一页的 submit 把草稿变成回答。开启 在邮件中分步显示 后,各页以表单前每页一个单选按钮的形式发送,并用 :checked 规则一次显示一页;不支持这些规则的应用会显示所有页面。由于文件只能在浏览器中添加,文件字段会链接到实时预览。条件问题在发送的表单中全部显示;对于被收件人之前的回答隐藏的问题,服务器会丢弃其回答。
服务器在写入任何内容之前,都会对照已保存邮件中的表单检查每个回答。提交了无效回答的浏览器会被送回 /v/[token]?invalid=<fieldId>&why=<problem>,JSON 调用则收到 400 invalid-answer。
商店与评价模块
这些模块中的链接都经过 /v/[token]/click,它会记录点击并重定向到目标地址。同一个签名链接在五分钟内重复访问只计一次。
倒计时
倒计时是一张来自 /api/countdown 的 <img>。它的网址对结束时间和颜色签名,每次加载都会根据剩余时间重新绘制一张 60 帧的 GIF,每帧一秒,之后停在最后一帧。完全相同的签名请求最多在十秒内共享一次渲染。alt 文本用文字写出剩余时间,方便读屏软件和图片加载较晚的应用。
<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>
按联系人计算的结束时间(发送后一段时间 或 联系人数据中的日期)在发送时算出,保存在收件人的行中(countdown_ends_<blockId>)以及他的实时预览令牌里,因此每次打开都显示同一个结束时间。渲染时已经结束的倒计时,会用文字发送结束提示,而不是图片。点击会带上收件人的结束时间,因此倒计时的汇总会按该收件人自己的截止时间,把每次点击计入结束前或结束后。
商品
使用 MailInApp 结账时,立即购买 是一个指向 /v/[token]/act?action=buy 的确认链接。确认页面会从已保存的邮件中重新读取商品,它的 POST 通过 /api/checkout 创建 Stripe Checkout 会话;单纯的 GET 不会创建任何东西。价格、名称和库存始终来自服务器上的副本。订单只有在收到 Stripe 签名的 webhook 后才会变为已付款,webhook 会在事务中再次核对库存,并退还会造成超卖的付款。设置了 库存 后,卡片上会带有来自 /api/product-status 的库存徽章,根据已付款件数最多每分钟重绘一次。
<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>
选择 链接到外部商店结账 时,立即购买 是指向商品页面的点击链接(导入的 Shopify 款式会带上 ?variant=),或在开启 单品折扣 时,指向发送时为每位收件人生成的专属折扣链接。
款式会在价格前面为每个选项值发送一个隐藏的单选按钮、一排标签(.pv-opts,即指向单选按钮的 <label for>),以及每个款式一个面板(.pv-panels),内含价格和购买链接。形如 #<id>-a<i>:checked:not(:disabled) ~ … 的规则会显示标签和所选款式的面板,并隐藏 .pd-price 和 .pv-list。在这些规则不生效的地方,会显示价格和 .pv-list:每个款式一个链接,分别购买该款式(&variant=<variantId>)。更多图片使用图片画廊的缩略图,并以带链接的小图作为替代。稍后再看 是带 action=save 的确认链接,每位收件人只记录一次。
<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>
商品网格
网格是一张由卡片组成的表格,每张卡片都是一张带边框的独立表格,单元格在手机上依次堆叠。每张卡片的按钮是使用卡片自身 ID 的点击链接(blockType=product-card)。导入卡片的价格和默认款式在渲染时从已同步的商品目录中读取。
<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>
开启 加入购物车 后,可放入购物车的卡片的按钮改为链接到购物车页面 /v/[token]/cart/[blockId]?add=<cardId>。该页面以及实时预览中的网格,会把所选的 item ID 和 qty_<cardId> 发送到 /api/cart,它从已保存的邮件中读取卡片和商店,再重定向到 Shopify 的购物车永久链接或 WooCommerce 的结账链接。结账会记录为一次网格点击,值中包含所选卡片和数量。
优惠券
优惠码是方框中的纯文本,带有 user-select:all,点按或双击即可选中全部。前往商店的按钮是点击链接。在实时预览、收件箱和应用中,方框是一个复制优惠码的 <button data-copy>。
<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>
来自合并标签的优惠码按收件人解析;解析为空时,不渲染该模块。
店铺评价
店铺评价是静态文本:星级是带 aria-label 的字符,每条评价的正文带有 dir="auto"。评价在渲染时从已同步的 storeReviews 中选出,从不保存在邮件的树中。选择 单个商品 时,“查看全部评价”链接是指向商品页面的点击链接。
<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>
实时预览、收件箱和 GET /api/v1/liveview/[token] 每次打开都会重新读取评价。
活动模块
出席回复和会议预约与反馈模块一样,通过确认链接记录。会议链接的加入按钮和网络研讨会报名的 立即报名 按钮,与商店模块的链接一样,是经过 /v/[token]/click 的点击链接。
会议链接
状态行(“…后开始”,开始后为“正在直播”)在邮件渲染时写入。它下方来自 /api/countdown 的 <img> 与倒计时模块的一样带签名,每次打开邮件时绘制剩余时间。在邮件中,加入按钮始终是有效的点击链接。
<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>
实时预览、收件箱和移动应用只在 startsAt 前 开始前多久开放加入链接 分钟起显示加入按钮。这在渲染时根据模块属性计算,不保存任何状态。在此之前显示一个不可用的“开始前N分钟开放”标签。没有 startsAt 的模块始终开放。
出席回复
每个回答都是带 response=yes、no 或 maybe 的确认链接。开启 允许携带同伴 时,“是”链接到实时预览,收件人在那里选择同伴人数。显示参加人数 会加入来自 /api/rsvp-count 的 <img>,按模块、颜色和宽度签名,从不按收件人签名,打开时根据出席回复的汇总绘制。
<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>
名额检查和按收件人去重在同一个 Firestore 事务中完成,所以名额绝不会超卖:超出名额的“是”记录为 waitlisted,“否”记录为 declined,“可能”记录为不占名额的 maybe。回复“是”之后的问题以 submit 发送到模块 ID 加 __details,服务器只接受已记录回答为“是”的收件人的提交,并像表单回答一样校验。
会议预约
时间是预约类型接下来的空闲时段,在邮件渲染时计算,并按预约类型的时区标注。在邮件中,每个时间都是带 action=book&slot=<epoch ms> 的确认链接,查看更多时间 打开实时预约页面 /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>
开启 以标签显示日期 后,每天一个隐藏的单选框(#<id>-d<i>)位于标签栏(.bk-bar)之前,形如 #<id>-d<i>:checked:not(:disabled) ~ … 的规则显示某一天的面板(.bk-p)。在这些规则不生效的地方,每个面板显示在其日期标题(.bk-dh)下。在实时预览、收件箱和应用中,时间是同一个表单里的单选标签,把所选的 slot 和 action=book 发送到 /api/interactions。
预约前,服务器会重新读取日历的空闲情况,并在事务中占用该时段,所以一个时段只会被预约一次。收件人以自己的联系人身份预约,每个模块一次。没有对应联系人的令牌会被引导到预约页面,在人机验证后填写姓名和邮箱。
网络研讨会报名
卡片在各处都一样。日期按模块的时区格式化并注明时区,立即报名 是指向场次公开页面 /webinar/<liveSessionId> 的点击链接,由场次 ID 生成,发送时无需查询。
<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>
报名由场次页面记录,所以模块本身只记录点击。
展示模块
这些模块不记录任何回答。每个模块都以本身就易读的形式发送内容,再加上 :checked 规则,在邮件应用能够执行的地方把它变成互动版本。规则位于 <head> 的 <style> 中,规则所依赖的输入元素包在 <!--[if !mso]><!--> 里,所以经典版 Outlook 看不到它们。
七个模块用两种结构写成:
- 单选组(轮播、选项卡、图片库):在内容前为每张幻灯片、每个选项卡或每张图片放一个隐藏的单选框,再用指向这些单选框的
for标签作为圆点、选项卡栏或缩略图。每条规则都写成#<radio>:checked:not(:disabled) ~ …。去掉输入元素的应用不会匹配任何规则,替代显示保持不变。 - 复选框开关(折叠面板、之前 / 之后、图片热点、菜单):在模块前放一个始终勾选的门控复选框
#<id>-k,在被轻点的<label>中放开关#<id>-t。隐藏内容的规则都从#<id>-k:checked开始,所以去掉门控的应用会显示全部内容。
这些模块中的链接和其他链接一样经过 /v/[token]/click。
轮播
每张幻灯片绘制两次:一次在 .carousel-fallback 中(第一张幻灯片和 查看全部 N 张幻灯片 链接,或在 .carousel-grid 表格中显示全部幻灯片),一次作为隐藏的 .lv-frame,由单选框的规则显示。.lv-px 条从第一张之后每张幻灯片的规则中加载幻灯片浏览信标 /v/[token]/nv/<blockId>/<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)}
箭头是每个画面中指向相邻单选框的 for 标签。缩略图用 .lv-tn 标签取代圆点。自动播放再加一个最先勾选的单选框,它的规则用 @media (prefers-reduced-motion:no-preference) 中的 @keyframes 动画让画面沿 .lv-track 移动;选择一张幻灯片就会取消它。幻灯片的价格和按钮属于幻灯片本身,所以替代显示中也有,按钮链接到幻灯片自己的 href。
折叠面板
每个条目的内容位于条目的 <label> 中、开关之后,所以在规则不执行的地方会直接显示。在实时预览、收件箱和画布中,每个条目改用原生的 <details>/<summary>。
<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}
选项卡
每个选项卡的模块只写一次,放在以选项卡标题为 .tb-h 标题开头的 .tb-p 面板中。这些依次排列的面板就是替代显示。单选框的规则显示 .tb-bar,隐藏标题,并显示一个面板。
<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}
之前 / 之后
两张图片放在同一个 <label> 中,各自位于其标签下。门控规则隐藏“之后”的图片并显示提示;开关交换两张图片。
<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}
图片热点
标记点只由门控之后的规则定位,从不使用行内 position(Gmail 会将其去掉)。每个标记点都是包住自己复选框和说明的 <label>。图片下方带编号的 .hs-legend 是替代显示,门控规则会隐藏它。
<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}
说明向左或向右、向上或向下打开,取决于标记点的位置:以水平 60%、垂直 65% 为界。
图片库
第一张图片始终在 .gl-main 中;其余图片是其中隐藏的画面。.gl-fallback 以小图显示它们,每张链接到实时预览,单选框的规则把它换成标签排成的 .gl-thumbs。商品模块的额外图片也用同样的部件绘制。
<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}
菜单
链接排成一个 .mn-row,每个都是有自己位置(blockType=menu-item)的点击链接,所以洞察能逐一列出链接名称。选择 在手机上 时,.mn-bar 和折叠这一行的规则位于 @media only screen and (max-width:620px) 中;选择 始终 时位于顶层。
<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}
}
游戏模块
三个游戏共用同一种结构。一个始终勾选的门控复选框 #<id>-k 位于 <label> 之前,<label> 里有一个单选框、涂层(.sc-surface,或者转盘 .stw-wheel 和它的按钮 .stw-go)和奖品(.sc-prize、.stw-prize)。门控的规则显示涂层并隐藏奖品。轻点标签会勾选单选框,它的规则隐藏涂层并显示奖品。
用单选框而不是复选框,这样第二次轻点也不会把奖品重新藏起来。输入框放在 <!--[if !mso]><!--> 中,去掉门控的应用会显示规则之外的内容。
每个模块记录一次 reveal。在邮件中,单选框的规则把揭晓信标 /v/[token]/rv/<blockId> 作为一条 4px 横条(.sc-px、.stw-px)的背景加载;实时预览则通过内联脚本发送揭晓。奖品链接经过 /v/[token]/click。
奖品。 有 game-prize 子项时,服务器会在生成邮件之前为每位收件人选定奖品:以项目、模块和收件人的 HMAC 为种子进行加权抽取,并连同优惠码只在 gamePrizes/{projectId}_{blockId}_{recipient} 中记录一次。结果以 prize_<blockId>、prize_label_<blockId>、prize_code_<blockId> 和 prize_url_<blockId> 存在收件人的行上,所以邮件、实时预览、收件箱和应用显示的是同一个奖品。
这时奖品面板只放在可交互的部分里,而指向实时预览的 揭晓我的奖品 链接(.stw-reveal、.sc-reveal)放在外面,由门控规则隐藏。行上没有结果就生成的邮件(导出、分配失败)只显示这个链接,由实时预览分配奖品。揭晓事件携带的是已记录的奖品,从不使用客户端提交的值。
幸运转盘
转盘是一个 240px 的 conic-gradient,每个奖品一格大小相同,标签用带阴影的白字,深色模式下也清晰可读。它的 @keyframes 在 3.2 秒内把转盘转到收件人奖品所在的角度,随后奖品面板淡入。经典版 Outlook 收到的是 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)}}
没有奖品时,转盘是一个 64px 的 🎡,在 0.9 秒内转两圈,然后显示一个指向 奖品链接 的带跟踪按钮。第二个指向同一链接的按钮 揭晓你的奖品 放在可交互部分之外,供其他应用显示(奖品链接留空时是指向实时预览的链接)。实时预览显示标题和奖品按钮。
刮刮卡
没有奖品时,奖品放在可交互部分之外,所以去掉规则的应用会直接显示它。涂层是一个 display:none 的 <span>,只有门控规则会显示它:银色条纹、涂层颜色,或者 封面图片 对应的 <img>(从不使用 CSS url())。揭晓按钮 会在标签内加一个 .sc-go span。
<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)}
门控规则把单选框变成一个 1px 的可聚焦元素,所以 Tab 能移到卡片上,空格键 能揭晓它。选择 卡片下方的按钮 时,带跟踪的按钮位于 </label> 之后、所有规则之外,刮开前后都可见。
神秘盒子
与刮刮卡相同的标记和规则,只是涂层换成礼盒:一个 72px 的 🎁(或 盒子图片)和点击提示文字。另有一条规则让盒子在关闭时轻轻晃动。
<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)}}
学习模块
抽认卡组不记录任何内容。作业为每位收件人记录一次提交。
抽认卡组
每张卡片与之前 / 之后的结构相同:一个始终勾选的门控复选框 #<card>-k,然后是一个 <label>,里面有卡片自己的复选框 #<card>-f、正面 .fc-front 和背面 .fc-back。门控的规则隐藏背面和各面的标签 .fc-l。勾选卡片的复选框会隐藏正面并显示背面。
每条规则都写有 :checked,所以丢弃这些规则的应用会把正面和背面上下排列,背面位于一条虚线下方,每一面以其标签开头(邮件语言的“问: ”和“答: ”)。已经以标签开头的卡片只保留一次标签。只有正面有图片的卡片翻转后仍保持 200px 高度,卡组不会在读者指尖下移动。实时预览绘制相同的标记,纯文本部分把每张卡片写成两行。
<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}
作业
截止日期是倒计时模块的图片,即为截止时间签名的 /api/countdown,位于“截止”一行之下。邮件在生成之后才被阅读,所以不写剩余时间;图片的替代文字是“距离截止的剩余时间”。截止后生成的邮件改为显示“已逾期”。实时预览把剩余时间写成文字(“2天4小时10分钟后截止”)。资料链接是普通链接,积分 会在标题后加上“(10分)”。
标记为完成 和投票一样是一个选项:在邮件中,它是指向 /v/[token]/act?action=complete 的一个链接,读者在那里确认。简短文字或链接回答是一个 <form>,把 action: "submit-answer" 和 answer(三行的 <textarea> 或 <input type="url">)发送到 /api/interactions,位于 <!--[if !mso]> 之内,下方在所有应用中都有一个指向实时预览(#em-<id>)的 在网页上回答 链接。
提交像投票一样按收件人去重,实时预览会读回它:“已标记为完成 ✓”,或带回答的“已提交 ✓”。dueAt 之后的提交也会照常记录,洞察根据提交时间判断按时还是逾期(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>
内容模块
这些模块不记录回答。视频、音频、场地和添加到日历是点击位:在个性化发送中,每个链接都会经过 /v/[token]/click?blockId=…&blockType=…&dest=…&sig=…,在模块上记录一次 click 并重定向到 dest。没有收件人令牌的导出邮件直接链接到目标。发出的标记在所有邮件应用中都相同,只有视频和音频的实时预览不同。
视频与音频
邮件在点击链接里绘制一张图片:以描述为 alt 的普通 <img> 显示海报图或封面图;没有图片时,绘制一块深色面板,显示 ▶ 或 ♪、描述,视频还会以 M:SS 显示时长。模块的宽度、内边距、边框和背景放在外层 <div> 上,所以面板保留自己的内边距。
实时预览和 MailInApp 收件箱绘制一个以海报图为 poster 的 <video controls>,或在封面 <img> 下方绘制一个 <audio controls>,两者都以描述作为 aria-label。移动应用会打开文件。没有 src 的模块不输出任何内容。
<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>
公式
公式是 GET /api/formula 返回的 PNG。写法(截断为 300 个字符)、显示方式和颜色都序列化在签名查询中,所以该端点不读取 Firestore,并以不可变的缓存头响应;由边缘 worker 提供。生成器会先排版一次公式,写出 <img> 的 width 和 height,使邮件在加载时不会跳动;排版时会缩小比例,以保持在图片尺寸预算之内。alt 就是写法本身,纯文本部分也是如此。
解析器是 MailInApp 自己的(没有 TeX 引擎):未知的宏会按字面文字绘制,渲染器从不抛出错误,所以公式永远不会中断发送。\ce{…} 把元素数目变为下标、末尾的电荷变为上标,并把 -> 绘制为箭头。写法为空时不输出任何内容。邮件、实时预览和收件箱绘制同一张图片,只有 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>
场地
照片、名称和地址都是普通 HTML,地址保留换行。路线链接依次为:粘贴的 Google 地图链接;否则在坐标非零且在范围内时为 https://maps.google.com/?q=<lat>,<lng>;否则为 https://maps.google.com/?q=<地址>。不涉及任何 Maps API 密钥。三者都没有时不绘制按钮。按钮是所有模块通用的防弹按钮:给经典版 Outlook 的 VML v:roundrect,以及给其他应用的带 mso-hide:all 的 <a>,两者都经过点击位。
<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>
添加到日历
只有在 开始时间 有效时才绘制三个按钮;缺少结束时间或结束早于开始时,改为开始后一小时。标题、描述和地点在生成链接前分别截断为 200、2,000 和 300 个字符,所以三个链接总是一致。三个按钮共用模块的同一个点击位。
- 下载 .ics 是
GET /api/calendar,整个活动都签名在查询中(对带calendar:前缀的输入做 HMAC,所以其他签名网址系列不会在这里通过验证,也不读取 Firestore)。它返回一个 RFC 5545 文件,DTSTART/DTEND为 UTC 时刻(末尾为Z,没有VTIMEZONE),所以每个日历都按嘉宾自己的时间显示。UID是活动各字段的 SHA-256,所以再次保存只会更新一个条目。文本按 §3.3.11 转义,行在 75 个八位字节处折叠。 - 添加到 Google Calendar 是一个
calendar.google.com/calendar/render?action=TEMPLATE&…链接,添加到 Outlook.com 是一个outlook.live.com/calendar/0/action/compose?…链接,两者都在渲染时生成。
打开 仅在参加后显示(afterRsvp)时,邮件不输出任何内容;实时预览、收件箱和移动应用会在收件人于该邮件中记录的出席回复为 confirmed 时输出此模块。工作室画布没有服务器密钥,会把 .ics 按钮绘制为 # 链接。
<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>
图表模块
图表、KPI 卡片和积分榜不记录任何内容,也不含链接。邮件、实时预览和 MailInApp 收件箱写出的标记相同,只有图片网址的来源不同。它们添加的每个词(表格标题、仪表图的区间、积分榜的列、合并出的 其他)都来自邮件语言的 emailBlocks.json chart.* 和 standings.*。
- 图片。 每个图表以及 KPI 卡片的迷你图,都是
GET /api/analytics/chart?d=…&s=…&r=2返回的一张 PNG。d是整个图表规格(类型、尺寸、标签、数值、颜色)的 base64url JSON,s是它基于LIVEVIEW_SECRET的 HMAC,r是像素比。该端点不读取 Firestore,所以响应完全由签名查询决定,并带有不可变的缓存头;由边缘 worker 绘制和提供。超过 6,000 个字符或超出某个图表上限的规格会被拒绝。标签在签名前会截断到规格的标签长度。 - 图片旁的文字。
<img>的alt写明图表类型并列出画出的每个数值(“Bar chart: North (Revenue 12,400); …”)。除仪表图外,每个图表随后都有一张始终可见、数字相同的<table aria-label="<标题>">,在需要的地方(多个系列、扇区、方块或色阶)附有图例。表格列出图片画出的内容,只有桑基图的表格列出输入的每条流向。 - 绑定的图表。 KPI 卡片以及柱状图、折线图和饼图接受
binding。数据源绑定先经过模块的filter(其值可以包含收件人合并标签),再把绑定的行按groupByField分组,并按系列聚合(sum、avg、count、latest;src/lib/charts/aggregate.ts)。@response:绑定读取项目的结果汇总(src/lib/charts/responseSource.ts)。两者都在渲染时解析:邮件在发送时,实时预览在每次加载时。带收件人标签的筛选会为每位收件人生成一份规格,也就是一个图片网址。 - 没有数据时。 没有可用行的图表会写出标题和一条提示(
chart.emptyRows等)来代替图片,所以半成品模块永远不会中断发送。
| 图表 | 表格列 | 上限 |
|---|---|---|
| 柱状、折线、雷达 | 类别,然后每个已命名系列一列 | 24 个类别、3 个系列;雷达 3 到 8 根轴 |
| 饼图、矩形树图 | 类别、数值、百分比 | 8 个扇区:最大的 7 个加 其他 |
| 散点 | 系列、X、Y,气泡图中还有大小 | 120 个点、8 个系列 |
| 直方图 | 区间、数量 | 500 个数值、2 到 20 个区间 |
| 热力图 | 行、列、数值(仅输入的格子) | 12 行 × 24 列 |
| 漏斗 | 阶段、数值、占首阶段 %、占上一阶段 % | 8 个阶段 |
| 瀑布 | 标签、数值、类型、累计 | 8 根柱 |
| 桑基 | 来源、去向、数值 | 12 个节点、24 条连接 |
超出上限的行会被舍弃,从不合并,只有饼图和矩形树图最小的扇区例外。漏斗和瀑布保留输入顺序,因为顺序本身就是含义。
带表格的图表
<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>
KPI 卡片
标签、数值(按数字、美元或百分比格式化)和变化都是文字。只有同时设置 previousValue 和 trendDirection 时才显示变化:百分比由两个值计算,箭头及其状态色(上升绿、下降红、持平琥珀)跟随输入的方向。迷你图图片至少需要两个点,最多 60 个,颜色跟随箭头。一行浅色文字为屏幕阅读器和纯文本部分复述结果。
GET /api/v1/liveview/[token] 把这些文字作为附加 props 交给移动应用,由邮件所用的同一个 kpiDisplay/gaugeDisplay 计算(attachChartImageUrls,src/lib/liveview/chartImages.ts):displayValue、displayChange/displayChangeColor 或 displayStatus/displayStatusColor、displaySummary,没有数字的仪表图则是 displayNotice。其他图表都会收到 chartTable,即从同一标记中读出的始终可见表格,格式为 JSON {headers, rows}。
<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>
仪表图
仪表图是唯一没有表格的图表:数值和区间是表盘旁的文字。默认情况下区间按升序排列:value <= goodMax 为良好,<= warningMax 为警告,其余为严重,使用主题的状态色。打开 higherIsBetter 后,value >= goodMin 为良好,>= warningMin 为警告,更低的为严重;图片仍然画三条升序色带(src/lib/charts/gauge.ts 的 gaugeSpecBands 传入 warningMin 和 goodMin,并交换良好与严重的颜色),所以签名格式不变。这三个 props 没有默认值,没有它们的仪表图照旧发送。min >= max 或顺序颠倒的阈值会被收进范围内,而不是被拒绝。无法读成数字的值(例如未解析的合并标签)会写出 chart.emptyGauge 代替表盘。
<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>
积分榜
一张没有图片的普通 <table>。行按 积分 从高到低稳定排序,所以积分相同的球队保持输入顺序;前三名显示 🥇🥈🥉。showDraws: false 会从表头和每一行移除平局列。highlightTeamName 不区分大小写地匹配球队,并把该行加粗、着色。没有球队时写出 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>