material_expressive_parts library

Helpers for customizing components copied from material_expressive_ui.

Import this library in the copied widget to use its theme and component helpers.

import 'package:material_expressive_ui/material_expressive_parts.dart';

Outside semver: this library may change in any version, a patch included; the CHANGELOG says how to move.

Classes

AlertDialogBehavior
What Compose's AlertDialog sets in code (behavior.yaml, verified at the pin).
AnimatedExpressiveTheme
ExpressiveTheme, springing to each new data on the theme's default effects spring (Compose animates a colour change on its effects springs; Material's AnimatedTheme on a fixed duration): every colour role cross-fades, and the rest changes at the halfway point (ExpressiveThemeData.lerp). The first build shows data at once.
AppBarBehavior
What Compose's AppBar sets in code (behavior.yaml, verified at the pin).
AppBarLargeFlexibleTokens
Compose's AppBarLargeFlexibleTokens.
AppBarLargeTokens
Compose's AppBarLargeTokens.
AppBarMediumFlexibleTokens
Compose's AppBarMediumFlexibleTokens.
AppBarMediumTokens
Compose's AppBarMediumTokens.
AppBarSmallTokens
Compose's AppBarSmallTokens.
AppBarTokens
Compose's AppBarTokens.
AssistChipTokens
Compose's AssistChipTokens.
BadgeBehavior
What Compose's Badge sets in code (behavior.yaml, verified at the pin).
BadgeTokens
Compose's BadgeTokens.
BaselineButtonTokens
Compose's BaselineButtonTokens.
BottomAppBarTokens
Compose's BottomAppBarTokens.
BottomSheetBehavior
What Compose's BottomSheet sets in code (behavior.yaml, verified at the pin).
ButtonBehavior
What Compose's Button sets in code (behavior.yaml, verified at the pin).
ButtonGroupBehavior
What Compose's ButtonGroup sets in code (behavior.yaml, verified at the pin).
ButtonGroupLargeTokens
Compose's ButtonGroupLargeTokens (not in the pinned jar; from the token DB).
ButtonGroupMediumTokens
Compose's ButtonGroupMediumTokens (not in the pinned jar; from the token DB).
ButtonGroupSmallTokens
Compose's ButtonGroupSmallTokens.
ButtonGroupXLargeTokens
Compose's ButtonGroupXLargeTokens (not in the pinned jar; from the token DB).
ButtonGroupXSmallTokens
Compose's ButtonGroupXSmallTokens (not in the pinned jar; from the token DB).
ButtonLargeTokens
Compose's ButtonLargeTokens.
ButtonMediumTokens
Compose's ButtonMediumTokens.
ButtonSmallTokens
Compose's ButtonSmallTokens.
ButtonXLargeTokens
Compose's ButtonXLargeTokens.
ButtonXSmallTokens
Compose's ButtonXSmallTokens.
CardBehavior
What Compose's Card sets in code (behavior.yaml, verified at the pin).
CarouselBehavior
What Compose's Carousel sets in code (behavior.yaml, verified at the pin).
CheckboxBehavior
What Compose's Checkbox sets in code (behavior.yaml, verified at the pin).
CheckboxTokens
Compose's CheckboxTokens.
ChipBehavior
What Compose's Chip sets in code (behavior.yaml, verified at the pin).
ChipsTokens
Compose's ChipsTokens.
ChromeGroundScope
Publishes the ChromeGround of the page it wraps. ChromeRoutes.page mounts one inside a pushed page and inside a branch root (from its NavTab.ground); a system's chrome inside the page reads it.
CircularProgressIndicatorTokens
Compose's CircularProgressIndicatorTokens.
ConnectedButtonGroupLargeTokens
Compose's ConnectedButtonGroupLargeTokens (not in the pinned jar; from the token DB).
ConnectedButtonGroupMediumTokens
Compose's ConnectedButtonGroupMediumTokens (not in the pinned jar; from the token DB).
ConnectedButtonGroupSmallTokens
Compose's ConnectedButtonGroupSmallTokens.
ConnectedButtonGroupXLargeTokens
Compose's ConnectedButtonGroupXLargeTokens (not in the pinned jar; from the token DB).
ConnectedButtonGroupXSmallTokens
Compose's ConnectedButtonGroupXSmallTokens (not in the pinned jar; from the token DB).
CornerDp
A corner dp long.
CornerPercent
A corner percent of the shape's shorter side (50: fully round).
CornersToken
A shape's four corners, start and end as the reading direction runs.
CornerToken
One corner of a shape: a length, or a share of the shorter side.
DateInputBehavior
What Compose's DateInput sets in code (behavior.yaml, verified at the pin).
DateInputModalTokens
Compose's DateInputModalTokens.
DatePickerBehavior
What Compose's DatePicker sets in code (behavior.yaml, verified at the pin).
DatePickerModalTokens
Compose's DatePickerModalTokens.
DateRangePickerBehavior
What Compose's DateRangePicker sets in code (behavior.yaml, verified at the pin).
DefaultDesignLocalizations
The words in English, with no localizations package.
DesignAdaptiveShell
An app's frame: destinations in a bar, a rail or a sidebar by the shell's width (DesignNavigationMode.fromWidth, or mode), and the app's body beside it (above a bar). The look paints each destination (destinationBuilder) and the navigation round them (navigationBuilder); the shell gives them their keys, their meaning to a screen reader and their place.
DesignAnchoredOverlay
A surface anchored to anchorBuilder's widget: a popover (DesignOverlayTrigger.press, focusOnOpen), a hover card (DesignOverlayTrigger.hover) or a menu (arrowKeyNavigation on).
DesignBandScale
Categories side by side (bars): count bands from start to end, paddingInner of each step between bands and paddingOuter at the ends. A value is a band's index; map gives its centre.
DesignBottomSheetController
Drives an open DesignBottomSheetRoute's size from outside it, as DraggableScrollableController drives a sheet, on the route's spring. The caller makes it, gives it to one route at a time, and disposes it.
DesignBottomSheetDetails
What a DesignBottomSheetRoute's panel paints from.
DesignBottomSheetDragHandle
A bottom sheet's drag handle, painted by builder: a button that moves the sheet to its next size (from the largest back to the smallest; a sheet of one size closes), Up and Down to a larger or smaller size when focused, and a screen reader's increase and decrease. Put it in a DesignBottomSheetRoute's panel.
DesignBottomSheetRoute<T>
A modal bottom sheet. Push it with Navigator.push; its panel is builder's, the screen's width, rising from the bottom edge.
DesignCalendar
One or more month grids over a DesignCalendarController.
DesignCalendarController
A calendar's state: the shown month, the keyboard's day and the selection.
DesignCalendarDay
One day as the grid paints it.
DesignCalendarHeader
A month's header, as DesignCalendar.headerBuilder gets it.
DesignCapCenter
Draws a one-line label or text entry so that the middle of its capitals is the middle of its own box, as Baseline puts a baseline where it is told.
DesignCarousel
Slides itemBuilder builds, itemCount of them.
DesignCarouselControls
What a carousel's controls act on.
DesignChart
A cartesian chart (line, area, bars, a sparkline): the look draws series from the scales and ticks in builder's details; the chart picks points, says them, and springs from one set of data to the next.
DesignChartDetails
A DesignChart as its look draws it.
DesignChartPoint
A point of a DesignChartSeries: x and y, or a gap where y is null.
DesignChartPointRef
A point of a chart: the indexth point of the seriesth series.
DesignChartSeries
A named run of points, in order along x.
DesignChartTable
A chart's data as a table, the alternative an app shows instead of the chart (a screen reader's "Show data table"): a row per x value, a column per series (DesignChartTable.new), or a row per slice with its value and share (DesignChartTable.slices). A screen reader reads a table, its column headers and cells, a missing value as "Empty"; cellBuilder paints each cell, and the columns are as wide as their widest cell.
DesignChartTableCellDetails
A cell of a DesignChartTable.
DesignColorArea
A saturation (across) and brightness (up) area for controller's hue.
DesignColorAreaDetails
What the look paints the area from.
DesignColorController
A colour being picked, as hue, saturation, brightness and alpha.
DesignColorPicker
An area over a hue slider (and an alpha slider), on one controller.
DesignColorSlider
A slider for one channel of controller's colour.
DesignCombobox<T extends Object>
A text field that suggests options as you type.
DesignComboboxField
The field, as DesignCombobox.fieldBuilder gets it: wire controller and focusNode to the look's text input, and submit to its onEditingComplete (and give it no onSubmitted; see submit).
DesignCommand
A command in a palette.
DesignCommandPalette
The palette's body: the field over the results. Put it in a route with showDesignCommandPalette, or anywhere (a sidebar's search).
DesignCommandShortcut
Opens a palette from anywhere under it on activators (Ctrl+K and Cmd+K).
DesignContextMenu
A menu of menuChildren that opens over child, where the user asks for it.
DesignControlBox
A control's box: at least minHeight tall, as wide as its child (or as the width it is told to be), with child placed by alignment and its text given even leading (TextLeadingDistribution.even).
DesignDataTable<R>
The rows of a DesignTableController's page under a header row, with one tab stop for the rows. The look paints the header cells, the cells, and each row around its cells.
DesignDateField
A date typed in segments, in the reader's order: value is a calendar day (its time ignored), null when empty; onChanged gets the day once every segment holds one, and null when one is cleared.
DesignDateRange
A range of days, start to end inclusive; end is null while only the start is chosen.
DesignDateSegmentDetails
One segment of a DesignDateField or DesignTimeField, as the look paints it.
DesignDensity
How compact a look's controls stand, as Material's VisualDensity: each step of vertical takes heightStep from a control's height and each step of horizontal paddingStep from its padding at either side, from -4 (tightest) to 4 (roomiest).
DesignDestinationDetails
What a look paints a destination from.
DesignDialog
An alert's or a simple dialog's layout: title and content scroll together over actions, which stay put. The actions sit side by side, sharing the row on a compact screen and aligned at the end on a larger screen. When their labels do not fit, including at a large text size, they stack, one to a line, the last given (the confirm) on top and the first (the dismissive one) at the bottom, as Material and iOS stack them.
DesignDialogAction
An action at the foot of a DesignDialog.
DesignDialogActionDetails
What the look paints a DesignDialogAction from.
DesignDialogDetails
What a DesignDialogRoute's builder paints from.
DesignDialogFrameDetails
What the look paints a DesignDialog's frame and action bar from.
DesignDialogRoute<T>
A modal dialog or alert. Push it with Navigator.push; its page is builder's, over a barrier.
DesignField
A control with its label, help and error.
DesignFieldParts
What a DesignField's builder lays out.
DesignForm
A Form that, on a submit that fails, shows every error, moves focus to the first field that is wrong (scrolling it into view) and tells a screen reader how many fields need attention; after that, errors update as the reader edits.
DesignFormField<T>
A FormField whose control DesignForm can focus: give focusNode to the control.
DesignFormState
The state of a DesignForm: submit and reset it.
DesignHaptics
The haptics ui_core's behaviours play: one callback per moment; a null callback plays nothing.
DesignHapticsScope
Puts haptics in force for child: the table every ui_core behaviour below reads with DesignHaptics.of.
DesignInputGroup
A field and its add-ons as one control.
DesignInventory
A look's inventory: one entry per DesignInventoryRow.
DesignInventoryEntry
A look's answer to one row: a live specimen (builder) or the reason the look leaves it out (absentReason).
DesignInventoryGallery
Lists an inventory, group by group in DesignInventoryRow.groups' order: each row's live specimen, or Deliberately absent: <reason> for a gap, or "Missing" for a row the inventory does not answer. Lazy: a row builds when it scrolls in.
DesignInventoryRow
One row of the inventory: a component every look either carries or leaves out with a reason.
DesignKeylineFace
Marks child as one face for the checks in package:ui_core_test: a control's face or a well (a field's, a list's, a table's) whose pixels may not show it, or a picture with things placed on it.
DesignKeylineRegion
Marks child as a card or a section whose contents share keylines: a keyline is the line that what starts a row (or ends one) sits on, so a card's title, its rows' words, its fields and its dividers start on one line, and its switches, chevrons and selects end on another.
DesignLinearScale
A number line: min at start, max at end.
DesignListDetail<T extends Object>
A list (listBuilder) and the detail of selectedItem (detailBuilder), as Compose's ListDetailPaneScaffold.
DesignLocalizations
The words a design system says on its own. The behaviours' words: the names a screen reader hears for a part with no text of its own (a carousel, a sheet's barrier, a split view's handle) and the messages they announce (a slide turned, a row moved, the results found), each also a parameter on its behaviour, which a null leaves to this. And the general words a look shows or says by itself (Cancel, Close, Today, Next month, "2 of 5"), under MaterialLocalizations' names where Flutter has the word, so a look built on any app (MaterialApp, CupertinoApp, WidgetsApp) has them.
DesignMenuBar
A row of menus.
DesignMenuEntry
An item of a menubar: a command, a submenu (children), or a divider.
DesignMotionPolicy
The Reduce Motion policy: which spring a component actually runs.
DesignNavigationDestination
A destination: its name and glyphs, as Material's NavigationDestination.
DesignNavigationDetails
What a look lays the navigation out from.
DesignNumberField
A number typed or stepped: value the number, null when empty; onChanged gets it as it is taken (Enter, the focus leaving, a step), not on each key typed.
DesignNumberFieldButtonDetails
One of a number field's step buttons, as the look paints it.
DesignNumberFieldDetails
The field, as DesignNumberField.fieldBuilder gets it: wire controller, focusNode, keyboardType, inputFormatters and onEditingComplete to the look's text input.
DesignOtpController
Holds a code: its text, its length, whether it is whole.
DesignOtpField
A one-time code drawn as boxes over one input.
DesignOtpSlot
One box, as DesignOtpField.slotBuilder gets it.
DesignOverlayAnchor
The anchor, as DesignAnchoredOverlay.anchorBuilder gets it.
DesignOverlayInfo
What DesignAnchoredOverlay.overlayBuilder paints the surface from.
DesignOverlayPadding
The edges a surface opened under it keeps clear of, beyond the screen's safe area and the on-screen keyboard: a look's own chrome over its pages, such as a desktop side bar a page's overlay runs under.
DesignOverlayPlacement
Where a surface goes relative to its anchor.
DesignPasswordController
Whether a password shows: true while it is hidden.
DesignPasswordDetails
What a DesignPasswordReveal's builder paints from.
DesignPasswordReveal
Holds whether a password shows and gives the field and its toggle what they need. The field keeps its focus and caret as it flips; with hideOnBlur a shown password hides again when focus leaves the field.
DesignPieChart
A pie or donut: the look draws slices from the angles in builder's details; the chart picks a slice, says it, and springs from one set of values to the next.
DesignPieChartDetails
A DesignPieChart as its look draws it.
DesignPieSlice
A slice of a DesignPieChart: a label and its value.
DesignPieSliceDetails
A slice as drawn.
DesignPressable
Makes any widget a control (press, focus, hover and what a screen reader hears), with no look of its own.
DesignPressableState
The state of a DesignPressable: states is what its builder was last given.
DesignPullToRefresh
child, a scroll view, refreshed by onRefresh on a pull.
DesignPullToRefreshState
The refresher's state: refresh runs one (a keyboard shortcut, a menu's "Refresh").
DesignRangeSlider
A slider of values between min and max.
DesignRangeTrack
The track's state, for the look to paint its rail and the filled part.
DesignRangeValues
A range's two ends.
DesignRating
A rating of itemCount items filled up to value (0, none, to itemCount): onChanged gets the value a tap, a drag, a key or a screen reader sets.
DesignRatingItemDetails
One item of a DesignRating, as the look paints it.
DesignRefreshDetails
What the look paints the indicator from.
DesignReorderableList<T extends Object>
A list of items the reader puts in order; onReorder gets an item's place from and its new place to (counted after it left).
DesignReorderItem
An item's place and moves, as DesignReorderableList.itemBuilder gets them.
DesignScale
Values to positions and back.
DesignScaleTick
A tick on a scale: a value, its position, its label.
DesignScrollArea
child, a scroll view on controller, with a scrollbar from thumbBuilder (and trackBuilder) on its end edge (or bottom).
DesignScrollThumb
A scrollbar's geometry and state, for the look to paint.
DesignSearchError
A search that failed, as a combobox's or a tag input's errorBuilder gets it: paint a message and a "Try again" (DesignLocalizations.retryButtonLabel) that calls retry, lit while focused.
DesignSheetInfo
What a side sheet's panel gets to paint with.
DesignSheetPageRoute<T>
A full-screen sheet presented as an opaque page of the navigator. The whole page rises on a spring and returns along the same path. With Reduce Motion it fades. Escape and Back respect the page's PopScope.
DesignSideSheetRoute<T>
A modal side sheet. Push it with Navigator.push; its panel is builder's, sized to width (at most the screen less minGap) and the full height.
DesignSpacing
The step a look's spacing stands on: every padding, gap and spacing token a multiple of grid.
DesignSpacingScope
Declares the spacing a look's parts stand on for the subtree, as a theme does; DesignSpacing.of reads it.
DesignSplitAction
An action in a split button's menu.
DesignSplitButton
A main action with a menu of actions beside it.
DesignSplitView
first and second side by side (or stacked, axis vertical), split at fraction of the room (the first pane's share).
DesignStyle
How one part of a look looks, as Material's ButtonStyle is: every slot resolves for the part's states (WidgetState.disabled, WidgetState.hovered, WidgetState.focused, WidgetState.pressed, WidgetState.selected, WidgetState.error).
DesignStyleOf
A part's style layers read at its states: its own style:, then its component theme (first wins). Each getter is the first layer's value for states, or null, so the part goes on to the theme-wide knobs and its own default.
DesignSwipeAction
An action behind a row.
DesignSwipeActionDetails
What the look paints an action from.
DesignSwipeActions
child with startActions behind its start edge and endActions behind its end edge.
DesignSwipeActionsController
Opens and closes a DesignSwipeActions row from outside, and says whether it is open, as flutter_slidable's controller does. The caller makes it, gives it to one row, and disposes it; with no row it does nothing.
DesignSwipeBackPageTransitionsBuilder
builder's page transition with iOS's swipe back from the screen's leading edge round it.
DesignTab
A tab: its name, and what a look paints it with.
DesignTabBar
A bar of tabs, controller choosing among them; the look paints each tab (tabBuilder) and the indicator under them (indicatorBuilder), or over them (indicatorPosition).
DesignTabController
Which tab is selected, and where a swipe or a change has got to: Material's TabController without Material. A DesignTabBar and a DesignTabView given the same one follow each other. The caller makes it, with a TickerProvider (TickerProviderStateMixin), and disposes it.
DesignTabDetails
What a look paints a tab from.
DesignTabIndicatorDetails
Where a look paints the indicator, and the selected tab's states.
DesignTableColumn<R>
A column of a DesignTableController.
DesignTableController<R>
A table's data and its view of it: the filter, the sort, the selection and the page.
DesignTableRow<R>
One row, as DesignDataTable.rowBuilder gets it.
DesignTabView
The pages of controller's tabs, one per tab, swiped between: Material's TabBarView without Material. Swiping moves the controller's DesignTabController.animation, so a bar's indicator follows the finger; let go, the pages spring to the nearer page (or the next, flung) on the controller's spring. A change from the bar springs the pages the same way. Each page is its tab's panel to a screen reader; pages off screen are not built, unless a page keeps itself alive.
DesignTagDetails
One tag, as DesignTagInput.tagBuilder gets it.
DesignTagInput<T extends Object>
Values chosen as tags, with a field that suggests and makes more.
DesignTapTarget
Lays child out at least minSize (the floor for what reaches the controls, DesignTapTargets.of, when null), placed by alignment, and sends a tap anywhere in that area to the child's centre: the control's layout, the area a tap reaches and the box a screen reader outlines are one.
DesignTapTargets
The least area a tap must reach on a control, by what reaches it: 44 by 44 for a finger (Apple's Human Interface Guidelines), 24 by 24 for a pointer (WCAG 2.2, success criterion 2.5.8, level AA).
DesignTapTargetScope
Declares the targets a look's controls stand at for the subtree, as a theme does; DesignTapTargets.of reads them.
DesignTextEntryBox
A text entry's box: at least minHeight tall, holding child, an editable as wide as the box, with one line centred in it and hint on the typed text's baseline while controller is empty.
DesignTimeField
A time of day typed in segments, on the reader's clock: value the time, null when empty; onChanged gets it once every segment holds one, and null when one is cleared.
DesignTimeOfDay
A time of day with no date: an hour (0–23), a minute and a second.
DesignTimeScale
Time, in local dates: min at start, max at end. Its values are milliseconds since the epoch (DateTime.millisecondsSinceEpoch); its ticks fall on calendar steps (seconds to years) and read as the reader's times and dates.
DesignToast
What a toast says and does. The look reads the fields it paints; data carries anything else it needs (a tone, an icon).
DesignToastDetails
What the look's DesignToaster.toastBuilder paints one toast from.
DesignToaster
Hosts toasts over child: put it above the app's navigator (WidgetsApp.builder), then call DesignToaster.of and DesignToasterState.show from anywhere below.
DesignToasterState
The state of a DesignToaster: show and dismiss toasts through it.
DesignToastHandle
A shown or waiting toast, as DesignToasterState.show returns it.
DesignToggleGroup<T>
A row (or column) of toggles over options.
DesignTooltip
A tooltip of message for child, painted by tooltipBuilder.
DesignTree<T extends Object>
The open rows of controller, one tab stop for all of them.
DesignTreeController<T extends Object>
A tree's nodes and which are open and selected.
DesignTreeItem<T extends Object>
A row's paint state.
DesignTreeRow<T extends Object>
A shown row of a tree.
DesignValueHandle
A focusable value between min and max.
DesignWheelColumn
One column of a DesignWheelPicker: its rows, their names and which of them can be chosen.
DesignWheelColumnDetails
One column of a DesignWheelPicker, as the look frames it: its lens, a band behind the centre row, a focus ring.
DesignWheelItemDetails
One row of a DesignWheelPicker, as the look paints it.
DesignWheelPicker
A wheel picker of linked columns: selection holds a row per column, columns gives the columns for a selection, and onChanged gets every pick as a whole, valid selection.
DialogTokens
Compose's DialogTokens.
DisplayFormat
English display formats for amounts, counts and dates.
DividerTokens
Compose's DividerTokens.
DockedToolbarBehavior
What Compose's DockedToolbar sets in code (behavior.yaml, verified at the pin).
DockedToolbarTokens
Compose's DockedToolbarTokens.
DragHandleTokens
Compose's DragHandleTokens.
ElevatedButtonTokens
Compose's ElevatedButtonTokens.
ElevatedCardTokens
Compose's ElevatedCardTokens.
ExpandedListTokens
Compose's ExpandedListTokens.
ExpressiveAmount
Money as a screen shows it, already formatted for the currency (text, $1,299.00): tabular figures, and at the title and display sizes the decimals a type step down and quieter (onSurfaceVariant) beside the whole units; was, the price before, struck through after it. Its ink is onSurface, or color (an error for money out). Announced as one node: the amount, then "was" and the old price.
ExpressiveAndroidShadowModel
Android's ambient and spot light values for Material elevation shadows.
ExpressiveAngleMeasurer
Measures a cubic by the angle it sweeps around (centerX, centerY): the measurer graphics-shapes 1.0.1 (what Compose material3 1.5.0-alpha29 runs on) matches morphs with.
ExpressiveAppBar
The authored screen header: Material's top app bar in its small, medium flexible and large flexible sizes, or the search app bar (ExpressiveAppBar.search).
ExpressiveAppBarAction
One action of an ExpressiveAppBar: an icon button that folds into the bar's overflow menu as an item when the bar has more than two.
ExpressiveAppBarScroll
Where a top bar stands against the content under it β€” Compose's TopAppBarState offsets, as a value: heightOffset (0 at rest, down to minus the bar's collapse range) and contentOffset (0 at rest, negative as content scrolls under the bar).
ExpressiveAppBarScrollScope
Publishes the ExpressiveAppBarScroll of the scrollable a screen's bar stands over; the bar reads it when it is given none of its own.
ExpressiveAreaChart
A count over time as a line over a tonal area from zero: a primary stroke over primaryContainer, the highlight point marked, every label under its point; values spring to new heights. With tooltip a pointer shows the point under it. An ExpressiveChart.line on ExpressiveChartDomain.zero.
ExpressiveArtwork
Looks up a picture’s colour scheme for the active app theme.
ExpressiveArtworkScheme
A picture’s light and dark colour roles at a given contrast.
ExpressiveAvatar
A person's or an entity's face in a small fixed shape: the photo in slotId when given (the initials standing in while it is pending or missing), else icon when given, else the initials of name β€” on a tone's container: tone, or when that is null the tone name always picks, so a list of people is varied and each person keeps a colour (ExpressiveMediaTone.primary is Material's list avatar exactly).
ExpressiveAvatarGroup
Who is in: the first max faces side by side from the start, 4dp apart, then one surfaceContainerHighest disc counting the rest of total (+3). The faces never overlap: in Material two surfaces of one level stand beside each other, never one through the other. Each face is an ExpressiveAvatar at size (a picture in the same circle); a screen reader hears semanticLabel, or the names shown and how many more.
ExpressiveBackHandle
The system back for an overlay a component holds open over its route β€” a split button's menu, an open FAB menu, a combobox's menu β€” rather than in a route of its own (Compose's BackHandler(enabled = open) { close }).
ExpressiveBadge
A badge (Compose Badge): a 6dp error-coloured dot, or with a label a 16dp-tall pill of labelSmall text in onError β€” a count, "999+", "New".
ExpressiveBadgeAnchor
Stands any badge widget on the top end corner of child (Compose BadgedBox), for a part whose badge slot takes a widget (a navigation item, a tab); an app badges a child with ExpressiveBadge(child:): the box is child's size; a dot stands 6dp in from the end edge and 6dp down from the top, a count badge 12dp in and 14dp down from its bottom β€” over the edge, as Material draws it. The badge paints over the child and is not hit-tested (it is decoration; the child keeps the target).
ExpressiveBakedColors
Every colour role of one theme, light and dark, by role name (ExpressiveColorRole.name, onSurfaceVariant), as ARGB.
ExpressiveBakedMotion
What a theme bakes for its motion: the theme.json motion scheme.
ExpressiveBakedShapes
What a theme bakes for its shapes: the corners of each themeable step of the scale.
ExpressiveBakedTextTheme
What a theme bakes for its type scale: nothing yet β€” the one scale.
ExpressiveBakedTheme
One theme as generated: its theme.json record and each foundation's part.
ExpressiveBanner
A banner: a card with an icon, a message and one or two actions, for a prominent, persistent message the reader acts on or dismisses (offline, a pending verification, an update).
ExpressiveBannerAction
One of a banner's actions: a text button.
ExpressiveBarChart
Counts as rounded bars, one per point: outline bars, the highlight bar in primary, each label under its bar; an optional target dotted across them; values spring to new heights. With tooltip a pointer shows the bar under it. An ExpressiveChart.bar.
ExpressiveBareField
The text field's input with no container of its own: bodyLarge in onSurface, the placeholder in onSurfaceVariant, the caret in primary, at least 48dp tall (Compose's minimumInteractiveComponentSize; a smaller type scale centres its line in it). For a field whose frame ui_core's behaviour owns.
ExpressiveBottomSheet
Compose's BottomSheet: a sheet on anchors over the space it is given (see the library doc). Give it the whole screen: it stands at the bottom, centred, at most 640dp wide.
ExpressiveBreadcrumb
Breadcrumbs: the path from the root to the current page, each ancestor an extra-small text button (labelLarge, primary, its press, focus ring and corners the button's own) and the current page plain labelLarge in onSurface, announced as the current page. A chevron_right in onSurfaceVariant stands between steps, mirrored right to left. Past maxShown steps the middle folds into a more_horiz icon button that opens a menu of the folded steps; where the trail is wider than its room it folds further, down to the root, the fold and the current page, and only then scrolls, the current page kept in view. Material 3 has no breadcrumbs (web-first); this is drawn from its buttons.
ExpressiveBreadcrumbItem
One step of a breadcrumb trail: its label, what a tap does (onPressed; the current page's step takes none) and an optional leading icon.
ExpressiveButton
A common button: a label, optionally with a leading and a trailing icon, in one of Material's five styles and five sizes, round or square, that changes shape on press. The five are Flutter's classes, which share this base as Flutter's share ButtonStyleButton: ExpressiveFilledButton (and ExpressiveFilledButton.tonal), ExpressiveOutlinedButton, ExpressiveElevatedButton and ExpressiveTextButton. Disabled when onPressed is null.
ExpressiveButtonGroup
A standard button group (Compose ButtonGroup): related buttons in a row, the size's gap apart. Pressing one widens it by expandedRatio of its width and squeezes its neighbours (each by at most ButtonGroupBehavior.compressionLimit) on the group's spatial spring; a quick tap still plays the widening out to ButtonGroupBehavior.releaseThreshold before it springs back.
ExpressiveButtonSegment<T>
One option of an ExpressiveSegmentedButton (Material's ButtonSegment).
ExpressiveCalendar
A month calendar standing in the page (shadcn's Calendar; the date picker's grid without its dialog): the month's name over its arrows, the weekdays in the picker's weekday type, each day a 40dp circle in a 48dp cell (overhanging its seventh where seven do not fit) β€” the chosen day in primary, today ringed in primary, a range's days on its secondaryContainer band. The keyboard is ui_core's DesignCalendar: the arrows move a day or a week, Page Up and Down a month, Home and End to the week's ends, Enter chooses; the keyboard's day shows the focus state layer and ring. A pointer resting on a day while a range has its start shows where the range would end.
ExpressiveCard
A card: related content and actions about one subject, on a contained surface in one of three styles (variant; filled by default, as Compose's Card). A card adds no padding of its own (Compose's card is a bare Column): pass padding, or lay the content out yourself β€” media edge to edge, then text inset by the spacing scale's 16dp.
ExpressiveCardColors
A card's colours (Compose's CardColors, plus the outlined card's stroke from CardDefaults.outlinedCardBorder).
ExpressiveCarouselController
Drives a carousel and reports its current item (Compose's CarouselState): a ScrollController whose offset is the carousel's scroll, starting at initialItem. Listeners hear every scroll; read currentItem in them.
ExpressiveCarouselItemInfo
What an item's content may read about its mask (Compose's CarouselItemDrawInfo): ExpressiveCarouselItemInfo.of(context).
ExpressiveCarouselItemPlacement
Where one item goes at one scroll offset, in the layout's unit: its start along the main axis, its mask (from the item's own start), and its paint order.
ExpressiveCarouselKeyline
One keyline (Compose's Keyline): where an item of size sits when its centre reaches unadjustedOffset β€” at offset, cut off by cutoff at an edge. In the layout's own unit (device pixels in a carousel).
ExpressiveCarouselKeylines
An ordered list of keylines (Compose's KeylineList).
ExpressiveCarouselLayout
Compose's carousel layout at one scroll offset, in device pixels: the pager's pages (whole-pixel page size and spacing, placed from the snap position) and each item's keyline mask and translation.
ExpressiveCarouselStrategy
Compose's Strategy: the keylines at rest and the steps that shift them at either end of the scroll, for a carousel availableSpace long.
ExpressiveCarouselView
A carousel: a scrolling row of items whose masks grow and shrink by the keyline strategy of its variant (see the library doc), each item's content drawn at full size under its mask β€” pictures from media slots (ExpressiveMedia) are what it is for β€” masked by itemCorner (Material rounds carousel items at corner.extraLarge).
ExpressiveChart
A simple chart on tokens, no chart library: points as rounded bars (ExpressiveChart.bar: outline, at least 3:1 on the surface in every scheme as a mark that carries a value must be, the highlight bar in primary) or as a line (ExpressiveChart.line: a primary stroke of the linear progress indicator's track thickness over a primaryContainer area, the highlight point marked), on a hairline outlineVariant baseline, with each point's label under it in labelSmall. The plot is aspectRatio wide to high; a change of values springs the bars and the line to their new heights (the default spatial spring).
ExpressiveChartAxis
A resolved y axis: its bounds and the step its gridlines stand at.
ExpressiveChartBand
A band across the plot between two values (a target range, a person's usual range), drawn in surfaceContainerHigh (or its own color) under the series and named in the legend and to a screen reader.
ExpressiveChartDomain
What a chart's y axis spans.
ExpressiveChartPoint
One point of a chart: its label on the axis and its value.
ExpressiveChartSeries
One named series of a paired chart: its label (the legend's word and what a screen reader says) and its points.
ExpressiveChartTarget
A goal across the plot at one value, drawn as a dotted line in outline under the series (a sleep goal, a goal weight) and named to a screen reader.
ExpressiveChartTick
A candidate x-axis label: where it stands, in the unit of the chart's span, and what it says (Sep 21).
ExpressiveCheckbox
A Material 3 checkbox (Compose Checkbox and TriStateCheckbox): a 20dp box, 2dp in from its 24dp bounds, that fills and draws its check on the default spatial spring, and gathers the check into a dash when value is null (indeterminate; only when tristate).
ExpressiveCheckboxRow
A checkbox with its label, the whole row the touch target.
ExpressiveChip
A Material 3 chip, one of Compose's four:
ExpressiveChipRow
Chips in a row: flowing onto more lines when they do not fit (Compose's FlowRow the chip samples use), or, scrollable, one line that scrolls sideways. 8dp apart (ChipBehavior.horizontalSpacing); lines sit on the chips' 48dp touch targets.
ExpressiveChoiceGroup<T>
Choice tiles as a group, ExpressiveSpacing.s8 apart: .single chooses one (value, radio semantics) and reports it on the tap itself, so a first-run step can advance on it; .multi chooses any number (values, checkbox semantics), a tap toggling one. semanticLabel names the group (the question it answers).
ExpressiveChoiceOption<T>
One option of an ExpressiveChoiceGroup.
ExpressiveChoiceTile
One large tonal choice: icon, title and an optional supportingText line, selected or not. Tap it to choose; in a group (ExpressiveChoiceGroup) the group decides what a tap does.
ExpressiveChosenFile
A file chosen in an ExpressiveFileUpload: its name and an optional detail (its size, 2.4 MB).
ExpressiveChromeMetrics
Expressive's chrome geometry, in logical pixels (dp).
ExpressiveCircularProgressIndicator
A circular progress indicator (Compose CircularProgressIndicator, 40dp; or with wavy CircularWavyProgressIndicator, 48dp, a hero).
ExpressiveCoachMark
A persistent rich tooltip with a caret and an action that teaches one feature in place: up while visible, pointing at child.
ExpressiveColorPicker
A colour chosen on a saturation and brightness area, a hue slider and, with showAlpha, an opacity slider, its hex code typed beside a swatch (shadcn's colour picker; Material has none). The area stands on the medium corner; the sliders are 12dp pill tracks (the hue's spectrum, the opacity's fade over a checker); every thumb is a 20dp circle of the colour under a 2dp surface ring and an outline hairline, which grows its state layer's halo under a pointer and wears the focus ring under the keyboard. The keys are ui_core's: the arrows step a thumb, Page Up and Down by ten; each part reads as an adjustable value.
ExpressiveColorScheme
Every colour role of one theme in one brightness.
ExpressiveCombobox<T>
An editable exposed dropdown menu (Compose's ExposedDropdownMenuBox around an editable field, the EditableExposedDropdownMenu sample): typing opens a menu of the options that match the text (filter; by default, the label contains it, ignoring case) while focus and typing stay in the field. Choosing one puts its label in the field, the caret at its end, and reports it through onSelected. The trailing arrow opens and closes the menu on its own.
ExpressiveComponentThemeData
A component style with stateful visual slots, resolved before the look's tokens.
ExpressiveContentBorder
An outline with an explicit content inset, in addition to its stroke.
ExpressiveCornerBorder
A rectangle with four independently sized corners, start and end following the reading direction: Compose's RoundedCornerShape. Each corner resolves against the painted rectangle and is clamped to half its shorter side, as Compose clamps. Lerps corner by corner.
ExpressiveCornerFeature
Corners contain the list of cubic curves which describe how the corner is rounded (or not), and a flag indicating whether the corner is convex. A regular polygon has all convex corners, while a star polygon generally (but not necessarily) has both convex (outer) and concave (inner) corners.
ExpressiveCornerRounding
Defines the amount and quality around a given vertex of a shape. radius defines the radius of the circle which forms the basis of the rounding for the vertex. smoothing defines the amount by which the curve is extended from the circular arc around the corner to the edge between vertices.
ExpressiveCornerSize
One corner's size: dp plus fraction of the shape's shorter side (Compose's CornerSize; one of the two is zero unless interpolated).
ExpressiveCounter
A number that moves: when value changes it counts from the number it shows to the new one on the slow effects spring (critically damped, so it never overshoots the answer) and settles on exactly value. The first build shows value without motion; a change mid-run retargets from where the count is.
ExpressiveCustomColor
A custom colour and its container, with their contrasting foreground colours.
ExpressiveCustomColors
Named custom colour groups for each of an app's themes.
ExpressiveCustomColorSet
One theme's custom colours, light and dark, by name.
ExpressiveDataTable<R>
The rows a DesignTableController holds, a page at a time, under a header that sorts (shadcn's DataTable; Material's data table): rows in the list item's grammar, as ExpressiveTable's, at least 56dp tall, a hairline between each, a chosen row on the list's selected container (secondaryContainer), the state layer filling the row's own square, the focus ring inside it. With selectable a checkbox stands before each row and a tristate one before the header, which takes the page. A sortable header is a pill: its label and an arrow pointing the sort's way, its state layer on the pill, its target 48dp tall. Past one page, ExpressivePagination stands under the rows.
ExpressiveDatePicker
Compose's DatePicker: a header (the title, the headline showing the selected date, the mode toggle), then the calendar β€” month navigation, the weekday letters and the paged months, with the year grid behind the month button β€” or, in ExpressiveDatePickerMode.input, an outlined field that takes MM/DD/YYYY.
ExpressiveDatePickerDialog
Compose's DatePickerDialog: child (an ExpressiveDatePicker or an ExpressiveDateRangePicker) on the picker's container β€” 360dp wide, at most 568dp tall, the extra-large corner β€” over the dismiss and confirm text buttons at its bottom end. On a window too short for it the picker scrolls above the buttons.
ExpressiveDateRangePicker
Compose's DateRangePicker: the header (title, the "start - end" headline, the mode toggle), the weekday letters, then every month in a scrolling list under its subhead, the chosen span drawn behind its days; in input mode, a start and an end field side by side.
ExpressiveDensity
Density in Flutter's four-pixel steps: standard, comfortable and compact, as Flutter names them, and adaptivePlatformDensity, compact where a pointer is the norm (macOS, Windows, Linux) and standard on touch. A part keeps each visual's floor at every density, and the pressable keeps every touch target's accessible minimum.
ExpressiveDescriptionItem
One term and its value, in an ExpressiveDescriptionList.
ExpressiveDescriptionList
Terms and their values, a row each between hairline dividers: an order's details, a file's properties.
ExpressiveDialog
Compose's AlertDialog: an optional icon centred over the title, the supporting text (or any content), scrolling when it is taller than the dialog may be, and up to three actions, listed as drawn β€” the last is the confirm action, ending the row and on top when they stack.
ExpressiveDialogAction
One action of an ExpressiveDialog: a text button, or with filled a filled one. A press closes the dialog (its route returns value) and then runs onPressed; closesDialog false keeps the dialog open.
ExpressiveDisclosure
An expandable list item (Material's expanded list, ExpandedListTokens): a header ExpressiveListTile whose trailing chevron sits in a round container (surface collapsed, surfaceContainer expanded) and turns as child opens beneath it on the default spatial spring. Expanded, the header and its content become two segments with 16dp outer corners (ExpandedListTokens.ContainerShape), 2dp apart.
ExpressiveDivider
A Material divider (Compose's HorizontalDivider / VerticalDivider): a 1dp outlineVariant line, full width or inset by the list's 16dp divider spaces (inset).
ExpressiveDockedBand
Records its child's laid-out height as route's docked band.
ExpressiveDockedDatePicker
The docked date picker (Compose's docked sample): a read-only text field of kind (filled, as ExpressiveTextField is, so a date sits among a form's fields; Compose's sample draws it outlined) showing value as MM/DD/YYYY (or as format prints it), whose tap (or calendar button) raises the calendar in a popover below it β€” no header, no toggle. A chosen day is reported through onChanged at once; the popover stays until a tap outside, Escape or the system back closes it.
ExpressiveDockedToolbar
The docked toolbar: a full-width bar of actions at the bottom of the screen (Compose's FlexibleBottomAppBar), 64dp tall above the bottom inset, its actions spread across it or at the fixed spacing.
ExpressiveDoubleMapper
ExpressiveDoubleMapper creates mappings from values in the [0..1) source space to values in the [0..1) target space, and back. This mapping is created given a finite list of representative mappings, and this is extended to the whole interval by linear interpolation, and wrapping around.
ExpressiveEdgeFeature
Edges have only a list of the cubic curves which make up the edge. Edges lie between corners and have no vertex or concavity; the curves are simply straight lines (represented by ExpressiveShapeCubic curves).
ExpressiveElevatedButton
Material's elevated button (ElevatedButton): a tonal surface with a shadow, for a button that must stand off a patterned background.
ExpressiveElevation
How a theme shows elevation: context.expressiveTheme.elevation.
ExpressiveEmptyState
The page's empty state: a glyph on a round tonal ground, what is missing, what to do about it and a tonal call to action β€” the render state of any page that lists things.
ExpressiveErrorState
The page's error state: an error glyph, what failed and why, and a tonal retry β€” centred and announced; the render state of any page that can fail. Where the page already shows a mark above it (a hero that stays mounted through the error), icon null leaves the glyph out, so the page keeps one focal shape.
ExpressiveFabMenu
The FAB menu: a FAB that opens into 2–5 related acts stacked above it (Compose's FloatingActionButtonMenu + ToggleFloatingActionButton). Opening morphs the FAB into the round close button (size, corner, colour and glyph on FloatingActionButtonMenuBehavior.toggleMotion) and the items stagger in from the one nearest the button (staggerMotion; each item's width and opacity on itemWidthMotion, itemAlphaMotion).
ExpressiveFabMenuItem
One act in an ExpressiveFabMenu: an icon and a label on a pill.
ExpressiveFabScrollExpansion
Collapses an extended FAB while the page scrolls down and expands it when the page scrolls up or returns to its top (Material's extended FAB guidance; Compose's samples derive expanded from the list state).
ExpressiveFace
One face of an ExpressiveAvatarGroup: whose, and their picture β€” an image, or the app's picture slot slotId β€” with their initials standing in when there is none.
ExpressiveFeature
While a polygon's shape can be drawn solely using a list of ExpressiveShapeCubic objects representing its raw curves and lines, features add an extra layer of context to groups of cubics. Features group cubics into (straight) edges, convex corners, or concave corners. For example, rounding a rectangle adds many cubics around its edges, but the rectangle's overall number of corners remains the same. ExpressivePolygonMorph therefore uses this grouping for several reasons:
ExpressiveFieldError
The message under an input that says what is wrong (the error supporting text of Compose's text fields): bodySmall in the error role, inset like a field's supporting text, announced when it appears. A text field shows its own through errorText; this is the same line for a control that has none (a code input, a group of choices).
ExpressiveFieldFrame
An outlined frame for an input group or a tag field.
ExpressiveFieldNodeHost
Marks the text fields below as the face of a control whose menu opens from them (a select's, a combobox's): the field's own node, over its container, says whether the menu is expanded. The node stays the field's, so a screen reader outlines what a tap reaches, and the field's supporting text stays a node of its own, as on any field.
ExpressiveFileUpload
A file input: a drop area on surfaceContainerLow at the large corner step, its edge a solid outline hairline as a field's (Material draws no dashed edges: a surface's edge is a line), holding an upload glyph in primary, label in titleSmall, supportingText in bodySmall and a tonal button that calls onBrowse (the app opens its picker). While dragging (the app's drop target says a drag hovers) the area fills primaryContainer under a solid 2dp primary edge; an errorText draws the edge solid in error and says what is wrong under the area. The chosen files list under it, each with a remove button calling onRemove with its index. Material 3 has no file input; this is drawn from its surface and buttons, and takes no plugin: the app wires its own drop target and picker.
ExpressiveFilledButton
Material's filled button (Compose Button, Flutter's FilledButton): the highest emphasis, in primary; ExpressiveFilledButton.tonal is the tonal button in secondaryContainer.
ExpressiveFillProbedWidth
The content's root: under a probe that was given a tight width it takes the full width it is offered, so the row centres in the container.
ExpressiveFloatingActionButton
The floating action button: the screen's one primary act, an icon on a 56, 80 or 96dp rounded square (Compose's FloatingActionButton, MediumFloatingActionButton, LargeFloatingActionButton).
ExpressiveFloatingToolbar
A floating toolbar: a pill of actions that floats over the content, screenOffset (16dp) from the screen's edge (Compose's HorizontalFloatingToolbar / VerticalFloatingToolbar).
ExpressiveFocusRing
The M3 focus indicator a pressable draws under keyboard focus: a ring of thickness in secondary, offset out from the component's edge, following its shape (Material's token DB, md.comp.button.focus. indicator.thickness and .outline.offset, the same for every component that has them).
ExpressiveFocusRingBox
The focus ring alone round shape, drawn while focused: for a part whose surface another widget draws (a chip ui_core gives focus to).
ExpressiveFormField
A control with its label above it and its help or error under it (shadcn's FormField; ui_core's DesignField): the label in labelLarge onSurface (primary while the control has focus, error with error), a required field's asterisk after it, the help in bodySmall onSurfaceVariant and the error in its place in error, as a text field's supporting text. A screen reader hears the label as the control's name and the error and help as its hint, once. Wrap the fields in ui_core's DesignForm to validate them together.
ExpressiveFullScreenDialogPage<T>
The go_router Page for a full-screen dialog: a focused task that covers the whole screen and is closed explicitly (its pop, the system back). An ExpressiveSheetPage with drawer: true; the screen inside draws its close and confirm actions.
ExpressiveGrid
A lazy grid (Compose's LazyVerticalGrid): itemCount cells from itemBuilder, built as they scroll into view, in columns equal columns or β€” with minItemWidth β€” as many as fit at that width (GridCells.Adaptive), spacing apart both ways. Cells are childAspectRatio wide per tall unless itemHeight fixes them. With shrinkWrap it lays out at its content's height inside a scrolling page.
ExpressiveGroupTapTarget
DesignTapTarget's layout and reach without a node of its own, for a target whose parts are nodes already: a pressable's ExpressiveSemanticsGroup spans its target, and a range slider's two handles are a slider each. DesignTapTarget merges what it holds into one node, which would make those parts one.
ExpressiveHeroMoment
One hero moment: the scope a hero widget requires. Wrap the one place on a page that spends the app's expression β€” the primary action's L/XL button, a shaped hero image, the FAB menu β€” and nothing else.
ExpressiveHeroMomentScope
The mounted scope of one ExpressiveHeroMoment: what a hero widget finds above it.
ExpressiveHost
The app's host: mounts the Expressive theme in force (light or dark by brightness, or by the platform's when null) on an ExpressiveTheme; under it a thin Material ThemeData for the primitives Expressive builds on (ink, text editing and selection, scrolling, page transitions), whose platform is the ambient one; the ground (the surface role); the text and icon defaults (Compose's bodyLarge in onSurface); the text-selection colours (primary, its background at HostBehavior.textSelectionBackgroundOpacity); and on Android, edge-to-edge system bars: transparent, their icons contrasting with the ground.
ExpressiveIcon
A Material Symbols glyph (ExpressiveSymbols) as Compose's Icon draws it: size (the ambient IconTheme's when null), tinted color (the ambient content colour when null), filled when selected β€” the FILL springs on the fast effects spring of the motion in force (ExpressiveMotion.of: MotionSchemeKeyTokens.FastEffects). weight, grade and opticalSize set the font's other variable axes; the sizes of ExpressiveIconSize are Material Symbols' optical sizes. Decorative (silent) unless semanticLabel is given.
ExpressiveIconButton
An icon button: a Material Symbols glyph on a pressable of the kind's colours, sized by size and width, its corners springing to the size's pressed shape while pressed.
ExpressiveIconToggleButton
An icon toggle button: on or off, in the kind's checked colours, its corners springing to the size's checked shape and its glyph filling when value.
ExpressiveImagePlaceholder
What stands in for a picture while it is pending or missing, in the look's own material: one tone's container, and on it two of Material's library shapes (a large one in the tone's ink, faint, running off an edge, and a smaller one in another tone's container), as Material 3 Expressive's own illustrations compose them. A box too small for the shapes to read (under 96dp on its short side) shows the image glyph in the tone's ink instead. seed (the slot id) picks the tone, the shapes and where they sit, so a grid of pending pictures is varied and stable.
ExpressiveInputGroup
A field and its add-ons as one control (shadcn's InputGroup): a scheme's https:// before the input, a unit or a copy button after it, all inside the outlined text field's container, a hairline between each add-on and the input. The container's outline is the text field's: 1dp outline, onSurface under a pointer, 2dp primary while anything inside has focus, error with isError. A press anywhere on the frame focuses the input (ui_core's DesignInputGroup).
ExpressiveInputOtp
Segmented entry for a short fixed-length code β€” a one-time code, a PIN (code-input, for the auth kit): one cell per character, each a text field container, painted on ui_core's DesignOtpField. It is one input under the cells, so a paste or the platform's one-time-code autofill fills every cell, backspace steps back a cell, and a long press or a secondary click offers Paste. The next cell to fill shows the focused outline; a screen reader hears one field, its length, and when the code is wrong.
ExpressiveInsetBorder
A nested outline concentric with outer, inset pixels inside it.
ExpressiveInventoryGallery
The inventory as one scrolling list, group by group: each group's heading in titleLarge with how many rows it carries, each row its name in titleSmall, its class in labelMedium (and, for a part that paints a ui_core behaviour, that behaviour), then its specimen, live, in a card's column: at most 560dp wide and 560dp tall.
ExpressiveLinearProgressIndicator
A linear progress indicator (Compose LinearProgressIndicator, or with wavy LinearWavyProgressIndicator, a hero).
ExpressiveLineChart
A line of a measure over time on an axis scaled to its data (pulse 64–78 reads 60–80 by 5): a primary stroke, the highlight point marked, gridlines at round steps, no area (an axis off zero would make an area read as a quantity from zero). The x labels thin out to fit (sparse). An ExpressiveChart.line on ExpressiveChartDomain.data.
ExpressiveLineReach
A field's line in a taller slot: its child (one line of text) centred on the slot's middle at its start edge, and a tap anywhere in the slot taken by the line, at the nearest spot on it, as a tap anywhere on Flutter's decorated TextField places the caret. The slot is height tall, else at least minHeight; it fills the width it is given unless fillWidth is false.
A link: its words in primary, underlined, with the pressable's state layers and ripple. Standing alone it keeps the 48dp tap target every control does; in a paragraph (span) it takes none, as WCAG 2.5.8 exempts a target inside a sentence (a line box cannot grow).
ExpressiveListSection
A group of list items (Compose's SegmentedListItems spaced ListItemDefaults.SegmentedGap, 2dp, apart): each item's corners are 4dp inside the group and 16dp on its outer edges, and a selected, pressed or focused item rounds to 16dp. With segmented false it is a plain list: items flush, optionally split by dividers.
ExpressiveListTile
A Material 3 Expressive list item (Compose's interactive ListItem, and SegmentedListItem inside an ExpressiveListSection): a headline with an optional overline above and supporting text below, between leading content (an icon, avatar, image or checkbox) and trailing content (text, an icon, a switch or a checkbox).
ExpressiveLoadingIndicator
The Expressive loading indicator (Compose LoadingIndicator, or with contained ContainedLoadingIndicator): a shape that morphs through seven library shapes as it turns β€” the wait for anything under about five seconds.
ExpressiveLoadingState
The page's loading state: the contained loading indicator over what is loading, centred and announced β€” the render state of any page that waits.
ExpressiveLocalizations
Every word a component says without being told.
ExpressiveLocalizationsScope
Gives its subtree strings in place of the ones above it (a host's translation, or a product's own wording).
ExpressiveMaterialShapeBorder
A library shape as a border: to clip imagery (ClipPath.shape, ShapeDecoration), never a text container.
ExpressiveMeasuredCubic
A MeasuredCubic holds information about the cubic itself, the feature (if any) associated with it, and the outline progress values (start and end) for the cubic. This information is used to match cubics between shapes that lie at similar outline progress positions along their respective shapes (after matching features and shifting).
ExpressiveMeasuredPolygon
A polygon whose curves are measured and given outline progress values.
ExpressiveMeasurer
Interface for measuring a cubic. Implementations can use whatever algorithm desired to produce these measurement values.
ExpressiveMedia
A picture in a declared media slot (the design kit's resolver), filling its box by fit, at aspectRatio when given, masked by corner on the theme's corner scale β€” or, with ExpressiveMedia.shaped, by a library shape (a hero moment).
ExpressiveMediaGround
A subtree on a media ground (design_kit's ChromeGround.media): the host's dark theme (ExpressiveHost.mediaThemeOf), the primitives it reads and its system bars β€” light icons β€” whatever brightness the app is in. The shell mounts it around its bar on a media tab and ExpressiveScaffold around a page that stands on media, so a feed's bar and a pushed player's back arrow are drawn in the dark scheme.
ExpressiveMenu
A menu anchored to child (Compose's DropdownMenuPopup with its anchor): a tap on child β€” or a long press or secondary click, with trigger longPress β€” opens groups (or one group of entries) below it. With builder, the app draws the anchor and opens the menu through the controller it is handed (an overflow icon button, a split button's trailing half, a select's field); controller opens it from anywhere.
ExpressiveMenuBar
A row of menus, a desktop app's File, Edit and View (shadcn's Menubar; ui_core's DesignMenuBar): each menu's title a text button in labelLarge on the full corner (40dp, in a 48dp target), its open menu's title on secondaryContainer; each menu a menu's panel of items with their shortcuts, check items checked by a leading check, submenus marked by an arrow. The arrows move along the bar and through a menu, Escape closes it, and a pointer moving along an open bar opens each menu in turn. Material has no menu bar; this is its menus on a bar.
ExpressiveMenuBarEntry
One entry of an ExpressiveMenuBar: a menu on the bar (its children), an item in a menu, a submenu, or a divider.
ExpressiveMenuCheckItem
An on/off setting (Compose's CheckableDropdownMenuItem): a tap flips checked through onChanged. Checked, it wears the selected container and shape and shows checkedIcon (the check, grown in on a spring when there is no icon; a given icon fills instead). The menu stays open unless closesMenu.
ExpressiveMenuController
Opens and closes an ExpressiveMenu or an ExpressivePopover from the app: an app bar's overflow button, a split button's trailing half, a select's field.
ExpressiveMenuDivider
A divider between a group's items (HorizontalDivider with MenuDefaults.HorizontalDividerPadding).
ExpressiveMenuEntry
One line of a menu group: an ExpressiveMenuItem, an ExpressiveMenuCheckItem, an ExpressiveMenuRadioItem, an ExpressiveMenuSubmenu, an ExpressiveMenuDivider or an ExpressiveMenuNote.
ExpressiveMenuGroup
A group of a menu (Compose's DropdownMenuGroup): an optional label (MenuDefaults.DropdownMenuGroupLabel) over its entries.
ExpressiveMenuItem
An action (Compose's DropdownMenuItem with a shape): a tap closes the menu, then runs onPressed. Disabled when onPressed is null.
ExpressiveMenuNote
A line the menu says rather than offers: nothing presses or focuses it, and a screen reader hears it as it changes (a live region). It sits where an item would, in the item's supporting type and ink, so builder gives only the words (a combobox's "No results").
ExpressiveMenuRadioItem
One of a set of choices (Compose's SelectableDropdownMenuItem, announced as a radio button): a tap selects it through onSelected and closes the menu unless closesMenu is false.
ExpressiveMenuSubmenu
An item that opens a cascading menu of groups beside it (Compose's MenuWithCascadingMenusSample: a second popup at MenuAnchorPosition.End). A choice in it closes both menus.
ExpressiveMenuSurface
A menu laid out: its groups as DropdownMenuPopup shows them, 2dp apart, as wide as the widest item. ExpressiveMenu shows it in a popup; laid out in place it is a menu at rest (a gallery, a screenshot). A bounded height scrolls the entries instead of clipping the last action.
ExpressiveMessageBubble
One chat message: text in bodyLarge on a bubble β€” incoming on surfaceContainerHigh at the start, outgoing on primary at the end β€” at most four fifths of the width, rounded largeIncreased except the sender-side corners it shares with the rest of its run (position: extraSmall). The first of an incoming run can name its author; the last of a run carries the timestamp and, outgoing, the status under the bubble in labelSmall.
ExpressiveMeter
An amount against its limit: the label at the start and the figure at the end over a determinate ExpressiveLinearProgressIndicator that fills the width, and a note under it. Past limit the indicator stays full and the figure and the indicator turn error. Announced as one node: the label, the figure of the limit, the note.
ExpressiveMinimumInteractiveSize
Compose's Modifier.minimumInteractiveComponentSize() on ui_core's padded tap target (DesignTapTarget): child keeps its size, centred in at least size Γ— size (HostBehavior.minimumInteractiveComponentSize, 48dp), and a tap anywhere in that area reaches it. The layout, the area a tap reaches and the box a screen reader outlines are one: the target is one node, child's semantics merged into it, so wrap one control, never a group.
ExpressiveMorph
A morph between two library shapes (Compose's Morph): the curves of both matched once, then any progress between them written into a Path the caller owns and reuses β€” nothing is allocated per frame. The matched data is shared and immutable; the output path never is, so any number of clippers and painters can use one pair at their own progress. Progress is what a spring drives (0: from, 1: to; a little beyond overshoots).
ExpressiveMorphClipper
Clips to morph at progress's value, re-clipping as it changes: a library-shape morph over imagery, driven by a spring.
ExpressiveMotion
The motion of one theme, or of one place in the tree (of).
ExpressiveMotionTokens
Compose's ExpressiveMotionTokens.
ExpressiveMultiChoiceSegmentedButton<T>
The multi-choice segmented button (Compose's MultiChoiceSegmentedButtonRow): the connected group of ExpressiveSegmentedButton whose segments are independent toggles, value the set chosen.
ExpressiveMultiSelect<T extends Object>
Several of options chosen as input chips in a field that suggests the rest as you type (shadcn's multi-select; ui_core's DesignTagInput): the outlined text field's container (2dp primary while anything in it has focus), each chosen value an input chip with its remove glyph, the keyboard's chip ringed, and the matching options on a menu's panel under it. The arrows (round past the ends, over a disabled option, which is offered dimmed), Enter and Escape work the suggestions; Backspace on an empty field, or Left at its start, steps onto the chips, and Backspace or Delete removes one. With onCreate the typed words make a value of their own.
ExpressiveNavigationBar
The flexible navigation bar (Compose ShortNavigationBar): a 64dp surfaceContainer band of destinations β€” 3 to 5 β€” over the system's bottom and side insets, the selectedIndex item wearing the active indicator (a secondaryContainer pill, the icon filled, the label in secondary). Selecting an item calls onSelected.
ExpressiveNavigationDrawer
The navigation drawer, standing: the expanded navigation rail (Material 3 Expressive retires the drawer for it), as wide as its longest label needs, from 220 to 360dp, each destination its icon and label in a row under a round indicator that spans the drawer 12dp in from its edges, a count at the row's end (Material's drawer), beside the page at expanded widths (840dp and up). On a phone the same drawer rises modally over a scrim with ExpressiveNavigationDrawer.show. The expanded ExpressiveNavigationRail, whose indicators hug their content.
ExpressiveNavigationRail
The navigation rail (Compose WideNavigationRail), collapsed: a 96dp surface column along the leading edge, header (the floating action button, a menu button) 44dp below the top inset, then destinations 4dp apart under it, each a 64dp vertical item.
ExpressiveNavItem
A named navigation destination with an icon and an optional badge.
ExpressiveNumberField
A whole-number quantity between two tonal icon buttons, βˆ’ and +: a cart line, guests, servings. Holding a button repeats; each button disables at its bound. format shows the value (a unit, a price); label names the quantity to a screen reader ("Increase Guests").
ExpressiveOutlinedButton
Material's outlined button (OutlinedButton): medium emphasis, an outline and no fill.
ExpressiveOutsideOutline
Keeps child out of the box a screen reader outlines for the pressable round it, cut from the side it stands on: a search bar's trailing actions, controls with nodes of their own, take the taps there, so the bar's node ends where its own tap does.
ExpressivePage<T>
The go_router Page for a route pushed off a root, keyed by go_router's page key. The page's chrome is derived, never authored: a screen inside reads the pushed register (RoutePresentation.of) from the route's place.
ExpressivePageDots
A page indicator: a dot per page, the current one stretched into a pill (M3 has no page indicator; this one is drawn from the foundations: the spacing scale's 8dp dot, its 24dp pill, corner.full, primary for the current page and outline for the rest β€” a control's 3:1 against the page, where outlineVariant is decoration and reads too faint β€” springing between pages on the fast spatial and effects springs).
ExpressivePageTransitionsBuilder
The look's push and pop for a page route it does not build itself (a MaterialPageRoute, go_router's MaterialPage): the fade-forwards an ExpressivePage pushes with, on its clock (ExpressivePage.fadeForwardsDuration): the page travels 96dp and fades in while the page beneath travels 96dp the other way; the pop is the reverse. expressivePageTransitions names it for macOS, Windows, Linux and Fuchsia.
ExpressivePagination
Pagination: previous and next standard icon buttons (chevron_left, chevron_right, mirrored right to left, disabled at either end) around the pages β€” the current one an extra-small tonal button announced as "Page 3 of 12", the others extra-small text buttons, the first and last always shown and each run between folded into an ellipsis. Where that row doesn't fit, "Page 3 of 12" in bodyMedium stands between the arrows instead. Material 3 has no pagination (it scrolls); this is drawn from its buttons, so every press, focus ring and corner is theirs.
ExpressivePasswordField
A password field: ExpressiveTextField with its text hidden and the eye after it (the secure text field's own toggle, a 40dp round icon button in onSurfaceVariant, error in error) that shows and hides it. The reveal is ui_core's DesignPasswordReveal: the toggle is named "Show password" or "Hide password" and reads as a toggle, and with hideOnBlur the text hides again when the field loses focus. Autofill offers saved passwords.
ExpressivePieChart
Parts of a whole as a donut: each part an arc in its own colour (primary, tertiary, secondary, outline in turn), 4dp apart, its ends round, centerValue over centerLabel in the hole and a legend of each part's value under it. An ExpressiveChart.donut.
ExpressivePlainTooltip
Compose's PlainTooltip: message in bodySmall on inverseSurface, on the extra-small corner, 8 Γ— 4dp padding, 40 Γ— 24dp at least and 200dp wide at most. An ExpressiveTooltip shows it; laid out in place it is the bubble alone.
ExpressivePoint
A point, or a vector, in two dimensions.
ExpressivePointNRound
One vertex of a custom polygon and its rounding (Compose's private PointNRound).
ExpressivePolygonMorph
This class is used to animate between start and end polygons objects.
ExpressivePopover
A popover anchored to child: content on the menu surface (ExpressivePopoverSurface), opened and placed the way a menu is β€” a tap (or, with trigger longPress, a long press) on child, or the builder's controller, opens it; a tap outside or the system back closes it, and so does ExpressivePopover.close from inside it.
ExpressivePopoverSurface
The menu surface holding arbitrary content: a standalone menu group's container (surfaceContainerLow on the large corner, elevation 2) with padding around child. ExpressivePopover shows it in a popup; laid out in place it is the surface alone.
ExpressivePopupRoute<T>
A modal popup route driven by a spring, never a duration : the push runs the route's controller to 1 on spring and the pop runs it back to 0, each from wherever it is β€” except a pop an overlay held open in the popup takes (ExpressiveBackHandle), which leaves it up. Menus, popovers and dialogs are raised in it on the root navigator, wrapped in the capturedThemes of the context that raised them.
ExpressivePredictiveBackTransition
A page's own push and pop on Android, and its frame while the system's predictive back gesture runs: one widget tree either way, so the page keeps its state when a gesture starts. ExpressivePage's route pushes by fade-forwards; with rise the page rises from the bottom edge instead (the full-screen dialog, whose route drives animation on its springs). The route claims and settles the gesture.
ExpressivePressable
The one pressable of Expressive (see the library doc): a surface on a spring-morphing shape, filled with color, casting elevation, its content in contentColor, with state layers, the ripple, focus, keyboard activation, semantics and the minimum touch target.
ExpressivePressShapes
A pressable's shapes (Compose's ButtonShapes, plus a toggle's checkedShape): at rest, while pressed, and while selected. Pressed wins over selected, selected over rest.
ExpressivePreview
One page previewed alone, in the platform's register (Android, the lab's default, or iOS) and the brightness asked for.
ExpressiveProgressableFeature
A feature and the outline progress it stands at.
ExpressivePullToRefreshState
The state of an ExpressiveRefreshIndicator: show refreshes as if pulled.
ExpressiveRadio
A Material 3 radio button (Compose RadioButton): a 20dp ring whose 12dp dot grows on the fast spatial spring when selected, its colour on the default effects spring.
ExpressiveRadioGroup<T>
A Material 3 radio group: its options as ExpressiveRadioRows, one of them value, each row the whole touch target (Compose's Modifier.selectableGroup() over Modifier.selectable rows, the pattern Material's guidance gives).
ExpressiveRadioOption<T>
One option of an ExpressiveRadioGroup.
ExpressiveRadioRow
A radio button with its label, the whole row the touch target: one row of an ExpressiveRadioGroup.
ExpressiveRangeSlider
Two values on one track (Compose's RangeSlider): start and end, each with its own handle; the active track runs between them. A press takes the nearer handle; a handle never passes the other.
ExpressiveRating
Stars out of max: Material Symbols' star, filled (FILL 1, primary) up to value, a star_half at a half, outlined (FILL 0, onSurfaceVariant) after. The fill springs when value changes.
ExpressiveReach
Lays its child out start and end wider than itself, reaching past its own edges by them (mirrored right to left), and takes hits there: a flush row's highlight and touch area run into the column's margin while its words and control stay on the column's edges; a stepper's 48dp targets past its end circles, the circles on the row's keyline.
ExpressiveRefreshIndicator
Pull-to-refresh with the Expressive loading indicator (Compose PullToRefreshBox with PullToRefreshDefaults.LoadingIndicator).
ExpressiveReorderableListView
A list whose items reorder by drag (Compose's reorderable list item colours: the dragged item lifts to level 4 in tertiaryContainer with 16dp corners β€” ReorderListTokens): each item from itemBuilder must carry a key, and usually an ExpressiveReorderHandle as its trailing content. onReorder is told the item's old index and its new one. Segmented like ExpressiveListSection unless segmented is false. It lays out at its content's height inside a scrolling page.
ExpressiveReorderHandle
The drag handle of an item in an ExpressiveReorderableListView: the drag_indicator glyph; a drag starting on it moves item index.
ExpressiveResizable
first and second beside each other (or stacked, axis vertical) across a 24dp gutter, the drag handle of Material's adaptive panes in it (Compose's VerticalDragHandle): a 4 x 48dp pill of outline, onSurface under a pointer or the keyboard, which springs to 12 x 52dp while dragged and wears the focus ring under the keyboard. The handle is ui_core's: drag it, or focus it and press the arrows (Enter folds the first pane away and back); a screen reader hears it as an adjustable "Resize" (ExpressiveLocalizations.resize) at its percentage.
ExpressiveRichTooltip
Compose's RichTooltip: an optional title (titleSmall, its first baseline 28dp down), the text (bodyMedium), and an optional action on surfaceContainer at elevation 2, on the medium corner, 16dp either side, 320dp wide at most.
ExpressiveRobotoFlexMetrics
Roboto Flex's vertical metrics, in em (multiply by the font size).
ExpressiveRoundedPolygon
The RoundedPolygon class allows simple construction of polygonal shapes with optional rounding at the vertices. Polygons can be constructed with either the number of vertices desired or an ordered list of vertices.
ExpressiveScaffold
Root of every page: its background, the bar its route derives, a scrolling body by default, and the bottom edge's chrome.
ExpressiveScrollArea
child, a scroll view on controller, with Material's scrollbar on its end edge (or its bottom, axis horizontal): a pill thumb of onSurface (10% light, 30% dark; 50% and 65% under a pointer; 60% and 75% while dragged), 8dp wide, 12dp over a faint track while a pointer is on the bar, fading out after the scroll stops. Under the keyboard the area takes focus (its own tab stop) and wears the focus ring inside its edge; the arrows scroll by a step, Page Up and Down by a page, Home and End to the ends (ui_core's DesignScrollArea).
ExpressiveScrollField
Compose's ScrollField: a vertically paged wheel of itemCount numbers that wraps around, a third of ScrollFieldBehavior.height a number, the centred one selected β€” drawn larger and in onSurface as it springs in, the others in outline β€” on the lowest container with the large corner. A fling snaps to a number, a tap on one springs it to the centre, the arrow keys step it. A pointer, a drag or the keyboard's focus lays the onSurface state layer on the container, and the keyboard's focus rings it. onChanged reports the selected index.
ExpressiveSearchBar
The search bar (Compose's SearchBar with its InputField): a 56dp pill on surfaceContainerHigh β€” the search glyph (or leading), the query or placeholder, trailing icons and an avatar β€” that opens the full-screen search view when tapped. The view (Compose's ExpandedFullScreenSearchBar, or with contained its ExpandedFullScreenContainedSearchBar) grows out of the bar: the field with a back arrow and a clear control, the filters chips under it, and results for the live query. The back arrow and the system back (predictive on Android) collapse it.
ExpressiveSearchBarState
The state of an ExpressiveSearchBar: opens and closes its view.
ExpressiveSearchField
The search input field (Compose's SearchBarDefaults.InputField): a 56dp pill on surfaceContainerHigh that edits the query β€” a leading search glyph (leading), placeholder, a clear control (clearable, "Clear search": empties the query and keeps focus), trailing icons β€” and, with onCancel, a leading back arrow ("Cancel search": empties the query, lets go of focus and tells onCancel). It is the search view's field; on its own it is an inline search (a toolbar's, a list's).
ExpressiveSectionHeader
A section's title (a list subheader): titleSmall in primary, set in line with the items' text (the list's 16dp leading space), announced as a heading, with an optional trailing action at the end.
ExpressiveSegmentedButton<T>
The segmented button (Compose's SingleChoiceSegmentedButtonRow): Material 3 Expressive's connected button group, which replaces segmented buttons β€” two to five toggle buttons joined 2dp apart, the outer corners full and the inner ones small; a press tightens the inner corners and widens the segment, and a selected segment rounds out fully. It picks one: value is the chosen segment's, and each segment is a radio button to assistive technology. ExpressiveMultiChoiceSegmentedButton picks several.
ExpressiveSelect<T>
An exposed dropdown menu (Compose's ExposedDropdownMenuBox around a read-only field): shows the chosen option's label, opens a menu of options below itself on a tap, Enter or Space, and reports the choice through onChanged. Disabled when onChanged is null or enabled is false.
ExpressiveSelectOption<T>
One choice of an ExpressiveSelect or an ExpressiveCombobox: the value the app keeps and the label the field and the menu show.
ExpressiveSelectTrailingIcon
ExposedDropdownMenuDefaults.TrailingIcon: arrow_drop_down, pointing up while expanded. Size and colour come from the field's icon slot.
ExpressiveSemanticsGroup
Compose's semantics(mergeDescendants = true): one node, child's semantics merged into it, except a node inside that takes input (an enabled pressable), which keeps a node of its own there β€” Compose's merge stops at a descendant that merges its own semantics. Every pressable is one; so is a static list item.
ExpressiveShadowLight
The light a shadow is cast from, in the painting canvas's coordinates (logical pixels): HWUI's point light over the top centre of the window.
ExpressiveShapeCubic
This class holds the anchor and control point data for a single cubic BΓ©zier curve, with anchor points (anchor0X, anchor0Y) and (anchor1X, anchor1Y) at either end and control points (control0X, control0Y) and (control1X, control1Y) determining the slope of the curve between the anchor points.
ExpressiveShapes
The shape scale of one theme: Compose's Shapes plus none and full.
ExpressiveSheet
Material's modal side sheet: the panel on surfaceContainerLow at level 1, the large corner on its inner edge, its headline in titleLarge onSurfaceVariant beside a close button, child under it and actions in a row under a divider at its foot. Open it with ExpressiveSheet.show: it slides in from the end edge (or the start) over the scrim at 32%, closes on the scrim, Escape, its close button or a fling toward its edge, and holds the keyboard inside while open (ui_core's DesignSideSheetRoute).
ExpressiveSheetController
Drives an ExpressiveBottomSheet (Compose's SheetState): where it rests, where it is going, and the springs that take it there. One controller serves one sheet at a time.
ExpressiveSheetDragHandle
BottomSheetDefaults.DragHandle: the 32Γ—4dp bar (SheetBottomTokens.DockedDragHandle*, on-surface-variant, the extra-large shape) with 22dp above and below it. A sheet makes it tappable.
ExpressiveSheetPage<T>
The go_router Page for a route raised as a sheet: a modal bottom sheet, or with drawer a full-screen dialog. The route names the root navigator (parentNavigatorKey), so the sheet stands above the shell and the bar under it does not move. The page publishes RoutePresentation.sheet, so the screen inside derives its dismiss affordance; the sheet draws only its container, handle, scrim and anchors.
ExpressiveShellAction
The shell's action: the design kit's ShellAction (icon, onPressed, label, accent, key) plus menu. As a spec it goes to ExpressiveShell(action:); as a widget β€” ExpressiveShellAction(action: spec), what the shell draws β€” it draws any spec by its type:
ExpressiveShellInsets
The bottom allowance the shell asks each branch root to reserve : the bar (64dp) + the system's bottom inset + the floating action button's clearance + the docked accessory. The shell publishes it through the design kit's ShellInsets; a screen reads it with of.
ExpressiveShellScaffold
The scaffold that owns an app's navigation: body (the branches), and one labelled item per tabs entry, in branch order, with the action and the accessory.
ExpressiveShrinkTapTargets
Shrinks the touch targets of everything below it to their drawn size (Compose's LocalMinimumInteractiveComponentSize provides 0.dp): for a dense layout that keeps its own spacing.
ExpressiveSkeleton
A skeleton: the tonal shape of content still loading β€” a block, a circle (an avatar) or lines of text β€” in the secondary container (the look's tonal ground, not a grey), on Material's shape scale (a block on the large corner, a line fully rounded), pulsing gently on the slow effects spring until the content arrives (still under Reduce Motion). Screen readers skip it; announce the wait with the page's loading state or a label.
ExpressiveSlider
A slider: one value on a thick track, the handle a slim pill that narrows while held, stops at the open ends (Compose's Slider).
ExpressiveSnackBar
The snackbar itself (Compose's Snackbar, Material's SnackBar): message on the inverse surface, with an optional action and close button. showExpressiveSnackBar raises one; place it yourself only to show one inline (a gallery, a custom host).
ExpressiveSnackBarTransition
How a toast enters and leaves (Compose's FadeInFadeOutWithScale item): opacity on SnackbarHostBehavior.opacityMotion and scale about the centre on scaleMotion, from and to hiddenScale. child enters when first built visible and leaves when visible turns false, then onExited runs. showExpressiveSnackBar's host wraps every toast in one; use it directly only for a toast in a custom host.
ExpressiveSpacing
The 8dp spacing scale, in logical pixels (dp).
ExpressiveSparkline
A trend at a glance, inline: a primary line on an axis scaled to its data, with no labels, gridlines or baseline. Its row says what it is (a screen reader hears the row, not the line). An ExpressiveChart.line with ExpressiveChartLabels.none.
ExpressiveSplashScreen
The splash: an overlay above the app (child, the router) that shows mark on its ground while restoring, then hands off into the first screen's ExpressiveSplashScreenAnchor and unmounts.
ExpressiveSplashScreenAnchor
Where the splash lands on the first screen: child's box, in shape (a library shape) or else the corner step corner, filled with color (the widget's own container colour: primaryContainer for a FAB, primary for a filled button). The mark morphs into it, then child fades in over it. Wrap one widget of the page the app opens on: a FAB (the shell's action anchors itself: ExpressiveShellAction(splashAnchor: true)), a button (full), a search bar, a tile. Outside an ExpressiveSplashScreen, or once it is gone, it is only child.
ExpressiveSplashScreenMark
The app's mark on its splash ground: a library shape (the shape constructor) or an app's own mark (ExpressiveSplashScreenMark.custom), with an optional wordmark under it in headlineMedium.
ExpressiveSplashScreenSource
The piece of a mark that hands off: its box, in shape (a library shape) or else the corner step corner, filled with color, morphs into the first screen's anchor. A shape mark is its own source; a custom mark wraps the piece that should become the anchor (Steady's big block, Margin's front card) and the rest of it fades with the ground.
ExpressiveSplitButton
A split button: a labelled leading action and a trailing chevron that opens menu under the pair (Compose's SplitButtonLayout with a LeadingButton and a checkable TrailingButton, as its samples compose them).
ExpressiveSplitButtonLayout
SplitButtonLayout: trailing at its own width, leading in what is left, both as tall as the taller, spacing apart (the size's between-space when null). The pair keeps Compose's 48dp touch target; its halves draw at their own size.
ExpressiveSplitLeadingButton
A split button's leading half (SplitButtonDefaults.LeadingButton and its styles): child in a row, the size's leading padding around it, the end corners tightening on press.
ExpressiveSplitTrailingButton
A split button's trailing half (SplitButtonDefaults.TrailingButton and its styles): child centred optically between the size's trailing padding, the start corners tightening on press. With checked set it is a toggle: checked, it becomes a circle under a veil of its content colour at the pressed opacity.
ExpressiveSpringColor
A colour that springs to each new value (an effects key, usually).
ExpressiveSpringShape
A shape that springs to each new value through ShapeBorder.lerp (a spatial key, usually: a press or selection morph). A shape morph between library polygons is shape.dart's; this one reshapes corners.
ExpressiveSpringSize
A size that springs to each new value (a spatial key, usually).
ExpressiveSpringTween<T>
A value of any lerpable type that springs to each new value on the spring motion names: the spring runs the progress from the value shown when value changed to the new one, through lerp (so an underdamped spring carries the lerp past the target before it settles exactly on it). A retarget starts the new leg from where the value is, at rest.
ExpressiveSpringValue
A number that springs to each new value on the spring motion names, in the value's own units: a retarget mid-flight keeps its momentum, and an underdamped spring overshoots value before it settles exactly on it.
ExpressiveStandardMotion
Pins everything below it to the Standard scheme: an Expressive app's dense data, a settings list, a table. The swap goes one way: nothing pins Expressive, so a Standard app never bounces. It follows its subtree into overlays and routes that capture themes.
ExpressiveStat
A number and what it counts: label (labelLarge, onSurfaceVariant, with an optional leading icon) over value in the size's style (ExpressiveCounter: a change counts to the new value on a spring), then an optional supporting line coloured and marked by trend.
ExpressiveStateElevation
A surface's elevation by interaction state (Compose's ButtonElevation, FloatingActionButtonElevation, CardElevation): the level at rest and, where a component's tokens name one, while pressed, focused, hovered, dragged or disabled. Precedence: disabled, then pressed, dragged, focused, hovered, rest.
ExpressiveStateFace
child on shape filled with color and states' state layer of contentColor, ringed under keyboard focus.
ExpressiveStateLayers
Compose's StateTokens as a theme applies them: context.expressiveTheme.states.
ExpressiveStatusColors
Success and warning colours harmonized to the theme's seed.
ExpressiveStatusView
One view for the three states a page passes through, centred where its content stands and announced as it appears: ExpressiveStatusView.loading (the contained loading indicator over what is loading, as ExpressiveLoadingState), ExpressiveStatusView.error (an error glyph, what failed and why, and a tonal retry, as ExpressiveErrorState) and ExpressiveStatusView.success (a check on a round primaryContainer ground, what is done and a tonal next step, as ExpressiveSuccessState).
ExpressiveStepProgress
A step indicator: where a flow is among count steps. Material 3 has none; it is built from the progress tokens β€” the active and track colours, the track's thickness, shape and gap.
ExpressiveStyledContent
Applies a pressable's stateful content slots and reserves its outline inset.
ExpressiveStyleScope
The stateful styling a pressable passes to its content.
ExpressiveSuccessState
The page's success state: a check on a round primary ground, what is done, what follows from it and a tonal next step β€” centred and announced; the render state a task ends on (a booking made, a payment sent). The ground is primaryContainer, the theme's own: Expressive keeps no success colour.
ExpressiveSurface
Compose's Surface: child on a shape filled with color (tinted by tonal elevation when it is the surface role), casting a shadow at shadowElevation, outlined by side, clipping its content to the shape. Content inherits contentColor (Compose's LocalContentColor) as its text and icon colour.
ExpressiveSwipeAction
An action a swipe reveals beside a row (ExpressiveSwipeActions).
ExpressiveSwipeActions
A row that reveals actions by a horizontal swipe (Material's reveal list, RevealListTokens): trailing actions show when the row swipes from its end edge, leading ones from its start edge (either side follows the reading direction). The row rests open with its actions shown; tapping one runs it and closes the row. With allowsFullSwipe, a swipe across the whole row runs the outermost action (each list's first) once. Every action is also a screen-reader action on the row.
ExpressiveSwipeToDismiss
A row that dismisses by a horizontal swipe (Compose's SwipeToDismissBox): the content follows the finger over its background, and a swipe past 56dp or faster than 125dp/s settles off the edge and reports onDismissed once; slower and shorter springs back. The list removes the item on onDismissed.
ExpressiveSwitch
A Material 3 switch (Compose Switch): a 52 Γ— 32dp track whose thumb grows from 16dp to 24dp when checked (or when it carries an icon) and to 28dp while pressed β€” at once, as Compose snaps it β€” then moves and resizes at the fast spatial spring's stiffness (SwitchBehavior.thumbMotion), critically damped: it settles once, with no overshoot past its end and no wobble.
ExpressiveSwitchRow
A switch with its label before it, the whole row the touch target (the settings-row pattern: label at the start, switch at the end).
ExpressiveSymbols
The Material Symbols Rounded glyphs Expressive bundles, one constant per Symbols name (arrow_back β†’ arrowBack). The FILL axis draws the filled form (Icon.fill); ExpressiveIcon animates it. A glyph with a direction mirrors in right-to-left text (matchTextDirection).
ExpressiveSymbolsFont
The bundled Material Symbols Rounded font and its FILL axis.
ExpressiveSystemBarColor
The ink an ExpressiveTheme sets, annotated over the scope's bounds: what an ExpressivePreview's system bars wear over a scope whose page asks for no overlay style, as the real bars adapt to what is under them β€” a page in a show's scheme gets the scheme's ink, not the app theme's.
ExpressiveTab
One tab: a label, an icon, or both (the icon over the label).
ExpressiveTabBar
In-page tabs (Compose PrimaryTabRow, SecondaryTabRow, PrimaryScrollableTabRow, SecondaryScrollableTabRow): tabs on a surface band over a hairline divider, the selectedIndex tab in the selected colour over its indicator, which slides and resizes to a new selection on a spatial spring. Fixed tabs share the width on a phone; in a window ExpressiveSelect.wideFrom or wider they keep to their labels (90dp at least) from the start edge, as Material's TabAlignment.start lays them out (sharing the width only when their labels need it all). scrollable tabs are as wide as their labels (90dp at least), start 52dp in and scroll the selected tab to the middle.
ExpressiveTable
Records with the same fields, in rows under their columns' heads, from the list's tokens: each row at least a one-line list item tall, a divider between rows, figures at the column's end in tabular numerals. A row with onPressed takes the list item's press; a selected one wears the list's selected container. Under stackBelow wide, or where a column is too narrow for its longest word, each row is a list item instead, its other cells named lines under its first.
ExpressiveTableColumn
A column of an ExpressiveTable.
ExpressiveTableRow
A row of an ExpressiveTable: its cells in column order, each a String or a Widget. The first cell is what the row is called.
ExpressiveTag
A short label on a thing β€” New, Fixed, a kind β€” that does nothing when pressed: a chip's height, corners and type in a tonal container, no outline and no press. Material has no tag; an assist chip that took no action would read as one that is broken, so the tag is its own part. Long words stay on one line with an ellipsis; their full label is spoken.
ExpressiveText
Text in one of Material's 30 type styles: role at size, emphasized or not, in color (the ambient content colour when null, as Compose's Text takes LocalContentColor). Display, headline and title text is announced as a heading.
ExpressiveTextArea
A multi-line text field that grows with its content (Compose's TextField and OutlinedTextField with singleLine = false): the same containers, colours and label motion as ExpressiveTextField, its label and input aligned to the top.
ExpressiveTextButton
Material's text button (TextButton): the lowest emphasis, a label in primary on no container, at its size's padding.
ExpressiveTextField
A single-line text field (Compose's TextField and OutlinedTextField; SecureTextField and OutlinedSecureTextField when secure).
ExpressiveTextTheme
The type scale of one theme: the 30 styles by ExpressiveTypeKey (of) and by name.
ExpressiveTheme
Mounts an ExpressiveThemeData for everything below it, as Material's Theme does: the one root widget an app needs, in its builder:, under MaterialApp, CupertinoApp or WidgetsApp alike (the last two with Material's localizations: a field is Flutter's Material TextField underneath). A nested one restyles a subtree. It follows the app into overlays and routes that capture themes (its mount is an InheritedTheme).
ExpressiveThemeData
One Expressive theme in one brightness: what every component reads through context.expressiveTheme, as Material's components read ThemeData.
ExpressiveThemeSpec
A theme’s seed, scheme variant, contrast, motion and colour roles.
ExpressiveTimeInput
Compose's TimeInput: the hour and minute as two fields β€” the one being edited a text field taking two digits, the other a selector β€” with the colon between them and the AM/PM toggle after them on the 12-hour clock. An out-of-range value shows the field in the error colours with what went wrong under it; two valid hour digits move on to the minutes.
ExpressiveTimeline
What happened, in order: each entry a marker on a hairline that joins it to the next, its title and time, and what more there is to say.
ExpressiveTimelineEntry
One thing that happened, on an ExpressiveTimeline.
ExpressiveTimePicker
Compose's TimePicker: the hour and minute selectors and (on the 12-hour clock) the AM/PM toggle, above the clock dial β€” or beside it in ExpressiveTimePickerLayout.horizontal. A tap on a selector picks what the dial edits; a tap or drag on the dial sets it, the selector springing to the value, and a chosen hour moves on to the minutes.
ExpressiveTimePickerController
Compose's TimePickerState: the time (hour 0–23, minute 0–59), the clock it is shown on and which value is being edited. Every time picker, time input and time scroll edits one; share it to switch between them (a dialog's mode toggle does). Listen to it for changes.
ExpressiveTimePickerDialog
Compose's TimePickerDialog (and, vibrant, VibrantTimePickerDialog): child (a time picker, time input or time scroll) on the dialog's container, the title above it (not on the vibrant dialog), and the action row under it β€” the modeToggle at its start, then dismiss and confirm at its end, 8dp apart. The dialog is as wide as its content plus 24dp either side (12dp, vibrant).
ExpressiveTimePickerModeToggle
TimePickerDialogDefaults.DisplayModeToggle: the icon button in a time picker dialog's action row that switches between the dial (or, with scroll, the scroll fields) and typing.
ExpressiveTimeScroll
Compose's TimeScroll: the hour and minute as two ExpressiveScrollFields (100 Γ— 120dp) with the colon between them and the vibrant AM/PM toggle after them on the 12-hour clock.
ExpressiveToggleButton
A toggle button (Compose ToggleButton and its elevated, tonal and outlined forms): a button that is on or off. Checked, it takes the checked colours and its shape morphs β€” round to the size's square, square to round β€” on ToggleButtonBehavior.shapeMotion.
ExpressiveToggleButtonColors
A toggle button's colours in place of its style's (Compose's ToggleButtonDefaults.toggleButtonColors(...)): each one left null keeps the style's. Disabled colours are always the style's.
ExpressiveToggleGroup<T>
A row of toggles that is one control (shadcn's ToggleGroup, drawn as Compose's connected ButtonGroup of toggle buttons): segments 2dp apart, the outer corners full and the inner ones small, a pressed segment's inner corners tighter and a selected one rounded out fully on the toggle's spring, in the toggle button's colours. Keyboard and semantics are ui_core's DesignToggleGroup: Tab reaches the group once, at its chosen segment, the arrow keys move along it (mirrored right to left), Home and End go to its ends, Space and Enter press; one choice is a radio group to a screen reader. Each segment draws the state layer in its own shape and, under keyboard focus, the focus ring round it.
ExpressiveToolbarFab
The FAB beside a floating toolbar (Compose's FloatingToolbarDefaults.StandardFloatingActionButton and VibrantFloatingActionButton): the FAB's shape and 24dp icon in kind's FAB colours, filling the square the toolbar gives it (56dp expanded, 80dp collapsed), at elevation level 2 (3 while hovered).
ExpressiveToolbarScrollBehavior
Moves a toolbar off the screen while its content scrolls on and back as it scrolls back (Compose's FloatingToolbarDefaults .exitAlwaysScrollBehavior; for an ExpressiveDockedToolbar, BottomAppBarDefaults.exitAlwaysScrollBehavior, which collapses the bar's height). When the scroll stops part way, the toolbar snaps to shown or hidden, whichever is nearer, on its spring.
ExpressiveToolbarScrollExpansion
Collapses and expands a floating toolbar as its content scrolls (Compose's Modifier.floatingToolbarVerticalNestedScroll): once the content advances collapseThreshold (40dp) the toolbar collapses; once it scrolls back expandThreshold it expands.
ExpressiveTooltip
Compose's TooltipBox: child, and a tooltip that a long press or a hovering mouse shows above it (below when there is no room above).
ExpressiveTooltipCaret
Where a tooltip's caret sits: on its top or bottom edge, x from its left edge (or, made with ExpressiveTooltipCaret.start, from its start edge), pointing at the anchor.
ExpressiveTooltipController
Shows and hides an ExpressiveTooltip from the app (Compose's TooltipState.show() / .dismiss()).
ExpressiveVerticalSlider
A vertical slider (Compose's VerticalSlider): the same slider stood on end, in a box of bounded height. By default min is at the top, as in Compose; set topToBottom false for a level, a volume or a brightness, whose minimum sits at the bottom.
ExpressiveWholeWords
child, a label, laid out as given while its longest word fits the width; when that word is wider (large text in a narrow slot), the whole label prints smaller, just enough for the word to fit, rather than breaking the word across lines. Its other words still wrap between them.
ExpressiveWholeWordsGroup
The labels of a row of equal slots (a fixed tab row's tabs, a bar's or a rail's items): one long word shrinks every label by the same scale, so the row's words stay one size.
ExpressiveWidthProbe
Records whether the button was given a tight width, for the content inside the pressable's surface: the surface's Stack loosens its constraints, and Compose's content Row fills the container and centres (horizontalArrangement = Center) whatever width the parent fixes.
ExtendedFabLargeTokens
Compose's ExtendedFabLargeTokens.
ExtendedFabMediumTokens
Compose's ExtendedFabMediumTokens.
ExtendedFabPrimaryTokens
Compose's ExtendedFabPrimaryTokens.
ExtendedFabSmallTokens
Compose's ExtendedFabSmallTokens.
FabBaselineTokens
Compose's FabBaselineTokens.
FabLargeTokens
Compose's FabLargeTokens.
FabMediumTokens
Compose's FabMediumTokens.
FabMenuBaselineTokens
Compose's FabMenuBaselineTokens.
FabPrimaryContainerTokens
Compose's FabPrimaryContainerTokens.
FabSecondaryContainerTokens
Compose's FabSecondaryContainerTokens.
FabSmallTokens
Compose's FabSmallTokens.
FilledAutocompleteTokens
Compose's FilledAutocompleteTokens.
FilledButtonTokens
Compose's FilledButtonTokens.
FilledCardTokens
Compose's FilledCardTokens.
FilledIconButtonTokens
Compose's FilledIconButtonTokens.
FilledTextFieldTokens
Compose's FilledTextFieldTokens.
FilledTonalButtonTokens
Compose's FilledTonalButtonTokens.
FilledTonalIconButtonTokens
Compose's FilledTonalIconButtonTokens.
FilterChipTokens
Compose's FilterChipTokens.
FloatingActionButtonBehavior
What Compose's FloatingActionButton sets in code (behavior.yaml, verified at the pin).
FloatingActionButtonMenuBehavior
What Compose's FloatingActionButtonMenu sets in code (behavior.yaml, verified at the pin).
FloatingToolbarBehavior
What Compose's FloatingToolbar sets in code (behavior.yaml, verified at the pin).
FloatingToolbarTokens
Compose's FloatingToolbarTokens.
GestureFocus
Holds the focus through the user gestures on a route: once they are over, the navigator's current route has it back (the route itself when it stays, the one under it when it went), on the child that held it there (its scope remembers which).
HostBehavior
What Compose's Host sets in code (behavior.yaml, verified at the pin).
IconButtonBehavior
What Compose's IconButton sets in code (behavior.yaml, verified at the pin).
InputChipBehavior
What Compose's InputChip sets in code (behavior.yaml, verified at the pin).
InputChipTokens
Compose's InputChipTokens.
LanguageHeightTokens
The language-height categories' data (emit/type.ts states the reasons).
LargeIconButtonTokens
Compose's LargeIconButtonTokens.
LinearProgressIndicatorTokens
Compose's LinearProgressIndicatorTokens.
ListItemBehavior
What Compose's ListItem sets in code (behavior.yaml, verified at the pin).
ListTokens
Compose's ListTokens.
LoadingIndicatorBehavior
What Compose's LoadingIndicator sets in code (behavior.yaml, verified at the pin).
LoadingIndicatorTokens
Compose's LoadingIndicatorTokens.
MediaSlot
Where a slot's picture comes from.
MediaSlotImage
Trusted image delivery for one declared media slot, shared by a system's photo and avatar components. fallback stands in while the picture is pending and whenever it misses, so a pending image never delays layout, first paint or publication.
MediumIconButtonTokens
Compose's MediumIconButtonTokens.
What Compose's Menu sets in code (behavior.yaml, verified at the pin).
Compose's MenuTokens.
ModalBottomSheetBehavior
What Compose's ModalBottomSheet sets in code (behavior.yaml, verified at the pin).
Compose's NavigationBarHorizontalItemTokens.
Compose's NavigationBarTokens.
Compose's NavigationBarVerticalItemTokens.
Compose's NavigationDrawerTokens.
What Compose's NavigationItem sets in code (behavior.yaml, verified at the pin).
Compose's NavigationRailBaselineItemTokens.
Compose's NavigationRailCollapsedTokens.
Compose's NavigationRailColorTokens.
Compose's NavigationRailExpandedTokens.
Compose's NavigationRailHorizontalItemTokens.
Compose's NavigationRailVerticalItemTokens.
One tab of the shell's navigation: a branch's root, with the glyph and the words it wears. The runtime emits one per StatefulShellBranch, in branch order; the system decides how it looks.
OutlinedAutocompleteTokens
Compose's OutlinedAutocompleteTokens.
OutlinedButtonTokens
Compose's OutlinedButtonTokens.
OutlinedCardTokens
Compose's OutlinedCardTokens.
OutlinedIconButtonTokens
Compose's OutlinedIconButtonTokens.
OutlinedSegmentedButtonTokens
Compose's OutlinedSegmentedButtonTokens.
OutlinedTextFieldTokens
Compose's OutlinedTextFieldTokens.
Owned<T extends ChangeNotifier>
Makes a T with create when first built, hands it to builder on every build, and disposes it when the subtree goes.
PlainTooltipTokens
Compose's PlainTooltipTokens.
PreviewDevice
The device a platform previews on: its logical size and pixel density. The oracle captures and the gallery's renders use the same numbers.
PreviewFrame
The frame a preview stands in: publishes its platform and brightness to everything inside it, scopes the platform override there, and publishes its box as the screen.
PreviewFrameData
What a PreviewFrame publishes to everything inside it.
PreviewStage
A stage that raises a previewed page on a route over itself once it is on screen, and keeps it raised: how a pushed or sheet page is previewed alone, so its exit renders as it does live and the chrome it derives is the real one (RoutePresentation.pushed or the sheet's).
PrimaryNavigationTabTokens
Compose's PrimaryNavigationTabTokens.
ProgressEasingBehavior
What Compose's ProgressEasing sets in code (behavior.yaml, verified at the pin).
ProgressIndicatorBehavior
What Compose's ProgressIndicator sets in code (behavior.yaml, verified at the pin).
ProgressIndicatorTokens
Compose's ProgressIndicatorTokens.
PullToRefreshBehavior
What Compose's PullToRefresh sets in code (behavior.yaml, verified at the pin).
RadioButtonBehavior
What Compose's RadioButton sets in code (behavior.yaml, verified at the pin).
RadioButtonTokens
Compose's RadioButtonTokens.
RenderDesignCapCenter
The render object of DesignCapCenter: keeps its child's size and paints it moved up or down so that its one-line label's capitals sit on the box's middle.
RenderDesignTapTarget
DesignTapTarget's render object: its child laid out as given, itself at least minSize, the child placed by alignment, a hit anywhere in it sent to the child's centre.
ReorderListTokens
Compose's ReorderListTokens.
RevealListTokens
Compose's RevealListTokens.
RichTooltipTokens
Compose's RichTooltipTokens.
RoutePresentationScope
Publishes the RoutePresentation of the route it stands in, overriding what the route's position implies. A system's sheet page wraps its child in one with RoutePresentation.sheet; a preview or a hand-built navigator may publish any presentation.
ScaffoldBehavior
What Compose's Scaffold sets in code (behavior.yaml, verified at the pin).
ScrimTokens
Compose's ScrimTokens.
ScrollFieldBehavior
What Compose's ScrollField sets in code (behavior.yaml, verified at the pin).
SearchBarBehavior
What Compose's SearchBar sets in code (behavior.yaml, verified at the pin).
SearchBarTokens
Compose's SearchBarTokens.
SearchViewTokens
Compose's SearchViewTokens.
SecondaryNavigationTabTokens
Compose's SecondaryNavigationTabTokens.
SegmentedMenuTokens
Compose's SegmentedMenuTokens.
ShapeTokens
Compose's ShapeTokens.
SheetBottomTokens
Compose's SheetBottomTokens.
SheetDefaultsBehavior
What Compose's SheetDefaults sets in code (behavior.yaml, verified at the pin).
ShellAction
The app-level act beside the shell's tabs: the one thing reachable from every root β€” add, compose, capture β€” with the glyph it wears and what it does. A system draws it in its own way (a floating action button, a disc in the bar, a square at its end).
ShellInsets
The bottom inset the shell's bar asks every branch root to keep clear: published by a system's shell over its branch container (and by a preview that stands the bar under a lone page), spent by the system's screen on its scroll padding and by its toast on its inset.
ShortNavigationBarBehavior
What Compose's ShortNavigationBar sets in code (behavior.yaml, verified at the pin).
SliderBehavior
What Compose's Slider sets in code (behavior.yaml, verified at the pin).
SliderTokens
Compose's SliderTokens.
SmallIconButtonTokens
Compose's SmallIconButtonTokens.
SnackbarBehavior
What Compose's Snackbar sets in code (behavior.yaml, verified at the pin).
SnackbarHostBehavior
What Compose's SnackbarHost sets in code (behavior.yaml, verified at the pin).
SnackbarTokens
Compose's SnackbarTokens.
SpacingTokens
The 8dp spacing scale: each step's md token and its length, under Cody's member names (s8 = space100).
SplitButtonBehavior
What Compose's SplitButton sets in code (behavior.yaml, verified at the pin).
SplitButtonLargeTokens
Compose's SplitButtonLargeTokens.
SplitButtonMediumTokens
Compose's SplitButtonMediumTokens.
SplitButtonSmallTokens
Compose's SplitButtonSmallTokens.
SplitButtonXLargeTokens
Compose's SplitButtonXLargeTokens.
SplitButtonXSmallTokens
Compose's SplitButtonXSmallTokens.
SpringToken
A spring, as Compose's spring(dampingRatio, stiffness) takes it.
StandardIconButtonTokens
Compose's StandardIconButtonTokens.
StandardMenuTokens
Compose's StandardMenuTokens.
StandardMotionTokens
Compose's StandardMotionTokens.
StateTokens
Compose's StateTokens.
SuggestionChipTokens
Compose's SuggestionChipTokens.
SwipeToDismissBoxBehavior
What Compose's SwipeToDismissBox sets in code (behavior.yaml, verified at the pin).
SwitchBehavior
What Compose's Switch sets in code (behavior.yaml, verified at the pin).
SwitchTokens
Compose's SwitchTokens.
TabBehavior
What Compose's Tab sets in code (behavior.yaml, verified at the pin).
TabRowBehavior
What Compose's TabRow sets in code (behavior.yaml, verified at the pin).
TextButtonTokens
Compose's TextButtonTokens.
TextFieldBehavior
What Compose's TextField sets in code (behavior.yaml, verified at the pin).
TextStyleToken
A type style, as Compose's TextStyle takes it from the type scale.
TimeInputTokens
Compose's TimeInputTokens.
TimePickerBehavior
What Compose's TimePicker sets in code (behavior.yaml, verified at the pin).
TimePickerDialogBehavior
What Compose's TimePickerDialog sets in code (behavior.yaml, verified at the pin).
TimePickerTokens
Compose's TimePickerTokens.
ToggleButtonBehavior
What Compose's ToggleButton sets in code (behavior.yaml, verified at the pin).
TonalButtonTokens
Compose's TonalButtonTokens.
TooltipBehavior
What Compose's Tooltip sets in code (behavior.yaml, verified at the pin).
TypefaceTokens
Compose's TypefaceTokens.
TypeScaleTokens
Compose's TypeScaleTokens.
TypographyTokens
Compose's TypographyTokens.
VibrantMenuTokens
Compose's VibrantMenuTokens.
WavyProgressIndicatorBehavior
What Compose's WavyProgressIndicator sets in code (behavior.yaml, verified at the pin).
WideNavigationRailBehavior
What Compose's WideNavigationRail sets in code (behavior.yaml, verified at the pin).
XLargeIconButtonTokens
Compose's XLargeIconButtonTokens.
XSmallIconButtonTokens
Compose's XSmallIconButtonTokens.

Enums

ChromeGround
The ground a page stands on, which is what its chrome is drawn against: the system's own surface, or media β€” a full-bleed feed of video or photographs, over which the chrome is dark and solid.
DesignBranchBackBehavior
Where back goes from a branch at its root page.
DesignCalendarMode
How a calendar selects.
DesignChartXAxis
What a DesignChart's x values are.
DesignColorChannel
A channel a DesignColorSlider sets.
DesignDateSegmentType
The kinds of segment a date or a time field is typed in.
DesignInput
What reaches a look's controls: a finger, or a pointer (a mouse, a trackpad, a stylus that hovers).
DesignMenuLevel
Where a DesignMenuBar's builder paints: the bar, a menu or a submenu.
DesignNavigationMode
How a shell shows its destinations.
DesignOverlayAlign
How a surface lines up with its anchor along the side it sits on.
DesignOverlaySide
Which side of the anchor a surface sits on. start and end follow the text direction.
DesignOverlayTrigger
What opens an anchored surface.
DesignRefreshMode
Where a pull stands.
DesignScrollbarVisibility
When a DesignScrollArea's scrollbar shows.
DesignSelection
A page's selection, for its select-all checkbox.
DesignSheetEdge
Which edge a DesignSideSheetRoute comes from.
DesignSortDirection
Which way a column sorts.
DesignSplitPart
Which part of a split button a builder paints.
DesignToastClosedReason
Why a toast left.
DesignWindowSizeClass
Material's window size classes, by width in logical pixels.
ExpressiveAmountSize
How large an ExpressiveAmount stands.
ExpressiveAppBarSize
The top app bar's size (Compose's TopAppBar, MediumFlexibleTopAppBar, LargeFlexibleTopAppBar).
ExpressiveAvatarSize
The avatar's sizes. m is Material's (ListTokens.ItemLeadingAvatar*: 40dp, initials in titleMedium); the others take the sizes Material's own avatars wear elsewhere β€” the chip's 24, the app bar's 32 β€” and the icon button's containers (56, 96), each with that component's icon size.
ExpressiveButtonKind
Material's five common-button styles.
ExpressiveButtonShape
A button's shape family at rest.
ExpressiveButtonSize
Material's five button sizes, by container height. large and extraLarge are hero sizes.
ExpressiveCardVariant
A card's three styles (Compose's ElevatedCard, Card, OutlinedCard).
ExpressiveCarouselVariant
The carousel's layouts.
ExpressiveChartLabels
Which x-axis labels a chart shows.
ExpressiveChartType
A chart's kinds.
ExpressiveColorRole
A colour role (Compose's ColorSchemeKeyTokens): what a token names, resolved against the theme's colour scheme at theme time.
ExpressiveCorner
The steps of the corner scale, smallest first.
ExpressiveDatePickerMode
Which face a date picker shows (Compose's DisplayMode).
ExpressiveDividerInset
Where a divider sits between its edges.
ExpressiveDockedToolbarArrangement
How a docked toolbar spaces its actions (BottomAppBarDefaults .FlexibleHorizontalArrangement and .FlexibleFixedHorizontalArrangement).
ExpressiveElevationLevel
An elevation level (Compose's ElevationTokens) and its height.
ExpressiveExpression
The expression budget: how many hero moments an app may spend , at most one per page.
ExpressiveFabColor
A FAB's colour style: Material's three container styles and the three vibrant ones.
ExpressiveFabMenuColor
The FAB menu's colour family: the toggle morphs from the container colour to the vibrant one as it opens; the items wear the container colour (ToggleFloatingActionButtonDefaults.containerColor, FloatingActionButtonMenuItem).
ExpressiveFabSize
A FAB's size. The plain FAB is 56, 80 or 96dp square; the extended FAB is that tall (Compose's small, medium and large extended FABs).
ExpressiveIconButtonKind
Material's four icon-button styles.
ExpressiveIconButtonShape
An icon button's corners at rest.
ExpressiveIconButtonSize
Material's five icon-button sizes: the container height.
ExpressiveIconButtonWidth
How wide an icon button is beside its height (Compose's IconButtonWidthOption): the glyph plus the size's narrow, default or wide leading and trailing space.
ExpressiveIconSize
The icon sizes: the icon buttons' glyph sizes (*IconButtonTokens .IconSize), which are Material Symbols' optical sizes.
ExpressiveLabelPosition
Where a text field's label rests once minimized (Compose's TextFieldLabelPosition).
ExpressiveLanguageHeight
How tall a language's script runs: the category of a locale's language.
ExpressiveMaterialShape
The library shapes of Compose's MaterialShapes, in its declaration order. They mask imagery, never text containers (CONTRACT Β§3).
ExpressiveMediaTone
The container family a placeholder or an avatar wears: one of the scheme's three accent containers, with its on-container ink.
ExpressiveMenuPosition
Where a menu or popover opens against its anchor (Compose's MenuAnchorPosition): it takes the next of Compose's candidate positions when the preferred one leaves the window's margins.
ExpressiveMenuTrigger
How a menu or popover is opened from its ExpressiveMenu.child: a tap (an overflow button) or a long press (a context menu, also opened by a secondary click).
ExpressiveMessagePosition
Where a message sits in a run of messages from one sender: the corners it shares with its neighbours are tightened.
ExpressiveMessageSide
Who sent a message.
ExpressiveMessageStatus
What became of an outgoing message.
ExpressiveMotionKey
A spring of the motion scheme (Compose's MotionSchemeKeyTokens), resolved against the theme's scheme (expressive or standard) at theme time.
ExpressiveMotionScheme
The motion scheme a theme runs.
ExpressiveMotionSpeed
A spring's pace: Compose's fast, default and slow.
ExpressiveNavigationBarArrangement
How a bar spreads its destinations (Compose ShortNavigationBarArrangement).
ExpressiveNavigationMode
How the Android register's navigation bar is drawn: Android's two system navigation modes.
ExpressiveNavItemPosition
Where a navigation item's glyph stands against its label (Compose NavigationItemIconPosition).
ExpressivePressRole
What a pressable is to assistive technology.
ExpressiveRatingSize
A rating's sizes: the star glyph's size.
ExpressiveShapeKey
A shape on the corner scale (Compose's ShapeKeyTokens), resolved against the theme's shapes at theme time.
ExpressiveSheetValue
Where a bottom sheet rests (Compose's SheetValue).
ExpressiveSliderSize
The five track sizes of the Material 3 Expressive slider.
ExpressiveSnackBarDuration
How long a snackbar stays up (Compose's SnackbarDuration).
ExpressiveSplashScreenGround
What the splash stands on.
ExpressiveSplitButtonKind
The four split-button styles (SplitButtonDefaults.LeadingButton and its Tonal…, Outlined…, Elevated… forms).
ExpressiveSplitButtonSize
The five split-button sizes: the container height.
ExpressiveStatSize
A stat's sizes: the value's style.
ExpressiveStatus
Which state an ExpressiveStatusView shows.
ExpressiveStepProgressKind
How an ExpressiveStepProgress draws its steps.
ExpressiveSwipeDirection
Which way a swipe travels, in reading order.
ExpressiveTabBarVariant
Primary or secondary tabs (Compose PrimaryTabRow / SecondaryTabRow).
ExpressiveTextFieldKind
A text field's container: Compose's two text fields.
ExpressiveTextRole
The five families of Material's type scale.
ExpressiveTextSize
The three sizes of each family.
ExpressiveTimePickerLayout
How a time picker lays its fields and dial out (Compose's TimePickerLayoutType).
ExpressiveTimePickerMode
Which face a time picker dialog shows (Compose's TimePickerDisplayMode).
ExpressiveTimeSelection
Which value a time picker's dial and fields edit (Compose's TimePickerSelectionMode).
ExpressiveToggleButtonKind
The toggle buttons' styles (Compose has no text toggle button).
ExpressiveTone
The tones a banner or a tag is drawn in: the container roles it wears, its content in the matching on… role.
ExpressiveToolbarFabPosition
Which end of a floating toolbar its FAB sits at: the start or end of a horizontal toolbar (Compose's FloatingToolbarHorizontalFabPosition), the top or bottom of a vertical one (…VerticalFabPosition).
ExpressiveToolbarKind
A toolbar's colours (Compose's FloatingToolbarColors defaults).
ExpressiveTooltipPosition
Which side of its anchor a tooltip prefers (Compose's TooltipAnchorPosition.Above / .Below): it takes the other when the preferred one has no room.
ExpressiveTrend
Which way a stat moved.
ExpressiveTypeKey
A type style (Compose's TypographyKeyTokens), resolved against the theme's type scale at theme time.
FontFamilyToken
A typeface the tokens name: the platform's (Compose's FontFamily; sansSerif is Roboto on Android). Expressive sets every style in Roboto Flex (wave decision E7).
PreviewPlatform
The platform a preview is drawn for: its device size and the platform whose behaviour applies inside it. The look is the system's everywhere; behaviour (scroll physics, back gestures, text handling) follows this platform.
RoutePresentation
How a route is presented, which is what a screen derives its bar from: the title on a root, the back affordance on a pushed page, the dismiss affordance on a sheet. A page never authors its own back or close; it reads its presentation (of).

Mixins

ExpressiveBackHandleRoute<T>
A route whose open overlays take the back before its PopScopes: while an ExpressiveBackHandle holds the back on it, the pop is the overlay's, even when a PopScope in the route refuses the route's own (Flutter's ModalRoute asks the PopScopes first, so a page guarding unsaved work would keep an open menu open and ask to be left). The kit's routes mix it in; a route's own pops (Navigator.pop) are unchanged.
ExpressivePredictiveBackRoute<T>
A page route whose system back gesture is Android's predictive back : ExpressivePage's route and the full-screen dialog (ExpressiveSheetPage with drawer) share it. The route builds its page inside an ExpressivePredictiveBackTransition, which draws the gesture's frame; the route claims the gesture, follows it and settles it by spring.
ExpressiveValueStart<W extends StatefulWidget>
A choice's field's state (a select's, a combobox's): where its value starts from its start edge, read after each frame from the field keyed valueFace, for its list's words (ExpressiveMenu.wordsStart).

Extension Types

Dp
A length in density-independent pixels (Compose's .dp): a Flutter logical pixel.
Ms
A duration in milliseconds.
Percent
A share of a whole, 0 to 100 (a corner's share of its shape's shorter side: Compose's CornerSize(percent)).
Sp
A text length in scale-independent pixels (Compose's .sp): a logical pixel at text scale 1, scaled with the platform's text size.

Extensions

DesignSpringDrive on AnimationController
Runs an AnimationController on a spring instead of a duration.
ExpressiveContrast on ExpressiveColorScheme
The pairs a scheme is held to, read together.
ExpressiveMotionContext on BuildContext
context.expressiveMotion: ExpressiveMotion.of.
ExpressiveStyleLayers on ExpressiveComponentThemeData
A component theme under a part's own style.
ExpressiveThemeContext on BuildContext
context.expressiveTheme: the theme every Expressive component reads.
PreviewPlatformDevice on PreviewPlatform
The platform's device, as data on the enum.

Constants

designSpringTolerance β†’ const Tolerance
When a spring-driven controller counts as settled, in the controller's own units (a 0–1 progress, or dp for a position):
expressiveBakedThemes β†’ const Map<String, ExpressiveBakedTheme>
Every baked theme, by id, in module.yaml's preset order.
expressiveBaselineTheme β†’ const ExpressiveBakedTheme
The baseline theme, baked: its record and each foundation's part.
expressiveBloomTheme β†’ const ExpressiveBakedTheme
The bloom theme, baked: its record and each foundation's part.
expressiveCapHeightFactor β†’ const double
Roboto Flex's cap height over its em (its OS/2 sCapHeight over its head table's unitsPerEm): the look's label typeface.
expressiveComposeDefaultShapes β†’ const ExpressiveBakedShapes
Compose's default corner scale, ShapeDefaults: what every system theme bakes today, and what a theme an app bakes wears (ExpressiveThemeSpec, which carries no shapes).
expressiveCupertinoWords β†’ const LocalizationsDelegate<CupertinoLocalizations>
Cupertino's words for any locale: the app's language where cupertino_ui speaks it, English elsewhere.
expressiveDefaultThemeId β†’ const String
The theme a host wears when it is handed none: module.yaml's first preset, the gallery default. A generated app names its own.
expressiveEmberTheme β†’ const ExpressiveBakedTheme
The ember theme, baked: its record and each foundation's part.
expressiveFontPackage β†’ const String?
The package that bundles Expressive's faces, or null when the app does. Every Expressive text style passes it as TextStyle.package, and every ExpressiveSymbols glyph as IconData.fontPackage.
expressiveGroveTheme β†’ const ExpressiveBakedTheme
The grove theme, baked: its record and each foundation's part.
expressiveInventory β†’ const DesignInventory
Every inventory row, each a live specimen of its Expressive<Stem>.
expressiveMaterialWords β†’ const LocalizationsDelegate<MaterialLocalizations>
Material's words for any locale: the app's language where material_ui speaks it, English elsewhere.
expressivePageTransitions β†’ const Map<TargetPlatform, PageTransitionsBuilder>
Material Expressive's push and pop for every platform, as a map of widgets-level PageTransitionsBuilders that fits the PageTransitionsTheme of both Materials, Flutter's and material_ui's:
expressiveSlateTheme β†’ const ExpressiveBakedTheme
The slate theme, baked: its record and each foundation's part.
expressiveTransparent β†’ const Color
No colour at all: Compose's Color.Transparent, the ground of a container that draws nothing of its own (a state layer's resting colour, a row with no fill).

Functions

designMatchScore(String text, String query) β†’ int?
How well query finds text: null not at all, higher better. A prefix beats a word's start, which beats a substring, which beats the letters in order.
designReduceMotionOf(BuildContext context) β†’ bool
Whether the reader asked for reduced motion at context: Android's Remove animations or the web's prefers-reduced-motion (MediaQuery.disableAnimationsOf), or iOS's Reduce Motion (dart:ui's AccessibilityFeatures.reduceMotion, which MediaQuery does not carry).
designShortcutKeys(BuildContext context, MenuSerializableShortcut shortcut, {TargetPlatform? platform, bool appleSymbols = true}) β†’ List<String>
The keys of shortcut (a SingleActivator or a CharacterActivator), one string a key, modifiers first, as Flutter's MenuItemButton labels them:
designShortcutLabel(BuildContext context, MenuSerializableShortcut shortcut, {TargetPlatform? platform, bool appleSymbols = true}) β†’ String
designShortcutKeys joined as a menu row shows them: "βŒƒ ⇧ N" with Apple's symbols (Flutter's spacing), "Shift+Command+N" in words on macOS and iOS, "Ctrl+Shift+N" elsewhere.
designSpring({required double dampingRatio, required double stiffness}) β†’ SpringDescription
The Flutter spring for the token (΢ = dampingRatio, k = stiffness): SpringDescription.withDampingRatio(mass: 1, stiffness: k, ratio: ΢), so damping = 2΢√k. Compose's spring(dampingRatio, stiffness) is written against unit mass, so the two run the same curve.
designSpringSimulation(SpringDescription spring, {required double from, required double to, double velocity = 0, Tolerance tolerance = designSpringTolerance}) β†’ SpringSimulation
The simulation of spring from from to to, starting at velocity units per second, that settles at tolerance and lands exactly on to.
designSwipeBack(Map<TargetPlatform, PageTransitionsBuilder> builders, {Set<TargetPlatform> platforms = const {TargetPlatform.iOS}}) β†’ Map<TargetPlatform, PageTransitionsBuilder>
builders with the entries for platforms (iOS, by default) wrapped in DesignSwipeBackPageTransitionsBuilder, so a page there pops with a swipe from the screen's leading edge and otherwise plays the look's push.
expressiveCardElevation(ExpressiveCardVariant variant) β†’ ExpressiveStateElevation
A variant's shadow elevation by interaction (Compose's CardDefaults.cardElevation, elevatedCardElevation, outlinedCardElevation: the outlined card keeps its rest level while pressed, focused and hovered).
expressiveChoiceWidth(BuildContext context, Widget face, {bool fitContent = false}) β†’ Widget
face, a choice's field: in a window ExpressiveSelect.wideFrom or wider, at most ExpressiveSelect.wideMaxWidth wide at its column's start (a form grid's narrower cell bounds it as before); on a phone, its column's width.
expressiveClearDockedBand(ModalRoute<Object?>? route) β†’ void
Forgets route's band (its screen docks nothing now).
expressiveColorsFromArgb(Map<String, int> roles, String owner) β†’ ExpressiveColorScheme
roles, every ExpressiveColorRole by name as ARGB, as a scheme with md.sys.color.shadow. Throws a StateError naming owner unless roles carries exactly the ExpressiveColorRoles.
expressiveComponentStates({bool enabled = true, bool selected = false, bool focused = false, bool error = false}) β†’ Set<WidgetState>
The states a part is in, for its component theme.
expressiveContextMenu(BuildContext context, EditableTextState editableTextState) β†’ Widget
A field's context menu: Material's default (the platform's own menu where the field supports it, else the adaptive toolbar), under the words it reads.
expressiveContrastRatio(Color a, Color b) β†’ double
WCAG 2's contrast ratio of two opaque colours: from 1 (the same luminance) to 21 (black on white), whichever is lighter.
expressiveCubicsPath(List<ExpressiveShapeCubic> cubics) β†’ Path
cubics as one closed path (Compose's pathFromCubics).
expressiveCustomPolygon({required int reps, required double centerX, required double centerY, required bool mirroring, required List<ExpressivePointNRound> points}) β†’ ExpressiveRoundedPolygon
MaterialShapes.customPolygon: points repeated reps times around (centerX, centerY) β€” or, mirroring, 2 Γ— reps times, every other section mirrored β€” as a polygon centred there (doRepeat).
expressiveDockedBandOf(BuildContext context) β†’ double
The docked band of the screen on context's route, measured from the screen's bottom edge (it spans the bottom system inset the chrome pads); 0 when the route's screen docks nothing or there is no route.
expressiveFaceLabel(Widget label) β†’ Widget
label, a face's one-line label, drawn with its capitals on its box's middle (ui_core's DesignCapCenter): centring the line box leaves them up to a few device pixels off, by the engine's whole-pixel baseline.
expressiveFontFamily(String family) β†’ String
family under the name Flutter registers it by: RobotoFlex when the app bundles it, packages/material_expressive_ui/RobotoFlex from the package. A test that loads the faces itself loads them under this name.
expressiveFullScreenKeylines({required double mainAxisSize, required double itemSpacing, required double anchorSize}) β†’ ExpressiveCarouselKeylines
The full-screen carousel's keylines: one item the carousel's whole length, and the anchors (expressiveHeroKeylines with no small items).
expressiveHeroKeylines({required double mainAxisSize, required double? maxItemSize, required double itemSpacing, required int itemCount, required bool centered, required double minSmallItemSize, required double maxSmallItemSize, required double anchorSize}) β†’ ExpressiveCarouselKeylines
Compose's heroKeylineList: one large item (up to maxItemSize) with a small item peeking β€” both sides when centered and there are three or more items.
expressiveIsSpatialKey(ExpressiveMotionKey key) β†’ bool
Whether key is a spatial spring (it moves, resizes or reshapes) rather than an effects spring (opacity, colour): Compose's *Spatial versus *Effects members of MotionSchemeKeyTokens.
expressiveLibraryPolygon(ExpressiveMaterialShape shape) β†’ ExpressiveRoundedPolygon
shape normalized into the unit square, built once: what Compose's MaterialShapes.<Name> returns.
expressiveLibraryShape(ExpressiveMaterialShape shape) β†’ ExpressiveRoundedPolygon
shape as MaterialShapes.kt builds it, before .normalized().
expressiveLibraryShapeCubics(ExpressiveMaterialShape shape) β†’ List<List<double>>
shape's cubics, normalized into the unit square as Compose's MaterialShapes.<Name> holds them, each a list of eight numbers: for tests and tools.
expressiveLibraryShapePath(ExpressiveMaterialShape shape, Rect rect) β†’ Path
The outline of shape in rect, as Compose's RoundedPolygon.toShape lays it out: the unit shape stretched to the rectangle's size, then moved so its bounds are centred in it.
expressiveLibraryUnitPath(ExpressiveMaterialShape shape) β†’ Path
shape's outline in the unit square, built once (Compose's RoundedPolygon.toPath, start angle 0). Never mutated: callers transform a copy.
expressiveListItemPressShapes(ExpressiveShapes shapes) β†’ ExpressivePressShapes
Compose's ListItemDefaults.shapes() (ListTokens' expressive item shapes): 4dp corners at rest, 12dp hovered, 16dp focused and pressed, in shapes' family. The row's highlight takes the morphing shape, so a hover is never a square over the row.
expressiveLoadFonts() β†’ Future<void>
Loads the bundled text and symbol faces before the first frame.
expressiveMultiBrowseKeylines({required double mainAxisSize, required double preferredItemSize, required double itemSpacing, required int itemCount, required double minSmallItemSize, required double maxSmallItemSize, required double anchorSize}) β†’ ExpressiveCarouselKeylines
Compose's multiBrowseKeylineList: as many large items of preferredItemSize as fit, then one medium and one small item peeking. Every length in the same unit (device pixels in a carousel).
expressivePaintFocusRing(Canvas canvas, Rect rect, OutlinedBorder shape, {required Color color, required double thickness, required double offset, TextDirection? textDirection, bool inward = false, Color? gap}) β†’ void
Strokes the focus ring, thickness wide in color, round shape laid on rect: offset out from its edge (the stroke's centre that plus half the stroke), concentric with a rounded rectangle (each corner's radius grown by the same, a square corner kept square), the shape's own outline grown outward otherwise.
expressiveResolveColors(ExpressiveBakedTheme baked, Brightness brightness, {double? contrast}) β†’ ExpressiveColorScheme
baked's colour roles in brightness, at the theme's own contrast or, given contrast, at that baked level. Throws when the level was not baked, or when the baked part does not carry exactly the ExpressiveColorRoles.
expressiveResolveMotion(ExpressiveBakedTheme baked, Brightness brightness) β†’ ExpressiveMotion
baked's motion in brightness. A theme's motion carries its scheme only; Reduce Motion and a pinned Standard subtree are read where a component runs (ExpressiveMotion.of).
expressiveResolveShapes(ExpressiveBakedTheme baked, Brightness brightness) β†’ ExpressiveShapes
baked's shape scale in brightness (shapes do not vary with it).
expressiveResolveTextTheme(ExpressiveBakedTheme baked, Brightness brightness) β†’ ExpressiveTextTheme
baked's type scale in brightness: the one scale, whatever either.
expressiveRotated(ExpressiveRoundedPolygon polygon, double degrees) β†’ ExpressiveRoundedPolygon
polygon through Compose's Matrix().apply { rotateZ(degrees) }.
expressiveScaled(ExpressiveRoundedPolygon polygon, double x, double y) β†’ ExpressiveRoundedPolygon
polygon through Compose's Matrix().apply { scale(x, y) }.
expressiveSearchViewGeometry({required Size screen, required Rect? collapsed, required double progress, double backProgress = 0, bool swipeFromLeft = true, double backDeltaY = 0, double topInset = 0, bool contained = false}) β†’ ({Rect content, double contentAlpha, double corner, Rect field, Rect surface, double surfaceAlpha})
The search view's frame at progress (0 collapsed, 1 expanded) and a predictive back gesture's transformed backProgress, on a screen whose collapsed bar stood at collapsed (Compose's FullScreenSearchBarLayout measure and placement, point for point): the surface, the field, the content, the surface's corner radius and the surface's and content's alpha.
expressiveSettleTime(SpringDescription spring) β†’ Duration
How long spring takes to carry a 0–1 progress to rest at the kit's designSpringTolerance: a spring route's transitionDuration. The spring drives the route's controller; the navigator only reads the figure.
expressiveSheetPageRoute<T>(BuildContext context, Page<T> page, {required bool drawer, required bool skipPartiallyExpanded}) β†’ Route<T>
The route an ExpressiveSheetPage (sheet_page.dart) raises: the modal sheet's, or with drawer the full-screen dialog's.
expressiveSparseTicks(List<ExpressiveChartTick> ticks, List<double> widths, {required double scale, double gap = ExpressiveSpacing.s8, int most = 7}) β†’ List<int>
The x labels a chart keeps of ticks (ExpressiveChartLabels.sparse): all of them when they fit; otherwise every k-th, counted back from the last, k the smallest step at which no two labels come closer than gap and at most most remain. ticks are evenly spaced, widths their label widths and scale logical pixels a unit of the span.
expressiveSpringTokenOf(ExpressiveMotionScheme scheme, ExpressiveMotionKey key) β†’ SpringToken
The generated spring token of key in scheme: Compose's ExpressiveMotionTokens or StandardMotionTokens.
expressiveTextLayout(TextStyle style) β†’ (TextStyle, TextHeightBehavior)
style and the text-height behaviour that lay it out as Compose does: unchanged with the default behaviour when its line height covers Roboto Flex's height, else the font's own ascent over the first line and descent under the last. Scale-free: text scaling multiplies the size and the line height alike.
expressiveTypeKeyOf(ExpressiveTextRole role, ExpressiveTextSize size, {bool emphasized = false}) β†’ ExpressiveTypeKey
The type-scale key of role at size, emphasized or not: one of the 30 (displayLarge … labelSmallEmphasized).
expressiveUncontainedKeylines({required double mainAxisSize, required double itemSize, required double itemSpacing, required double anchorSize, double mediumLargeItemDiffThreshold = CarouselBehavior.mediumLargeItemDiffThreshold}) β†’ ExpressiveCarouselKeylines
Compose's uncontainedKeylineList: items of itemSize from the start, the last one cut off at the end.
expressiveWidestOption(BuildContext context, List<String> labels, Widget face) β†’ Widget
face, a select's read-only field: in a window ExpressiveSelect.wideFrom or wider, at least as wide as its widest option of labels needs, up to the width it is given (Flutter's DropdownButton is as wide as its widest item), so a person reads any choice whole and the face does not change width as they choose; on a phone, as it is (its column's width; a choice too long for it ends in an ellipsis).
hideCurrentExpressiveSnackBar(BuildContext context) β†’ void
Dismisses the snackbar showing over context's root overlay, if any; the next queued one follows (Material's ScaffoldMessenger.hideCurrentSnackBar).
predictiveBackGeometry({required Size size, required double progress, SwipeEdge edge = SwipeEdge.left, double startY = 0, double touchY = 0}) β†’ ({double corner, Offset offset, double scale})
The page's frame at a predictive back gesture's progress (0 to 1) on a screen of size, swiped from edge, the finger having moved vertically from startY to touchY: its scale about its centre, then its offset, and the corner it rounds to when the display publishes none. The spec is cited in this file's header.
showDesignCommandPalette({required BuildContext context, required DesignCommandPalette palette(ValueChanged<DesignCommand> run), Widget surfaceBuilder(BuildContext context, Widget palette)?, Color barrierColor = const Color(0x66000000), DesignBarrierBuilder? barrierBuilder, String? barrierLabel, AlignmentGeometry alignment = const Alignment(0, -0.6)}) β†’ Future<void>
Opens palette in a modal route over a barrier; surfaceBuilder paints the panel around it. A command runs after the route has closed and focus is back where it was.
showExpressiveBottomSheet<T>(BuildContext context, {required WidgetBuilder builder, bool skipPartiallyExpanded = false, bool useRootNavigator = true, ExpressiveComponentThemeData? style}) β†’ Future<T?>
Shows builder's content in a modal bottom sheet (Material's showModalBottomSheet, Compose's ModalBottomSheet), raised from code without a route of the app's router: the same scrim, sheet and back as ExpressiveSheetPage, on the root navigator by default. The route keeps the themes where it was raised (InheritedTheme.capture), so a subtree's theme reaches a sheet raised above it. Completes with the value the sheet is popped with.
showExpressiveDatePicker({required BuildContext context, ExpressiveComponentThemeData? style, DateTime? initialDate, DateTime? firstDate, DateTime? lastDate, bool selectableDay(DateTime day)?, ExpressiveDatePickerMode initialMode = ExpressiveDatePickerMode.picker, String? title, DateTime? today, int? firstDayOfWeek, String? confirmLabel, String? dismissLabel}) β†’ Future<DateTime?>
Raises an ExpressiveDatePicker in an ExpressiveDatePickerDialog and resolves to the day confirmed with OK, or null when cancelled. The choice is a draft until OK, which waits for one.
showExpressiveDateRangePicker({required BuildContext context, ExpressiveComponentThemeData? style, DateTime? initialStart, DateTime? initialEnd, DateTime? firstDate, DateTime? lastDate, bool selectableDay(DateTime day)?, String? title, DateTime? today, int? firstDayOfWeek, String? confirmLabel, String? dismissLabel}) β†’ Future<({DateTime end, DateTime start})?>
Raises an ExpressiveDateRangePicker in an ExpressiveDatePickerDialog and resolves to the range confirmed with OK (OK waits for both ends), or null when cancelled.
showExpressiveDialog<T>({required BuildContext context, required WidgetBuilder builder, bool barrierDismissible = true, bool useRootNavigator = true}) β†’ Future<T?>
Raises the dialog builder builds (an ExpressiveDialog, usually) on the root navigator, centred over the scrim, fading in and out on the default effects spring. Resolves to what the dialog closes with. A tap on the scrim or the system back closes it unless barrierDismissible is false; Escape closes it either way.
showExpressiveMenu(BuildContext context, {Rect? anchor, List<ExpressiveMenuGroup>? groups, List<ExpressiveMenuEntry>? entries, bool vibrant = false, ExpressiveComponentThemeData? style, ExpressiveMenuPosition position = ExpressiveMenuPosition.below, String? label, bool matchAnchorWidth = false, double? maxHeight}) β†’ Future<void>
Opens a menu of groups (or one group of entries) against anchor, a rectangle in global coordinates, or against context's own box (Material's showMenu, Compose's DropdownMenu); resolves when it closes. Closed with nothing chosen (Escape, a tap outside, Back), it gives the focus back to what opened it under context, even a button the pointer pressed, so Enter opens it again.
showExpressiveNavigationDrawer(BuildContext context, {required List<ExpressiveNavItem> destinations, required int selectedIndex, Widget? header, ExpressiveComponentThemeData? style, bool useRootNavigator = true}) β†’ Future<int?>
Raises the expanded rail modally over a scrim, from the leading edge (Compose's ModalWideNavigationRail, expanded and hidden when collapsed): the navigation drawer of a phone, where a bar has no room for every destination. It slides in on the fast spatial spring, the modal container colour, its end corners large, its indicators spanning it as ExpressiveNavigationDrawer's do; a tap on the scrim or the system back closes it. Resolves to the index chosen, or null.
showExpressivePopover(BuildContext context, {required WidgetBuilder builder, ExpressiveComponentThemeData? style, Rect? anchor, ExpressiveMenuPosition position = ExpressiveMenuPosition.below, EdgeInsetsGeometry padding = const EdgeInsets.all(ExpressiveSpacing.s16), String? label}) β†’ Future<void>
Opens a popover of builder's content against anchor, a rectangle in global coordinates, or against context's own box. Resolves when it closes.
showExpressiveSnackBar(BuildContext context, String message, {String? actionLabel, VoidCallback? onAction, bool withDismissAction = false, bool actionOnNewLine = false, ExpressiveSnackBarDuration? duration, ExpressiveComponentThemeData? style}) β†’ void
Shows message as a snackbar (Material's ScaffoldMessenger.showSnackBar with a SnackBar, Compose's SnackbarHostState.showSnackbar): a transient bottom notification above the shell's bar and action β€” a confirmation the page does not have to hold β€” after any snackbar already showing or queued. actionLabel + onAction add ONE inline action β€” the undo pattern; tapping it dismisses the snackbar and runs onAction. withDismissAction adds the close button; actionOnNewLine puts the action under a long message. duration defaults to short, with or without an action.
showExpressiveTimePicker({required BuildContext context, int initialHour = 0, int initialMinute = 0, bool? is24Hour, bool vibrant = false, ExpressiveTimePickerMode initialMode = ExpressiveTimePickerMode.dial, ExpressiveComponentThemeData? style, String? confirmLabel, String? dismissLabel}) β†’ Future<({int hour, int minute})?>
Raises a time picker in an ExpressiveTimePickerDialog and resolves to the time confirmed with OK, or null when cancelled. initialMode picks the face (the dialog's toggle switches to typing and back); vibrant the vibrant dialog (always so for the scroll face); is24Hour follows the platform's setting when null.
withPlatformWords(BuildContext context, Widget child, {bool overlay = false}) β†’ Widget
child with the Material and Cupertino words the package's primitives read, when the app supplies none.

Typedefs

DesignBarrierBuilder = Widget Function(BuildContext context, Animation<double> animation)
Paints a modal part's barrier in place of its barrier colour: a look's own screen over the page behind (Ben-Day dots, a blur, a grain).
DesignBottomSheetBuilder = Widget Function(BuildContext context, DesignBottomSheetDetails details)
Builds a bottom sheet's panel from details.
DesignCalendarDayBuilder = Widget Function(BuildContext context, DesignCalendarDay day, Set<WidgetState> states)
Paints one day for its states (WidgetState.selected when chosen, WidgetState.focused while the keyboard is on it, hovered, pressed, disabled).
DesignChartBuilder = Widget Function(BuildContext context, DesignChartDetails details)
Draws a chart from its details.
DesignChartFormat = String Function(double value)
Formats a value for labels, readouts and speech.
DesignChartTableCellBuilder = Widget Function(BuildContext context, DesignChartTableCellDetails cell)
Paints a cell of a DesignChartTable.
DesignComboboxFieldBuilder = Widget Function(BuildContext context, DesignComboboxField field)
Paints the field.
DesignDateFieldFrameBuilder = Widget Function(BuildContext context, Set<WidgetState> states, Widget segments)
Frames a date or time field's laid-out segments (its box, its focus ring); states are the field's: focused (a segment has the focus), hovered, disabled, error.
DesignDateLiteralBuilder = Widget Function(BuildContext context, String literal)
Paints the text between a field's segments ("/", ".", ":", Japanese's year mark U+5E74).
DesignDateSegmentBuilder = Widget Function(BuildContext context, DesignDateSegmentDetails details)
Paints one segment of a date or time field. A segment is a tap target: a look gives its face the floor (DesignTapTarget).
DesignDestinationBuilder = Widget Function(BuildContext context, DesignNavigationDestination destination, DesignDestinationDetails details)
Paints a destination.
DesignDialogActionBuilder = Widget Function(BuildContext context, DesignDialogAction action, DesignDialogActionDetails details)
Paints an action of a DesignDialog.
DesignDialogBuilder = Widget Function(BuildContext context, DesignDialogDetails details)
Builds a dialog route's page: the look's dialog, which details lets it move as the route opens and closes.
DesignDialogPartBuilder = Widget Function(BuildContext context, DesignDialogFrameDetails details, Widget child)
Wraps a part of a DesignDialog (its frame or its action bar) in the look's paint.
DesignDividerBuilder = Widget Function(BuildContext context, Set<WidgetState> states, Axis axis)
Builds a split view's divider for its states (focused while the keyboard is on it, hovered, pressed while dragged).
DesignFieldBuilder = Widget Function(BuildContext context, DesignFieldParts parts)
Lays out a field's parts.
DesignHandleBuilder = Widget Function(BuildContext context, Set<WidgetState> states)
Builds a handle's face for its states (focused while the keyboard is on it, hovered, pressed while dragged, disabled).
DesignInputGroupBuilder = Widget Function(BuildContext context, Set<WidgetState> states, Widget child)
Builds the group's frame around child (the field and its add-ons) for states: WidgetState.focused while anything inside has focus, WidgetState.hovered, WidgetState.disabled and WidgetState.error.
DesignInventoryGroupBuilder = Widget Function(BuildContext context, String group, int present, int total)
Builds a group's heading in a DesignInventoryGallery: present of total rows carried.
DesignInventoryRowBuilder = Widget Function(BuildContext context, DesignInventoryRow row, DesignInventoryEntry? entry, Widget? specimen)
Builds one row in a DesignInventoryGallery. entry is null when the inventory does not answer the row; specimen is the entry's live specimen, built, when it has one.
DesignListSurfaceBuilder = Widget Function(BuildContext context, Widget list)
Paints the list's surface around list (a panel, its shadow).
DesignMenuItemBuilder = Widget Function(BuildContext context, DesignMenuEntry entry, DesignMenuLevel level, Set<WidgetState> states)
Paints an item for its states (WidgetState.focused while the keyboard is on it, WidgetState.selected for the active menu title, hovered, pressed, disabled). In a menu whose highlight follows the pointer, one item at most is focused or hovered: the current one.
DesignMenuSurfaceBuilder = Widget Function(BuildContext context, DesignOverlayInfo info, List<Widget> items)
Paints a menu's panel round its items (scroll them when DesignOverlayInfo.maxSize is short): a menubar's menus, a context menu's.
DesignNavigationBuilder = Widget Function(BuildContext context, DesignNavigationDetails details)
Lays out and paints the navigation round its destinations.
DesignNumberFieldBuilder = Widget Function(BuildContext context, DesignNumberFieldDetails details)
Paints the field's text input.
DesignNumberFieldButtonBuilder = Widget Function(BuildContext context, DesignNumberFieldButtonDetails details)
Paints a step button: a look gives it a finger's floor (DesignTapTarget).
DesignNumberFieldLayoutBuilder = Widget Function(BuildContext context, Widget field, Widget decrement, Widget increment)
Lays out the field and its decrement and increment buttons.
DesignOptionBuilder<T> = Widget Function(BuildContext context, T option, Set<WidgetState> states)
Paints one option for its states: WidgetState.focused while it is highlighted (the keyboard's place in the list), WidgetState.selected when it is the combobox's value, WidgetState.disabled when it cannot be taken, and a pointer's hovered and pressed.
DesignOptionSearch<T> = FutureOr<Iterable<T>> Function(String query)
Searches for the options matching query.
DesignOtpContextMenuBuilder = Widget Function(BuildContext context, TextSelectionToolbarAnchors anchors, List<ContextMenuButtonItem> items)
Draws the field's edit menu: Flutter's toolbar arguments, so a look can hand them on (Material's AdaptiveTextSelectionToolbar.buttonItems, Cupertino's CupertinoAdaptiveTextSelectionToolbar.buttonItems) or draw its own. items is the Paste item (its label from its ContextMenuButtonType, in the app's language); pressing it pastes and closes the menu.
DesignOtpLayoutBuilder = Widget Function(BuildContext context, List<Widget> slots)
Lays out the boxes (a row; a look may put a dash in the middle).
DesignOtpSlotBuilder = Widget Function(BuildContext context, DesignOtpSlot slot)
Paints one box.
DesignOverlayAnchorBuilder = Widget Function(BuildContext context, DesignOverlayAnchor anchor)
Paints the anchor.
DesignOverlaySurfaceBuilder = Widget Function(BuildContext context, DesignOverlayInfo info)
Paints the surface.
DesignPaletteLayoutBuilder = Widget Function(BuildContext context, Widget field, Widget results)
A palette's list, as DesignCommandPalette.layoutBuilder lays it out.
DesignPieChartBuilder = Widget Function(BuildContext context, DesignPieChartDetails details)
Draws a pie chart from its details.
DesignPressableBuilder = Widget Function(BuildContext context, Set<WidgetState> states, Widget? child)
Builds a pressable's face for its current states (hovered, focused, pressed, disabled, selected, error). child is the pressable's own child, passed through so a face that does not change with state is built once.
DesignRatingItemBuilder = Widget Function(BuildContext context, DesignRatingItemDetails details)
Paints one item of a rating.
DesignRatingLayoutBuilder = Widget Function(BuildContext context, List<Widget> items)
Lays out a rating's items, in reading order.
DesignScrollbarBuilder = Widget Function(BuildContext context, DesignScrollThumb thumb)
Paints a scrollbar's thumb or track.
DesignSearchErrorBuilder = Widget Function(BuildContext context, DesignSearchError error)
Paints a failed search (error) in the list's surface.
DesignSwipeActionBuilder = Widget Function(BuildContext context, DesignSwipeAction action, DesignSwipeActionDetails details)
Paints an action.
DesignTabBuilder = Widget Function(BuildContext context, DesignTab tab, DesignTabDetails details)
Paints a tab.
DesignTabIndicatorBuilder = Widget Function(BuildContext context, DesignTabIndicatorDetails details)
Paints the indicator, laid out in DesignTabIndicatorDetails.rect.
DesignTableHeaderBuilder<R> = Widget Function(BuildContext context, DesignTableColumn<R> column, DesignSortDirection? sort, Set<WidgetState> states)
A sortable header, as DesignDataTable.headerBuilder gets it.
DesignTagBuilder<T> = Widget Function(BuildContext context, T value, DesignTagDetails tag)
Paints one tag.
DesignTagLayoutBuilder = Widget Function(BuildContext context, List<Widget> tags, Widget field)
Lays out the tags and the field (a wrap, by default).
DesignToastBuilder = Widget Function(BuildContext context, DesignToastDetails details)
Paints one toast.
DesignToastStackBuilder = Widget Function(BuildContext context, List<Widget> toasts)
Lays out the shown toasts, oldest first.
DesignToggleItemBuilder<T> = Widget Function(BuildContext context, T value, Set<WidgetState> states)
Builds an item's face for its states (selected, focused while the keyboard is on it, hovered, pressed, disabled).
DesignWheelColumnBuilder = Widget Function(BuildContext context, DesignWheelColumnDetails details, Widget wheel)
Frames one column of a DesignWheelPicker round its wheel.
DesignWheelItemBuilder = Widget Function(BuildContext context, DesignWheelItemDetails details)
Builds one row of a DesignWheelPicker.
ExpressiveComboboxFilter<T> = bool Function(ExpressiveSelectOption<T> option, String query)
Whether option matches what the user typed.
ExpressiveFormat = DisplayFormat
Expressive's formatters: the design kit's DisplayFormat, named for the system.
ExpressiveLerp<T> = T Function(T a, T b, double t)
Linear interpolation of T at t (which a spatial spring carries past 1 when it overshoots).
ExpressiveMeasuredFeatures = List<ExpressiveProgressableFeature>
MeasuredFeatures contains a list of all features in a polygon along with the [0..1] progress at that feature.
ExpressivePointTransformer = (double, double) Function(double x, double y)
A function that moves the point (x, y) to a new point.
ExpressiveSearchResultsBuilder = Widget Function(BuildContext context, String query)
What the search view shows under its field for the live query.
ExpressiveSplashScreenMarkBuilder = Widget Function(BuildContext context, bool restoring)
Builds a custom mark; restoring is whether the app is still restoring (run an indicator of the mark's own while it is).
ExpressiveSpringToken = ({double dampingRatio, double stiffness})
A spring token as the scheme states it, before Reduce Motion: damping ratio ΞΆ and stiffness k (unit mass).

Exceptions / Errors

DesignInventoryError
Thrown by DesignInventory.verify: the rows an inventory answers wrong.