Apple UI Colors

macOS Quaternary System Fill

NSColor.quaternarySystemFill
Desktop Control Surface
Adaptive System Token•macOS 10.10+ / 10.14+, AppKit

Complete technical specification and developer reference for Quaternary System Fill in Apple's macOS design system. In light appearance, it resolves to HEX rgba(0, 0, 0, 0.03); in dark appearance, it dynamically adapts to HEX rgba(255, 255, 255, 0.03). Features wide-gamut Display P3 values, UIKit bridge (UIColor.quaternarySystemFill), AppKit bridge (NSColor.quaternarySystemFill), WCAG contrast audit, and Xcode drop-in initializers.

Light Modergba(0, 0, 0, 0.03)
Dark Modergba(255, 255, 255, 0.03)
Quaternary System Fill Color Preview

A quaternary fill color for controls and interface elements.

ColorNSColor.quaternarySystemFill
Copy:
Dynamic Asset
Desktop Control Surface
macOS 10.10+ / 10.14+, AppKit
Initializers & Color Spaces
Color(r:g:b:)Color(red: 0.000, green: 0.000, blue: 0.000)
Color(r:g:b:op:)Color(red: 0.000, green: 0.000, blue: 0.000, opacity: 0.03)
Color(hue:sat:bri:)HSBColor(hue: 0.000, saturation: 0.000, brightness: 0.000, opacity: 0.03)
Color(.displayP3)Wide GamutColor(.displayP3, red: 0.000, green: 0.000, blue: 0.000, opacity: 0.03)
Color(.sRGB)Color(.sRGB, red: 0.000, green: 0.000, blue: 0.000, opacity: 0.03)
Color(hex:)ExtensionColor(hex: "rgba(0, 0, 0, 0.03)")
#colorLiteralXcode#colorLiteral(red: 0.000, green: 0.000, blue: 0.000, alpha: 0.03)
Color(uiColor:)iOSColor(uiColor: UIColor(red: 0.000, green: 0.000, blue: 0.000, alpha: 0.03))
Active HEX: rgba(0, 0, 0, 0.03)P3 R: 0.000 G: 0.000 B: 0.000

Technical Color Specifications

Exact resolved HEX codes, sRGB 8-bit components, HSL, and normalized Swift floating-point decimals for Light and Dark modes.

Color Metric / SpaceLight AppearanceDark AppearanceSwift Code Literal
HEX Codergba(0, 0, 0, 0.03)rgba(255, 255, 255, 0.03)Color(hex: "rgba(0, 0, 0, 0.03)")
sRGB (0–255)rgba(0, 0, 0, 0.03)rgba(255, 255, 255, 0.03)(r: 0.000, g: 0.000, b: 0.000)
Display P3 (Wide Gamut)P3 (0.000, 0.000, 0.000)P3 (1.000, 1.000, 1.000)Color(.displayP3, ...)
HSL / HSBhsla(0, 0%, 0%, 0.03)hsla(0, 0%, 100%, 0.03)Color(hue:sat:bri:)
Platform BridgeUIKit: UIColor.quaternarySystemFillAppKit: NSColor.quaternarySystemFillColor(uiColor:) / Color(nsColor:)

Light Appearance

Light Theme
HEX Code
rgba(0, 0, 0, 0.03)
RGB (0–255)
rgba(0, 0, 0, 0.03)
HSL
hsla(0, 0%, 0%, 0.03)
Normalized Swift Literal:
(r: 0.000, g: 0.000, b: 0.000)

Dark Appearance

Dark Theme
HEX Code
rgba(255, 255, 255, 0.03)
RGB (0–255)
rgba(255, 255, 255, 0.03)
HSL
hsla(0, 0%, 100%, 0.03)
Normalized Swift Literal:
(r: 1.000, g: 1.000, b: 1.000)

Drop-In Developer Snippets

Ready-to-paste code blocks for Xcode asset catalogs and Swift files.

