iPipОтправить

← Все инструменты

Проверка значка строки меню

Перетащите значок строки меню ниже. Он рисуется прямо на этой странице, картинка никуда не загружается.

Проверка значка строки меню

Попробуйте пример:

Что делает

Перетащите маленький значок, который ваше приложение для 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 в каталоге ресурсов.

Загружается ли мой значок куда-нибудь?

Нет. Картинка читается и рисуется в вашем браузере, и никуда ничего не отправляется.

Похожее