フォーム
Rating
星で評価を付ける部品。標準では操作でき、矢印キーで星の数を増減できます。readOnly にすると評価の表示だけになります。
ReactVueWeb Components
Storybook で見る プレイグラウンド
使用例
<Rating defaultValue={3} label="評価" onChange={setScore} />
<Rating value={4} readOnly />設定できる項目
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
value | number | — | Controlled value (0–`max`). |
defaultValue | number | 0 | Initial value when uncontrolled. @default 0 |
onChange | (value: number) => void | — | Called with the newly selected rating. |
max | number | 5 | Number of stars. @default 5 |
name | string | — | Radio-group name (auto-generated if omitted). |
size | 'sm' | 'md' | 'lg' | md | Control size. @default 'md' |
readOnly | boolean | false | Render as a non-interactive, labeled display. @default false |
disabled | boolean | false | Disable interaction. @default false |
label | string | Rating | Group label, e.g. "Rating". @default 'Rating' |
starLabel | (n: number, max: number) => string | ${n} / ${max} | Builds each star's accessible name. @default `${n} / ${max}` |
アクセシビリティ
- 文字と背景の明るさの差をしっかり取り、読みやすくしています。ライトでもダークでも、見やすさの国際基準 WCAG の最高ランク AAA（明るさの差が 7:1 以上）を満たします。
- マウスがなくても、キーボードだけですべての操作ができます。
- いまどこを操作しているかを示す枠（フォーカスの囲み）が、常にはっきり見えます。
- 利用者が「画面の動きを減らす」設定にしているときは、過剰なアニメーションを止めます。
どのコンポーネントも、だれにとっても使いやすいように、見やすさの国際基準 WCAG の最高ランク AAA（WCAG 2.1 AAA）を満たすよう作っています。