Sprawdzanie ikony paska menu
Wrzuć poniżej ikonę paska menu. Jest rysowana tu, na tej stronie, a obraz nigdy nie jest wysyłany.
Wypróbuj przykład:
Co robi
Wrzuć małą ikonę, którą twoja aplikacja na Maca umieszcza na pasku menu, tę, którą Apple nazywa elementem paska menu, jako PNG lub SVG. Narzędzie rysuje ją na jasnym i ciemnym pasku menu, jako obraz szablonowy i we własnych kolorach, a także w stanie zaznaczenia. Potem sprawdza to, co psuje wygląd ikon paska menu: kolory w obrazie, który ma być szablonem, obraz wyższy niż pasek, rysunek za mały lub za duży, brak kopii Retina i ikonę, która zlewa się z paskiem, gdy nie jest szablonem. To dotyczy ikony paska menu. Dla ikony aplikacji w Docku i Finderze użyj sprawdzania ikon Maca.
Co mówi Apple
Human Interface Guidelines Apple mówią, że pasek menu ma wysokość 24 pt, i zalecają symbol dla elementu paska menu, albo SF Symbol, albo własny. Ikony interfejsu i symbole używają czerni i przezroczystości do określenia kształtu, a system nakłada inne kolory na czarne części, więc ikona wygląda dobrze na ciemnym i jasnym pasku menu oraz po zaznaczeniu. Dokumentacja AppKit Apple mówi, że obrazy szablonowe powinny być tylko czarne i przezroczyste, a kanał alfa może zmieniać krycie czerni. Dla własnych ikon interfejsu Apple zaleca format wektorowy, taki jak PDF lub SVG.
Apple nie podaje rozmiaru ikon paska menu w punktach. Oznaczenia 10 pt i 22 pt w sprawdzeniach to nasza orientacyjna zasada, a narzędzie mówi o tym tam, gdzie z nich korzysta.
Jak zrobić z niej obraz szablonowy
// 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() }W Xcode możesz też zaznaczyć zestaw obrazów w katalogu zasobów i ustawić Render As na Template Image. SF Symbol jest już szablonem.
Jak działają sprawdzenia
Obraz jest rysowany w twojej przeglądarce i odczytywany jest każdy piksel. Piksele prawie przezroczyste są pomijane. Piksel liczy się jako kolorowy, gdy jego czerwony, zielony i niebieski są daleko od siebie, a jako szary lub biały, gdy są blisko siebie, ale nie ciemne. Rozmiary w punktach to piksele podzielone przez skalę. Narzędzie zgaduje skalę po nazwie pliku (@2x, @3x) lub po wysokości, a możesz ją ustawić sam. Kontrast używa wzoru WCAG 2 względem dwóch jednolitych kolorów paska. Prawdziwy pasek menu jest półprzezroczysty i przybiera kolory tapety, więc podglądy i współczynniki są bliskie, ale nie dokładne.
Co oznacza każdy wynik
| Oznaczenie | Co to oznacza |
|---|---|
| OK | Ta część jest gotowa. |
| Wygląd | Działa, ale u niektórych osób może wyglądać źle albo nie jest tym, o co prosi Apple. |
| Uwaga | Warto wiedzieć, nic się nie psuje. |
| Popraw | Ikona będzie wyglądać na zepsutą na pasku menu, dopóki to się nie zmieni. |
Pytania
Jakiego rozmiaru powinna być ikona paska menu Maca?
Apple podaje wysokość paska menu 24 pt i nie ustala rozmiaru ikony, więc obraz musi się zmieścić w 24 pt, z odrobiną miejsca u góry i u dołu. Dołącz kopię @2x albo plik PDF lub SVG, żeby był ostry na ekranach Retina.
Czym jest obraz szablonowy?
Obraz, który macOS koloruje za ciebie. Powinien być tylko czarny i przezroczysty. System rysuje go tak, żeby wyglądał dobrze na jasnym i ciemnym pasku menu oraz po zaznaczeniu.
Dlaczego moja ikona paska menu znika w trybie ciemnym?
Zwykle dlatego, że to nie jest obraz szablonowy. Czarna ikona pokazana we własnych kolorach zlewa się z ciemnym paskiem menu. Oznacz ją jako szablon, przez isTemplate w kodzie lub Render As Template Image w katalogu zasobów.
Czy moja ikona gdzieś jest wysyłana?
Nie. Obraz jest odczytywany i rysowany w przeglądarce, a nic nie jest wysyłane.