Radio 单选框

单选框。

何时使用#

用于在多个备选项中选中单个状态。
和 Select 的区别是，Radio 所有选项默认可见，方便用户在比较中选择，因此选项不宜过多。

API#

Radio#

参数	说明	类型	默认值
checked	指定当前是否选中	Boolean	false
defaultChecked	初始是否选中	Boolean	false
value	根据 value 进行比较，判断是否选中	String	无

RadioGroup#

单选框组合，用于包裹一组 Radio。

参数	说明	类型	可选值	默认值
onChange	选项变化时的回调函数	Function(e:Event)	无	无
value	用于设置当前选中的值	String	无	无
defaultValue	默认选中的值	String	无	无
size	大小，只对按钮样式生效	String	`large` `default` `small`	`default`

代码演示

import { Radio } from 'antd';

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

基本

最简单的用法。

import { Radio } from 'antd';
const RadioGroup = Radio.Group;

const App = React.createClass({
  getInitialState() {
    return {
      value: 1
    };
  },
  onChange(e) {
    console.log('radio checked', e.target.value);
    this.setState({
      value: e.target.value
    });
  },
  render() {
    return (
      <div>
        <RadioGroup onChange={this.onChange} value={this.state.value}>
          <Radio key="a" value={1}>A</Radio>
          <Radio key="b" value={2}>B</Radio>
          <Radio key="c" value={3}>C</Radio>
          <Radio key="d" value={null}>D</Radio>
        </RadioGroup>
      </div>
    );
  }
});
ReactDOM.render(<App />, mountNode);

RadioGroup 组合

一组互斥的 Radio 配合使用。

import { Radio } from 'antd';
const RadioButton = Radio.Button;
const RadioGroup = Radio.Group;

ReactDOM.render(<div>
  <div>
    <RadioGroup defaultValue="a" size="large">
      <RadioButton value="a">杭州</RadioButton>
      <RadioButton value="b">上海</RadioButton>
      <RadioButton value="c">北京</RadioButton>
      <RadioButton value="d">成都</RadioButton>
    </RadioGroup>
  </div>
  <div style={{ marginTop: 16 }}>
    <RadioGroup defaultValue="a">
      <RadioButton value="a">杭州</RadioButton>
      <RadioButton value="b">上海</RadioButton>
      <RadioButton value="c">北京</RadioButton>
      <RadioButton value="d">成都</RadioButton>
    </RadioGroup>
  </div>
  <div style={{ marginTop: 16 }}>
    <RadioGroup defaultValue="a" size="small">
      <RadioButton value="a">杭州</RadioButton>
      <RadioButton value="b">上海</RadioButton>
      <RadioButton value="c">北京</RadioButton>
      <RadioButton value="d">成都</RadioButton>
    </RadioGroup>
  </div>
</div>, mountNode);

大小

大中小三种组合，可以和表单输入框进行对应配合。

import { Radio, Button } from 'antd';

const App = React.createClass({
  getInitialState() {
    return {
      disabled: true
    };
  },
  toggleDisabled() {
    this.setState({
      disabled: !this.state.disabled
    });
  },
  render() {
    return (
      <div>
        <Radio defaultChecked={false} disabled={this.state.disabled}>不可用</Radio>
        <br />
        <Radio defaultChecked disabled={this.state.disabled}>不可用</Radio>
        <div style={{ marginTop: 20 }}>
          <Button type="primary" onClick={this.toggleDisabled}>
            Toggle disabled
          </Button>
        </div>
      </div>
    );
  }
});

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

不可用

Radio 不可用。

import { Radio } from 'antd';
const RadioButton = Radio.Button;
const RadioGroup = Radio.Group;

function onChange(e) {
  console.log(`radio checked:${e.target.value}`);
}

ReactDOM.render(<div>
  <div>
    <RadioGroup onChange={onChange} defaultValue="a">
      <RadioButton value="a">杭州</RadioButton>
      <RadioButton value="b">上海</RadioButton>
      <RadioButton value="c">北京</RadioButton>
      <RadioButton value="d">成都</RadioButton>
    </RadioGroup>
  </div>
  <div style={{ marginTop: 16 }}>
    <RadioGroup onChange={onChange} defaultValue="a">
      <RadioButton value="a">杭州</RadioButton>
      <RadioButton value="b" disabled>上海</RadioButton>
      <RadioButton value="c">北京</RadioButton>
      <RadioButton value="d">成都</RadioButton>
    </RadioGroup>
  </div>
  <div style={{ marginTop: 16 }}>
    <RadioGroup disabled onChange={onChange} defaultValue="a">
      <RadioButton value="a">杭州</RadioButton>
      <RadioButton value="b">上海</RadioButton>
      <RadioButton value="c">北京</RadioButton>
      <RadioButton value="d">成都</RadioButton>
    </RadioGroup>
  </div>
</div>, mountNode);

按钮样式

按钮样式的单选组合。