Switch开关

开关选择器。

何时使用#

需要表示开关状态/两种状态之间的切换时；
和 checkbox的区别是，切换 switch 会直接触发状态改变，而 checkbox 一般用于状态标记，需要和提交操作配合。

代码演示

最简单的用法。

import { Switch } from 'antd';

function onChange(checked) {
  console.log(`switch to ${checked}`);
}

ReactDOM.render(
  <Switch defaultChecked={false} onChange={onChange} />,
  mountNode
);

关
0

文字和图标

带有文字和图标。

import { Switch, Icon } from 'antd';

ReactDOM.render(
  <div>
    <Switch checkedChildren="开" unCheckedChildren="关" />
    <br />
    <Switch checkedChildren="1" unCheckedChildren="0" />
    <br />
    <Switch checkedChildren={<Icon type="check" />} unCheckedChildren={<Icon type="cross" />} />
  </div>
, mountNode);

不可用

Switch 失效状态。

import { Switch, Button } from 'antd';

class App extends React.Component {
  state = {
    disabled: true,
  }
  toggle = () => {
    this.setState({
      disabled: !this.state.disabled,
    });
  }
  render() {
    return (
      <div>
        <Switch disabled={this.state.disabled} />
        <br />
        <Button type="primary" onClick={this.toggle}>Toggle disabled</Button>
      </div>
    );
  }
}

ReactDOM.render(<App />, mountNode);

两种大小

size="small" 表示小号开关。

import { Switch } from 'antd';

ReactDOM.render(
  <div>
    <Switch />
    <br />
    <Switch size="small" />
  </div>
, mountNode);

API#

Switch#

参数	说明	类型	默认值
checked	指定当前是否选中	boolean	false
checkedChildren	选中时的内容	string\|ReactNode
defaultChecked	初始是否选中	boolean	false
size	开关大小，可选值：`default` `small`	string	default
unCheckedChildren	非选中时的内容	string\|ReactNode
onChange	变化时回调函数	Function(checked:Boolean)

Components

Switch开关

何时使用#

代码演示

API#

Switch#