Changes in this version
Importance not yet assessed.
Adds guidance for touch input on Macs with a touch display across macOS pages
No section of this page changed in this version.
Other pages in this version: 18 sections on 6 pages. All pages changed in v35
Summaries are written automatically and may be wrong; the diff below is the record.
Rating indicators
A rating indicator doesn’t display partial symbols; it rounds the value to display complete symbols only. Within a rating indicator, symbols are always the same distance apart and don’t expand or shrink to fit the component’s width.
Best practices
Make it easy to change rankings. When presenting a list of ranked items, let people adjust the rank of individual items inline without navigating to a separate editing screen.
If you replace the star with a custom symbol, make sure that its purpose is clear. The star is a very recognizable ranking symbol, and people may not associate other symbols with a rating scale.
Platform considerations
No additional considerations for macOS. Not supported in iOS, iPadOS, tvOS, visionOS, or watchOS.
Resources
Related
Developer documentation
NSLevelIndicator.Style.rating — AppKit
Change log
Date | Changes |
|---|---|
September 23, 2022 | New page. |