material_expressive_parts library
Everything material_expressive_ui's component files use, public: the look, the foundation, and the helpers the look's barrel
keeps back (components/sheet.dart, internal/badge_anchor.dart, internal/cap_label.dart, internal/choice_width.dart, internal/color/baked_colors.dart, internal/density.dart, internal/docked_band.dart, internal/field_node.dart, internal/focus_ring.dart, internal/gesture_focus.dart, internal/group_tap_target.dart, internal/icons/symbols.g.dart, internal/list_item_shapes.dart, internal/motion/baked_motion.dart, internal/owned.dart, internal/platform_words.dart, internal/reach.dart, internal/shape/baked_shapes.dart, internal/shape/graphics/graphics.dart, internal/shape/library.dart, internal/shape/library_shapes.g.dart, internal/spacing/spacing.g.dart, internal/state_face.dart, internal/style_layers.dart, internal/styled_content.dart, internal/themes/baked_theme.dart, internal/themes/baseline.g.dart, internal/themes/bloom.g.dart, internal/themes/ember.g.dart, internal/themes/grove.g.dart, internal/themes/registry.g.dart, internal/themes/slate.g.dart, internal/tokens/app_bar_large_flexible_tokens.g.dart, internal/tokens/app_bar_large_tokens.g.dart, internal/tokens/app_bar_medium_flexible_tokens.g.dart, internal/tokens/app_bar_medium_tokens.g.dart, internal/tokens/app_bar_small_tokens.g.dart, internal/tokens/app_bar_tokens.g.dart, internal/tokens/assist_chip_tokens.g.dart, internal/tokens/badge_tokens.g.dart, internal/tokens/baseline_button_tokens.g.dart, internal/tokens/behavior.g.dart, internal/tokens/bottom_app_bar_tokens.g.dart, internal/tokens/button_group_large_tokens.g.dart, internal/tokens/button_group_medium_tokens.g.dart, internal/tokens/button_group_small_tokens.g.dart, internal/tokens/button_group_x_large_tokens.g.dart, internal/tokens/button_group_x_small_tokens.g.dart, internal/tokens/button_large_tokens.g.dart, internal/tokens/button_medium_tokens.g.dart, internal/tokens/button_small_tokens.g.dart, internal/tokens/button_x_large_tokens.g.dart, internal/tokens/button_x_small_tokens.g.dart, internal/tokens/checkbox_tokens.g.dart, internal/tokens/chips_tokens.g.dart, internal/tokens/circular_progress_indicator_tokens.g.dart, internal/tokens/connected_button_group_large_tokens.g.dart, internal/tokens/connected_button_group_medium_tokens.g.dart, internal/tokens/connected_button_group_small_tokens.g.dart, internal/tokens/connected_button_group_x_large_tokens.g.dart, internal/tokens/connected_button_group_x_small_tokens.g.dart, internal/tokens/date_input_modal_tokens.g.dart, internal/tokens/date_picker_modal_tokens.g.dart, internal/tokens/dialog_tokens.g.dart, internal/tokens/divider_tokens.g.dart, internal/tokens/docked_toolbar_tokens.g.dart, internal/tokens/drag_handle_tokens.g.dart, internal/tokens/elevated_button_tokens.g.dart, internal/tokens/elevated_card_tokens.g.dart, internal/tokens/expanded_list_tokens.g.dart, internal/tokens/expressive_motion_tokens.g.dart, internal/tokens/extended_fab_large_tokens.g.dart, internal/tokens/extended_fab_medium_tokens.g.dart, internal/tokens/extended_fab_primary_tokens.g.dart, internal/tokens/extended_fab_small_tokens.g.dart, internal/tokens/fab_baseline_tokens.g.dart, internal/tokens/fab_large_tokens.g.dart, internal/tokens/fab_medium_tokens.g.dart, internal/tokens/fab_menu_baseline_tokens.g.dart, internal/tokens/fab_primary_container_tokens.g.dart, internal/tokens/fab_secondary_container_tokens.g.dart, internal/tokens/fab_small_tokens.g.dart, internal/tokens/filled_autocomplete_tokens.g.dart, internal/tokens/filled_button_tokens.g.dart, internal/tokens/filled_card_tokens.g.dart, internal/tokens/filled_icon_button_tokens.g.dart, internal/tokens/filled_text_field_tokens.g.dart, internal/tokens/filled_tonal_button_tokens.g.dart, internal/tokens/filled_tonal_icon_button_tokens.g.dart, internal/tokens/filter_chip_tokens.g.dart, internal/tokens/floating_toolbar_tokens.g.dart, internal/tokens/input_chip_tokens.g.dart, internal/tokens/keys.g.dart, internal/tokens/large_icon_button_tokens.g.dart, internal/tokens/linear_progress_indicator_tokens.g.dart, internal/tokens/list_tokens.g.dart, internal/tokens/loading_indicator_tokens.g.dart, internal/tokens/medium_icon_button_tokens.g.dart, internal/tokens/menu_tokens.g.dart, internal/tokens/navigation_bar_horizontal_item_tokens.g.dart, internal/tokens/navigation_bar_tokens.g.dart, internal/tokens/navigation_bar_vertical_item_tokens.g.dart, internal/tokens/navigation_drawer_tokens.g.dart, internal/tokens/navigation_rail_baseline_item_tokens.g.dart, internal/tokens/navigation_rail_collapsed_tokens.g.dart, internal/tokens/navigation_rail_color_tokens.g.dart, internal/tokens/navigation_rail_expanded_tokens.g.dart, internal/tokens/navigation_rail_horizontal_item_tokens.g.dart, internal/tokens/navigation_rail_vertical_item_tokens.g.dart, internal/tokens/outlined_autocomplete_tokens.g.dart, internal/tokens/outlined_button_tokens.g.dart, internal/tokens/outlined_card_tokens.g.dart, internal/tokens/outlined_icon_button_tokens.g.dart, internal/tokens/outlined_segmented_button_tokens.g.dart, internal/tokens/outlined_text_field_tokens.g.dart, internal/tokens/plain_tooltip_tokens.g.dart, internal/tokens/primary_navigation_tab_tokens.g.dart, internal/tokens/progress_indicator_tokens.g.dart, internal/tokens/radio_button_tokens.g.dart, internal/tokens/reorder_list_tokens.g.dart, internal/tokens/reveal_list_tokens.g.dart, internal/tokens/rich_tooltip_tokens.g.dart, internal/tokens/scrim_tokens.g.dart, internal/tokens/search_bar_tokens.g.dart, internal/tokens/search_view_tokens.g.dart, internal/tokens/secondary_navigation_tab_tokens.g.dart, internal/tokens/segmented_menu_tokens.g.dart, internal/tokens/shape_tokens.g.dart, internal/tokens/sheet_bottom_tokens.g.dart, internal/tokens/slider_tokens.g.dart, internal/tokens/small_icon_button_tokens.g.dart, internal/tokens/snackbar_tokens.g.dart, internal/tokens/split_button_large_tokens.g.dart, internal/tokens/split_button_medium_tokens.g.dart, internal/tokens/split_button_small_tokens.g.dart, internal/tokens/split_button_x_large_tokens.g.dart, internal/tokens/split_button_x_small_tokens.g.dart, internal/tokens/standard_icon_button_tokens.g.dart, internal/tokens/standard_menu_tokens.g.dart, internal/tokens/standard_motion_tokens.g.dart, internal/tokens/state_tokens.g.dart, internal/tokens/suggestion_chip_tokens.g.dart, internal/tokens/switch_tokens.g.dart, internal/tokens/text_button_tokens.g.dart, internal/tokens/time_input_tokens.g.dart, internal/tokens/time_picker_tokens.g.dart, internal/tokens/token_types.g.dart, internal/tokens/tokens.g.dart, internal/tokens/tonal_button_tokens.g.dart, internal/tokens/type_scale_tokens.g.dart, internal/tokens/typeface_tokens.g.dart, internal/tokens/typography_tokens.g.dart, internal/tokens/vibrant_menu_tokens.g.dart, internal/tokens/x_large_icon_button_tokens.g.dart, internal/tokens/x_small_icon_button_tokens.g.dart, internal/type/baked_type_scale.dart, internal/type/font_metrics.g.dart, internal/type/language_height.g.dart, internal/type/text_height.dart, internal/whole_words.dart, internal/width_probe.dart, internal/word_scope.dart).
Import it in a component you copied out of the package to change, in place of the src/ imports it had; the
rest of your app stays on the package:
// lib/ui/my_card.dart, copied from package:material_expressive_ui/src/material_expressive/... and renamed.
import 'package:flutter/widgets.dart';
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
AlertDialogsets 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
AnimatedThemeon 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
AppBarsets 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
Badgesets in code (behavior.yaml, verified at the pin). - BadgeTokens
-
Compose's
BadgeTokens. - BaselineButtonTokens
-
Compose's
BaselineButtonTokens. - BottomAppBarTokens
-
Compose's
BottomAppBarTokens. - BottomSheetBehavior
-
What Compose's
BottomSheetsets in code (behavior.yaml, verified at the pin). - ButtonBehavior
-
What Compose's
Buttonsets in code (behavior.yaml, verified at the pin). - ButtonGroupBehavior
-
What Compose's
ButtonGroupsets 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
Cardsets in code (behavior.yaml, verified at the pin). - CarouselBehavior
-
What Compose's
Carouselsets in code (behavior.yaml, verified at the pin). - CheckboxBehavior
-
What Compose's
Checkboxsets in code (behavior.yaml, verified at the pin). - CheckboxTokens
-
Compose's
CheckboxTokens. - ChipBehavior
-
What Compose's
Chipsets in code (behavior.yaml, verified at the pin). - ChipsTokens
-
Compose's
ChipsTokens. - ChromeGroundScope
-
Publishes the ChromeGround of the page it wraps.
ChromeRoutes.pagemounts 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
DateInputsets in code (behavior.yaml, verified at the pin). - DateInputModalTokens
-
Compose's
DateInputModalTokens. - DatePickerBehavior
-
What Compose's
DatePickersets in code (behavior.yaml, verified at the pin). - DatePickerModalTokens
-
Compose's
DatePickerModalTokens. - DateRangePickerBehavior
-
What Compose's
DateRangePickersets 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
DraggableScrollableControllerdrives 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 noonSubmitted; 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.
- A destination: its name and glyphs, as Material's NavigationDestination.
- 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
fromand its new placeto(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
errorBuildergets 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
ButtonStyleis: 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
TabControllerwithout 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
TabBarViewwithout 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
DockedToolbarsets 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 isonSurface, or color (an error for money out). Announced as one node: the amount, then "was" and the old price. - ExpressiveAndroidShadowModel
-
Android's shadow model, as the framework applies it on the oracle AVD
(
material_oracle, android-36) and Skia draws it. The literal lint excepts exactly these declarations (Tsrc/lint.ts,LITERAL_EXCEPTIONS): they are the platform's, not a design token. - 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 (CONTRACT Β§4.2
ExpressiveAppBar): 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
TopAppBarStateoffsets, 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
primarystroke overprimaryContainer, 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
-
An app's artwork: the slot-to-scheme table
tools/expressive_tokensgenerates (lib/app/artwork.g.dart,appArtwork). - ExpressiveArtworkScheme
- One picture's content colour, baked: the scheme a page wears when the picture heads it, as Jetcaster's Now Playing and show pages recolour from the cover.
- 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.primaryis Material's list avatar exactly). - ExpressiveAvatarGroup
-
Who is in: the first max faces side by side from the start, 4dp
apart, then one
surfaceContainerHighestdisc 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 oflabelSmalltext inonErrorβ 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 withExpressiveBadge(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.jsonmotion 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.jsonrecord 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:
outlinebars, the highlight bar inprimary, 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:
bodyLargeinonSurface, the placeholder inonSurfaceVariant, the caret inprimary, at least 48dp tall (Compose'sminimumInteractiveComponentSize; 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 plainlabelLargeinonSurface, announced as the current page. Achevron_rightinonSurfaceVariantstands between steps, mirrored right to left. Past maxShown steps the middle folds into amore_horizicon 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 (CONTRACT Β§4.1
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 shareButtonStyleButton: 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 mostButtonGroupBehavior.compressionLimit) on the group's spatial spring; a quick tap still plays the widening out toButtonGroupBehavior.releaseThresholdbefore 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 inprimary, today ringed inprimary, a range's days on itssecondaryContainerband. The keyboard is ui_core'sDesignCalendar: 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 bareColumn): 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 fromCardDefaults.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 inprimary) or as a line (ExpressiveChart.line: aprimarystroke of the linear progress indicator's track thickness over aprimaryContainerarea, the highlight point marked), on a hairlineoutlineVariantbaseline, with each point's label under it inlabelSmall. 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
outlineunder 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
CheckboxandTriStateCheckbox): 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
FlowRowthe 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:
.singlechooses one (value, radio semantics) and reports it on the tap itself, so a first-run step can advance on it;.multichooses 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 wavyCircularWavyProgressIndicator, 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
surfacering and anoutlinehairline, 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
ExposedDropdownMenuBoxaround an editable field, theEditableExposedDropdownMenusample): 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
- One custom colour of an app, baked in one theme and brightness: a colour group as Material's custom colours have it, color with the content on it, and a container with the content on that.
- ExpressiveCustomColors
-
An app's custom colours: the table
tools/expressive_tokensgenerates beside its themes (lib/app/themes.g.dart,appCustomColors), each of its own themes' colours, the default theme first. - 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 (surfacecollapsed,surfaceContainerexpanded) 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 1dpoutlineVariantline, 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 onFloatingActionButtonMenuBehavior.toggleMotion) and the items stagger in from the one nearest the button (staggerMotion; each item's width and opacity onitemWidthMotion,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
expandedfrom 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):
bodySmallin theerrorrole, inset like a field's supporting text, announced when it appears. A text field shows its own througherrorText; this is the same line for a control that has none (a code input, a group of choices). - ExpressiveFieldFrame
-
The outlined text field's container for a field ui_core frames (an
input group, a tag input): the extra-small corner at least 56dp tall (less
at a denser theme, as the text field), its
outline 1dp in
outline,onSurfaceunder a pointer, 2dpprimarywhile anything inside has focus, inerrorfor WidgetState.error, andonSurfaceat 12% when disabled (OutlinedTextFieldTokens). - 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
surfaceContainerLowat the large corner step, its edge a solidoutlinehairline as a field's (Material draws no dashed edges: a surface's edge is a line), holding anuploadglyph inprimary, label intitleSmall, supportingText inbodySmalland a tonal button that calls onBrowse (the app opens its picker). While dragging (the app's drop target says a drag hovers) the area fillsprimaryContainerunder a solid 2dpprimaryedge; an errorText draws the edge solid inerrorand 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'sFilledButton): the highest emphasis, inprimary; ExpressiveFilledButton.tonal is the tonal button insecondaryContainer. - 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.thicknessand.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'sDesignField): the label inlabelLargeonSurface(primarywhile the control has focus,errorwith error), a required field's asterisk after it, the help inbodySmallonSurfaceVariantand the error in its place inerror, 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'sDesignFormto 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
ExpressiveSemanticsGroupspans 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
ThemeDatafor the primitives Expressive builds on (ink, text editing and selection, scrolling, page transitions), whose platform is the ambient one; the ground (thesurfacerole); the text and icon defaults (Compose'sbodyLargeinonSurface); the text-selection colours (primary, its background atHostBehavior.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
Icondraws it: size (the ambientIconTheme'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
imageglyph 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'shttps://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: 1dpoutline,onSurfaceunder a pointer, 2dpprimarywhile anything inside has focus,errorwith isError. A press anywhere on the frame focuses the input (ui_core'sDesignInputGroup). - 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'sDesignOtpField. 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
titleLargewith how many rows it carries, each row its name intitleSmall, its class inlabelMedium(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 wavyLinearWavyProgressIndicator, 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
primarystroke, 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
TextFieldplaces the caret. The slot is height tall, else at least minHeight; it fills the width it is given unless fillWidth is false. - ExpressiveLink
-
A link (CONTRACT Β§4.1
link): its words inprimary, 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 spacedListItemDefaults.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, andSegmentedListIteminside an ExpressiveListSection): aheadlinewith an optional overline above andsupportingtext 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 containedContainedLoadingIndicator): 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 (CONTRACT Β§3). - 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 andExpressiveScaffoldaround 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
DropdownMenuPopupwith its anchor): a tap on child β or a long press or secondary click, with triggerlongPressβ 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'sDesignMenuBar): each menu's title a text button inlabelLargeon the full corner (40dp, in a 48dp target), its open menu's title onsecondaryContainer; 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 flipscheckedthrough 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 (
HorizontalDividerwithMenuDefaults.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
DropdownMenuItemwith 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. -
An item that opens a cascading menu of groups beside it (Compose's
MenuWithCascadingMenusSample: a second popup atMenuAnchorPosition.End). A choice in it closes both menus. - ExpressiveMenuSurface
-
A menu laid out: its groups as
DropdownMenuPopupshows 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
bodyLargeon a bubble β incoming onsurfaceContainerHighat the start, outgoing onprimaryat the end β at most four fifths of the width, roundedlargeIncreasedexcept 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 inlabelSmall. - 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 (CONTRACT Β§4.1
segmented-control,multi; Compose'sMultiChoiceSegmentedButtonRow): 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 (2dpprimarywhile 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. -
The flexible navigation bar (Compose
ShortNavigationBar): a 64dpsurfaceContainerband of destinations β 3 to 5 β over the system's bottom and side insets, the selectedIndex item wearing the active indicator (asecondaryContainerpill, the icon filled, the label insecondary). Selecting an item callsonSelected. - 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.
-
The navigation rail (Compose
WideNavigationRail), collapsed: a 96dpsurfacecolumn 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. -
One navigation destination (CONTRACT Β§4.2
ExpressiveNavItem(icon, label, key)): its glyph, its label β required, Material always labels its navigation β and the walkthrough key set on its hit target. - 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,primaryfor the current page andoutlinefor the rest β a control's 3:1 against the page, whereoutlineVariantis 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'sMaterialPage): 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" inbodyMediumstands 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,errorin error) that shows and hides it. The reveal is ui_core'sDesignPasswordReveal: 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,outlinein 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 inbodySmalloninverseSurface, 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 (
surfaceContainerLowon 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 (wave decision F11): 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'scheckedShape): 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()overModifier.selectablerows, 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, astar_halfat 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
PullToRefreshBoxwithPullToRefreshDefaults.LoadingIndicator). - ExpressiveReorderableListView
-
A list whose items reorder by drag (Compose's reorderable list item
colours: the dragged item lifts to level 4 in
tertiaryContainerwith 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_indicatorglyph; 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 ofoutline,onSurfaceunder 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 onsurfaceContainerat 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'sDesignScrollArea). - ExpressiveScrollField
-
Compose's
ScrollField(CONTRACT Β§4.1's number scroll field): a vertically paged wheel of itemCount numbers that wraps around, a third of ScrollFieldBehavior.height a number, the centred one selected β drawn larger and inonSurfaceas it springs in, the others inoutlineβ 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 theonSurfacestate layer on the container, and the keyboard's focus rings it. onChanged reports the selected index. - ExpressiveSearchBar
-
The search bar (Compose's
SearchBarwith itsInputField): a 56dp pill onsurfaceContainerHighβ the search glyph (or leading), the query orplaceholder, trailing icons and an avatar β that opens the full-screen search view when tapped. The view (Compose'sExpandedFullScreenSearchBar, or with contained itsExpandedFullScreenContainedSearchBar) 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 onsurfaceContainerHighthat 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):
titleSmallinprimary, 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 (CONTRACT Β§4.1
segmented-control; Compose'sSingleChoiceSegmentedButtonRow, Material'sSegmentedButton): 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
ExposedDropdownMenuBoxaround 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
Shapesplus none and full. - ExpressiveSheet
-
Material's modal side sheet: the panel on
surfaceContainerLowat level 1, the large corner on its inner edge, its headline intitleLargeonSurfaceVariantbeside 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'sDesignSideSheetRoute). - 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 (CONTRACT Β§4.2): 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
(CONTRACT Β§4.2
ExpressiveShellInsets): 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'sShellInsets; 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'sSnackBar): 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
FadeInFadeOutWithScaleitem): opacity onSnackbarHostBehavior.opacityMotionand scale about the centre onscaleMotion, from and tohiddenScale. 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
primaryline 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:
primaryContainerfor a FAB,primaryfor 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
SplitButtonLayoutwith aLeadingButtonand a checkableTrailingButton, 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'sbetween-spacewhen null). The pair keeps Compose's 48dp touch target; its halves draw at their own size. - ExpressiveSplitLeadingButton
-
A split button's leading half (
SplitButtonDefaults.LeadingButtonand 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.TrailingButtonand 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 (CONTRACT Β§2): 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
StateTokensas a theme applies them:context.expressiveTheme.states. - ExpressiveStatusColors
-
A theme's status tones: success and warning as Material's custom
colours, each a colour group (ExpressiveCustomColor). Never colour
roles (contract Β§7):
tools/expressive_tokensbakes them for every preset and every app theme, light and dark, from Material's green 800 (#2E7D32) and amber 600 (#FFB300) harmonised toward the theme's seed, held to the custom-colour floors (content 4.5:1; the colour against its container and the surface 3:1; all 7:1 at contrast 1). A banner, a tag and the kit parts' notices read them. - 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
primaryContainerground, 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 (CONTRACT Β§7). - ExpressiveSurface
-
Compose's
Surface: child on a shape filled with color (tinted by tonal elevation when it is thesurfacerole), casting a shadow at shadowElevation, outlined by side, clipping its content to the shape. Content inherits contentColor (Compose'sLocalContentColor) 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 on the fast spatial spring (SwitchBehavior.thumbMotion). - 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);ExpressiveIconanimates 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 asurfaceband 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'sTabAlignment.startlays 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
onPressedtakes 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
Stringor aWidget. 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
TexttakesLocalContentColor). Display, headline and title text is announced as a heading. - ExpressiveTextArea
-
A multi-line text field that grows with its content (Compose's
TextFieldandOutlinedTextFieldwithsingleLine = 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 inprimaryon no container, at its size's padding. - ExpressiveTextField
-
A single-line text field (Compose's
TextFieldandOutlinedTextField;SecureTextFieldandOutlinedSecureTextFieldwhensecure). - 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
Themedoes: the one root widget an app needs, in itsbuilder:, underMaterialApp,CupertinoApporWidgetsAppalike (the last two with Material's localizations: a field is Flutter's MaterialTextFieldunderneath). 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 readThemeData. - ExpressiveThemeSpec
- One theme as baked, in public form: what an app's generated themes hold.
- 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
ToggleButtonand 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 β onToggleButtonBehavior.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 connectedButtonGroupof 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'sDesignToggleGroup: 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.StandardFloatingActionButtonandVibrantFloatingActionButton): 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
Stackloosens its constraints, and Compose's contentRowfills 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
FloatingActionButtonsets in code (behavior.yaml, verified at the pin). - FloatingActionButtonMenuBehavior
-
What Compose's
FloatingActionButtonMenusets in code (behavior.yaml, verified at the pin). - FloatingToolbarBehavior
-
What Compose's
FloatingToolbarsets 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
Hostsets in code (behavior.yaml, verified at the pin). - IconButtonBehavior
-
What Compose's
IconButtonsets in code (behavior.yaml, verified at the pin). - InputChipBehavior
-
What Compose's
InputChipsets 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
ListItemsets in code (behavior.yaml, verified at the pin). - ListTokens
-
Compose's
ListTokens. - LoadingIndicatorBehavior
-
What Compose's
LoadingIndicatorsets 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. - MenuBehavior
-
What Compose's
Menusets in code (behavior.yaml, verified at the pin). - MenuTokens
-
Compose's
MenuTokens. - ModalBottomSheetBehavior
-
What Compose's
ModalBottomSheetsets in code (behavior.yaml, verified at the pin). -
Compose's
NavigationBarHorizontalItemTokens. -
Compose's
NavigationBarTokens. -
Compose's
NavigationBarVerticalItemTokens. -
Compose's
NavigationDrawerTokens. -
What Compose's
NavigationItemsets 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
Twith 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).
-
Compose's
PrimaryNavigationTabTokens. - ProgressEasingBehavior
-
What Compose's
ProgressEasingsets in code (behavior.yaml, verified at the pin). - ProgressIndicatorBehavior
-
What Compose's
ProgressIndicatorsets in code (behavior.yaml, verified at the pin). - ProgressIndicatorTokens
-
Compose's
ProgressIndicatorTokens. - PullToRefreshBehavior
-
What Compose's
PullToRefreshsets in code (behavior.yaml, verified at the pin). - RadioButtonBehavior
-
What Compose's
RadioButtonsets 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
Scaffoldsets in code (behavior.yaml, verified at the pin). - ScrimTokens
-
Compose's
ScrimTokens. - ScrollFieldBehavior
-
What Compose's
ScrollFieldsets in code (behavior.yaml, verified at the pin). - SearchBarBehavior
-
What Compose's
SearchBarsets in code (behavior.yaml, verified at the pin). - SearchBarTokens
-
Compose's
SearchBarTokens. - SearchViewTokens
-
Compose's
SearchViewTokens. -
Compose's
SecondaryNavigationTabTokens. - SegmentedMenuTokens
-
Compose's
SegmentedMenuTokens. - ShapeTokens
-
Compose's
ShapeTokens. - SheetBottomTokens
-
Compose's
SheetBottomTokens. - SheetDefaultsBehavior
-
What Compose's
SheetDefaultssets 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.
-
What Compose's
ShortNavigationBarsets in code (behavior.yaml, verified at the pin). - SliderBehavior
-
What Compose's
Slidersets in code (behavior.yaml, verified at the pin). - SliderTokens
-
Compose's
SliderTokens. - SmallIconButtonTokens
-
Compose's
SmallIconButtonTokens. - SnackbarBehavior
-
What Compose's
Snackbarsets in code (behavior.yaml, verified at the pin). - SnackbarHostBehavior
-
What Compose's
SnackbarHostsets 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
SplitButtonsets 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
SwipeToDismissBoxsets in code (behavior.yaml, verified at the pin). - SwitchBehavior
-
What Compose's
Switchsets in code (behavior.yaml, verified at the pin). - SwitchTokens
-
Compose's
SwitchTokens. - TabBehavior
-
What Compose's
Tabsets in code (behavior.yaml, verified at the pin). - TabRowBehavior
-
What Compose's
TabRowsets in code (behavior.yaml, verified at the pin). - TextButtonTokens
-
Compose's
TextButtonTokens. - TextFieldBehavior
-
What Compose's
TextFieldsets in code (behavior.yaml, verified at the pin). - TextStyleToken
-
A type style, as Compose's
TextStyletakes it from the type scale. - TimeInputTokens
-
Compose's
TimeInputTokens. - TimePickerBehavior
-
What Compose's
TimePickersets in code (behavior.yaml, verified at the pin). - TimePickerDialogBehavior
-
What Compose's
TimePickerDialogsets in code (behavior.yaml, verified at the pin). - TimePickerTokens
-
Compose's
TimePickerTokens. - ToggleButtonBehavior
-
What Compose's
ToggleButtonsets in code (behavior.yaml, verified at the pin). - TonalButtonTokens
-
Compose's
TonalButtonTokens. - TooltipBehavior
-
What Compose's
Tooltipsets 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
WavyProgressIndicatorsets in code (behavior.yaml, verified at the pin). -
What Compose's
WideNavigationRailsets 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.
- 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.
mis Material's (ListTokens.ItemLeadingAvatar*: 40dp, initials intitleMedium); 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 (CONTRACT Β§3).
- 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 .FlexibleHorizontalArrangementand.FlexibleFixedHorizontalArrangement). - ExpressiveElevationLevel
-
An elevation level (Compose's
ElevationTokens) and its height. - ExpressiveExpression
- The expression budget: how many hero moments an app may spend (CONTRACT Β§3), 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 (CONTRACT Β§2, "Motion").
- ExpressiveMotionSpeed
- A spring's pace: Compose's fast, default and slow.
-
How a bar spreads its destinations (Compose
ShortNavigationBarArrangement). - How the Android register's navigation bar is drawn: Android's two system navigation modes.
-
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.LeadingButtonand itsTonalβ¦,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
FloatingToolbarColorsdefaults). - 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;sansSerifis 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 aPopScopein the route refuses the route's own (Flutter's ModalRoute asks thePopScopes 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
(CONTRACT Β§5): 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
baselinetheme, baked: its record and each foundation's part. - expressiveBloomTheme β const ExpressiveBakedTheme
-
The
bloomtheme, baked: its record and each foundation's part. - expressiveCapHeightFactor β const double
-
Roboto Flex's cap height over its em (its OS/2
sCapHeightover its head table'sunitsPerEm): 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
embertheme, 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 asIconData.fontPackage. - expressiveGroveTheme β const ExpressiveBakedTheme
-
The
grovetheme, 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
PageTransitionsThemeof both Materials, Flutter's and material_ui's: - expressiveSlateTheme β const ExpressiveBakedTheme
-
The
slatetheme, 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
queryfindstext: 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'sAccessibilityFeatures.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'sMenuItemButtonlabels 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'sspring(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
springfromfromtoto, starting atvelocityunits per second, that settles attoleranceand lands exactly onto. -
designSwipeBack(
Map< TargetPlatform, PageTransitionsBuilder> builders, {Set<TargetPlatform> platforms = const {TargetPlatform.iOS}}) β Map<TargetPlatform, PageTransitionsBuilder> -
builderswith the entries forplatforms(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 namingownerunlessrolescarries 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 -
cubicsas one closed path (Compose'spathFromCubics). -
expressiveCustomPolygon(
{required int reps, required double centerX, required double centerY, required bool mirroring, required List< ExpressivePointNRound> points}) β ExpressiveRoundedPolygon -
MaterialShapes.customPolygon:pointsrepeatedrepstimes around (centerX,centerY) β or,mirroring,2 Γ repstimes, 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 -
familyunder the name Flutter registers it by:RobotoFlexwhen the app bundles it,packages/material_expressive_ui/RobotoFlexfrom 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 tomaxItemSize) with a small item peeking β both sides whencenteredand there are three or more items. -
expressiveIsSpatialKey(
ExpressiveMotionKey key) β bool -
Whether
keyis a spatial spring (it moves, resizes or reshapes) rather than an effects spring (opacity, colour): Compose's*Spatialversus*Effectsmembers ofMotionSchemeKeyTokens. -
expressiveLibraryPolygon(
ExpressiveMaterialShape shape) β ExpressiveRoundedPolygon -
shapenormalized into the unit square, built once: what Compose'sMaterialShapes.<Name>returns. -
expressiveLibraryShape(
ExpressiveMaterialShape shape) β ExpressiveRoundedPolygon -
shapeasMaterialShapes.ktbuilds it, before.normalized(). -
expressiveLibraryShapeCubics(
ExpressiveMaterialShape shape) β List< List< double> > -
shape's cubics, normalized into the unit square as Compose'sMaterialShapes.<Name>holds them, each a list of eight numbers: for tests and tools. -
expressiveLibraryShapePath(
ExpressiveMaterialShape shape, Rect rect) β Path -
The outline of
shapeinrect, as Compose'sRoundedPolygon.toShapelays 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'sRoundedPolygon.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, inshapes' 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 ofpreferredItemSizeas 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,
thicknesswide incolor, roundshapelaid onrect:offsetout 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 inbrightness, at the theme's own contrast or, givencontrast, 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 inbrightness. 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 inbrightness(shapes do not vary with it). -
expressiveResolveTextTheme(
ExpressiveBakedTheme baked, Brightness brightness) β ExpressiveTextTheme -
baked's type scale inbrightness: the one scale, whatever either. -
expressiveRotated(
ExpressiveRoundedPolygon polygon, double degrees) β ExpressiveRoundedPolygon -
polygonthrough Compose'sMatrix().apply { rotateZ(degrees) }. -
expressiveScaled(
ExpressiveRoundedPolygon polygon, double x, double y) β ExpressiveRoundedPolygon -
polygonthrough Compose'sMatrix().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 transformedbackProgress, on ascreenwhose collapsed bar stood atcollapsed(Compose'sFullScreenSearchBarLayoutmeasure 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
springtakes to carry a 0β1 progress to rest at the kit's designSpringTolerance: a spring route'stransitionDuration(wave decision F11). 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 withdrawerthe 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 thangapand at mostmostremain.ticksare evenly spaced,widthstheir label widths andscalelogical pixels a unit of the span. -
expressiveSpringTokenOf(
ExpressiveMotionScheme scheme, ExpressiveMotionKey key) β SpringToken -
The generated spring token of
keyinscheme: Compose'sExpressiveMotionTokensorStandardMotionTokens. -
expressiveTextLayout(
TextStyle style) β (TextStyle, TextHeightBehavior) -
styleand 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
roleatsize, 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 ofitemSizefrom 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 oflabelsneeds, up to the width it is given (Flutter'sDropdownButtonis 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'sScaffoldMessenger.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 ofsize, swiped fromedge, the finger having moved vertically fromstartYtotouchY: 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
palettein a modal route over a barrier;surfaceBuilderpaints 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, ExpressiveComponentThemeData? style}) β Future< T?> -
Shows
builder's content in a modal bottom sheet (Material'sshowModalBottomSheet, Compose'sModalBottomSheet), 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, }) β Future< T?> -
Raises the dialog
builderbuilds (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 unlessbarrierDismissibleis 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 ofentries) againstanchor, a rectangle in global coordinates, or againstcontext's own box (Material'sshowMenu, Compose'sDropdownMenu); resolves when it closes. Closed with nothing chosen (Escape, a tap outside, Back), it gives the focus back to what opened it undercontext, even a button the pointer pressed, so Enter opens it again. -
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 againstanchor, a rectangle in global coordinates, or againstcontext'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
messageas a snackbar (Material'sScaffoldMessenger.showSnackBarwith aSnackBar, Compose'sSnackbarHostState.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+onActionadd ONE inline action β the undo pattern; tapping it dismisses the snackbar and runsonAction.withDismissActionadds the close button;actionOnNewLineputs the action under a long message.durationdefaults 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.
initialModepicks the face (the dialog's toggle switches to typing and back);vibrantthe vibrant dialog (always so for the scroll face);is24Hourfollows the platform's setting when null. -
withPlatformWords(
BuildContext context, Widget child, {bool overlay = false}) β Widget -
childwith 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);statesare 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
detailslets 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) forstates: 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:
presentoftotalrows carried. - DesignInventoryRowBuilder = Widget Function(BuildContext context, DesignInventoryRow row, DesignInventoryEntry? entry, Widget? specimen)
-
Builds one row in a DesignInventoryGallery.
entryis null when the inventory does not answer the row;specimenis 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. - 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
fieldand itsdecrementandincrementbuttons. -
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< Function(String query)T> > -
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'sCupertinoAdaptiveTextSelectionToolbar.buttonItems) or draw its own.itemsis 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).childis 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
optionmatches 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
Tatt(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;
restoringis 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.