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 组。