Object
An object is an icon that represents a content type.
When to use
- Showing the type of each item in a mixed list, so people can tell a bug from a story at a glance.
- Next to an item title, when the type is useful but does not need a word.
When not to use
- For a person or a team. Use an avatar or a tile.
- For status. Use a lozenge. Mixing the two gives colour two meanings.
- In a list where every item is the same type. The icon repeats on every row and adds nothing.
Guidance
Do
Sync fails on retry
Put the type icon next to the title. Use the same glyph for each type everywhere.
Don't
Do not show the icons as a legend and expect people to learn them. People learn an icon from seeing it next to the item it marks.
Intensity
How much attention each of this component's grounds uses, scored against the ladder in both themes.
| Appearance | Ground | Light | Dark |
|---|---|---|---|
| object | brand-bold | 0.460Marked | 0.598Marked |
| object--bug | danger-bold | 0.443Marked | 0.617Marked |
| object--epic | discovery-bold | 0.444Marked | 0.624Marked |
| object--story | lime-bold | 0.450Marked | 0.695Marked |
| object--task | brand-bold | 0.460Marked | 0.598Marked |
Substrate, Ambient and Marked are measured. Directed depends on what else is in the region. Demanded is declared, and its use is limited. So neither of those two depends on the component alone. See intensity.