Verifica icona della barra dei menu
Trascina qui sotto l'icona della barra dei menu. Viene disegnata direttamente in questa pagina e l'immagine non viene mai caricata.
Prova un esempio:
Che cosa fa
Trascina la piccola icona che la tua app Mac mette nella barra dei menu, quella che Apple chiama menu bar extra, come PNG o SVG. Lo strumento la disegna su una barra dei menu chiara e una scura, come immagine template e con i suoi colori, e nello stato selezionato. Poi controlla ciò che fa sembrare sbagliate le icone della barra dei menu: colori in un'immagine pensata come template, un'immagine più alta della barra, un disegno troppo piccolo o troppo grande, una copia Retina mancante e un'icona che si confonde con la barra quando non è un template. Questo vale per l'icona della barra dei menu. Per l'icona della tua app nel Dock e nel Finder, usa il verificatore di icone Mac.
Cosa dice Apple
Le Human Interface Guidelines di Apple dicono che la barra dei menu è alta 24 pt e suggeriscono un simbolo per un menu bar extra, un SF Symbol o uno tuo. Le icone e i simboli dell'interfaccia usano nero e trasparente per definire la forma, e il sistema applica altri colori alle parti nere, così l'icona appare corretta sulle barre dei menu scure e chiare e quando è selezionata. La documentazione AppKit di Apple dice che le immagini template dovrebbero essere solo nere e trasparenti e che il canale alfa può cambiare l'opacità del nero. Per le tue icone dell'interfaccia, Apple suggerisce un formato vettoriale come PDF o SVG.
Apple non indica una dimensione in punti per le icone della barra dei menu. I valori di 10 pt e 22 pt nei controlli sono la nostra regola pratica e lo strumento lo dice dove li usa.
Come renderla un'immagine template
// 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 puoi anche selezionare l'image set nel tuo asset catalog e impostare Render As su Template Image. Un SF Symbol è già un template.
Come funzionano i controlli
L'immagine viene disegnata nel tuo browser e ogni pixel viene letto. I pixel quasi trasparenti vengono esclusi. Un pixel conta come colorato quando rosso, verde e blu sono molto distanti, e come grigio o bianco quando sono vicini ma non scuri. Le dimensioni in punti sono i pixel divisi per la scala. Lo strumento deduce la scala dal nome del file (@2x, @3x) o dall'altezza, e puoi impostarla tu. Il contrasto usa la formula WCAG 2 rispetto a due colori piatti della barra. La vera barra dei menu è trasparente e assume i colori dello sfondo, quindi le anteprime e i rapporti sono vicini, non esatti.
Cosa significa ogni risultato
| Voto | Che cosa significa |
|---|---|
| OK | Questa parte è pronta. |
| Aspetto | Funziona, ma per alcune persone potrebbe sembrare sbagliata, oppure non è ciò che chiede Apple. |
| Nota | Da sapere, nulla è rotto. |
| Correggi | L'icona apparirà rotta nella barra dei menu finché questo non cambia. |
Domande
Che dimensione dovrebbe avere l'icona della barra dei menu di un Mac?
Apple dà alla barra dei menu un'altezza di 24 pt e nessuna dimensione fissa per l'icona, quindi l'immagine deve stare entro 24 pt, con un po' di spazio sopra e sotto. Fornisci una copia @2x, o un PDF o SVG, così resta nitida sugli schermi Retina.
Cos'è un'immagine template?
Un'immagine che macOS colora per te. Dovrebbe essere solo nera e trasparente. Il sistema la disegna in modo che appaia corretta sulle barre dei menu chiare e scure e quando è selezionata.
Perché l'icona della mia barra dei menu sparisce in modalità scura?
Di solito perché non è un'immagine template. Un'icona nera mostrata con i suoi colori si confonde con una barra dei menu scura. Contrassegnala come template, con isTemplate nel codice o con Render As Template Image nell'asset catalog.
La mia icona viene caricata da qualche parte?
No. L'immagine viene letta e disegnata nel tuo browser, e non viene inviato nulla.