ColorPicker

A SwiftUI ColorPicker component for selecting colors.

iOS

Included in Expo Go

GitHub

npm

Changelog

Recommended version:

~57.0.14

Expo UI ColorPicker matches the official SwiftUI ColorPicker API and allows app users to select colors from a palette.

ColorPicker row inside a Form, showing the current color swatch

Installation

Terminal

- npx expo install @expo/ui

- yarn expo install @expo/ui

- pnpm expo install @expo/ui

- bun expo install @expo/ui

If you are installing this in an existing React Native app, make sure to install expo in your project.

Usage

Basic color picker

ColorPickerExample.tsx

import { useState } from 'react';
import { Host, ColorPicker } from '@expo/ui/swift-ui';

export default function ColorPickerExample() {
  const [color, setColor] = useState('#FF6347');

  // A color picker fills the width it is given, so `matchContents` collapses it.
  return (
    <Host style={{ flex: 1 }}>
      <ColorPicker
        label="Select a color"
        selection={color}
        onSelectionChange={setColor}
      />
    </Host>
  );
}

Color picker with opacity support

Use the supportsOpacity prop to allow users to select colors with alpha transparency.

ColorPickerOpacityExample.tsx

import { useState } from 'react';
import { Host, ColorPicker } from '@expo/ui/swift-ui';

export default function ColorPickerOpacityExample() {
  const [color, setColor] = useState('#FF634780');

  return (
    <Host style={{ flex: 1 }}>
      <ColorPicker
        label="Select a color with opacity"
        selection={color}
        onSelectionChange={setColor}
        supportsOpacity
      />
    </Host>
  );
}

API

import { ColorPicker } from '@expo/ui/swift-ui';

Component

`ColorPicker`

Only for:

iOS

Type: React.Element<ColorPickerProps>

Renders a ColorPicker component using SwiftUI.

ColorPickerProps

`label`

Only for:

iOS

Optional • Type: string

A label displayed on the ColorPicker.

`onSelectionChange`

Only for:

iOS

Optional • Type: (value: string) => void

Callback function that is called when a new color is selected.

`selection`

Only for:

iOS

Literal type: union

The currently selected color in the format #RRGGBB or #RRGGBBAA.

Acceptable values are: string | null

`supportsOpacity`

Only for:

iOS

Optional • Type: boolean

Whether the color picker should support opacity.

Inherited props

CommonViewModifierProps