Skip to main content

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​

Storybook

Both Codes Earned​

Storybook

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​

VariantWhat it is
running / pausedBadge and button.
earnedHelper 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​

PropTypeDefaultDescription
patient *string—Patient name; required
month *string—Month being counted ("October 2026"); required
minutesnumber0Minutes already logged this month
clockstring"00:00"Starting value of the session clock, "mm:ss" or "h:mm:ss"
runningbooleanundefined (uncontrolled)Controlled running state
defaultRunningbooleanfalseInitial running state (uncontrolled)
onRunningChange(running: boolean) => void—Called when Start or Pause is pressed
onLogActivity(seconds: number) => voidnoneCalled by Log Activity with the session clock in seconds
flatbooleanfalseBorder instead of shadow
footerReactNodenoneFooter content
asElementType'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>
KindNameDescription
attributepatientPatient name; required
attributemonthMonth being counted ("October 2026"); required
attributeminutesMinutes already logged this month; default 0
attributeclockStarting value of the session clock, "mm:ss" or "h:mm:ss"; default "00:00"
attributerunningControlled running state; default undefined (uncontrolled)
attributedefault-running / defaultRunningInitial running state (uncontrolled); default false
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus
attributeflatBorder instead of shadow; default false
property / JSON attributeasRoot tag name; default 'section'
eventco-running-changeCalled when Start or Pause is pressed (React: onRunningChange)
eventco-log-activityCalled by Log Activity with the session clock in seconds; default none (React: onLogActivity)
slotfooterFooter content; default none Plain text also works as the `footer` attribute.