Проверка значка строки меню
Перетащите значок строки меню ниже. Он рисуется прямо на этой странице, картинка никуда не загружается.
Попробуйте пример:
Что делает
Перетащите маленький значок, который ваше приложение для Mac помещает в строку меню, тот, что Apple называет menu bar extra, в формате PNG или SVG. Инструмент нарисует его на светлой и тёмной строке меню, как шаблонное изображение и в собственных цветах, а также в выделенном состоянии. Затем он проверит то, из-за чего значки строки меню выглядят плохо: цвета в картинке, которая должна быть шаблоном, картинку выше строки, рисунок слишком маленький или слишком большой для неё, отсутствие копии для Retina и значок, который сливается со строкой, если он не шаблон. Это для значка строки меню. Для значка приложения в Dock и Finder используйте проверку значка для Mac.
Что говорит Apple
В Human Interface Guidelines Apple сказано, что высота строки меню 24 pt, и для расширения строки меню предлагается символ, либо SF Symbol, либо ваш собственный. Значки интерфейса и символы задают форму чёрным и прозрачным, а система применяет к чёрным частям другие цвета, поэтому значок хорошо выглядит на тёмной и светлой строке меню и в выделенном состоянии. В документации Apple по AppKit сказано, что шаблонные изображения должны быть только чёрными и прозрачными, а альфа-канал может менять непрозрачность чёрного. Для собственных значков интерфейса Apple рекомендует векторный формат, например PDF или SVG.
Apple не задаёт размер значков строки меню в pt. Отметки 10 pt и 22 pt в проверках это наше практическое правило, и инструмент говорит об этом там, где их использует.
Как сделать шаблонное изображение
// 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() }В Xcode можно также выбрать набор изображений в каталоге ресурсов и установить для Render As значение Template Image. SF Symbol уже является шаблоном.
Как работают проверки
Картинка рисуется в вашем браузере, и читается каждый пиксель. Почти прозрачные пиксели не учитываются. Пиксель считается цветным, если его красная, зелёная и синяя составляющие сильно различаются, и серым или белым, если они близки, но пиксель не тёмный. Размеры в pt это пиксели, делённые на масштаб. Инструмент угадывает масштаб по имени файла (@2x, @3x) или по высоте, и вы можете задать его сами. Контраст считается по формуле WCAG 2 относительно двух плоских цветов строки. Настоящая строка меню полупрозрачна и принимает цвета обоев, поэтому превью и коэффициенты близки к реальным, но не точны.
Что означает каждый результат
| Отметка | Что это значит |
|---|---|
| OK | Эта часть готова. |
| Вид | Работает, но у некоторых людей может выглядеть неправильно, или это не то, чего просит Apple. |
| Заметка | Стоит знать, но ничего не сломано. |
| Исправить | Пока это не изменится, значок будет выглядеть в строке меню сломанным. |
Вопросы
Какого размера должен быть значок строки меню Mac?
Apple задаёт высоту строки меню 24 pt и не задаёт фиксированный размер значка, поэтому картинка должна помещаться в 24 pt с небольшим запасом сверху и снизу. Добавьте копию @2x, или PDF, или SVG, чтобы значок оставался чётким на экранах Retina.
Что такое шаблонное изображение?
Изображение, которое macOS окрашивает сама. Оно должно быть только чёрным и прозрачным. Система рисует его так, чтобы оно хорошо выглядело на светлой и тёмной строке меню и в выделенном состоянии.
Почему мой значок строки меню пропадает в тёмной теме?
Обычно потому, что это не шаблонное изображение. Чёрный значок в собственных цветах сливается с тёмной строкой меню. Отметьте его как шаблон: isTemplate в коде или Render As Template Image в каталоге ресурсов.
Загружается ли мой значок куда-нибудь?
Нет. Картинка читается и рисуется в вашем браузере, и никуда ничего не отправляется.