UIColor.clearColor static property
The UIColor.clearColor static property is a fixed color: fully transparent. Its value doesn't change between Light Mode and Dark Mode.
You don't need it in everyday code: write the string 'clear' 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.clearColor === UIColor.clearColoristrue. - Assigning it to a color property has the same effect as writing
'clear'. It reads back as the string'clear', not aUIColorobject. Reading back'clear'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 value comes from Apple's definition, converted to 0–255 and rounded.
Examples
js
const box = new UIView();
box.backgroundColor = UIColor.clearColor;
console.log(box.backgroundColor);Result: The console prints clear. The on-screen color is not verified in the simulator.
Corresponding iOS API
UIColor.clearColor. In Swift the name is UIColor.clear, which matches the color name string here.