CCMTimer
ComplexQuality and care programs
<co-ccm-timer>CCMTimer tracks chronic care management minutes for the month toward 99490 and 99439.
import { CCMTimer } from 'health-components';
Examples
Running And Paused
Both Codes Earned
Usage
<CCMTimer patient="Ralph Edwards" month="October 2026" minutes={23} defaultRunning clock="07:12" />
When to use
- Care managers logging time on calls and coordination.
When not to use
- RPM time: RPMReadingChart.
Variants and states
| Variant | What it is |
|---|---|
| running / paused | Badge and button. |
| earned | Helper names earned codes. |
Accessibility
- Clock not announced every second (aria-live off).
Do and don't
- Do: Count only eligible staff time with consent.
- Don't: Round minutes up.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
patient * | string | — | Patient name; required |
month * | string | — | Month being counted ("October 2026"); required |
minutes | number | 0 | Minutes already logged this month |
clock | string | "00:00" | Starting value of the session clock, "mm:ss" or "h:mm:ss" |
running | boolean | undefined (uncontrolled) | Controlled running state |
defaultRunning | boolean | false | Initial running state (uncontrolled) |
onRunningChange | (running: boolean) => void | — | Called when Start or Pause is pressed |
onLogActivity | (seconds: number) => void | none | Called by Log Activity with the session clock in seconds |
flat | boolean | false | Border instead of shadow |
footer | ReactNode | none | Footer content |
as | ElementType | 'section' | Root tag name |
Also accepts native attributes, including defaultChecked, defaultValue, autoFocus, plus className and event handlers on the root element.
Angular, Vue and HTML
Register the elements once (Angular guide), then use <co-ccm-timer>. Attributes take strings; arrays and objects are set as properties (Angular [prop], Vue :prop) or as JSON attributes. Callbacks are DOM events with the value in event.detail.
Angular template
<co-ccm-timer patient="…" month="…" [defaultValue]="defaultValue" (co-running-change)="onRunningChange($event.detail)"></co-ccm-timer>
| Kind | Name | Description |
|---|---|---|
| attribute | patient | Patient name; required |
| attribute | month | Month being counted ("October 2026"); required |
| attribute | minutes | Minutes already logged this month; default 0 |
| attribute | clock | Starting value of the session clock, "mm:ss" or "h:mm:ss"; default "00:00" |
| attribute | running | Controlled running state; default undefined (uncontrolled) |
| attribute | default-running / defaultRunning | Initial running state (uncontrolled); default false |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| attribute | flat | Border instead of shadow; default false |
| property / JSON attribute | as | Root tag name; default 'section' |
| event | co-running-change | Called when Start or Pause is pressed (React: onRunningChange) |
| event | co-log-activity | Called by Log Activity with the session clock in seconds; default none (React: onLogActivity) |
| slot | footer | Footer content; default none Plain text also works as the `footer` attribute. |