Salut, je suis PipCes apps Featured passent à tour de rôle dans mon notch.
iPipSoumettre

← Tous les outils

Vérificateur d'icône de barre des menus

Déposez ci-dessous l'icône de votre barre des menus. Elle est dessinée ici même, sur cette page, et l'image n'est jamais envoyée.

Vérificateur d'icône de barre des menus

Essayez un exemple :

Ce qu'il fait

Déposez la petite icône que votre app Mac place dans la barre des menus, celle qu'Apple appelle un menu bar extra, au format PNG ou SVG. L'outil la dessine sur une barre des menus claire et sur une sombre, comme image modèle et avec ses propres couleurs, et à l'état sélectionné. Puis il vérifie ce qui rend les icônes de barre des menus laides : des couleurs dans une image censée être un modèle, une image plus haute que la barre, un dessin trop petit ou trop grand pour elle, une copie Retina manquante, et une icône qui se fond dans la barre quand ce n'est pas un modèle. Cela concerne l'icône de la barre des menus. Pour l'icône de votre app dans le Dock et le Finder, utilisez le vérificateur d'icône Mac.

Ce que dit Apple

Les Human Interface Guidelines d'Apple indiquent que la barre des menus mesure 24 pt de haut, et suggèrent un symbole pour un menu bar extra, soit un SF Symbol, soit le vôtre. Les icônes d'interface et les symboles utilisent le noir et le transparent pour définir leur forme, et le système applique d'autres couleurs aux parties noires, afin que l'icône soit bien lisible sur les barres des menus sombres et claires et quand elle est sélectionnée. La documentation AppKit d'Apple indique que les images modèles doivent être uniquement noires et transparentes, et que le canal alpha peut modifier l'opacité du noir. Pour vos propres icônes d'interface, Apple suggère un format vectoriel comme PDF ou SVG.

Apple ne donne pas de taille en points pour les icônes de la barre des menus. Les repères de 10 pt et 22 pt dans les contrôles sont notre règle empirique, et l'outil l'indique là où il les utilise.

Comment en faire une image modèle

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

Dans Xcode, vous pouvez aussi sélectionner l'ensemble d'images dans votre catalogue de ressources et régler Render As sur Template Image. Un SF Symbol est déjà un modèle.

Comment fonctionnent les contrôles

L'image est dessinée dans votre navigateur et chaque pixel est lu. Les pixels presque transparents sont écartés. Un pixel compte comme coloré quand son rouge, son vert et son bleu sont très éloignés, et comme gris ou blanc quand ils sont proches mais pas sombres. Les tailles en points sont les pixels divisés par l'échelle. L'outil devine l'échelle d'après le nom du fichier (@2x, @3x) ou la hauteur, et vous pouvez la régler vous-même. Le contraste utilise la formule WCAG 2 avec deux couleurs de barre unies. La vraie barre des menus est translucide et prend les couleurs du fond d'écran, donc les aperçus et les rapports sont proches, pas exacts.

Ce que signifie chaque résultat

RepèreCe que cela signifie
OKCette partie est prête.
AspectCela fonctionne, mais l'affichage peut être mauvais pour certaines personnes, ou ce n'est pas ce qu'Apple demande.
RemarqueBon à savoir, rien n'est cassé.
CorrigerL'icône aura l'air cassée dans la barre des menus tant que cela ne change pas.

Questions

Quelle taille doit avoir une icône de barre des menus Mac ?

Apple donne à la barre des menus une hauteur de 24 pt et aucune taille fixe pour l'icône, donc l'image doit tenir dans 24 pt, avec un peu de marge au-dessus et en dessous. Fournissez une copie @2x, ou un PDF ou SVG, pour qu'elle reste nette sur les écrans Retina.

Qu'est-ce qu'une image modèle ?

Une image que macOS colorie pour vous. Elle doit être uniquement noire et transparente. Le système la dessine pour qu'elle soit bien lisible sur les barres des menus claires et sombres et quand elle est sélectionnée.

Pourquoi l'icône de ma barre des menus disparaît-elle en mode sombre ?

Généralement parce que ce n'est pas une image modèle. Une icône noire affichée avec ses propres couleurs se fond dans une barre des menus sombre. Marquez-la comme modèle, avec isTemplate dans le code ou Render As Template Image dans le catalogue de ressources.

Mon icône est-elle envoyée quelque part ?

Non. L'image est lue et dessinée dans votre navigateur, et rien n'est envoyé.

Voir aussi