Перевірка значка рядка меню
Перетягніть значок рядка меню нижче. Він малюється прямо на цій сторінці, картинка нікуди не завантажується.
Спробуйте приклад:
Що робить
Перетягніть маленький значок, який ваш застосунок для 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 у каталозі ресурсів.
Чи завантажується мій значок кудись?
Ні. Зображення читається й малюється у вашому браузері, і нічого не надсилається.