Menubalkicoon-checker
Sleep je menubalkicoon hieronder. Het wordt hier op deze pagina getekend, en de afbeelding wordt nooit geüpload.
Probeer een voorbeeld:
Wat het doet
Sleep het kleine icoon dat je Mac-app in de menubalk zet, wat Apple een menu bar extra noemt, erheen als PNG of SVG. De tool tekent het op een lichte en een donkere menubalk, als templateafbeelding en in zijn eigen kleuren, en in de geselecteerde staat. Daarna controleert hij wat menubalkicoontjes er verkeerd uit laat zien: kleuren in een afbeelding die een template moet zijn, een afbeelding die hoger is dan de balk, een tekening die te klein of te groot is, een ontbrekende Retina-kopie en een icoon dat opgaat in de balk als het geen template is. Dit is voor het menubalkicoon. Voor het icoon van je app in het Dock en de Finder gebruik je de Mac-icoon-checker.
Wat Apple zegt
In de Human Interface Guidelines van Apple staat dat de menubalk 24 pt hoog is, en wordt een symbool voorgesteld voor een menu bar extra, een SF Symbol of je eigen symbool. Interface-iconen en symbolen gebruiken zwart en doorzichtig om hun vorm te bepalen, en het systeem past andere kleuren toe op de zwarte delen, zodat het icoon er goed uitziet op donkere en lichte menubalken en wanneer het geselecteerd is. In de AppKit-documentatie van Apple staat dat templateafbeeldingen alleen zwart en doorzichtig moeten zijn, en dat het alfakanaal kan veranderen hoe dekkend het zwart is. Voor je eigen interface-iconen stelt Apple een vectorformaat voor zoals PDF of SVG.
Apple geeft geen grootte in punten voor menubalkicoontjes. De markeringen van 10 pt en 22 pt in de controles zijn onze vuistregel, en de tool zegt dat erbij waar hij ze gebruikt.
Hoe maak je er een templateafbeelding van
// 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 kun je ook de image set in je asset catalog selecteren en Render As instellen op Template Image. Een SF Symbol is al een template.
Hoe de controles werken
De afbeelding wordt in je browser getekend en elke pixel wordt gelezen. Pixels die bijna doorzichtig zijn, worden weggelaten. Een pixel telt als gekleurd als rood, groen en blauw ver uit elkaar liggen, en als grijs of wit als ze dicht bij elkaar liggen maar niet donker zijn. Groottes in punten zijn de pixels gedeeld door de schaal. De tool raadt de schaal op basis van de bestandsnaam (@2x, @3x) of de hoogte, en je kunt hem zelf instellen. Contrast gebruikt de WCAG 2-formule tegen twee effen balkkleuren. De echte menubalk is doorzichtig en neemt de kleuren van de achtergrond over, dus de voorbeelden en verhoudingen komen dichtbij, maar zijn niet exact.
Wat elk resultaat betekent
| Markering | Wat het betekent |
|---|---|
| OK | Dit deel is klaar. |
| Uiterlijk | Het werkt, maar het kan er voor sommige mensen verkeerd uitzien, of het is niet wat Apple vraagt. |
| Let op | Goed om te weten, er is niets kapot. |
| Oplossen | Het icoon ziet er kapot uit in de menubalk tot dit verandert. |
Vragen
Hoe groot moet een Mac-menubalkicoon zijn?
Apple geeft de menubalk een hoogte van 24 pt en geen vaste grootte voor het icoon, dus de afbeelding moet binnen 24 pt passen, met wat ruimte boven en onder. Lever een @2x-kopie, of een PDF of SVG, zodat hij scherp blijft op Retina-schermen.
Wat is een templateafbeelding?
Een afbeelding die macOS voor je inkleurt. Hij moet alleen zwart en doorzichtig zijn. Het systeem tekent hem zo dat hij er goed uitziet op lichte en donkere menubalken en wanneer hij geselecteerd is.
Waarom verdwijnt mijn menubalkicoon in de donkere modus?
Meestal omdat het geen templateafbeelding is. Een zwart icoon in zijn eigen kleuren gaat op in een donkere menubalk. Markeer het als template, met isTemplate in code of Render As Template Image in de asset catalog.
Wordt mijn icoon ergens geüpload?
Nee. De afbeelding wordt gelezen en getekend in je browser, en er wordt niets verstuurd.