Ciao, sono PipQueste app Featured si alternano nel mio notch.
iPipInvia

← Tutti gli strumenti

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.

Verifica icona della barra dei menu

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

VotoChe cosa significa
OKQuesta parte è pronta.
AspettoFunziona, ma per alcune persone potrebbe sembrare sbagliata, oppure non è ciò che chiede Apple.
NotaDa sapere, nulla è rotto.
CorreggiL'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.

Correlati