Switch开关

开关选择器。

何时使用

• 需要表示开关状态/两种状态之间的切换时；

• 和 checkbox 的区别是，切换 switch 会直接触发状态改变，而 checkbox 一般用于状态标记，需要和提交操作配合。

代码演示

基本

最简单的用法。

import { Switch } from 'antd';
function onChange(checked) {
  console.log(`switch to ${checked}`);
}
ReactDOM.render(<Switch defaultChecked onChange={onChange} />, mountNode);

文字和图标

带有文字和图标。

import { Switch } from 'antd';
import { CloseOutlined, CheckOutlined } from '@ant-design/icons';
ReactDOM.render(
  <>
    <Switch checkedChildren="开启" unCheckedChildren="关闭" defaultChecked />
    <br />
    <Switch checkedChildren="1" unCheckedChildren="0" />
    <br />
    <Switch
      checkedChildren={<CheckOutlined />}
      unCheckedChildren={<CloseOutlined />}
      defaultChecked
    />
  </>,
  mountNode,
);

加载中

标识开关操作仍在执行中。

import { Switch } from 'antd';
ReactDOM.render(
  <>
    <Switch loading defaultChecked />
    <br />
    <Switch size="small" loading />
  </>,
  mountNode,
);

不可用

Switch 失效状态。

import { Switch, Button } from 'antd';
const App = () => {
  const [disabled, setDisabled] = React.useState(true);
  const toggle = () => {
    setDisabled(!disabled);
  };
  return (
    <>
      <Switch disabled={disabled} defaultChecked />
      <br />
      <Button type="primary" onClick={toggle}>
        Toggle disabled
      </Button>
    </>
  );
};
ReactDOM.render(<App />, mountNode);

两种大小

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

import { Switch } from 'antd';
ReactDOM.render(
  <>
    <Switch defaultChecked />
    <br />
    <Switch size="small" defaultChecked />
  </>,
  mountNode,
);

API

方法