开关

一个可以在开和关状态之间切换的切换控件。

Android

iOS

Web

Included in Expo Go

Recommended version:

~57.0.22

受控切换。将 value 与 onValueChange 配对，以便从 React 管理状态。

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

Two Material 3 switches showing on and off states

安装

🌐 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 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

当提供 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 matchContents={{ vertical: true }} style={{ width: '100%' }}>
      <Switch label="Enable notifications" value={notifications} onValueChange={setNotifications} />
    </Host>
  );
}

应用接口

🌐 API

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

Component

`Switch`

Android

iOS

Web

Type: React.Element<SwitchProps>

A toggle control that switches between on and off states.

Props for the Switch component, a toggle control.

SwitchProps

`disabled`

Android

iOS

Web

Optional • Type: boolean

Whether the switch is disabled. Disabled switches do not respond to user interaction.

`label`

Android

iOS

Web

Optional • Type: string

Text label displayed alongside the switch.

`modifiers`

Android

iOS

Web

Optional • Type: ModifierConfig[]

Platform-specific modifier escape hatch. Pass an array of modifier configs from @expo/ui/swift-ui/modifiers or @expo/ui/jetpack-compose/modifiers.

`onValueChange`

Android

iOS

Web

Type: (value: boolean) => void

Called when the user toggles the switch.

`testID`

Android

iOS

Web

Optional • Type: string

Identifier used to locate the component in end-to-end tests.

`value`

Android

iOS

Web

Type: boolean

Whether the switch is on.