This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

滑块

一个与 @react-native-community/slider 兼容的滑块。

Android
iOS
Web
Included in Expo Go
Recommended version:
~58.0.15

一个 Slider 组件,其 API 与 @react-native-community/slider 兼容。它在 Android 上使用 Material 3 Slider,在 iOS 上使用 SwiftUI Slider,在 web 上使用原生 <input type="range"> 元素。

🌐 A Slider component with an API compatible with @react-native-community/slider. It uses a Material 3 Slider on Android, a SwiftUI Slider on iOS, and a native <input type="range"> element on web.

在内部,这个组件封装了平台特定的 @expo/ui 原语:

🌐 Under the hood this component wraps the platform-specific @expo/ui primitives:

如果你需要更底层的控制,请直接使用那些原语。

🌐 If you need lower-level control, use those primitives directly.

A Material 3 slider at the middle of its rangeA Material 3 slider at the middle of its range

安装

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

从 @react-native-community/slider 迁移

🌐 Migrating from @react-native-community/slider

  • 将导入从 import Slider from '@react-native-community/slider' 更新为 import Slider from '@expo/ui/community/slider'。
  • onSlidingStart、onSlidingComplete、tapToSeek、StepMarker、renderStepNumber、thumbImage、minimumTrackImage、maximumTrackImage、trackImage、accessibilityUnits、accessibilityIncrements、testID 和 ref.updateValue 尚不支持。
  • 在 iOS 上,maximumTrackTintColor 和 thumbTintColor 没有视觉效果——SwiftUI 的 Slider 只暴露最小(活动)轨迹颜色。minimumTrackTintColor 在两个平台上都有效。

基本用法

🌐 Basic usage

SliderExample.tsx
import { useState } from 'react'; import { Text, useColorScheme, View } from 'react-native'; import Slider from '@expo/ui/community/slider'; export default function SliderExample() { const [value, setValue] = useState(0.5); const colorScheme = useColorScheme(); return ( <View> <Slider value={value} onValueChange={setValue} /> <Text style={{ color: colorScheme === 'dark' ? '#FFFFFF' : '#000000' }}> Value: {value.toFixed(3)} </Text> </View> ); }

应用接口

🌐 API

import Slider from '@expo/ui/community/slider';

No API data file found, sorry!