Rating

评分组件可以让用户深入了解他人的意见和经验，也可以让用户提交自己的评价。

基础的评分组件

<Typography component="legend">Controlled</Typography>
<Rating
  name="simple-controlled"
  value={value}
  onChange={(event, newValue) => {
    setValue(newValue);
  }}
/>
<Typography component="legend">Read only</Typography>
<Rating name="read-only" value={value} readOnly />
<Typography component="legend">Disabled</Typography>
<Rating name="disabled" value={value} disabled />
<Typography component="legend">No rating given</Typography>
<Rating name="no-value" value={null} />

评分精度

使用 value 属性可以让评分组件展示任何的浮点的评分值。您可以使用 precision 属性定义可变化的最小增量值。

<Rating name="half-rating" defaultValue={2.5} precision={0.5} />
<Rating name="half-rating-read" defaultValue={2.5} precision={0.5} readOnly />

悬停反馈

你可以在鼠标悬停时让组件显示一个辅助标签来帮助用户选择正确的评分值。以下案例使用了 onChangeActive 这一属性。

<Rating
  name="hover-feedback"
  value={value}
  precision={0.5}
  getLabelText={getLabelText}
  onChange={(event, newValue) => {
    setValue(newValue);
  }}
  onChangeActive={(event, newHover) => {
    setHover(newHover);
  }}
  emptyIcon={<StarIcon style={{ opacity: 0.55 }} fontSize="inherit" />}
/>
{value !== null && (
  <Box sx={{ ml: 2 }}>{labels[hover !== -1 ? hover : value]}</Box>
)}

尺寸

你可以使用 size 属性来更改评分组件大小。

<Rating name="size-small" defaultValue={2} size="small" />
<Rating name="size-medium" defaultValue={2} />
<Rating name="size-large" defaultValue={2} size="large" />

自定义评分组件

你可以参考以下一些例子来自定义组件。您可以在重写文档页面中了解更多有关此内容的信息。

<Typography component="legend">Custom icon and color</Typography>
<StyledRating
  name="customized-color"
  defaultValue={2}
  getLabelText={(value: number) => `${value} Heart${value !== 1 ? 's' : ''}`}
  precision={0.5}
  icon={<FavoriteIcon fontSize="inherit" />}
  emptyIcon={<FavoriteBorderIcon fontSize="inherit" />}
/>
<Typography component="legend">10 stars</Typography>
<Rating name="customized-10" defaultValue={2} max={10} />

Radio group

评分是通过一个单选框组实现的，设置 highlightSelectedOnly 以恢复默认状态。

<StyledRating
  name="highlight-selected-only"
  defaultValue={2}
  IconContainerComponent={IconContainer}
  getLabelText={(value: number) => customIcons[value].label}
  highlightSelectedOnly
/>

无障碍设计

(WAI 教程)

这个组件的可访问性依赖于：

一个单选框组，其字段在视觉上是隐藏的。它包含六个单选按钮，一组用于每颗星星的选择，另一组代表默认选中的 0 颗星。请确保为 name 属性提供一个对父表单唯一的值。
Labels for the radio buttons containing actual text ("1 Star", "2 Stars", …). 当页面的语言不是英语时，请确保为 getLabelText 属性提供一个合适的函数。 Be sure to provide a suitable function to the getLabelText prop when the page is in a language other than English. 你可以使用这上面所提供的本地化语言选项，或者单独提供你自己的语言包。 You can use the included locales, or provide your own.
为评分图标提供了一个视觉上独特的外观。默认情况下，评分组件通过颜色和形状的差异（填充和空图标）来表示所指定的值。如果你使用颜色作为唯一的方式来表示数值，那么数值信息也应该像下面这个示例一样以文本的形式来显示。这对于符合 WCAG2.1 的成功标准 1.4.1 非常重要。

Good

<Rating
  name="text-feedback"
  value={value}
  readOnly
  precision={0.5}
  emptyIcon={<StarIcon style={{ opacity: 0.55 }} fontSize="inherit" />}
/>
<Box sx={{ ml: 2 }}>{labels[value]}</Box>

ARIA

只读评分有一个 "img" 的角色（role），以及一个描述显示评分的 aria-label。

键盘输入

由于评分组件是由单选按钮组成的，所以键盘交互遵循本地浏览器行为。 Tab 键将聚焦当前的评分，光标键可以控制所选的评分。

只读的评分组件不可以被聚焦。

API

<Rating />