Hallo, ich bin PipDiese Featured-Apps wechseln sich in meinem Notch ab.
iPipEinreichen

← Alle Tools

Menüleisten-Symbol-Prüfer

Zieh dein Menüleisten-Symbol unten hinein. Es wird direkt auf dieser Seite gezeichnet, und das Bild wird nie hochgeladen.

Menüleisten-Symbol-Prüfer

Probiere ein Beispiel:

Was es macht

Zieh das kleine Symbol hinein, das deine Mac-App in die Menüleiste setzt, das, was Apple ein Menüleisten-Extra nennt, als PNG oder SVG. Das Tool zeichnet es auf einer hellen und einer dunklen Menüleiste, als Template-Bild und in seinen eigenen Farben, und im ausgewählten Zustand. Dann prüft es, was Menüleisten-Symbole falsch aussehen lässt: Farben in einem Bild, das ein Template sein soll, ein Bild, das höher ist als die Leiste, eine Zeichnung, die dafür zu klein oder zu groß ist, eine fehlende Retina-Kopie und ein Symbol, das in der Leiste verschwindet, wenn es kein Template ist. Das gilt für das Menüleisten-Symbol. Für dein App-Symbol im Dock und im Finder nutze den Mac-Symbol-Prüfer.

Was Apple sagt

Apples Human Interface Guidelines sagen, die Menüleiste sei 24 pt hoch, und empfehlen für ein Menüleisten-Extra ein Symbol, entweder ein SF Symbol oder dein eigenes. Oberflächensymbole und Symbole nutzen Schwarz und Transparent, um ihre Form zu bestimmen, und das System wendet auf die schwarzen Teile andere Farben an, damit das Symbol auf dunklen und hellen Menüleisten und im ausgewählten Zustand richtig aussieht. Apples AppKit-Dokumentation sagt, Template-Bilder sollten nur schwarz und transparent sein, und der Alphakanal könne ändern, wie deckend das Schwarz ist. Für deine eigenen Oberflächensymbole empfiehlt Apple ein Vektorformat wie PDF oder SVG.

Apple gibt für Menüleisten-Symbole keine Größe in Punkten vor. Die Marken von 10 pt und 22 pt in den Prüfungen sind unsere Faustregel, und das Tool sagt das dort, wo es sie verwendet.

So wird daraus ein Template-Bild

// 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() }

In Xcode kannst du auch das Bildset in deinem Asset-Katalog auswählen und Render As auf Template Image setzen. Ein SF Symbol ist bereits ein Template.

So funktionieren die Prüfungen

Das Bild wird in deinem Browser gezeichnet und jedes Pixel wird gelesen. Pixel, die fast transparent sind, werden weggelassen. Ein Pixel zählt als farbig, wenn Rot, Grün und Blau weit auseinanderliegen, und als grau oder weiß, wenn sie nah beieinanderliegen, aber nicht dunkel sind. Größen in Punkten sind die Pixel geteilt durch den Maßstab. Das Tool errät den Maßstab aus dem Dateinamen (@2x, @3x) oder der Höhe, und du kannst ihn selbst einstellen. Der Kontrast nutzt die WCAG-2-Formel gegen zwei einfarbige Leistenfarben. Die echte Menüleiste ist durchscheinend und übernimmt die Farben des Hintergrundbilds, deshalb sind die Vorschauen und die Verhältnisse nah dran, aber nicht exakt.

Was jedes Ergebnis bedeutet

MarkierungWas es bedeutet
OKDieser Teil ist bereit.
AussehenEs funktioniert, sieht aber für manche Leute vielleicht falsch aus, oder es entspricht nicht dem, was Apple verlangt.
HinweisGut zu wissen, nichts ist kaputt.
BehebenDas Symbol sieht in der Menüleiste kaputt aus, bis sich das ändert.

Fragen

Wie groß sollte ein Mac-Menüleisten-Symbol sein?

Apple gibt der Menüleiste eine Höhe von 24 pt und keine feste Größe für das Symbol, das Bild muss also in 24 pt passen, mit etwas Platz oben und unten. Liefere eine @2x-Kopie oder ein PDF oder SVG mit, damit es auf Retina-Bildschirmen scharf bleibt.

Was ist ein Template-Bild?

Ein Bild, das macOS für dich einfärbt. Es sollte nur schwarz und transparent sein. Das System zeichnet es so, dass es auf hellen und dunklen Menüleisten und im ausgewählten Zustand richtig aussieht.

Warum verschwindet mein Menüleisten-Symbol im Dunkelmodus?

Meist, weil es kein Template-Bild ist. Ein schwarzes Symbol in seinen eigenen Farben verschwindet in einer dunklen Menüleiste. Markiere es als Template, mit isTemplate im Code oder Render As Template Image im Asset-Katalog.

Wird mein Icon irgendwo hochgeladen?

Nein. Das Bild wird in deinem Browser gelesen und gezeichnet, und nichts wird gesendet.

Verwandt