Apple Touch 图标:尺寸、格式与代码

作者

访客将网站添加到 iPhone 主屏幕时,Apple Touch 图标明确指定要使用的图片。它与浏览器标签页图标、网页应用清单中声明的图标相互独立。

手机主屏幕上的正方形网站图标
Apple Touch 图标与浏览器标签页图标是独立的资源。

只需一个尺寸:180×180

180×180 像素常用作高分辨率源图。iOS 可以将它缩小用于更小的显示位置,因此大多数项目只需保留一个声明。

过去的建议列出了从 57×57 到 152×152 的八个文件,每个文件都有独立的 sizes 属性。这些版本如今已无必要,只会使 HTML 臃肿,并为相同效果增加请求。

文件必须是 PNG。对于此类图标,iOS 不读取 SVG 或 WebP,而 JPEG 会破坏扁平图形的清晰边缘。

优先使用不透明背景

透明背景可能因系统版本和显示场景而产生意外效果。为了控制主屏幕上的外观,请使用自己选定的不透明背景。

解决方法是在导出前,将图标合成到不透明背景上。选择品牌色;如果图形本身色彩丰富,也可以使用纯白,并在图形周围保留约 10% 的留白,使画面更舒展。

但不要自行添加圆角:iOS 会施加自己的圆角遮罩。文件已有圆角时,会形成双重圆角,边角效果不佳。

需要粘贴的标签

在页面 head 中添加一行即可:link rel="apple-touch-icon" href="/apple-touch-icon.png"。只提供一个文件时,sizes 属性可省略。

还可选择添加 meta name="apple-mobile-web-app-title" content="Your brand",以控制图标下方显示的名称。没有此标签时,iOS 会使用页面标题,而页面标题通常过长,会被截断。

同时在根目录放置一份名为 apple-touch-icon.png 的文件:与 favicon.ico 类似,找不到标签时,iOS 会尝试从这个地址读取。

为什么图标迟迟不更新

iOS 会强力缓存图标,已添加到主屏幕的快捷方式不会自行更新。测试新版本时,请删除快捷方式、清除 Safari 数据,然后重新添加网站。

如果仍然缺少图标,请检查三点:文件返回 200 而非 404,内容类型为 image/png,且未被 robots.txt 规则或身份验证阻止。

LFFavicon 检测工具会针对任意公开 URL 检查这些情况,并显示实际获取到的图标。

一手资料

常见问题

需要多个尺寸的 apple-touch-icon 吗?

对大多数项目而言,一个高分辨率 180×180 文件即可让 iOS 生成更小的版本。请在项目支持的设备上测试。

Android 会使用 apple-touch-icon 吗?

Android 上的 Chrome 可以将它作为后备,但会优先读取网页应用清单图标。请始终在清单中声明 192×192 和 512×512 图标,这是正式支持的方式。

可以用 SVG 作为 Apple Touch 图标吗?

不可以,此标签在 iOS 上需要 PNG 位图。请将 SVG 用于桌面浏览器的网站图标,以获得清晰显示和深色模式支持。

动手实践

生成器可在几秒内免费生成完整图标组合,无需上传图片。

检测网站的 Apple Touch 图标

接下来可以阅读与尝试

探索 LFFavicon 的其他工具,以及解答常见问题的指南。

工具

指南