更新记录
0.1.4(2026-08-14)
下载此版本
- 精简 readme:移除内部开发向内容(设计说明 / 实现细节 / 平台差异实现等),只保留安装、用法、API、主题等用户文档
0.1.2(2026-08-07)
下载此版本
- 支持 iOS 端:App 端条件编译分支已覆盖
APP-IOS,iOS 直接可用
0.1.1(2026-08-01)
下载此版本
查看更多
平台兼容性
uni-app x(4.25)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| √ |
√ |
√ |
√ |
√ |
√ |
其他
nax-rate
uni-app x 评分组件,功能覆盖常用场景。
依赖
nax-icon(星形图标)
nax-ui-theme(CSS 变量 --nax-*,安装时依赖 / 运行时弱依赖)
基础用法
<nax-rate v-model="value" @change="onChange"></nax-rate>
Props
| 属性 |
类型 |
默认 |
说明 |
| modelValue |
number |
0 |
当前分值(v-model),allowHalf 时可为 x.5 |
| count |
number |
5 |
星星总数(1–20) |
| disabled |
boolean |
false |
禁用交互,并降低透明度 |
| readonly |
boolean |
false |
只读展示(不交互、不降透明度) |
| size |
string |
md |
sm / md / lg,或数字像素字符串 |
| inactiveColor |
string |
'' |
未选中色;空则 --nax-color-text-placeholder |
| activeColor |
string |
'' |
选中色;空则 --nax-color-warning |
| gutter |
number |
6 |
星星间距(px) |
| minCount |
number |
0 |
最少可选星数 |
| allowHalf |
boolean |
false |
允许半星 |
| touchable |
boolean |
true |
允许滑动打分 |
| activeIcon |
string |
star |
选中图标(nax-icon name) |
| inactiveIcon |
string |
star |
未选中图标(nax-icon name) |
| customClass |
string |
'' |
根节点扩展 class |
尺寸
| size |
图标边长 |
| sm |
18px |
| md |
22px |
| lg |
28px |
Events
| 事件 |
说明 |
| update:modelValue |
v-model |
| change |
分值变化(number) |
主题
通过 CSS 变量覆盖:
| Token |
用途 |
--nax-color-text-placeholder |
占位文字色 |
--nax-color-warning |
警告色 |
--nax-opacity-disabled |
禁用透明度 |