This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 55).

Switch

A toggle control that switches between on and off states.

Android

iOS

Web

Included in Expo Go

A controlled toggle. Pair value with onValueChange to manage state from React.

Installation

Terminal

- npx 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 switch

SwitchExample.tsx

import { useState } from 'react';
import { Host, Switch } from '@expo/ui';

export default function SwitchExample() {
  const [enabled, setEnabled] = useState(false);

  return (
    <Host matchContents>
      <Switch value={enabled} onValueChange={setEnabled} />
    </Host>
  );
}

With label

When label is provided, the switch is rendered alongside its text in a labeled row.

LabeledSwitchExample.tsx

import { useState } from 'react';
import { Host, Switch } from '@expo/ui';

export default function LabeledSwitchExample() {
  const [notifications, setNotifications] = useState(true);

  return (
    <Host style={{ flex: 1 }}>
      <Switch label="Enable notifications" value={notifications} onValueChange={setNotifications} />
    </Host>
  );
}

API

import { Switch } from '@expo/ui';

No API data file found, sorry!