Привіт, я PipЦі застосунки Featured по черзі показуються в моєму notch.
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 у каталозі ресурсів.

Чи завантажується мій значок кудись?

Ні. Зображення читається й малюється у вашому браузері, і нічого не надсилається.

Схожі