daisyUI Rating 组件完全指南:用 radio 实现可交互与只读星级评分
daisyUI Rating 组件完全指南:用 radio 实现可交互与只读星级评分
daisyUI 的 Rating 组件是一组由原生 radio 按钮构成的评分控件,用户点击即可给出星级评价,天然支持键盘操作与表单提交。本文以 skills/daisyui/components/rating.md 为核心,结合 rating.css 的源码实现,完整讲解 Rating 的类名体系、可交互与只读两种写法、清空评分技巧以及无障碍注意事项,读完即可在 Tailwind CSS + daisyUI 5 项目中直接落地使用。
Rating 组件是什么
Rating(评分)是一组 radio 按钮,让用户对内容给出评级(通常是 1~5 星)。它与其他评分组件最大的区别在于:基于原生 <input type="radio"> 实现,因此:
- 无需 JavaScript 即可工作,刷新后所选值依然保留;
- 天然支持表单提交(
name+value随表单一起发送); - 天然支持键盘方向键切换评分,满足无障碍访问需求。
在 daisyUI 中,Rating 的视觉效果由 rating 类与 mask 遮罩类(如 mask-star)共同完成:rating 负责布局与选中态高亮,mask 负责把元素裁剪成星星形状。
类名体系一览
Rating 组件的类名分为三类,见 skills/daisyui/components/rating.md:
| 类型 | 类名 |
|---|---|
| 组件类 | rating |
| 修饰符 | rating-half、rating-hidden |
| 尺寸 | rating-xs、rating-sm、rating-md、rating-lg、rating-xl |
使用规则:
rating是必选的容器类;- 修饰符与尺寸类都可选,可同时使用一个修饰符 + 一个尺寸类;
- 尺寸类的默认视觉为
rating-md(对应源码中--size为0.25rem * 6,即 1.5rem/24px,见 rating.css)。
尺寸类与底层变量
在 rating.css 中,每个尺寸类都通过覆盖 --size 自定义属性控制星星大小,基准值为 --size-selector(默认 0.25rem):
| 尺寸类 | --size 计算值 |
最终星星尺寸(默认主题下) |
|---|---|---|
rating-xs |
0.25rem * 4 |
1rem(16px) |
rating-sm |
0.25rem * 5 |
1.25rem(20px) |
rating-md |
0.25rem * 6 |
1.5rem(24px) |
rating-lg |
0.25rem * 7 |
1.75rem(28px) |
rating-xl |
0.25rem * 8 |
2rem(32px) |
--size-selector 是 daisyUI 5 的设计令牌,可在 functions/variables.css 中看到其声明。如果需要全局统一调整 Rating 等选择器类控件的大小,可以覆盖该变量,而不是逐个改尺寸类。
基础语法:可交互评分
可交互(用户可点选)的 Rating 标准写法如下:
<div class="rating">
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
</div>
语法要点:
- 每个选项都是一个
<input type="radio">,需要同时加上mask和mask-star两个类:mask提供遮罩裁剪基础样式,mask-star提供五角星的 SVG 遮罩路径(见 mask.css); - 同一组评分必须使用相同的
name属性,这样浏览器才会把它们归为一组单选,保证同时只能选中一个; - 源码中
input { cursor-pointer appearance-none }去除了原生 radio 外观并显示手型光标,因此视觉上呈现为纯粹的星星。
未选中星星的样式
从 rating.css 可以看到,所有子元素默认是 bg-base-content(主题内容色)、opacity-20(20% 透明度)的浅色星星;当处于选中/高亮状态时透明度提升为 100%:
:checked,
[aria-checked="true"],
[aria-current="true"],
:has(~ :checked, ~ [aria-checked="true"], ~ [aria-current="true"]) {
opacity: 100%;
}
注意最后一条使用 :has(~ ...) 兄弟选择器——它让当前选中项之前的所有星星(以及选中项自身)都变为不透明,从而实现"从第一颗星到选中星全部点亮"的经典评分视觉。这也是 Rating 组件核心交互逻辑全部由 CSS 完成、无需 JS 的原因。
只读评分:使用 div 代替 radio
当评分仅用于展示(如商品评价汇总、历史评分),不需要用户交互时,应改用 <div> 元素而不是 radio 输入。在只读模式下,选中项通过 aria-current="true" 标记,视觉上同样会被点亮:
<div class="rating">
<div class="mask mask-star" aria-label="1 star"></div>
<div class="mask mask-star" aria-label="2 star" aria-current="true"></div>
<div class="mask mask-star" aria-label="3 star"></div>
<div class="mask mask-star" aria-label="4 star"></div>
<div class="mask mask-star" aria-label="5 star"></div>
</div>
关键点:
- 每个
<div>都要加aria-label说明它代表的星级(如"3 star"),便于屏幕阅读器朗读; - 当前评分对应的元素加
aria-current="true"(源码中与:checked一样会被点亮为不透明,见上文:checked, [aria-checked="true"], [aria-current="true"]选择器); - 由于不使用
input,该写法不会触发键盘焦点样式,也不参与表单提交,适合纯粹的展示场景。
清空评分:rating-hidden
默认的 radio 评分一旦选中就难以取消。解决方法是在第一颗星之前添加一个加了 rating-hidden 类的 radio 输入,它会被渲染成一个隐藏的"空选项",用户点击它即可清空整个评分:
<div class="rating">
<input type="radio" name="rating-1" class="rating-hidden" />
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
<input type="radio" name="rating-1" class="mask mask-star" />
</div>
在源码中,.rating-hidden 被定义为 w-2 bg-transparent(宽 0.5rem 且背景透明),宽度仅为普通星星的三分之一,视觉上几乎不可见,但依然可点击,见 rating.css。
半星评分:rating-half
需要支持半星(如 4.5 分)时,在容器上加 rating-half 修饰符,并把每颗星拆成两个相邻的 radio,分别用 mask-half-1 和 mask-half-2 裁剪出左半星与右半星:
<div class="rating rating-half">
<input type="radio" name="rating-10" class="rating-hidden" />
<input type="radio" name="rating-10" class="mask mask-star-2 mask-half-1" />
<input type="radio" name="rating-10" class="mask mask-star-2 mask-half-2" />
<input type="radio" name="rating-10" class="mask mask-star-2 mask-half-1" />
<input type="radio" name="rating-10" class="mask mask-star-2 mask-half-2" />
<!-- 依此类推,每颗星两个 input -->
</div>
实现原理:
.rating-half将星星宽度减半(width: calc(var(--size) * 0.5)),见 rating.css;.mask-half-1通过mask-size: 200%与mask-position: left只显示星星左半部分,.mask-half-2同理显示右半部分(RTL 环境下位置自动镜像),见 mask.css;- 这里示例使用了
mask-star-2(另一种星形 SVG 路径),在 mask.css 中可以看到它与mask-star的路径不同、外观略有差异,可自行选择。
交互反馈与动效细节
rating.css 中还内置了细腻的交互反馈:
- 选中动画:默认在
prefers-reduced-motion: no-preference下,星星以rating关键帧播放 0.25s 的缩放 + 亮度/对比度增强动画(见第 84-90 行的@keyframes rating); - 键盘焦点:
:focus-visible时星星放大到 1.1 倍并带 0.2s 过渡,让键盘用户清楚看到当前焦点位置; - 按下反馈:
:active:focus时取消动画并放大到 1.1 倍,模拟按压效果; - 尊重系统偏好:所有动画均受
prefers-reduced-motion媒体查询保护,开启"减少动态效果"的系统用户不会看到动画。
这些细节意味着 Rating 组件开箱即用地提供了良好的触觉与视觉反馈,无需额外编写交互脚本。
使用建议与注意事项
汇总 skills/daisyui/components/rating.md 中的规则与实战经验:
{MODIFIER}组合:容器类名可以同时包含一个修饰符(rating-half或rating-hidden)与一个尺寸类(rating-xs~rating-xl),例如class="rating rating-half rating-lg";- name 唯一性:同一页面若有多个评分组,务必为每组使用不同的
name值(如rating-1、rating-2),避免不同评分组之间互相冲突、选中互相串扰; - 需要可清空时加
rating-hidden:放在第一颗星之前,让用户能取消已选的评分; - 只读展示用
div:不可交互的评分不要使用 radio,用<div>+aria-label+aria-current="true"代替,语义更准确; - 可结合表单使用:因为是原生 radio,评分值会随表单正常提交,后端可直接读取
name对应的值;配合表单校验框架也能复用原生约束。
相关资源
- 组件技能文档:skills/daisyui/components/rating.md
- 核心样式实现:packages/daisyui/src/components/rating.css
- 星形与半星遮罩:packages/daisyui/src/components/mask.css
- 尺寸变量令牌声明:packages/daisyui/functions/variables.css
- 其余组件技能文档位于 skills/daisyui/components/,可查阅同类组件的类名与语法约定