Color

struct · iOS 13.0+ · SDK 27.1

@frozen struct Color

A representation of a color that adapts to a given context. You can create a color in one of several ways: * Load a color from an Asset Catalog: ``` let aqua = Color("aqua") // Looks in your app's main bundle by default. ``` * Specify component values, like red, green, and blue; hue, saturation, and brightness; or white level: ``` let skyBlue = Color(red: 0.4627, green: 0.8392, blue: 1.0) let lemonYellow = Color(hue: 0.1639, saturation: 1, brightness: 1) let steelGray = Color(white: 0.4745) ``` * Create a color instance from another color, like a <doc://com.apple.documentation/documentation/UIKit/UIColor> or an <doc://com.apple.documentation/documentation/AppKit/NSColor>: ``` #if os(iOS) let linkColor = Color(uiColor: .link) #elseif os(macOS) let linkColor = Color(nsColor: .linkColor) #endif ``` * Use one of a palette of predefined colors, like ``ShapeStyle/black``, ``ShapeStyle/green``, and ``ShapeStyle/purple``. Some view modifiers can take a color as an argument. For example, ``View/foregroundStyle(_:)`` uses the color you provide to set the foreground color for view elements, like text or <doc://com.apple.documentation/design/human-interface-guidelines/sf-symbols>: Image(systemName: "leaf.fill") .foregroundStyle(Color.green)  Because SwiftUI treats colors as ``View`` instances, you can also directly add them to a view hierarchy. For example, you can layer a rectangle beneath a sun image using colors defined above: ZStack { skyBlue Image(systemName: "sun.max.fill") .foregroundStyle(lemonYellow) } .frame(width: 200, height: 100) A color used as a view expands to fill all the space it's given, as defined by the frame of the enclosing ``ZStack`` in the above example:  SwiftUI only resolves a color to a concrete value just before using it in a given environment. This enables a context-dependent appearance for system defined colors, or those that you load from an Asset Catalog. For example, a color can have distinct light and dark variants that the system chooses from at render time.

Members (37)

static initCgColor(cgColor: _CoreGraphics_CGColor): Color

init(cgColor: CGColor)

get cgColor(): (_CoreGraphics_CGColor) | null

var cgColor: CGColor? { get }

static get accentColor(): Color

static var accentColor: Color { get }

resolveHDR(environment: EnvironmentValues): Color_ResolvedHDR

func resolveHDR(in environment: EnvironmentValues) -> Color.ResolvedHDR

get description(): string

var description: String { get }

exposureAdjust(stops: number): Color

@export(implementation) func exposureAdjust(_ stops: Double) -> Color

static initHueSaturationBrightnessOpacity(hue: number, saturation: number, brightness: number, opacity?: number): Color

init(hue: Double, saturation: Double, brightness: Double, opacity: Double = 1)

mix(rhs: Color, fraction: number, colorSpace?: Gradient_ColorSpace): Color

func mix(with rhs: Color, by fraction: Double, in colorSpace: Gradient.ColorSpace = .perceptual) -> Color

static get red(): Color

static let red: Color

static get blue(): Color

static let blue: Color

static get cyan(): Color

static let cyan: Color

static get gray(): Color

static let gray: Color

static get mint(): Color

static let mint: Color

static get pink(): Color

static let pink: Color

static get teal(): Color

static let teal: Color

static get black(): Color

static let black: Color

static get brown(): Color

static let brown: Color

static get clear(): Color

static let clear: Color

static get green(): Color

static let green: Color

static get white(): Color

static let white: Color

static get indigo(): Color

static let indigo: Color

static get orange(): Color

static let orange: Color

static get purple(): Color

static let purple: Color

static get yellow(): Color

static let yellow: Color

opacity(opacity: number): Color

func opacity(_ opacity: Double) -> Color

static get primary(): Color

static let primary: Color

resolve(environment: EnvironmentValues): Color_Resolved

func resolve(in environment: EnvironmentValues) -> Color.Resolved

get gradient(): AnyGradient

var gradient: AnyGradient { get }

headroom(headroom?: (number) | null): Color

func headroom(_ headroom: Double?) -> Color

static get secondary(): Color

static let secondary: Color

static initRedGreenBlueOpacity(colorSpace: Color_RGBColorSpace, red: number, green: number, blue: number, opacity?: number): Color

init(_ colorSpace: Color.RGBColorSpace = .sRGB, red: Double, green: Double, blue: Double, opacity: Double = 1)

static initWhiteOpacity(colorSpace: Color_RGBColorSpace, white: number, opacity?: number): Color

init(_ colorSpace: Color.RGBColorSpace = .sRGB, white: Double, opacity: Double = 1)

static initBundle(name: string, bundle?: (_Foundation_Bundle) | null): Color

init(_ name: String, bundle: Bundle? = nil)

static init(resolved: Color_ResolvedHDR): Color

init(_ resolved: Color.ResolvedHDR)

static init85145(resolved: Color_Resolved): Color

init(_ resolved: Color.Resolved)

static init50051(resource: _DeveloperToolsSupport_ColorResource): Color

init(_ resource: ColorResource)

static init51359(cgColor: _CoreGraphics_CGColor): Color

init(_ cgColor: CGColor)

All SwiftUICore types →