你好,我是 Pip这些 Featured 应用轮流出现在我的刘海里。
iPip提交

← 全部工具

菜单栏图标检查器

把你的菜单栏图标拖到下面。它就在这个页面上直接绘制,图片不会被上传。

菜单栏图标检查器

试试示例:

功能

把你的 Mac 应用放在菜单栏里的小图标,也就是 Apple 所说的菜单栏扩展,以 PNG 或 SVG 的形式拖进来。工具会把它画在浅色和深色菜单栏上,分别以模板图像和它自己的颜色呈现,还有被选中的状态。然后它会检查让菜单栏图标看起来不对劲的原因:本该是模板的图片里有颜色、图片比菜单栏高、绘制的内容相对菜单栏太小或太大、缺少 Retina 副本,以及不是模板时图标融进菜单栏。这个工具针对的是菜单栏图标。至于 Dock 和 Finder 里的应用图标,请使用 Mac 图标检查器。

Apple 怎么说

Apple 的 Human Interface Guidelines 说菜单栏高 24 pt,并建议菜单栏扩展使用符号,可以是 SF Symbol,也可以是你自己的。界面图标和符号用黑色和透明来定义形状,系统会给黑色部分应用其他颜色,所以图标在深色和浅色菜单栏上,以及被选中时,看起来都正常。Apple 的 AppKit 文档说,模板图像应该只有黑色和透明,而 Alpha 通道可以改变黑色的不透明度。对于你自己的界面图标,Apple 建议使用 PDF 或 SVG 这样的矢量格式。

Apple 没有给出菜单栏图标的点尺寸。检查中的 10 pt 和 22 pt 标记是我们的经验法则,工具在用到它们的地方也会这样说明。

如何把它做成模板图像

// AppKit
let item = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
let image = NSImage(named: "MenuIcon")
image?.isTemplate = true
item.button?.image = image

// SwiftUI, macOS 13 or later
MenuBarExtra("Zorbclip", image: "MenuIcon") { ContentView() }

在 Xcode 中,你也可以在资源目录里选中图像集,把 Render As 设为 Template Image。SF Symbol 本来就是模板。

检查是如何进行的

图片会在你的浏览器中绘制,并读取每一个像素。几乎透明的像素会被忽略。红、绿、蓝三个值相差很大的像素算作彩色,三个值接近但不是深色的像素算作灰色或白色。以点为单位的尺寸,是像素除以缩放比例。工具会根据文件名(@2x、@3x)或高度来猜测缩放比例,你也可以自己设定。对比度使用 WCAG 2 的公式,对照两种纯色的菜单栏颜色计算。真实的菜单栏是透明的,会带上壁纸的颜色,所以预览和比值只是接近,并不精确。

每种结果的含义

标记含义
正常这一部分已经没问题了。
外观它能用,但对一些人来说可能看起来不对,或者不符合 Apple 的要求。
注意值得了解,但没有任何问题。
修复在这一点改变之前,图标在菜单栏里看起来会是坏的。

问题

Mac 菜单栏图标应该多大?

Apple 规定菜单栏的高度是 24 pt,但没有规定图标的固定尺寸,所以图片必须放进 24 pt 之内,上下还要留一点空间。请提供一份 @2x 副本,或者 PDF、SVG,这样它在 Retina 屏幕上才会保持清晰。

什么是模板图像?

由 macOS 替你上色的图像。它应该只有黑色和透明。系统会负责绘制,所以在浅色和深色菜单栏上,以及被选中时,它看起来都正常。

为什么我的菜单栏图标在深色模式下消失了?

通常是因为它不是模板图像。以自身颜色显示的黑色图标,会融进深色菜单栏。请把它标记为模板:在代码里用 isTemplate,在资源目录里用 Render As Template Image。

我的图标会被上传到任何地方吗?

不会。图片在你的浏览器中读取和绘制,不会发送任何内容。

相关内容