Feedback topic
Feedback
Alerts, toasts, banners, status pills and screens, empty states, skeletons, progress bars and rings, spinners, countdowns, badges and a success check. Toasts and progress are announced to screen readers.
Classes
- SheenActionBanner Feedback
- A banner in the flow of a page that tells about a change and offers one action: "Prices changed · Show".
- SheenAlert Feedback
- The alert that showSheenAlert shows, for apps that present it themselves.
- SheenBadge Feedback
- A count or a dot at the top-end corner of child, in red with white figures, as iOS badges are: unread messages, items in a cart.
- SheenCountdownPill Feedback
- A pill counting down time left, such as a hold, an offer or a one-time code: in the warning colour while time remains, red with one pulse in the last two minutes (warnAt), grey at 0:00.
- SheenEmptyState Feedback
- An empty list or a dead end: a glyph in a glass circle, a title and your message. compact is the small form for sheets and side panes.
- SheenProgressBar Feedback
- A thin progress bar: a track filled with the accent up to value, from the start edge.
- SheenProgressCapsule Feedback
- A wait the user can see, such as "Checking live prices": a glass capsule with a spinner and a label, announced to screen readers as a live region.
- SheenProgressRing Feedback
- A circular progress indicator: an arc in the accent over a faint ring, filled to value.
- SheenSkeleton Feedback
- A placeholder block for content that is loading, swept by a soft highlight every 1.2 seconds; still with Reduce Motion. Without a width it fills the width it is given.
- SheenSpinner Feedback
- A ring spinner: a faint track with a bright quarter that turns. Like the system spinner it keeps turning with Reduce Motion, since the turning is the message.
- SheenStatusNotice Feedback
- A notice in a glass row with a glyph, such as "Payments are temporarily unavailable", with an optional action.
- SheenStatusPill Feedback
- A small capsule that names a state, such as "Confirmed" or "Pending", in the colour of its tone.
- SheenStatusScreen Feedback
- A whole screen that explains a state the app is in: offline, under maintenance, an update needed, a section closed, a booking confirmed.
- SheenSuccessCheck Feedback
- A filled check that springs in once with a success haptic, for a moment worth marking: a booking made, a payment done. With Reduce Motion it fades in instead.
- SheenSuggestionCard Feedback
- A way out of an empty state ("Try instead"): a title, an optional line under it and a chevron.
- SheenToast Feedback
- A short message at the top of the screen, above every page, sheet and the keyboard: a glass capsule with a glyph in the colour of its SheenTone.
Functions
-
showSheenAlert(
{required BuildContext context, required String title, required String message, required String primaryLabel, String? secondaryLabel, bool barrierDismissible = false}) → Future< Feedbackbool?> - Shows a decision alert on glass and returns true for the primary action, false for the secondary and null when dismissed.