ブロックのマークアップ リファレンス
このページでは、各インタラクティブブロックが送信される HTML に何を書き込むか、そして受信者の回答がどのように MailInApp に届くかを説明します。開発者の方や、HTML を書き出して別のプラットフォームから送信する方に向けたページです。受信者に見えるものと受け取れるものは、各ブロックのページで説明しています。階層そのものについてはフォールバックの仕組みを参照してください。
サンプルは短くしてあります。実際の出力には、インラインスタイル、ダークモード用のクラス、テーマの色がさらに含まれます。各リンクは受信者の署名付きライブビュートークン(/v/[token])を指し、メールと、パーソナライズされた送信では受信者を識別します。
回答の記録方法
2つの経路が同じ記録用エンドポイントに届き、同じイベントを生成します。そのため、受信者がどこで回答しても結果は変わりません。
- **確認リンク。**ワンタップの回答は、ブロック、アクション、値をクエリに含む
/v/[token]/actへの<a href>です。開いたページで受信者に確認を求め、その確認フォームの送信で回答が記録されます。単なる GET では何も記録されないため、すべてのリンクを先読みするリンクスキャナーやセキュリティツールが投票することはありません。スキャナーに強いインタラクション記録を参照してください。 - **フォーム送信。**入力式や複数回答のブロックは、
/api/interactionsにapplication/x-www-form-urlencodedで送信する<form method="post">を含みます。ウェブ版 Gmail と iOS・Android 版 Outlook アプリはメールから送信します。こうしたフォームには必ず、ライブビュー上の同じブロックへの ウェブで回答する リンクが常に表示され、ライブビューでは通常のウェブフォームとして動作します。
受信者の回答は、メール、ブロック、受信者の組み合わせごとに1回だけ、3つから作ったドキュメント ID で保存されます。そのため、タップを繰り返してもページを再読み込みしても何も変わりません。受信者トークンのないエクスポートしたメールからの回答は人に紐づけられないため、代わりに IP、キャンペーン、1分ごとに回数が制限されます。
フィードバックのブロック
投票
各選択肢はチップの見た目をした確認リンクで、どのメールアプリでも常に表示されます。
<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 を1つ送ります(保存時は option と optionId の並列リストになります)。あわせて ウェブで回答する リンクも付きます。その他 の選択肢はライブビュー上の投票へのリンクで、受信者はそこで回答を入力します。シャッフルした投票の順番は受信者のトークンから決まるため、開くたびに同じです。リアルタイム結果の画像 は /api/results-image の <img> で、受信者ごとではなく投票の選択肢ごとに署名されます。
評価
既定の 星 形式では、星ごとに確認リンクを1つ、高いほうから右から左の並びで送信します。各リンクには空の星と塗りつぶした星が入っています。アプリが対応していれば :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 まで、星ごとに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 アンカーの奥に問題を置きます。
フォーム
1ページのフォームは、すべての項目を /api/interactions に送信する1つの <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 ルールで1ページずつ表示します。これらのルールに対応しないアプリでは、すべてのページが表示されます。ファイルはブラウザからしか追加できないため、ファイルの項目はライブビューにリンクします。条件付きの質問は送信されるフォームではすべて表示され、受信者の前の回答によって非表示になる質問への回答はサーバーが破棄します。
サーバーは何かを書き込む前に、保存されたメールのフォームと照らして各回答を確認します。無効な回答を送ったブラウザは /v/[token]?invalid=<fieldId>&why=<problem> に戻され、JSON の呼び出しには 400 invalid-answer が返ります。
ショップとレビューのブロック
これらのブロックのリンクは /v/[token]/click を経由し、クリックを記録してから行き先へリダイレクトします。同じ署名付きリンクを5分以内に繰り返しても1回と数えます。
カウントダウン
カウントダウンは /api/countdown から読み込む1つの <img> です。URL は終了と色に対して署名され、読み込みのたびに残り時間から60フレーム(1秒1フレーム)の GIF を新たに描き、最後のフレームで止まります。同一の署名付きリクエストは最大10秒間レンダリングを共有します。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 の在庫バッジが付き、支払い済み数から最大1分に1回描き直されます。
<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 の確認リンクで、受信者ごとに1回記録されます。
<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 に送ります。/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 から選ばれ、メールのツリーには保存されません。1 つの商品 の場合、「すべてのレビューを見る」リンクは商品ページへのクリックリンクです。
<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>
定員の確認と受信者ごとの重複排除は1つの Firestore トランザクションで行うので、席が売り過ぎになることはありません。定員を超えた「はい」は waitlisted、「いいえ」は declined、「未定」は席を使わない maybe として記録されます。「はい」の後の質問は、ブロック ID に __details を付けたものへの submit として送られ、サーバーは記録された回答が「はい」の受信者からのみ受け付け、フォームの回答と同じように検証します。
ミーティング予約
時間は予約タイプの次の空き枠で、メールのレンダリング時に計算され、予約タイプのタイムゾーンで表記されます。メールでは各時間が 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) ~ … の形のルールが1日分のパネル(.bk-p)を表示します。これらのルールが効かない場所では、各パネルが日付の見出し(.bk-dh)の下に表示されます。ライブビュー、受信トレイ、アプリでは、時間は1つのフォーム内のラジオチップで、選んだ slot と action=book を /api/interactions に送ります。
予約の前に、サーバーはカレンダーの空き状況を読み直し、トランザクションで枠を確保するので、1つの枠が予約されるのは1回だけです。受信者は自分の連絡先として、ブロックごとに1回予約されます。連絡先のないトークンは予約ページに送られ、ボット確認の後で名前とメールアドレスを尋ねます。
ウェビナー申し込み
カードはどこでも同じです。日付はブロックのタイムゾーンでゾーン名付きで表記され、今すぐ登録 はセッションの公開ページ /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 には見えません。
7 つのブロックは、2 つの形で書かれています。
- ラジオのグループ(カルーセル、タブ、画像ギャラリー):コンテンツの前に、スライド、タブ、画像ごとに非表示のラジオを置き、そのラジオを指す
for付きのラベルを、ドット、タブバー、サムネイルにします。ルールはすべて#<radio>:checked:not(:disabled) ~ …の形です。入力要素を取り除くアプリではどのルールも当てはまらず、代わりの表示がそのまま残ります。 - チェックボックスの切り替え(アコーディオン、ビフォー / アフター、画像ホットスポット、メニュー):ブロックの前に常にチェックされたゲート用チェックボックス
#<id>-kを置き、タップされる<label>の中に切り替え用の#<id>-tを置きます。何かを隠すルールは#<id>-k:checkedから始まるので、ゲートを取り除くアプリではすべてが表示されます。
これらのブロックのリンクは、ほかのリンクと同じく /v/[token]/click を通ります。
カルーセル
各スライドは 2 回描かれます。1 回は .carousel-fallback の中(最初のスライドと 全 N 枚のスライドを見る リンク、またはすべてのスライドを並べた .carousel-grid の表)、もう 1 回はラジオのルールが表示する非表示の .lv-frame です。.lv-px の帯は、2 枚目以降の各スライドのルールからスライド閲覧のビーコン /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 のラベルに置き換えます。自動再生はラジオをもう 1 つ加えて最初にチェックし、そのルールが @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}
タブ
各タブのブロックは 1 回だけ書かれ、タブのタイトルを見出し .tb-h とするパネル .tb-p に入ります。縦に並んだこのパネルが代わりの表示です。ラジオのルールが .tb-bar を表示し、見出しを隠して、パネルを 1 つ表示します。
<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}
ビフォー / アフター
2 枚の画像はひとつの <label> の中に、それぞれのラベルの下に入ります。ゲートのルールがアフター画像を隠してヒントを表示し、切り替えで 2 枚が入れ替わります。
<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}
メニュー
リンクは 1 つの .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}
}
ゲームのブロック
3 つのゲームは同じ形で書かれています。常にチェックされたゲート用チェックボックス #<id>-k が <label> の前にあり、その <label> の中にラジオ、カバー(.sc-surface、またはルーレット .stw-wheel とボタン .stw-go)、賞品(.sc-prize、.stw-prize)が入っています。ゲートのルールがカバーを表示して賞品を隠します。ラベルをタップするとラジオがチェックされ、そのルールがカバーを隠して賞品を表示します。
チェックボックスではなくラジオなので、2 回目のタップで賞品がまた隠れることはありません。入力要素は <!--[if !mso]><!--> の中にあり、ゲートを取り除くアプリではルールの外にあるものが表示されます。
各ブロックは reveal を記録します。メールでは、ラジオのルールが結果表示ビーコン /v/[token]/rv/<blockId> を 4px の帯(.sc-px、.stw-px)の背景として読み込み、ライブビューはインラインスクリプトから結果表示を送ります。賞品のリンクは /v/[token]/click を通ります。
賞品。 game-prize の子要素がある場合、サーバーはメールを生成する前に受信者ごとの賞品を選びます。プロジェクト、ブロック、受信者の HMAC をシードにした重み付き抽選で、結果はコードとともに gamePrizes/{projectId}_{blockId}_{recipient} に 1 回だけ記録されます。結果は受信者の行に 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 秒で 2 回転し、賞品のリンク へのトラッキング付きボタンを表示します。同じリンクへの 2 つ目のボタン 賞品を見る がインタラクティブな部分の外にあり、その他のアプリに表示されます(賞品のリンクが空欄ならライブビューへのリンク)。ライブビューにはタイトルと賞品ボタンが表示されます。
スクラッチカード
賞品がない場合、賞品はインタラクティブな部分の外にあるので、ルールを取り除くアプリではすぐに表示されます。カバーは 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)}}
学習のブロック
単語カードセットは何も記録しません。課題は受信者ごとに 1 件の提出を記録します。
単語カードセット
各カードはビフォー / アフターと同じ形です。常にチェックされたゲート用チェックボックス #<card>-k の後に <label> があり、その中にカード専用のチェックボックス #<card>-f、表 .fc-front、裏 .fc-back が入っています。ゲートのルールが裏と面のラベル .fc-l を隠します。カードのチェックボックスをチェックすると、表が隠れて裏が表示されます。
どのルールも :checked を含むため、ルールを捨てるアプリでは表と裏が上下に並び、裏は点線の下に表示されます。各面の先頭にはラベル(メールの言語で「問: 」「答: 」)が付きます。すでにラベルで始まるカードでは、ラベルは 1 回だけです。表だけに画像があるカードは、めくった後も高さ 200px を保つので、読者の指の下でカードセットが動きません。ライブビューも同じマークアップを描き、テキスト版では各カードを 2 行で書きます。
<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 へのリンクが 1 つあり、読者はそこで確定します。短いテキストやリンクでの回答は <form> で、action: "submit-answer" と answer(3 行の <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 を読まず、変更不可のキャッシュヘッダーで応答します。配信はエッジワーカーが担います。エミッターは数式を一度レイアウトして <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 マップのリンク、なければ座標が 0 でなく範囲内のときに https://maps.google.com/?q=<lat>,<lng>、それもなければ https://maps.google.com/?q=<住所> です。Maps の API キーは使いません。3つとも空ならボタンは描きません。ボタンはすべてのブロック共通の防弾ボタンで、クラシック 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>
カレンダーに追加
3つのボタンは、有効な 開始日時 があるときだけ描かれます。終了がないか開始より前なら、開始の1時間後になります。イベント名、説明、場所は、リンクを作る前にそれぞれ 200、2,000、300 文字で切り詰めるので、3つのリンクは常に一致します。3つともブロックのクリックスロットを1つ共有します。
- .ics をダウンロード は
GET /api/calendarで、イベント全体がクエリに署名されています(calendar:を接頭辞にした入力の HMAC なので、ほかの署名付き URL のファミリーはここで検証されず、Firestore も読みません)。DTSTART/DTENDを UTC の時点(末尾にZ、VTIMEZONEなし)にした RFC 5545 のファイルを返すので、どのカレンダーもゲスト自身の時刻で表示します。UIDはイベントの項目の SHA-256 なので、保存し直すと1件のエントリーが更新されます。テキストは §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 の受信トレイは同じマークアップを書き出し、違うのは画像 URL のオリジンだけです。追加される言葉(表の見出し、ゲージのゾーン、順位表の列、まとめた その他)はすべて、メールの言語の emailBlocks.json chart.* と standings.* から取られます。
- 画像。 各グラフと KPI カードのスパークラインは、
GET /api/analytics/chart?d=…&s=…&r=2が返す 1 枚の PNG です。dはグラフの仕様全体(種類、サイズ、ラベル、値、色)を base64url の JSON にしたもの、sはそのLIVEVIEW_SECRETによる HMAC、rはピクセル比です。このエンドポイントは Firestore から何も読まないので、レスポンスは署名付きクエリだけで決まり、変更されないキャッシュヘッダーが付きます。描画と配信はエッジワーカーが行います。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)を読みます。どちらもレンダリング時に解決され、メールでは送信時、ライブビューでは読み込むたびです。受信者のタグを含むフィルターは受信者ごとの仕様、つまり受信者ごとの画像 URL になります。 - データがないとき。 使える行のないグラフは、画像の代わりにタイトルとお知らせ(
chart.emptyRowsなど)を書き出すので、作りかけのブロックが送信を止めることはありません。
| グラフ | 表の列 | 上限 |
|---|---|---|
| 棒、折れ線、レーダー | カテゴリ、続いて名前のある系列ごとに 1 列 | 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 の両方があるときだけ表示されます。割合は 2 つの値から計算され、矢印とその状態の色(上昇は緑、下降は赤、横ばいは琥珀色)は入力した向きに従います。スパークラインの画像には 2 点以上が必要で、最大 60 点まで受け付け、色は矢印の色に合わせます。控えめな 1 行が、スクリーンリーダーとテキスト版のために結果をテキストで繰り返します。
GET /api/v1/liveview/[token] は、メールと同じ kpiDisplay/gaugeDisplay で求めたこれらの言葉を、追加の props としてモバイルアプリに渡します(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 が注意、それより下が深刻です。画像は引き続き昇順の 3 つの帯を描くので(src/lib/charts/gauge.ts の gaugeSpecBands が warningMin と goodMin を、良好と深刻の色を入れ替えて渡します)、署名付きの形式は変わりません。3 つの 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> です。行は安定ソートで 勝ち点 の多い順に並ぶので、同点のチームは入力した順のままです。上位 3 位には 🥇🥈🥉 が付きます。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>