文本组件允许您插入一个段落。每个段落支持基本的Markdown

• 粗体文本：**粗体文本**

• 斜体文本：_斜体文本_

• 链接：[链接文本](https://example.com)

• 也是一个链接：<https://example.com>

• 标题 (h1-h6)

  • #大标题
  • ######小标题

• 无序列表

  - item one
  - item two
  - item three
  

• 有序列表

  1. item one
  1. item two
  1. item three
  

Content::builder()
  .text("## Thank you for signing up")
  .text("Please **verify your email** by [clicking here](https://example.com/confirm?token=XYZ)")
  .build()?;

链接组件添加锚点标签。这与带有Markdown编写的链接的文本组件相同

Content::builder()
  .link("Confirm Email", "https://example.com/confirm?token=XYZ")
  .build()?;

按钮也可以用作行动号召。按钮颜色通过仪表板的应用程序颜色设置。

Content::builder()
  .button("Confirm Email", "https://example.com/confirm?token=XYZ")
  .build()?;

图片组件将链接到电子邮件中的图片。请注意，出于隐私原因，许多电子邮件客户端将阻止自动加载图片。

// Simple
Content::builder()
  .image("https://placekitten.com/300/200")
  .build()?;

// Clickable & with attributes
Content::builder()
  .component(
    Image::new("https://placekitten.com/300/200")
      .url("https://example.com")
      .width(200)
      .height(100)
      .alt("Alt Text")
      .build()?
  )
  .build()?;

仅需要 src 参数；其他都是可选的。

如果您已开启“图片优化”

1. 您的图片将被缓存并由我们的CDN分发，以加快加载速度。缓存不会过期。如果您想重新缓存，只需在图片URL的末尾添加一个查询参数即可。

2. 图片将被转换为电子邮件客户端广泛支持的格式。以下图片格式将自动处理

   • Jpeg
   • Png
   • Gif
   • WebP
   • Tiff
   • Ico
   • Bmp
   • Svg

3. 免费账户的最大图片大小为5MB，付费账户为20MB。

4. 如果您想指定 width 和/或 height（它们是可选的）。请注意，如果图片太大，将会缩小以适应电子邮件主题。

OTP组件专为显示临时密码和重置码而设计。

Content::builder()
  .text("Here's your **temporary login code**:")
  .otp("XY78-2BT0-YFNB-ALW9")
  .build()?;

您可以通过指定用户名轻松添加带有链接的社交图标。通常，此组件位于电子邮件的页脚中。

这些都是支持的平台

Content::builder()
  .socials(&[
    SocialItem::new(Service::Website, "https://example.com"),
    SocialItem::new(Service::Email, "[email protected]"),
    SocialItem::new(Service::Phone, "123-456-7890"), // `tel:` link
    SocialItem::new(Service::Facebook, "Username"),
    SocialItem::new(Service::YouTube, "ChannelID"),
    SocialItem::new(Service::Twitter, "Username"),
    SocialItem::new(Service::X, "Username"),
    SocialItem::new(Service::GitHub, "Username"),
    SocialItem::new(Service::Instagram, "Username"),
    SocialItem::new(Service::LinkedIn, "Username"),
    SocialItem::new(Service::Slack, "Org"),
    SocialItem::new(Service::Discord, "Username"),
    SocialItem::new(Service::TikTok, "Username"),
    SocialItem::new(Service::Snapchat, "Username"),
    SocialItem::new(Service::Threads, "Username"),
    SocialItem::new(Service::Telegram, "Username"),
    SocialItem::new(Service::Mastodon, "@[email protected]"),
    SocialItem::new(Service::Rss, "https://example.com/blog"),
  ])
  .build()?;

如果您希望收件人能够在浏览器中阅读电子邮件，您可以添加“在浏览器中查看”组件，该组件将自动生成链接。通常，此组件位于电子邮件的页眉或页脚中。

您可以提供链接的文本。如果没有提供，则使用默认值：“在浏览器中查看”

知道链接的人将能够查看电子邮件。

Content::builder()
  .view_in_browser()
  .build()?;

通过商店徽章链接到您的移动应用程序

Content::builder()
  .store_badges(&[
    StoreBadgeItem::new(StoreBadge::AppStore, "https://apps.apple.com/us/app/example/id1234567890"),
    StoreBadgeItem::new(StoreBadge::GooglePlay, "https://play.google.com/store/apps/details?id=com.example"),
    StoreBadgeItem::new(StoreBadge::MicrosoftStore, "https://apps.microsoft.com/detail/example"),
  ])
  .build()?;

您还可以即时生成二维码。它们将以图片形式显示在电子邮件中。

以下是所有支持的数据类型

// URL
Content::builder()
  .qr_code("https://example.com")
  .build()?;

// Email
Content::builder()
  .component(QrCode::email("[email protected]"))
  .build()?;

// Phone
Content::builder()
  .component(QrCode::phone("123-456-7890"))
  .build()?;

// SMS / Text message
Content::builder()
  .component(QrCode::sms("123-456-7890"))
  .build()?;

// Geo coordinates
Content::builder()
  .component(QrCode::coordinates(37.773972, -122.431297))
  .build()?;

// Crypto address (for now only Bitcoin and Ethereum are supported)
Content::builder()
  .component(QrCode::cryptocurrency_address(Cryptocurrency::Bitcoin, "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"))
  .build()?;

// You can also encode any binary data
Content::builder()
  .component(QrCode::new(&[1, 2, 3]))
  .build()?;

生成的签名可以添加到您的电子邮件中，以增添一丝个人风格。这将使用几种可用的字体之一，将您的自定义文本与图片嵌入

// Signature with a default font
Content::builder()
  .signature("John Smith")
  .build()?;

// Signature with a custom font
Content::builder()
  .component(Signature::new("John Smith", Some(SignatureFont::ReenieBeanie)))
  .build()?;

以下是可用的字体

• SignatureFont::ReenieBeanie 预览 →
• SignatureFont::MeowScript 预览 →
• SignatureFont::Caveat 预览 →
• SignatureFont::Zeyada 预览 →
• SignatureFont::Petemoss 预览 →

签名不应超过64个字符。仅允许字母数字字符和大多数常见符号。