跳到主要内容
新架构实战课 实操 + 基建 + 原理全维度包揽,抢先掌握 React Native 新架构精髓 立即查看 >Version: 0.72

🚧 Slider

已过时。 Use @react-native-community/slider instead.

用于选择一个范围值的组件。


文档

Props

style

Used to style and layout the Slider. See StyleSheet.js and ViewStylePropTypes.js for more info.

类型必需
View.style

disabled

如果为 true,用户就不能移动滑块。默认为 false。

类型必需
bool

maximumValue

滑块的最大值(当滑块滑到最右端时表示的值)。默认为 1。

类型必需
number

minimumTrackTintColor

滑块左侧轨道的颜色。在 iOS 上默认为一个蓝色的渐变色。

类型必需
color

minimumValue

滑块的最小值(当滑块滑到最左端时表示的值)。默认为 0。

类型必需
number

onSlidingComplete

用户松开滑块的时候调用此回调,无论值是否变化。回调值为当前值。

类型必需
function

onValueChange

在用户拖动滑块的过程中不断调用此回调。

类型必需
function

step

滑块的步长(拖动变化的最小单元)。这个值应该在 0 到(maximumValue - minimumValue)之间。默认值为 0。

类型必需
number

maximumTrackTintColor

滑块右侧轨道的颜色。在 iOS 上默认为一个灰色的渐变色。

类型必需
color

testID

Used to locate this view in UI automation tests.

类型必需
string

value

滑块的初始值。这个值应该在最小值和最大值之间。默认值是 0。

*注意:这不是一个受控组件!*也就是说,你不需要在滑动过程中去手动更新值。

类型必需
number

thumbTintColor

Color of the foreground switch grip.

类型必需平台
colorAndroid

maximumTrackImage

指定一个滑块右侧轨道背景图。仅支持静态图片。图片最左边的像素会被平铺直至填满右侧轨道。

类型必需平台
Image.propTypes.sourceiOS

minimumTrackImage

指定一个滑块左侧轨道背景图。仅支持静态图片。图片最右边的像素会被平铺直至填满左侧轨道。

类型必需平台
Image.propTypes.sourceiOS

thumbImage

给滑块设置一张图片。只支持静态图片。

类型必需平台
Image.propTypes.sourceiOS

trackImage

给轨道设置一张背景图。只支持静态图片。图片最中央的像素会被平铺直至填满轨道。

类型必需平台
Image.propTypes.sourceiOS