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

Switch

跨平台通用的“开关”组件。

注意这是一个“受控组件”(controlled component)。你必须使用onValueChange回调来更新value属性以响应用户的操作。如果不更新value属性,组件只会按一开始给定的value值来渲染且保持不变,看上去就像完全点不动。

示例


文档

Props

View Props

继承了所有的View Props.


disabled

如果为true则禁用此组件的交互。

类型Default
boolfalse

ios_backgroundColor
iOS

在 iOS 上,自定义背景颜色。这种背景颜色可以在开关值为false时或开关被禁用(且开关呈半透明状态)时看到。

类型
color

onChange

当值改变的时候调用此回调函数,参数为事件。如果你只想接收新值,请改用 onValueChange

类型
function

onValueChange

当值改变的时候调用此回调函数,参数为新的值。如果你想接收一个完整事件,请使用 onChange

类型
function

thumbColor

开关上圆形按钮的背景颜色。在 iOS 上设置此颜色会丢失按钮的投影效果。

类型
color

trackColor

关闭状态时的边框颜色(iOS)或背景颜色(Android)。

iOS: 当开关值为 false 时,轨道会收缩到边框内。如果你想改变收缩后轨道露出的背景颜色,请使用 ios_backgroundColor

Type
object: {false: color, true: color}

value

表示此开关是否打开。默认为 false(关闭状态)。

类型
bool