Skip to main content

CareTeamPanel

ComplexChart panels<co-care-team-panel>

CareTeamPanel lists everyone caring for the patient, inside and outside the practice, with role, specialty, NPI, last contact and call or message actions.

import { CareTeamPanel } from 'health-components';

Examples​

Showcase​

Storybook

Read Only​

Storybook

Empty​

Storybook

Usage​

<CareTeamPanel members={team} />

When to use​

  • Chart sidebar, referral routing, care coordination and transitions of care.

When not to use​

  • Staff scheduling: ProviderDayColumns.

Variants and states​

VariantWhat it is
internalPrimary avatar, message action.
outsideAccent avatar, Outside tag, no secure message.
primaryPCP tag (or a custom label).
endedDimmed with end date.
emptyAsks to add the PCP.
readOnlyNo add or row menu.

Clinical values​

Every number renders through CareOS.ClinicalValue and CareOS.fmt (the clinical-values builder), matched by LOINC; measures that table lacks (NT-proBNP, lactate, vancomycin trough, CrCl, PHQ-9, per-kg doses) use a local table with the same rules: tabular figures, the unit always shown, fixed decimals per measure (potassium 1, sodium 0, creatinine 2), the reference range in the title or beside it, and H, L, HH or LL flags in words for screen readers. The flag says where the number sits against the adult reference range in the rules table; it does not say the number was measured correctly.

Accessibility​

  • Icon buttons name the person and the number.

Do and don't​

  • Do: Show NPI for outside clinicians.
  • Don't: Delete an ended relationship: end it.

Props​

PropTypeDefaultDescription
membersCareTeamMember[]none (empty state)Team members
updatedstringnoneWhen the team was last updated
readOnlybooleanfalseNo Add Member or row menus
titlestring'Care Team'Card title
onAddMember() => voidnoneCalled by Add Member
onCall(member: CareTeamMember) => voidnoneCalled by Call
onMessage(member: CareTeamMember) => voidnoneCalled by Message
onMemberAction(action: CareTeamAction, member: CareTeamMember) => voidnoneCalled with a row menu action
rangeContextRangeContextIdthe global context, else 'outpatient'Which shared reference range flags use; the lab range on a result still wins

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-care-team-panel>. 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-care-team-panel updated="…" read-only [members]="members" (co-add-member)="onAddMember($event.detail)"></co-care-team-panel>
KindNameDescription
property / JSON attributemembersTeam members; default none (empty state)
attributeupdatedWhen the team was last updated; default none
attributeread-only / readOnlyNo Add Member or row menus; default false
attributetitleCard title; default 'Care Team'
attributerange-context / rangeContextWhich shared reference range flags use; the lab range on a result still wins; default the global context, else 'outpatient'
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus
eventco-add-memberCalled by Add Member; default none (React: onAddMember)
eventco-callCalled by Call; default none (React: onCall)
eventco-messageCalled by Message; default none (React: onMessage)
eventco-member-actionCalled with a row menu action; default none (React: onMemberAction)