logoAnt Design

⌘ K
  • Design
  • Development
  • Components
  • Blog
  • Resources
6.0.0-alpha.3
  • Components Overview
  • Changelog
    v6.0.0-alpha.3
  • General
    • Button
    • FloatButton
      5.0.0
    • Icon
    • Typography
  • Layout
    • Divider
    • Flex
      5.10.0
    • Grid
    • Layout
    • Masonry
      6.0.0
    • Space
    • Splitter
      5.21.0
  • Navigation
    • Anchor
    • Breadcrumb
    • Dropdown
    • Menu
    • Pagination
    • Steps
    • Tabs
  • Data Entry
    • AutoComplete
    • Cascader
    • Checkbox
    • ColorPicker
      5.5.0
    • DatePicker
    • Form
    • Input
    • InputNumber
    • Mentions
    • Radio
    • Rate
    • Select
    • Slider
    • Switch
    • TimePicker
    • Transfer
    • TreeSelect
    • Upload
  • Data Display
    • Avatar
    • Badge
    • Calendar
    • Card
    • Carousel
    • Collapse
    • Descriptions
    • Empty
    • Image
    • List
      DEPRECATED
    • Popover
    • QRCode
      5.1.0
    • Segmented
    • Statistic
    • Table
    • Tag
    • Timeline
    • Tooltip
    • Tour
      5.0.0
    • Tree
  • Feedback
    • Alert
    • Drawer
    • Message
    • Modal
    • Notification
    • Popconfirm
    • Progress
    • Result
    • Skeleton
    • Spin
    • Watermark
      5.1.0
  • Other
    • Affix
    • App
      5.1.0
    • ConfigProvider
    • Util
When To Use
Examples
Basic
Sizes
Half star
Show copywriting
Read only
Clear star
Other Character
Customize character
API
Methods
Design Token

Rate

Used for rating operation on something.
Importimport { Rate } from "antd";
GitHub
components/rateIssueOpen issues
Docs
Edit this page
contributors
RadioSelect

Resources

Ant Design X
Ant Design Charts
Ant Design Pro
Pro Components
Ant Design Mobile
Ant Design Mini
Ant Design Web3
Ant Design Landing-Landing Templates
Scaffolds-Scaffold Market
Umi-React Application Framework
dumi-Component doc generator
qiankun-Micro-Frontends Framework
Ant Motion-Motion Solution
China Mirror 🇨🇳

Community

Awesome Ant Design
Medium
X
yuque logoAnt Design in YuQue
Ant Design in Zhihu
Experience Cloud Blog
seeconf logoSEE Conf-Experience Tech Conference

Help

GitHub
Change Log
FAQ
Bug Report
Issues
Discussions
StackOverflow
SegmentFault

Ant XTech logoMore Products

yuque logoYuQue-Document Collaboration Platform
AntV logoAntV-Data Visualization
Egg logoEgg-Enterprise Node.js Framework
Kitchen logoKitchen-Sketch Toolkit
Galacean logoGalacean-Interactive Graphics Solution
WeaveFox logoWeaveFox-AI Development with WeaveFox 🦊
xtech logoAnt Financial Experience Tech
Theme Editor
Made with ❤ by
Ant Group and Ant Design Community
loading

When To Use

  • Show evaluation.
  • A quick rating operation on something.

Examples

API

Common props ref:Common props

PropertyDescriptiontypeDefaultVersion
allowClearWhether to allow clear when click againbooleantrue
allowHalfWhether to allow semi selectionbooleanfalse
autoFocusIf get focus when component mountedbooleanfalse
characterThe custom character of rateReactNode | (RateProps) => ReactNode<StarFilled />function(): 4.4.0
classNameThe custom class name of ratestring-
countStar countnumber5
defaultValueThe default valuenumber0
disabledIf read only, unable to interactbooleanfalse
keyboardSupport keyboard operationbooleantrue5.18.0
sizeStar size'small' | 'middle' | 'large''middle'
styleThe custom style object of rateCSSProperties-
tooltipsCustomize tooltip by each characterTooltipProps[] | string[]-
valueThe current valuenumber-
onBlurCallback when component lose focusfunction()-
onChangeCallback when select valuefunction(value: number)-
onFocusCallback when component get focusfunction()-
onHoverChangeCallback when hover itemfunction(value: number)-
onKeyDownCallback when keydown on componentfunction(event)-

Methods

NameDescription
blur()Remove focus
focus()Get focus

Design Token

Component TokenHow to use?
Token NameDescriptionTypeDefault Value
starBgStar background colorstringrgba(0,0,0,0.06)
starColorStar colorstring#fadb14
starHoverScaleScale of star when hoverreadonly string[] | Transform | readonly Transform[] | { _multi_value_?: boolean; _skip_check_?: boolean; value: readonly string[] | Transform | (readonly string[] | Transform | undefined)[] | undefined } | undefinedscale(1.1)
starSizeStar sizenumber20
starSizeLGLarge star sizenumber25
starSizeSMSmall star sizenumber15
Global TokenHow to use?
Basic

The simplest usage.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Half star

Support select half star.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Read only

Read only, can't use mouse to interact.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Other Character

Replace the default star to other character like alphabet, digit, iconfont or even Chinese word.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Sizes

Three sizes.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
6.0.0
Show copywriting

Add copywriting in rate components.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Clear star

Support set allow to clear star when click again.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Customize character

Can customize each character using (RateProps) => ReactNode.

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
  • A
    A
  • A
    A
  • A
    A
  • A
    A
  • A
    A
  • 好
    好
  • 好
    好
  • 好
    好
  • 好
    好
  • 好
    好
normal
allowClear: true
allowClear: false
  • 1
    1
  • 2
    2
  • 3
    3
  • 4
    4
  • 5
    5