• 简体中文
  • Rate 评分

    选择或展示评分。

    基础用法

    交互预览基础用法

    当前评分:3.5

    basic.tsx
    import { Rate } from '@sudden3/leaf-ui';
    import { useState } from 'react';
    
    export function RateBasic() {
      const [value, setValue] = useState(3.5);
      return (
        <div className="leaf-demo-stack">
          <Rate aria-label="项目评分" value={value} onChange={setValue} allowHalf />
          <p className="leaf-demo-note">当前评分:{value}</p>
          <Rate aria-label="只读评分" defaultValue={4} readOnly color="#20834a" />
          <Rate aria-label="禁用评分" defaultValue={2} disabled size="sm" />
        </div>
      );
    }
    

    Rate API

    属性类型默认值说明
    value / defaultValuenumber0受控 / 初始评分
    onChange(value: number) => void—评分变化
    countnumber5星数,范围 1–20
    allowHalf / allowClearbooleanfalse / true半星 / 再次点击清空
    disabled / readOnlybooleanfalse禁用 / 只读
    size'sm' | 'md' | 'lg''md'星星尺寸
    colorstring主题警告色评分颜色
    name / formstring—字段名 / 关联表单
    requiredbooleanfalse要求非零评分

    类型

    定义组件属性或组装列表时可导入相关类型。

    import type { RateProps } from '@sudden3/leaf-ui';

    使用说明

    方向键切换评分,Home / End 选择首尾,Delete 或 Backspace 清空。设置 name 后可通过 FormData 读取评分;required 支持表单校验,非受控评分支持 reset。