データ表示
Countdown
指定した日時までの残り時間を日・時・分・秒で示すタイマー。毎秒更新してゼロで止まり、onComplete で到達を知らせます。各セグメントにラベルを付け、色だけに頼りません。
ReactVueWeb Components
Storybook で見る プレイグラウンド
使用例
<Countdown to={Temporal.PlainDateTime.from('2027-01-01T00:00:00')} onComplete={() => alert('done')} />
<Countdown to="2027-12-31T23:59:59" format="hms" />設定できる項目
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
to 必須 | Temporal.PlainDateTime | Temporal.ZonedDateTime | string | — | Target date/time. Accepts `Temporal.PlainDateTime`, `Temporal.ZonedDateTime`, or an ISO string. When the target is in the past the display reads all zeros. |
onComplete | () => void | — | Called once when the countdown reaches zero. |
format | CountdownFormat | dhms | Which segments to show. `'dhms'` shows days + hours + minutes + seconds. `'hms'` shows hours (including overflow from days) + minutes + seconds. |
live | boolean | true | Whether to tick each second. |
アクセシビリティ
- 文字と背景の明るさの差をしっかり取り、読みやすくしています。ライトでもダークでも、見やすさの国際基準 WCAG の最高ランク AAA（明るさの差が 7:1 以上）を満たします。
- マウスがなくても、キーボードだけですべての操作ができます。
- いまどこを操作しているかを示す枠（フォーカスの囲み）が、常にはっきり見えます。
- 利用者が「画面の動きを減らす」設定にしているときは、過剰なアニメーションを止めます。
どのコンポーネントも、だれにとっても使いやすいように、見やすさの国際基準 WCAG の最高ランク AAA（WCAG 2.1 AAA）を満たすよう作っています。