0Pricing
HTML Academy · 课时

Twitter Card 元标签

使用卡片元标签自定义 Twitter 链接预览

Twitter Card 元标签 是 CoddyKit 上的免费 HTML Academy 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 HTML Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 HTML Academy 课程共包含 4 节课。

为什么需要单独的标准

Twitter(X)在 OpenGraph 出现之前定义了自己的预览卡片协议,并一直维护至今。虽然现代 Twitter 在缺少 twitter:* 标签时会回退到 OG 标签,但明确声明 twitter:card 能提供最可预测的卡片布局。

twitter:card 类型

四种卡片类型:summary(标题/描述旁的小缩略图)、summary_large_image(全宽主图)、app(移动应用安装)和 player(嵌入式视频或音频)。对于内容丰富的文章,请选择 summary_large_image。

<meta name="twitter:card" content="summary_large_image">

twitter:title 和 twitter:description

如果存在这两个标签,它们会在 Twitter 上覆盖 og:title 和 og:description。当您希望面向 Twitter 用户使用不同于一般 OpenGraph 使用者的标题时,请设置它们;否则就让 Twitter 回退到 OG 值。

twitter:image

对于摘要卡片,请使用至少 144x144 的 1:1 方形图片。对于 summary_large_image,请使用 2:1 的图片,理想尺寸为 1200x600 或更大。Twitter 会拒绝超过 5 MB 的图片。与 og:image 一样,请使用绝对 URL——相对路径无法正常工作。

twitter:image:alt

卡片图片的替代文本,最多 420 个字符。它能改善使用屏幕阅读器浏览 Twitter 的用户的无障碍体验,并在图片加载失败时提供备用描述。请始终提供它——这是提升包容性、耗时仅 30 秒的改进。

twitter:site 和 twitter:creator

twitter:site 是您网站的 Twitter 账号(带有 @)。twitter:creator 是个人作者的账号。填写这些信息后,Twitter 就能显示“来自 @yoursite”,并将署名链接到真实账号。

<meta name="twitter:site" content="@coddykit">
<meta name="twitter:creator" content="@ada_lovelace">

property 属性与 name 属性

OpenGraph 使用 property="og:...";Twitter 使用 name="twitter:..."。这种差异源于历史原因(RDFa 与 HTML5 meta)。从技术上说两者都有效;为每种协议使用正确的属性,可以避免严格验证器中的边界问题。

应用卡片

twitter:card="app" 允许您通过 twitter:app:id:iphone、twitter:app:id:ipad、twitter:app:id:googleplay 和 twitter:app:url:* 深层链接推广 iOS/Android 应用。点击卡片后会打开 App Store、Play Store,或者在应用已安装时直接打开应用。

播放器卡片

twitter:card="player" 会在推文中直接嵌入视频或音频播放器。它需要 twitter:player(HTTPS iframe 的 URL)、twitter:player:width 和 twitter:player:height。为防止滥用,Twitter 会人工审核播放器卡片——请通过 developer.twitter.com 提交。

使用 Twitter Card Validator 进行测试

Twitter 已关闭公开的 Card Validator 界面,但卡片仍会在推文草稿中显示预览。请将 URL 粘贴到私人草稿中,以便在发布实际推文前准确查看将要呈现的卡片类型和图片。

备用策略

请始终同时包含 twitter:card 和完整的 OG 标签集合。大多数非 Twitter 平台会忽略 twitter:* 标签,而大多数现代 Twitter 客户端会回退到 OG,因此两者结合就能以极少的重复内容在各个平台生成正确的预览。

知识检查

如果缺少 twitter:title 但存在 og:title,Twitter 卡片上会显示什么?

总结

Twitter 卡片(通过 name="twitter:card" 声明)能为页面在 X 上提供可预测的预览。对于编辑内容,请选择 summary_large_image,添加带绝对 URL 的 twitter:image 和 twitter:image:alt,使用账号标注网站和作者,并让 OG 值填充未覆盖的标签。

常见问题解答

「Twitter Card 元标签」课时是免费的吗?

是的 — 「Twitter Card 元标签」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 HTML Academy 课程的其余内容,请升级到 CoddyKit PRO。 HTML Academy 课程共包含 4 节课。

「Twitter Card 元标签」这节课中我会学到什么?

使用卡片元标签自定义 Twitter 链接预览 你通过在浏览器中直接运行的动手代码来练习 HTML Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 HTML Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 HTML Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。

「Twitter Card 元标签」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 HTML Academy 课中编写并运行代码吗?

能。每节 HTML Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. OpenGraph:og:title、og:description、og:image
  2. Twitter Card 元标签
  3. JSON-LD 结构化数据基础
  4. 面向国际化页面的 hreflang
← 返回 HTML Academy