UStackUStack
React Email icon

React Email

React Email 提供无样式 React 与 TypeScript 邮件组件,支持 Tailwind,并含兼容性测试、链接校验与垃圾邮件评分工具。

React Email

什么是 React Email?

React Email 是一组无样式的 React 和 TypeScript 邮件组件,用于构建邮件。其目标是通过提供可复用的构建块和模式来简化邮件 UI 的编写,从而更容易组合标记。

该库包含示例,展示如何组装邮件的常见部分(例如,文档结构、布局容器、文本、图像和按钮),然后渲染它们以用于邮件工作流。

主要特性

  • 用于邮件布局的无样式 React 组件:使用 HtmlHeadBodyContainerSectionTextImg 等组件组合邮件结构,从而控制样式和布局。
  • 基于 Tailwind 的样式选项:使用 Tailwind 包装器为组件应用 Tailwind 类(或选择内联 CSS 作为替代方案)。
  • 示例和可复制的启动代码:从示例模板(如 email-template.tsx)开始,然后用自己的数据替换占位符。
  • 针对热门邮件客户端的兼容性测试:使用内置检查查看 HTML/CSS 在 Gmail、Apple Mail、Outlook、Yahoo Mail、HEY 和 Superhuman 中的支持情况。
  • 发送前专注于交付性的工具:运行工具,包括 链接检查器(验证链接)、兼容性检查器(评估客户端支持)和 垃圾邮件评分 分析器(估算被标记为垃圾邮件的可能性)。
  • 转换和集成支持:将 React 邮件代码转换为 HTML 或纯文本,并通过常见邮件服务提供商发送,包括 Resend、SendGrid、Amazon Web Services 和 Postmark。

如何使用 React Email

  1. 创建邮件项目:使用提供的启动命令 npx create-email@latest
  2. 编写邮件模板(例如 WelcomeEmail):在 .tsx 文件中使用 React Email 组件组合。
  3. 样式化邮件:根据首选工作流,使用 Tailwind 类(通过 Tailwind 包装器)或内联 CSS。
  4. 预览和验证:在使用内置检查器、兼容性检查器和垃圾邮件评分工具发送前预览和验证输出。
  5. 导出并发送:将模板转换为 HTML 或纯文本,然后使用邮件服务提供商(例如 Resend、SendGrid、AWS 或 Postmark)发送。

使用场景

  • 具有可复用模板的营销或入职邮件:一次性构建欢迎邮件(带有可配置的 props 如 usernamecompany),并在多个活动中复用相同的组件结构。
  • 团队跨产品标准化邮件 UI:通过在多个项目中使用 React Email 组件,保持常见布局原语(页眉、页脚、部分、分隔线、网格)的一致性。
  • 希望获得更好客户端兼容性反馈的开发者团队:运行兼容性检查器,识别特定 HTML/CSS 方法在常见邮件客户端中的表现。
  • 包含邮件编辑器的应用:集成编辑器工作流,让用户在产品中编写邮件,同时在底层依赖 React Email 组件。
  • 自动化发送管道:将模板转换为 HTML 或纯文本,并通过邮件提供商如 Resend、SendGrid、AWS 或 Postmark 发送。

常见问题

  • React Email 是带样式的还是无样式的?
    React Email 被描述为一组 无样式 组件。您自己应用样式(例如通过 Tailwind 包装器使用 Tailwind 或内联 CSS)。

  • 可以使用 Tailwind 或内联 CSS 样式化邮件吗?
    可以。文档内容指出,您可以使用 Tailwind 或内联 CSS 使邮件外观正确。

  • 发送前有哪些验证工具?
    该页面列出了用于检查链接的 检查器、用于热门客户端 HTML/CSS 支持的 兼容性检查器,以及 垃圾邮件评分 分析器。

  • React Email 支持哪些输出格式?
    它可以将 React 邮件代码转换为 HTML 或纯文本

  • React Email 可以发送到哪些邮件提供商?
    该页面提到了与 ResendSendGridAmazon Web ServicesPostmark 的集成。

替代方案

  • 纯 HTML 邮件模板:您可以手动编写使用表格和内联样式的 HTML。这可能更直接,但会丢失 React 组件工作流以及内置的 linter/兼容性工具。
  • 其他基于组件的邮件模板库:寻找提供代码形式可复用邮件 UI 原语的库(而非静态模板)。这些库在兼容性检查和送达评分工具方面的支持程度各异。
  • 带拖拽编辑器的邮件设计工具:这些工具专注于非开发者的视觉编辑,但可能无法与 React/TypeScript 代码库自然集成,或输出纯文本/HTML 转换工作流。
  • 服务器端邮件模板引擎:模板系统可从模板和数据生成 HTML 邮件,但通常不提供此处所述的 React 组件结构和邮件客户端专用检查。
React Email | UStack