Xcode Location: Save as Contents.json inside Assets.xcassets/Quaternary System Fill.colorset/
Includes Light + Dark Modes
Contents.json
{
  "colors": [
    {
      "color": {
        "color-space": "srgb",
        "components": {
          "red": "0.000",
          "green": "0.000",
          "blue": "0.000",
          "alpha": "0.030"
        }
      },
      "idiom": "universal"
    },
    {
      "appearances": [
        {
          "appearance": "luminosity",
          "value": "dark"
        }
      ],
      "color": {
        "color-space": "srgb",
        "components": {
          "red": "1.000",
          "green": "1.000",
          "blue": "1.000",
          "alpha": "0.030"
        }
      },
      "idiom": "universal"
    }
  ],
  "info": {
    "author": "xcode",
    "version": 1
  }
}

Live UI Component Sandbox

Preview Color.quaternary system fill inside standard Apple interface components.

Interactive Controls
Active TagBadge 99+
Toggle Tint
Container & Typography Styling

●SwiftUI Notification

Just now

Demonstrates how Apple designers pair system background tints with dynamic Quaternary System Fill accents.

Dynamic Headline in Quaternary System Fill

.foregroundStyle(NSColor.quaternarySystemFill)

Platform Implementation Snippets

Ready-to-use Swift code for SwiftUI, UIKit, and AppKit applications.

AppKit (macOS Swift)
// AppKit (macOS)
let button = NSButton()
button.contentTintColor = NSColor.quaternarySystemFill

// Custom Layer Tint
let layer = CALayer()
layer.backgroundColor = NSColor.quaternarySystemFill.cgColor

// Bridging AppKit into SwiftUI
let swiftUIColor = Color(nsColor: .quaternarySystemFill)

WCAG 2.1 Accessibility Contrast Audit

Contrast calculations of Quaternary System Fill against pure white and iOS OLED dark surfaces.

Light Mode (rgba(0, 0, 0, 0.03))on White (#FFF)
Contrast Ratio:1.07:1
Normal Text (4.5:1 AA): Fail
Dark Mode (rgba(255, 255, 255, 0.03))on Dark (#1C1C1E)
Contrast Ratio:1.08:1
Normal Text (4.5:1 AA): Fail

Recommended HIG Use Cases

  • Buttons, popups, and segmented controls
  • Active selection rings and focus states
  • Slider tracks and progress indicators

Anti-Patterns to Avoid

  • Long-form document text
  • Static non-interactive headers

Browse More macOS Colors

Quickly jump to other Apple system colors and semantic tokens.

All 53 Colors →
System Red
System Orange
System Yellow
System Green
System Mint
System Teal
System Cyan
System Blue
System Indigo
System Purple
System Pink
System Brown
System Gray
Label
Secondary Label
Tertiary Label
Quaternary Label
Quinary Label

Frequently Asked Questions

How do I use NSColor.quaternarySystemFill in macOS AppKit apps?

In AppKit, assign NSColor.quaternarySystemFill to NSView, NSTextField, or NSButton styling. In SwiftUI on macOS, bridge it using Color(nsColor: .quaternarySystemFill).

What is the HEX code for macOS Quaternary System Fill in light and dark mode?

In light appearance, Quaternary System Fill resolves to rgba(0, 0, 0, 0.03). In dark appearance, it automatically adapts to rgba(255, 255, 255, 0.03).

How do I bridge NSColor.quaternarySystemFill into SwiftUI?

In SwiftUI views on macOS, instantiate Color(nsColor: .quaternarySystemFill) to access the native AppKit dynamic color token.

Does Quaternary System Fill adapt to Dark Mode and vibrancy in macOS?

Yes, NSColor.quaternarySystemFill is an appearance-aware NSColor that updates automatically when switching between light and dark modes or across vibrant desktop materials.

Why use AppKit system colors instead of hardcoded hex values?

NSColor system tokens adapt automatically to user accent color preferences, Dark Mode, and accessibility contrast settings.