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 反馈 — 无需本地设置。