Checkbox 多选框

多选框。

何时使用#

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

API#

Checkbox#

参数 说明 类型 可选值 默认值
checked 指定当前是否选中 boolean false
defaultChecked 初始是否选中 boolean false
onChange 变化时回调函数 Function(e:Event)

代码演示

import { Checkbox } from 'antd';
const container = document.getElementById('components-checkbox-demo-basic');

function onChange(e) {
  console.log('checked = ' + e.target.checked);
}

ReactDOM.render(<label>
  <Checkbox defaultChecked={false} onChange={onChange} />
  Checkbox
</label>, container);

简单的 checkbox。

import { Checkbox, Button } from 'antd';
const container = document.getElementById('components-checkbox-demo-controller');

const App = React.createClass({
  getInitialState() {
    return {
      checked: true,
      disabled: false
    };
  },
  render() {
    const label = (this.state.checked ? '选中' : '取消') + '-' +
      (this.state.disabled ? '不可用' : '可用');
    return <div>
      <p style={{marginBottom: '20px'}}>
        <label>
          <Checkbox checked={this.state.checked}
            disabled={this.state.disabled}
            onChange={this.onChange} />
            {label}
        </label>
      </p>
      <p>
        <Button type="primary" size="small"
          onClick={this.toggleChecked}>
          {!this.state.checked ? '选中' : '取消'}
        </Button>
        <Button style={{marginLeft: '10px'}}
          type="primary" size="small"
          onClick={this.toggleDisable}>
          {!this.state.disabled ? '不可用' : '可用'}
        </Button>
      </p>
    </div>;
  },
  toggleChecked(e) {
    this.setState({checked: !this.state.checked});
  },
  toggleDisable(e) {
    this.setState({disabled: !this.state.disabled});
  },
  onChange(e) {
    console.log('checked = ', e.target.checked);
    this.setState({
      checked: e.target.checked
    });
  }
});

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

联动 checkbox。

import { Checkbox } from 'antd';
const container = document.getElementById('components-checkbox-demo-disable');

ReactDOM.render(<div>
  <Checkbox defaultChecked={false} disabled />
  <br />
  <Checkbox defaultChecked disabled />
</div>, container);

不可用

checkbox 不可用。