开关

用于切换控制的 Jetpack Compose 开关组件。

Android

Included in Expo Go

GitHub

npm

更新日志

Recommended version:

~56.0.26

有关跨平台用法，请参阅通用的 Switch —— 它会针对每个平台渲染相应的原生组件。

Expo UI Switch 与官方 Jetpack Compose Switch API 一致。

安装

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.

使用

切换开关

ToggleSwitchExample.tsx

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

export default function ToggleSwitchExample() {
  const [checked, setChecked] = useState(false);

  return (
    <Host matchContents>
      <Switch value={checked} onCheckedChange={setChecked} />
    </Host>
  );
}

自定义颜色

CustomColorsExample.tsx

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

export default function CustomColorsExample() {
  const [checked, setChecked] = useState(false);

  return (
    <Host matchContents>
      <Switch
        value={checked}
        onCheckedChange={setChecked}
        colors={{
          checkedThumbColor: '#6200EE',
          checkedTrackColor: '#EDE9FE',
          uncheckedThumbColor: '#9CA3AF',
          uncheckedTrackColor: '#F3F4F6',
          uncheckedBorderColor: '#D1D5DB',
        }}
      />
    </Host>
  );
}

自定义拇指内容

使用 Switch.ThumbContent 在拇指内部渲染自定义元素。Switch.DefaultIconSize 会提供 M3 默认图标大小，使你的内容恰好适配。

ThumbContentExample.tsx

import { useState } from 'react';
import { Host, Switch, Box } from '@expo/ui/jetpack-compose';
import { size, clip, background, Shapes } from '@expo/ui/jetpack-compose/modifiers';

export default function ThumbContentExample() {
  const [checked, setChecked] = useState(false);

  return (
    <Host matchContents>
      <Switch
        value={checked}
        onCheckedChange={setChecked}
        colors={{
          checkedThumbColor: '#7C3AED',
          checkedTrackColor: '#EDE9FE',
          checkedIconColor: '#7C3AED',
          uncheckedThumbColor: '#9CA3AF',
          uncheckedTrackColor: '#F3F4F6',
          uncheckedBorderColor: '#D1D5DB',
          uncheckedIconColor: '#9CA3AF',
        }}>
        <Switch.ThumbContent>
          <Box
            modifiers={[
              size(Switch.DefaultIconSize, Switch.DefaultIconSize),
              clip(Shapes.Circle),
              background(checked ? '#FFFFFF' : '#E5E7EB'),
            ]}
          />
        </Switch.ThumbContent>
      </Switch>
    </Host>
  );
}

API

import { Switch } from '@expo/ui/jetpack-compose';

Components

`Switch`

Android

Type: React.Element<SwitchProps>

A switch component.

SwitchProps

`children`

Android

Optional • Type: React.ReactNode

Children containing ThumbContent slot.

`colors`

Android

Optional • Type: SwitchColors

Colors for switch core elements.

`enabled`

Android

Optional • Type: boolean • Default: true

Whether the switch is enabled.

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component.

`onCheckedChange`

Android

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

Callback function that is called when the checked state changes.

`value`

Android

Type: boolean

Indicates whether the switch is checked.

`SwitchThumbContent`

Android

Type: React.Element<ThumbContentProps>

Custom content to be displayed inside the switch thumb.

Types

`SwitchColors`

Android

Colors for switch core elements.

Property	Type	Description
checkedBorderColor(optional)	`ColorValue`	-
checkedIconColor(optional)	`ColorValue`	-
checkedThumbColor(optional)	`ColorValue`	-
checkedTrackColor(optional)	`ColorValue`	-
disabledCheckedBorderColor(optional)	`ColorValue`	-
disabledCheckedIconColor(optional)	`ColorValue`	-
disabledCheckedThumbColor(optional)	`ColorValue`	-
disabledCheckedTrackColor(optional)	`ColorValue`	-
disabledUncheckedBorderColor(optional)	`ColorValue`	-
disabledUncheckedIconColor(optional)	`ColorValue`	-
disabledUncheckedThumbColor(optional)	`ColorValue`	-
disabledUncheckedTrackColor(optional)	`ColorValue`	-
uncheckedBorderColor(optional)	`ColorValue`	-
uncheckedIconColor(optional)	`ColorValue`	-
uncheckedThumbColor(optional)	`ColorValue`	-
uncheckedTrackColor(optional)	`ColorValue`	-