Rate评分

评分组件。

何时使用#

  • 对评价进行展示。

  • 对事物进行快速的评级操作。

代码演示

最简单的用法。

expand codeexpand code
import { Rate } from 'antd';

ReactDOM.render(<Rate />, mountNode);
normal

给评分组件加上文案展示。

expand codeexpand code
import { Rate } from 'antd';

const desc = ['terrible', 'bad', 'normal', 'good', 'wonderful'];

class Rater extends React.Component {
  state = {
    value: 3,
  };

  handleChange = value => {
    this.setState({ value });
  };

  render() {
    const { value } = this.state;
    return (
      <span>
        <Rate tooltips={desc} onChange={this.handleChange} value={value} />
        {value ? <span className="ant-rate-text">{desc[value - 1]}</span> : ''}
      </span>
    );
  }
}

ReactDOM.render(<Rater />, mountNode);
allowClear: true
allowClear: false

支持允许或者禁用清除。

expand codeexpand code
import { Rate } from 'antd';

ReactDOM.render(
  <div>
    <Rate defaultValue={3} />
    <span className="ant-rate-text">allowClear: true</span>
    <br />
    <Rate allowClear={false} defaultValue={3} />
    <span className="ant-rate-text">allowClear: false</span>
  </div>,
  mountNode,
);

支持选中半星。

expand codeexpand code
import { Rate } from 'antd';

ReactDOM.render(<Rate allowHalf defaultValue={2.5} />, mountNode);

只读,无法进行鼠标交互。

expand codeexpand code
import { Rate } from 'antd';

ReactDOM.render(<Rate disabled defaultValue={2} />, mountNode);

  • A
    A
  • A
    A
  • A
    A
  • A
    A
  • A
    A

可以将星星替换为其他字符,比如字母,数字,字体图标甚至中文。

expand codeexpand code
import { Rate, Icon } from 'antd';

ReactDOM.render(
  <div>
    <Rate character={<Icon type="heart" />} allowHalf />
    <br />
    <Rate character="A" allowHalf style={{ fontSize: 36 }} />
    <br />
    <Rate character="" allowHalf />
  </div>,
  mountNode,
);

API#

属性说明类型默认值版本
allowClear是否允许再次点击后清除booleantrue3.1.0
allowHalf是否允许半选booleanfalse
autoFocus自动获取焦点booleanfalse
character自定义字符ReactNode<Icon type="star" />
className自定义样式类名string-
countstar 总数number5
defaultValue默认值number0
disabled只读,无法进行交互booleanfalse
style自定义样式对象object-
tooltips自定义每项的提示信息string[]-3.12.0
value当前数,受控值number-
onBlur失去焦点时的回调Function()-
onChange选择时的回调Function(value: number)-
onFocus获取焦点时的回调Function()-
onHoverChange鼠标经过时数值变化的回调Function(value: number)-
onKeyDown按键回调Function(event)-

方法#

名称描述版本
blur()移除焦点
focus()获取焦点
Mentions提及Radio单选框