Checkbox 多选框

多选框。

何时使用#

在一组可选项中进行多项选择时；
单独使用可以表示两种状态之间的切换，和 switch 类似。区别在于切换 switch 会直接触发状态改变，而 checkbox 一般用于状态标记，需要和提交操作配合。

API#

Checkbox#

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

Checkbox Group#

参数	说明	类型	默认值
defaultValue	默认选中的选项	array	[]
value	指定选中的选项	array	[]
options	指定可选项	array	[]
onChange	变化时回调函数	Function(checkedValue)

代码演示

import { Checkbox } from 'antd';

function onChange(e) {
  console.log(`checked = ${e.target.checked}`);
}

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

基本用法

简单的 checkbox。

import { Checkbox, Button } from 'antd';

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() {
    this.setState({ checked: !this.state.checked });
  },
  toggleDisable() {
    this.setState({ disabled: !this.state.disabled });
  },
  onChange(e) {
    console.log('checked = ', e.target.checked);
    this.setState({
      checked: e.target.checked,
    });
  }
});

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

和外部组件通信

联动 checkbox。

import { Checkbox } from 'antd';

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

不可用

checkbox 不可用。

import { Checkbox } from 'antd';
const CheckboxGroup = Checkbox.Group;

function onChange(checkedValues) {
  console.log('checked = ', checkedValues);
}

ReactDOM.render(
  <CheckboxGroup options={['Apple', 'Pear', 'Orange']} defaultValue={['Apple']} onChange={onChange} />
, mountNode);

Checkbox 组

方便的从数组生成 Checkbox 组。若需要 label 和 value 分离请直接使用 Checkbox。