Skip to content
BigBang

Popular

    ↑↓Navigate↵OpenEscClose
    TR

    Components

    CountdownTimer

    Time left until a moment, as a clock with an optional draining ring, a warning colour and spoken milestones.

    Storybook
    Storybook
    Source
    Source

    The clock has role="timer" and is named with label; the role is not live, so seconds are not read. Milestones are in a separate polite status region. The ring has aria-hidden.

    CountdownTimer takes no focus.

    Focus does not move when time is up; the app can move it to the next action if needed.

    Moment Output
    1 minute left “1 min left”
    10 seconds left “10 s left”
    Zero “Time is up”

    Moments already past at mount are not read.

    All state colours meet 4.5:1 for text; the ring track is decoration.

    Criterion How CountdownTimer meets it What product teams must do
    2.2.1 Timing adjustable The time is shown and announced. Offer a way to extend or restart it.
    4.1.3 Status messages Milestones are read without moving focus. —
    2.3.3 Animation from interactions The ring steps under reduced motion. —