daisyUI Rating 组件完全指南:用 radio 实现可交互与只读星级评分

原创2026-09-09 17:12:401,889 阅读
文章标签:前端UI组件设计系统前端构建AI 技能插件系统

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>

语法要点:

  1. 每个选项都是一个 <input type="radio">,需要同时加上 mask 和 mask-star 两个类:mask 提供遮罩裁剪基础样式,mask-star 提供五角星的 SVG 遮罩路径(见 mask.css);
  2. 同一组评分必须使用相同的 name 属性,这样浏览器才会把它们归为一组单选,保证同时只能选中一个;
  3. 源码中 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 中的规则与实战经验:

  1. {MODIFIER} 组合:容器类名可以同时包含一个修饰符(rating-half 或 rating-hidden)与一个尺寸类(rating-xs ~ rating-xl),例如 class="rating rating-half rating-lg";
  2. name 唯一性:同一页面若有多个评分组,务必为每组使用不同的 name 值(如 rating-1、rating-2),避免不同评分组之间互相冲突、选中互相串扰;
  3. 需要可清空时加 rating-hidden:放在第一颗星之前,让用户能取消已选的评分;
  4. 只读展示用 div:不可交互的评分不要使用 radio,用 <div> + aria-label + aria-current="true" 代替,语义更准确;
  5. 可结合表单使用:因为是原生 radio,评分值会随表单正常提交,后端可直接读取 name 对应的值;配合表单校验框架也能复用原生约束。

相关资源

登录后查看全文
daisyui