Skip to content
Alea
Pro
  1. Alea
  2. Components
  3. Feedback
  4. ChangedByBanner

FeedbackAlea Pro

ChangedByBanner

A notice that someone else changed what you are looking at ("Ana changed this 3 minutes ago"), with your own actions after it, such as Review changes and Keep mine.

import { Button } from '@alea-design/ui';
import { ChangedByBanner } from '@alea-design/pro';

Examples

Changed by someone

The sentence, the time and your own actions. A polite status: screen readers say it when it appears.

Case 1042

Three people work on the same case: who is here, who is editing what, and a banner when someone changes it.

Props

ChangedByBanner props

"Ana changed this 3 minutes ago", with your actions after it. A polite status, so a screen reader says it when it appears. Built on Banner.

PropTypeDefaultDescription
peoplerequiredPresencePerson[]Who changed it. Empty hides the banner.
actionsReactNodenoneThe buttons after the message: Review changes, Keep mine.
atTimeInputnoneWhen, as a date or a timestamp: shown as "3 minutes ago" with the exact time in a tooltip title.
classNamestringnoneExtra class names for the root element.
onDismiss(() => void)noneShows a close button.
tone"neutral" | "warning" | "info""info"info (default) or warning, for a change that touches what the person is doing.
whenReactNodenoneOr the time already worded ("while you were away"), when you do not have a date.

Specs

Generated from the source: the variants in the types, the states and tokens in the CSS, and the motion patterns that apply. The grids render the real component in both themes; the numbers are measured from the page.

Variants
toneneutralwarninginfo
Dark and light
Every color comes from theme tokens, so it follows data-theme (and presets like Graphite) on the page or any wrapper. Contrast is checked in both themes.
Styling hooks
.alea-changed-by.alea-changed-by-icon

Accessibility

  • It is a polite status, so a screen reader says the sentence when it appears and does not interrupt what the person is doing.
  • The time is a time element with the exact date and hour in its title; the relative text follows the language.
  • The buttons are yours: give them names that say what they do, and keep the safe one (Keep mine) as easy to reach as the other.

Keyboard

KeyDoes
TabReaches the actions and the close button

Do and don't

Do

  • Show it where the person is looking, above the content that changed.
  • Pair it with ReviewChanges: one action opens the review.
  • Pass at when you know it; pass when to say it your own way ("while you were away").

Don't

  • Don't apply the change before the person has chosen: the banner informs, it does not decide.
  • Don't stack one banner per change: pass all the people who changed it.

In Figma

The properties of the Figma components, generated from the kit, so they always match it. The last column is the React prop each one stands for.

Changed by banner · 3 variants

Figma propertyKindValuesDefaultReact prop
ToneVariantInfo, Warning, NeutralInfotone
MessageText-Ana changed this 3 minutes agopeople, at, when
ActionsBoolean-trueactions
DismissibleBoolean-falseonDismiss
Tested with axe, keyboard and screen reader roles