こんにちは、PipですこのFeaturedアプリが私のノッチに順番に表示されます。
iPip登録

← すべてのツール

メニューバーアイコンチェッカー

メニューバーアイコンを下にドロップしてください。このページの中でそのまま描画され、画像がアップロードされることはありません。

メニューバーアイコンチェッカー

例を試す:

機能

あなたの Mac アプリがメニューバーに表示する小さなアイコン、Apple がメニューバーエクストラと呼ぶものを、PNG か SVG でドロップしてください。ツールは、明るいメニューバーと暗いメニューバーに、テンプレートイメージとして、またそのままの色で、さらに選択された状態でも描画します。そして、メニューバーアイコンがおかしく見える原因をチェックします。テンプレートにするはずの画像に色がついている、画像がバーより高い、描画がバーに対して小さすぎる、または大きすぎる、Retina 用のコピーがない、テンプレートでないためにアイコンがバーに溶け込んでしまう、といった点です。これはメニューバーアイコン用です。Dock や Finder に表示されるアプリアイコンには、Mac アイコンチェッカーを使ってください。

Apple の説明

Apple の Human Interface Guidelines では、メニューバーの高さは 24 pt とされ、メニューバーエクストラには SF Symbol か自作のシンボルを使うことが提案されています。インターフェイスのアイコンやシンボルは、黒と透明で形を定義し、システムが黒い部分に別の色を適用するため、暗いメニューバーでも明るいメニューバーでも、選択されたときでも正しく見えます。Apple の AppKit のドキュメントには、テンプレートイメージは黒と透明だけにするべきで、アルファチャンネルで黒の不透明度を変えられると書かれています。自作のインターフェイスアイコンには、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 の式を、2 つの単色のバーの色に対して使っています。実際のメニューバーは透けていて壁紙の色を帯びるため、プレビューと比率は近い値ですが、正確ではありません。

各結果の意味

印意味
OKこの部分は問題ありません。
見た目動きますが、人によっては正しく見えないか、Apple の求めるものと違っています。
注知っておくとよいことですが、壊れているわけではありません。
修正これが変わるまで、アイコンはメニューバーで壊れて見えます。

質問

Mac のメニューバーアイコンはどのくらいのサイズにするべきですか?

Apple はメニューバーの高さを 24 pt としていますが、アイコンの決まったサイズは示していません。そのため、上下に少し余白を残して 24 pt の中に収める必要があります。Retina 画面でもくっきり見えるように、@2x のコピー、または PDF か SVG を用意してください。

テンプレートイメージとは何ですか?

macOS が色をつけてくれる画像です。黒と透明だけで作る必要があります。システムが描画するので、明るいメニューバーでも暗いメニューバーでも、選択されたときでも正しく見えます。

ダークモードでメニューバーアイコンが消えるのはなぜですか?

たいていは、テンプレートイメージではないからです。黒いアイコンをそのままの色で表示すると、暗いメニューバーに溶け込んでしまいます。コードでは isTemplate、アセットカタログでは Render As の Template Image を使って、テンプレートに設定してください。

アイコンはどこかにアップロードされますか?

いいえ。画像はブラウザで読み込まれて描画され、どこにも送信されません。

関連