Skip to content

UIColor.systemGrayColor static property ​

The UIColor.systemGrayColor static property is the gray among the system colors. System colors are a set of colors commonly used in iOS interfaces; their values are determined by the system and differ slightly between Light Mode and Dark Mode.

You don't need it in everyday code: write the string 'systemGray' 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.systemGrayColor === UIColor.systemGrayColor is true.
  • Assigning it to a color property has the same effect as writing 'systemGray'. It reads back as the string 'systemGray', not a UIColor object. Reading back 'systemGray' after writing it to a color property goes through the same code as the other color names and is not individually verified in the simulator.
  • The exact value is not documented.

Examples ​

js
const box = new UIView();
box.backgroundColor = UIColor.systemGrayColor;
console.log(box.backgroundColor);

Result: The console prints systemGray. The on-screen color is not verified in the simulator.

Corresponding iOS API ​

UIColor.systemGrayColor. In Swift the name is UIColor.systemGray, which matches the color name string here.

See also ​