UIColor.secondarySystemGroupedBackgroundColor static property
The UIColor.secondarySystemGroupedBackgroundColor static property is a semantic color: the background of the groups placed on a grouped-style page background. Semantic colors are named by purpose; their values are determined by the system and change with Light Mode, Dark Mode, and the Increase Contrast setting.
You don't need it in everyday code: write the string 'secondarySystemGroupedBackground' directly to a color property for the same effect.
Value
UIColor.
- Read-only. Assigning to it throws
TypeError. - Reading it always returns the same object:
UIColor.secondarySystemGroupedBackgroundColor === UIColor.secondarySystemGroupedBackgroundColoristrue. - Assigning it to a color property has the same effect as writing
'secondarySystemGroupedBackground'. It reads back as the string'secondarySystemGroupedBackground', not aUIColorobject (verified by testing). - The exact value has not been measured.
Examples
js
const box = new UIView();
box.backgroundColor = UIColor.secondarySystemGroupedBackgroundColor;
console.log(box.backgroundColor);Result: The console prints secondarySystemGroupedBackground. The on-screen color is not verified in the simulator.
Corresponding iOS API
UIColor.secondarySystemGroupedBackgroundColor. In Swift the name is UIColor.secondarySystemGroupedBackground, which matches the color name string here.