comic_parts library
Helpers for customizing components copied from comic_ui.
Import this library in the copied widget to use its theme and component helpers.
import 'package:comic_ui/comic_parts.dart';
Outside semver: this library may change in any version, a patch included; the CHANGELOG says how to move.
Classes
- AnimatedComicShape
- Builds builder with shape, easing to each new shape over the motion's state duration (a cut under Reduce Motion). Flutter interpolates the border and its corner sizes. A null shape builds at once with null: the part draws its own.
- AnimatedComicTheme
-
Animates to a new data over duration (200 ms, Material's
AnimatedThemedefault), asAnimatedThemedoes: colours blend through ComicThemeData.lerp. - CapLabel
- Draws child, a control's one-line label or a one-line text entry, with its capitals on its box's middle. The cap height is the display face's when display says so, else read from the child's style when it is a Text set in the display face, else the text face's.
- 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. - ComicActionLines
- Action lines alone, in any colour: every other wedge of a sunburst, behind a child.
-
ComicActionSheet<
T> - A short list of choices raised from the page's foot on the bottom sheet's face, each a full-width row, with a cancel under them. showComicActionSheet raises it and returns the chosen value.
- ComicAmountRow
- A row of a measured list: an amount in a fixed column, then what it's of, a small note after. Ingredients, parts, a kit list.
- ComicAnchorFace
- Marks a dropdown's drawn face inside the room comicDropdownWidth gives it; comicAnchorFaceOf finds it.
- ComicAppBar
-
A page's top bar: the route's way out, the app's name or the page's title in the lettering, the app's places on a desktop, and
the page's own actions at its end. A page never authors its own back or close: leave leading unset, or pass autoLeading
to key it. On a desktop the title moves to the head of the page's column. logo stands in place of the logo, such as a
ComicGroupChip. - ComicAreaChart
- A ComicChart with the area under each line filled: a running total, a level over time.
- ComicArtBand
- An illustrated band with an optional caption and sound effect.
- ComicAutoRow
- Columns as wide as their content wants, pushed apart. If they don't all fit, each starts at its longest word and shares what is left, up to what it wants: the one that fits stays on one line, the long ones wrap.
- ComicAvatar
- A framed photo with an initials fallback while loading or on failure.
- ComicAvatarGroup
- Overlapping framed faces, followed by the number of remaining people.
- ComicBackButton
- The way out of a pushed page or a sheet: a square arrow, or a cross.
- ComicBadge
- A count in a small square caption, with room for large text.
- ComicBalancedText
-
text-wrap: balance: finds the narrowest width that keeps the same number of lines, so no line ends alone. The balanced box stands where textAlign says: in the middle by default, at the start for a start-aligned paragraph. - ComicBalloon
- A speech balloon: paper at any hour, its words in caps, a by-line under them. It sizes itself to its words at any width, and the tail is part of its outline, so no words can part them. It hugs its words at its column's start; fill takes the column instead. room counts the tail in its size (take it off where a speaker stands in the gap). tailAt points the tail, 0 to 1 along its edge.
- ComicBanner
- A status panel with a mark, words and optional action.
- ComicBar
-
A bar in a box: its fill true to value of of, its dots on whole device pixels. height up from 18. It takes the width it's
given. A zero value is a bare track; a value past the whole fills it. Words go beside it, not on it, unless a
ComicStamp: give it a label and it stands under its own head, the label at the start and its figure (the value if left out) at the end, read together. - ComicBarChart
- A ComicChart of grouped bars: amounts side by side, one group a label.
- ComicBareEditor
- The text field's editor without its frame: the frame is the row's own.
- ComicBarEntry
- A row of a bar list: a head or a word, a name, its bar, its figure.
- ComicBarList
- A ranked list of bars on one scale: a roll call, a rating's spread, the top of anything. of is the whole; the largest if left out. An empty list draws nothing.
- ComicBenDay
- A dot screen for wordless illustrations.
- ComicBeside
-
An object beside its words: a portrait, a mark, a small chart or picture. The object keeps its size up to
maxObject of the width; the words take the rest. If the words would get under minWords, they go under the
object instead, so a column never crushes to a letter a line. Never write this as a
Rowwith anExpanded. - ComicBottomSheet
- A scrollable inked sheet, with a close control and optional actions.
-
ComicBottomSheetRoute<
T> - A sheet that slides up over a plain ComicScreenScrim. The sheet is centred and at most 640 logical pixels wide.
- ComicBrand
- The app, as its chrome names it.
- ComicBreadcrumb
- Where a page sits in a hierarchy: each ancestor a link, the current page last and plain. It wraps on a phone.
- ComicBurst
-
The one number a screen shouts: a jagged star with a hard back plate, a number in it, a word over and under. It fits any
number, scaling its words down whole, and it can't clip. One per screen: a second under the same
ComicScaffoldcomes out as a flatComicStamp, with a line in the log. For small repeatable counts useComicPop, and for a statusComicStamp. - ComicBurstFit
- The lines of a burst fitted into its star: laid out once, scaled down whole until no point along any line's edges stands within clear of the star's edge. So a number of any length fits, and never clips.
- ComicBurstLedger
-
A screen's one burst.
ComicScaffoldholds this: the firstComicBurstunder it takes the place, and any other draws itself as a flat stamp and says so in the log. - ComicButton
- A button: the plain outlined box by default, ComicButton.filled for the screen's primary action, ComicButton.text for quiet words with no box. isDestructiveAction draws any of them in the danger tone, as Cupertino names it.
- ComicButtonGroup
- Related actions joined in one trough, the segmented control's: each its own press, its wash and ring concentric with the trough, none chosen (for one that stays on, a ComicToggleGroup). Each takes its own width.
- ComicButtonGroupItem
- One action in a ComicButtonGroup.
- ComicButtonRoom
- Keeps a button at its content width on screens at least 600 pixels wide when its parent would stretch it beyond comicDropdownMost.
-
ComicButtonSegment<
T> - A segment's value, label and optional glyph.
- ComicCalendar
- A calendar for selecting a day, a range of dates or several days. The controller sets the selection mode. Arrow keys move by day or week, Page Up and Page Down move by month, and Home and End move to the bounds of the week.
- ComicCaption
- A narration caption: the square box a narrator talks from. By default it hangs in its panel's top corner, ruled on its two open sides. free stands it alone with all four edges, to lay over art. tight is the size for a small panel.
- ComicCard
- An inked card with a title and a stack of content. Given a height (cards sharing a row), a child wrapped in ComicGrow takes the slack, so what follows it (an action) stands on the card's foot, on one line across the row.
- ComicCarouselView
- A row of panels that slides sideways one at a time: the next one peeks at the edge, page dots below say where you are, and on a wide window a step back and a step on stand beside the dots. Each item is clipped to the medium corner, so pictures follow the shape theme.
- ComicCast
- One of a lineup: a name, a portrait widget, or a picture from a media slot, and whether it's you.
- ComicChapterPanel
-
A chapter: a band of art with a caption, a lettered head on a well, then its rows, usually
ComicTimedRows withinset: 14. Three of these side by side read as a book of days. - ComicChart
- A chart of one or more series, drawn as its type: inked lines with square point marks, an area filled under them, or grouped bars, over a zero baseline with gaps, an optional target band, a value axis, the x labels and a legend. Hover, a touch or the arrow keys show a point's values in a plate. With no values it says so; loading holds its place.
- ComicChartBand
- An optional target range behind a chart.
- ComicChartSeries
- One named series; a missing value breaks the line.
- ComicCheckbox
- A square tick box, with its tap target around it.
- ComicCheckRow
- A labelled checkbox row with a full-width target.
- ComicChip
- A short filter or quick reply, as wide as its word, on the family's capsule step. It wears the lamp when selected; a choice is lit, not acted on.
- ComicChoice
- One choice in a ComicChoices: its words, an optional small line, and the value it stands for (its words if left out).
- ComicChoiceBox
- The box of every option: a contour on the control's fill; selected, it wears the lamp, and everything in it reads on that by itself.
- ComicChoices
-
One choice from a few, as tiles: a filter, a grade, a size, a kind. Give it the words: on a phone it puts as many on a row
as hold their longest word, and the rest on the next rows, so no tile crushes; from 600 up each tile keeps to its words
(its name over its note), side by side. Never write this as a
RowofExpandedboxes. The selected tile wears the lamp. - ComicChromeMetrics
- Shared measures of Comic's page and controls.
- ComicChromeScope
- What every page under the shell reads: the app's name and its places.
- ComicCircularProgressIndicator
- A twelve-point burst whose ink advances with progress, or turns while waiting.
- ComicClaim
- A sentence with its one figure lit: "You owe Sam €19." A head or a mark at its start, the words in the lettering, a quiet line under them. For the panel that tells someone where they stand.
- ComicColors
- Colours. Grounds first, then what stands on them.
- ComicColumn
-
A column that is safe everywhere. Children stretch to its width. Under a bounded height (a card in a
ComicRowon a desktop) theComicGrowchildren share the requested height, floored at their own height. A single growing body under a loose height ceiling can keep its natural size or expand up to that ceiling; under a scroll view children take their own height. Use it in place of Column + Expanded inside any card. -
ComicCombobox<
T extends Object> - An editable field that shows matching options in a menu.
- ComicCommand
-
A field over a list of commands that narrows as you type; arrows walk it and Enter runs one. Stands inline on a
page. showComicCommand raises the same palette over the page, for Ctrl+K. A command's
data, when it is anIconData, is drawn beside its words. - ComicCompactScope
-
What a
ComicPanel(compact: true)tells the star inside it; a star asks with comicCompactHere. - ComicComponentThemes
-
Every component theme in one, as
ThemeDataholds Material's: whatComicThemeDatacarries and lerps. - ComicCover
- The cover: the look's whole home, once. Action lines and two fading halftones on a process-colour ground; an issue box, a price box and a date box in its corners; a big outlined masthead; a subtitle with its emphasis lit; one burst; someone in a balloon whose tail finds them in the lineup; a cast shoulder to shoulder at its foot. The boxes say any neutral thing: "No. 27, plans this year". On a phone in a compact panel it's a band of 130 lp: masthead, the issue box, a small burst.
- ComicCoverBox
- One corner box of a cover: a big line in the lettering, a small one under it.
- ComicCoverBurst
- The words of a cover's burst.
- ComicCoverPrint
-
Action lines radiating from one point, with halftones fading in from two corners, over a child. It fills the box it's
given and crops to it like an SVG's
slice, so it composes at any shape. No per-frame work: it stands in aRepaintBoundaryand redraws only if it's resized. Put words on it only inside a paper or caption box, or inComicLettering: nothing small reads on rays and dots. - ComicCrumb
- One step of a ComicBreadcrumb trail: its words and where a press goes. The last step is the current page.
-
ComicDataTable<
R> - A table of records the reader can sort, page and pick from: press a heading to sort, press a row or its box to pick it; arrows walk the rows. For a few plain facts use ComicTable. Too narrow for its columns, it scrolls sideways.
- ComicDatePicker
- A seven-column month that grows to fit the scaled day numbers. Arrows move by day or week; Page Up and Down change month.
- ComicDateRangePicker
- A span of days on a ComicCalendar in range mode, with the span written above it. The first press starts it, the second ends it; onChanged hears a whole span.
- ComicDensity
-
How compact the controls stand, as Material's
VisualDensity: each step of vertical takes 4 from a control's height and each step of horizontal 2 from its padding at either side, from -4 (tightest) to 4 (roomiest). The touch target does not move: 48 where a touch reaches the control, 44 elsewhere, whatever the density, so a compact face stands in the same target with room around it. - ComicDescriptionItem
- One term and what it means, in a ComicDescriptionList.
- ComicDescriptionList
- Terms and their details between rules: the term in the lettering over its detail on a phone, beside it on a wider page. A screen reader hears each pair as one.
- ComicDialog
- A square inked panel with a lettered title and wrapping action row.
-
ComicDialogRoute<
T> - A dialog that springs into view over a plain ComicScreenScrim. The dialog appears immediately when reduced motion is enabled.
- ComicDisclosure
- A section that opens in place. Use expanded for external control.
- ComicDivider
- An inked rule between parts of a page: across (Axis.horizontal) or down a row. With label the words stand in the middle of the rule, in the lettering ("or", a date).
- ComicDotFade
- A halftone that fades, as on a cover: dots largest at from and gone by reach, in the design's own box (see ComicCoverPrint).
- ComicDotsScope
- Uses the primary text colour for secondary text on a tinted surface.
- ComicDroppedFile
- A file in a ComicFileUpload's list: its name, its size in words, how far it has gone up, and what went wrong.
- ComicEmptyState
- A section with nothing in it yet: a drawing of your own if you like, a lettered title, a line, a way forward.
- ComicEqualRow
-
Children side by side, widths in proportion to
flex, all as tall as the tallest. Each child is measured first and then given the row's height, so a card can hold anything, andComicGrowlists inside take up the slack. - ComicErrorState
- When a page's data could not load: what happened, and a way to try again.
- ComicEventPanel
-
Something coming up: a date in its caption, a title, where, who's in, a count. Its drawing or picture stands in a cell at its
end on a phone and a band on top on a desktop. big is the one that's the star of the row: it counts down with count in
the lettering, on a tinted ground. Lay them in
ComicTier(phone: ComicTierLayout.stack). - ComicFace
- Data for a face pile.
- ComicFacts
- Figures in equal cells on a contour: a lettered value, a quiet word under it. Four across on a phone if they fit their words, else two; one row on a desktop. An empty list draws nothing. Stand it at the foot of a panel or a splash (bare takes off its top rule to stand it free).
- ComicFigures
- A row of two to four figures in wells, the last on the lamp if highlightLast: a recipe's times, a booking's nights. Lettered numbers, quiet words under them.
- ComicFileUpload
- Where files come in: a well that invites a drop, a button that opens the caller's picker, and the files chosen so far, each with its progress, its error and a way to take it off. The package reads no file system: onChoose opens the app's own picker, and onDrop takes whatever an in-app drag lets go over the well (a desktop or web app wires its platform's drop to it).
- ComicFill
- A part that fills the width it is given, up to maxWidth, and past that stands in the middle of the room. With an aspect it keeps it whatever it is handed: a stretching Row asks for a height as well, and a bare AspectRatio gives in and distorts the art. A Row with no width to give gets loneWidth, so the part stands small and leaves the row its words.
- ComicFitRow
-
A row that can't overflow, and works inside a plain
Row. One child,fill, takes what is left; the others keep their natural width, measured last to first, each leaving at leastfillMin(orfillShareof the row, or the fill's longest word, up to half the row) for it.shrinkmakes the row only as wide as its content, for a mark and a label. - ComicFlow
- Many amounts flowing into one, as ribbons drawn to scale: each ribbon's width is its amount, and they stack to the total, so a reader sees who gives most. It can be money, hours or tonnes: each ComicFlowFrom.figure's words are yours. It keeps to any width, and any number of rows scales to its height limit. No rows draws nothing.
- ComicFlowFrom
- One source of a ComicFlow.
- ComicFocusRing
- The keyboard's focus ink and room. A focused part pops: it lifts up and to the start off a hard print of its outline in the plate's ink, width down and to the end. color inks that print where the plate's ink would not show on the ground beside the part (a light control at night), and a splitter's handle. width and gap together are the room a focused part keeps from what stands beside it.
- ComicFormat
- Formats English dates, 24-hour times, durations and numbers for Comic captions.
- ComicFormField
- A labelled group in a form: a label, then the control, a line of help under it.
- ComicGlyphs
- The one icon set used by Comic and its kit adapters.
- ComicGridOf
- A fixed number of equal columns at every width (chips, date chips, stats), each row sharing its height.
- ComicGroupChip
- A group's chip for a bar: its overlapping heads and its name in the lettering, and a arrow if it opens a switcher.
- ComicGrow
-
Marks a child of a
ComicColumnas taking a share of the slack (CSSflex: 1). - ComicHighlight
- A plain ink tint under the pointer or a press, and the keyboard's pop: under the focus the part lifts up and to the start off a hard print of its outline, down and to the end, its words on a plain fill. The tint is uniform across the lettering.
- ComicHost
- The app's host, mounted once around the router's navigator: Comic's theme, ground and text defaults.
- ComicHoverCard
- A card that comes up while the pointer rests on child, or the keyboard is on it, and goes when it leaves: more about a name, without a press. What it says must also be reachable some other way; touch gets it on a long press.
- ComicIconButton
- A square button with one icon, for a bar or a row. It keeps its size at its column's start, and needs a label for a screen reader.
- ComicIndicia
- The small print a comic carries at its foot: who made it, and what this page is. Put it last on a page that has a colophon to give; it isn't automatic. A bold first word if you give lead.
- ComicInput
- A one-line text field the generated stubs draw; ComicTextField is the same field with more to say.
- ComicInputGroup
- A text field with optional leading and trailing widgets in a shared frame. The frame highlights when a child has focus. Tapping the frame or a noninteractive accessory focuses the text field.
- ComicInputOtp
- A one-time code, one inked box a digit, with the platform's one-time-code autofill. A paste fills it, a long press or a secondary click offers Paste, and a screen reader hears one field.
- ComicKbd
- A key on the keyboard, or a run of them, as a small cap standing on its own edge: Ctrl, K, Enter. Words beside it say what it does; a screen reader hears the keys joined by "plus". ComicKbd.shortcut takes its keys from a shortcut, as the platform orders them and the reader's language names them.
- ComicKvRow
- A label at the start, a value at the end, on one baseline, and share if there's a third figure, in the lettering or the number face by its size. Neither word crushes the other.
- ComicLabel
- A small label in caps: a form field's name, a column's name.
- ComicLedgerRow
- A dated line of a ledger: a small date, a title and its meta, a lettered value at its end.
- ComicLettering
-
Outlined lettering: the concept's stacked
text-shadow, as one part. It lays out once and paints that one layout in every layer, so the layers can't come apart in RTL or on a wrap, and it stays vector at any scale: no blur, no filter. Lettering is set in caps. fit shrinks one line to the width, for a masthead. Its box is the words' box; the outline paints outside. - ComicLetteringScope
- Re-scopes everything under it for words on a filled ground: every ink answers with letters.
- ComicLetteringStyle
- How lettering is outlined: contour width, then the layers behind it from nearest to farthest.
- ComicLetters
-
Words in the lettering, in caps, plain: a panel's title. Pass any
t.typestyle from the lettering set;panelif left out. - ComicLinearProgressIndicator
- A ruled progress strip. Unknown progress advances a small inked segment.
- ComicLineChart
- The chart row's three names (the shared stems): a ComicChart of inked lines, of an area under them, or of grouped bars. Each takes ComicChart's own arguments, the form aside.
- ComicLineup
- A cast standing in a line, shoulder to shoulder, each over a name plate. On a phone their shoulders overlap a little, as a cover's do. An empty list draws nothing. Names scale down to their plate rather than wrap.
- ComicLink
- A textual navigation action, underlined and announced as a link.
- ComicList
-
Stacks rows and shares a panel's slack evenly among them, so a list in a taller panel doesn't end on a hole. Wrap it in
ComicGrowwhen it should take that slack. - ComicListSection
- A ruled group whose rows retain their own semantics and controls.
- ComicListTile
- The list row: a mark, a title and its meta, a figure or state beside them, an action. Any row of a list that holds more than a label and a value is this one, with or without the action. A compact action stays beside the words when their measured widths leave a readable text column; long actions and enlarged text stack. Rows with both a trailing value and an action keep the action below on narrow screens.
- ComicLoadingState
- While a page's data is on its way: a thought with three dots in it.
- ComicLocalizations
-
The words only Comic's parts say when the caller gives none; the shared ones are
DesignLocalizations. English ships (ComicLocalizationsEn); another language is a subclass and a delegate that loads it. With no delegate installed, the parts speak English. - ComicLocalizationsEn
- Comic's English words.
- ComicLogo
- The app's name as a logo: lettered in the lamp with an outline and a hard double drop.
- ComicMarkPanel
-
A memory or a past thing: a band of colour with a drawn object and a sound effect, then a lettered line and a few words on
paper. ground is 1 to 4. Keep the words short: this is a panel of a strip. In a
ComicTier(phone: ComicTierLayout.strip)these make a wall; give two in aComicTier(slanted: true)the page's one lean. - ComicMedia
- A picture from a declared media slot, in a square contour. Until it loads, or if it never does, a screen of dots a step off the panel and an empty burst on them: at night that stays dark, so a shelf of them isn't a wall of lit blocks. It takes the width it's given and sets its height by aspect.
-
ComicMenu<
T> - A menu that marks the selected item with a yellow fill and check.
-
ComicMenuAnchor<
T> - Wires a menu's anchor without exposing a render box to the app. A list that opens from a field (matchAnchorWidth) marks the field's current value (ComicMenuItem.selected), as a ComicSelect's list does: it opens on that row, which carries the check.
- ComicMenuBar
-
A row of menus across the head of a desktop window, each dropping a list of commands with their keys; arrow keys
walk the bar and the lists. An entry's
data, when it is anIconData, is drawn beside its words. -
ComicMenuItem<
T> - One option in an inked menu. Disabled options remain readable.
- ComicMenuOpen
-
Holds whether the menu of the
ComicMenuAnchorabove is up. - ComicMenuRowFace
- A menu row with a solid tint for hover and a check beside a selected label. The row grows to fit large text and the configured touch target.
- ComicMeter
- A measured quantity with a value, unit and ruled bar.
- ComicMoreLink
- A way to more: a word and a arrow in the group's colour. A small tap target of its own: 44 tall.
- ComicMotion
- Comic's motion: a page being turned, quick and snappy, with a small overshoot where a panel pops. A press lands in press; a control's state (a switch's thumb, a check inked in, a selected segment) moves in state; what moves across the page in move; what pops over it in raise (a dialog, a menu), or travel from the page's foot (a sheet), and leaves in leave. Under Reduce Motion, and in every shot, each is a cut: read them through of or durationOf.
-
ComicMultiSelect<
T extends Object> -
Several values chosen as tags in the text field's frame, with an editor after them that suggests more as you
type, on the menu's raised face. Down or Up opens the suggestions (every option not yet chosen, until words are
typed), and the keys wrap at their ends; Enter takes the lit suggestion (or, with onCreate, the typed words);
Backspace on an empty editor steps onto the tags, and Backspace or Delete removes one. The behaviour is the design
kit's
DesignTagInput. - The phone's tab bar: the current tab in a lamp's square, the app-level act a small balloon rising from the middle.
- A permanent side navigation panel for a wide layout.
- A narrow side rail of destinations for a medium or wide window: each an icon in its indicator over its short word, the current one lit as the phone's ComicNavigationBar lights it. leading (a logo, an act) stands above them and trailing below. A phone keeps the bottom bar; a window wide enough for whole labels takes ComicNavigationDrawer.
- One application destination, with its labels, glyph and activation callback.
- ComicNumberField
- A number stepper: one trough at a field's height, less and more as square cells at its ends and the lettered count with its unit between them; a note under it. A press marks its cell concentric with the trough.
- ComicOutward
- Stands child margin outward on each side and takes no room for it: the room a press keeps round a face with no surface at rest (a radio row's sides, a quiet button's start) is painted only (its wash and ring), while the face starts on its column's edge. A tap and a screen reader reach the box it takes, never the room: the area a tap reaches is the box a screen reader outlines. With inwardWhenHeld, a parent holding it at a set width (a stretching column) keeps the room inside, so a stretched button's words stay centred in the room it is given.
-
ComicPage<
T> - The router's page for a route pushed off a root, on the theme's ground.
- ComicPageDots
- Page indicators: a small caption mark a page, the current one longer. With onChanged the row is one control, as a phone's page control is: a press on a mark goes to its page, the arrow keys step (Home and End to the ends), and a screen reader adjusts it as a slider. One target, the whole row's height, instead of a row of small ones each inside its neighbours' reach.
- ComicPageTransitionsBuilder
-
Comic's page change: a cut, as the eye jumps to the next panel. A page pushed or popped stands in its place at full
ink in its first frame: nothing travels in from a side, fades or zooms (laws 1 and 3). ComicTheme gives it to the
routes it reaches (Comic's own pages among them); an app's
MaterialAppgives comicPageTransitions to its own theme, so aMaterialPageRouteit pushes cuts too. The cut alone takes no swipe: comicPageTransitions wraps it on iOS in ui_core'sDesignSwipeBackPageTransitionsBuilder, which keeps the swipe from the leading edge; a map of your own does the same. - ComicPagination
- Pages of a long list: a step back, the page numbers around the current one (the first and last always, a gap marked between), and a step on. Where the numbers don't fit, it says "Page 3 of 12" between the steps. page is zero-based.
- ComicPanel
- The panel: a 3 px square contour on a fill, with an optional caption in its corner. Every box on a page is one of these. It takes the height its tier gives it, and its child grows to fill that. Children: anything. bleed takes away the inside, for art that runs to the contour. compact asks a star inside for its short form on a phone.
- ComicPanelHead
- A panel's head: its lettered title, a quiet line under it, a way to more at its end.
- ComicPanelStack
- A column of panels inside a tier, with the page's gutter. grow lets its last panel take the height the tier has left, so the column ends level with its neighbour rather than on a blank third.
- ComicPasswordField
- A password field with a visibility button that preserves the caret position. When hideOnBlur is true, leaving the field hides the password.
- ComicPeople
- A row of people, tightly. Past max it counts the rest as a small "+3". An empty list draws nothing. overlap is the group's stack. It stays on one line, at its column's start.
- ComicPerson
-
A person in a ring: a picture from a media slot if you have one, a portrait widget if you supply one, or else their initials. Any
name goes in label. isCurrentUser is the viewer, marked in the act colour. out is someone who isn't coming: a dashed ghost.
It keeps its size at its column's start.
Use
ComicPerson.seeded('Sam Doe')to derive the initials from a name. - ComicPictureCard
-
A picture over its words, bleeding to its panel's contour: one piece of a collection, a place, a person. The picture is your
media slot. Lay them out in a
ComicTier. - ComicPieChart
- An inked pie with its largest slice pulled out, a figure in the middle, and a key of what each slice is. It keeps its size and stands at its column's start on a phone. Four slices read best; up to six get their own inks. All zero draws an empty ring.
- ComicPlated
- A raised face with a fixed ink shadow. When down is true, the face moves toward the shadow. shape defines both outlines.
- ComicPop
- A small count that pops off its row: the leader of a poll, a score. Any number of them, since each is only a count. Any number fits.
- ComicPopover
- A small raised panel that opens from whatever anchorBuilder draws, pressed: a filter, a colour, a few settings. Press its anchor again, press away or Escape to close it. For a list of commands use a menu; for a modal question, a dialog.
- ComicPressable
- An accessible press target for a custom control.
- ComicPreview
- One page's isolated preview: the same host, tab bar, route and sheet the app gives it live, without the router.
- ComicPrintGround
- Supplies the solid colour painted behind each line of display lettering.
- ComicProgressCells
- Progress cell by cell: completed lit, started dotted, the rest empty, of total. Eight to twenty read best. It takes its column's width.
-
ComicRadio<
T> - One radio choice and its optional explanation.
-
ComicRadioGroup<
T> - A group of exclusive choices, drawn as small inked caption boxes.
- ComicRaised
- A dismissible overlay and the future that completes when it is gone.
- ComicRaisedFrame
- A menu or popover frame with a themed fill, rim and inner padding.
- ComicRand
- A small repeatable random: a burst's jags and a seed's pick don't change between runs or devices.
- ComicRangeSlider
- A slider with two handles that select the ends of a range. Pressing or dragging the track moves the nearest handle. Each handle has its own keyboard focus and screen-reader label.
- ComicRating
- A score the reader gives: a row of stars to press, lit up to the one chosen. Pressing the chosen star again clears it when clearable. Each star is its own 44 target with a round mark of its own size; ComicStars shows a score that isn't asked for.
- ComicRefreshIndicator
- A list that refreshes when pulled down from its top: the dial fills as it is pulled, spins while onRefresh runs and ticks when done. Give it a scrolling child.
-
ComicReorderableListView<
T extends Object> - Rows the reader can put in their own order: drag a row by its dots, or long press it; a screen reader gets move up and move down.
- ComicReply
- What you'd say back: your head, a reply field, and its action. The act is a label on a desktop and an icon on a phone. Stands under a thread.
- ComicResizable
- Two panes with an inked rule between them that drags to share the room; arrow keys move it when it has the focus.
- ComicRow
-
A row on the 12-column grid:
ComicRow(spans: [7, 5], children: [a, b]). From 1024 wide the panels sit side by side and share a height, with 16 gutters. Below that they stack with 10 between.ComicTieris the same thing with the comic page's other reflows; use this when every panel holds words. - ComicRuled
- A row with a rule on its top edge. strong is the 3 px contour a total stands under.
- ComicScaffold
-
A page: the top bar, then the page's column on newsprint with its gutter. It holds the screen's one burst (see
ComicBurst). body is usuallyComicSections(children: [...]). A nav root leaves topBar out for the app's bar. - ComicScreened
- Softens an unavailable control's ink while keeping its words distinct on a flat, lightly inked ground.
- ComicScreenGrid
- A screen of dots laid on whole device pixels, so a tile repeats exactly and there's no moiré at any scale.
- ComicScreenScrim
- A uniform veil over the page behind a modal. The route drives its opacity.
- ComicScrollArea
- A scrolling region whose bar is drawn in Comic's ink and stays out of the way until it is wanted. Give child a scroll view on controller; arrow keys scroll it when labelled.
- ComicScrollBehavior
-
How a scroll looks under Comic: a thin bar in the contour's ink on a desktop, the stretch on Android, and nothing of
Material's.
ComicThemeinstalls it. - ComicSearchField
- A search field with a clear control and standard submit behavior.
- ComicSectionHeader
- A section's head, on the gutter between tiers: big lettering, a small word after it on one baseline. If both won't fit on a line the small word goes under.
- ComicSections
- A page's tiers and heads, one under another on the page's gutter: 16 on a desktop, 10 on a phone.
-
ComicSegmentedButton<
T> - Exclusive choices in one trough at a field's height: every segment one width, no dividers, the chosen one a thumb (the trough's outline moved in by its rim and 4 px, concentric under every corner family) that slides to the next choice. When the labels need more space, the segments stack at the reader's text size.
- ComicSegments
- A span of time or a run of steps, each block as wide as its amount, numbered in the lettering: a timeline. The long block wears the lamp. Under each amount its own number, unless you give labels. A block too narrow for its number with air both sides leaves it out of the bar, to the key under the bar and its scale: its swatch, its number and its amount, in order. A number is never squeezed, laid over a rule or left loose under the bar. No parts draws nothing.
-
ComicSelect<
T> - A field that opens Comic's keyboard-accessible menu.
- ComicSelectField
- A read-only picker: a value, a dim note and a arrow, in a field's box, under an optional label. A screen reader names it by semanticLabel, else label, and reads value after the name.
-
ComicSelectOption<
T> - One value and its readable name in a select.
- ComicSendButton
- The small act at the end of a reply field.
- ComicSfx
-
A sound effect: lettered, tilted, sitting on art. It paints outside its box as lettering does. Colour it by the art ground
under it:
t.colors.sfxOn(ground). - ComicShapes
- One corner scale for controls and surfaces, with square corners by default.
- One part of a ComicShares.
- A whole split into parts: a stacked bar true to its amounts, a scale of what's done against what's left, and a key with each part's words. The first part is what the scale marks as done. A budget, a schedule, a storage meter. No parts draws nothing.
- ComicSheet
- The inked panel a side sheet holds: a title and a close at its head, words that scroll, and actions along its foot. It stands clear of the screen's edges so every corner of the shape family shows.
-
ComicSheetAction<
T> - One choice on a ComicActionSheet.
-
ComicSheetPage<
T> - The router's page for a sheet, raised on the root navigator over the shell: from a phone's foot, as a card in the middle of a desktop. drawer stands it as tall as its content. The screen inside derives its close.
- ComicShellAction
- The app-level act beside the tabs: a small balloon in the tab bar's middle on a phone, at the masthead's end on a desktop. Quieter (a plain square) when accent is off.
- ComicSkeleton
- A placeholder with slowly pulsing dots. The dots stay still with reduced motion.
- ComicSkin
- Skin tones and their halftone shade, for the drawn cast. They belong to the people drawn, so no preset moves them.
- ComicSlice
- A slice of a ComicPieChart.
- ComicSlider
- An adjustable value with keyboard, pointer and accessibility actions.
- ComicSnackBar
- A short announcement printed as a narration panel, with an optional action.
- ComicSpace
- Comic's spacing: the room between and around things, on a 4-point grid, so a page's gaps and insets agree. Parts take theirs from here; the fine steps under the grid (hair, fine, nib) set a mark against its rim. A value off the grid is an optical one, named where it is used, with its reason.
- ComicSparkline
- A trend in a line's height, inline beside a figure: no axes, an inked line over its first series colour, the last value marked. values may hold gaps; a run of continuous values reads best (120 x 32 is a legible size).
- ComicSpeech
- One person speaking in a thread: a head, then a balloon whose tail reaches back at them. It keeps the head's size and lets the balloon wrap, at any width.
- ComicSplash
-
A page's opening panel: a scene or a picture running to the contour, a narration caption, a big outlined title, one burst, and a
bar of facts along its foot. art fills it: a
ComicDrawing, aComicMedia, or aComicArtBand.titleHighsets the title up on action lines with figure at its side and a balloon from the author. In a compact panel on a phone it becomes a band of about 130 lp with the title and a small burst, and drops the facts and the rest: the page's job then shows on the first screen. On a desktop compact keeps all of it at about 380 lp, not 540, so the panels beside it don't end on blank paper. - ComicSplit
- Start and end on one baseline, pushed apart; if they don't fit on a line, end drops under start. CSS flex-wrap with baseline alignment, which Wrap can't do.
- ComicSplitAction
- One more action behind a ComicSplitButton's arrow.
- ComicSplitButton
- A primary action and a menu button in one frame. The label runs the primary action. The arrow opens actions and regains focus when the menu closes.
- ComicStamp
- A rubber stamp: a word or two on paper, tilted, in the lettering. For a status, not a count: Paid, Sold out, In the lead. It hugs its word at its column's start.
- ComicStars
- A score out of stars, drawn: the font has none. Lit on the lamp, the rest empty.
- ComicStateDecoration
- A face's decoration, moving from one state's to the next with ComicStateLerp: what a part draws its fill, rim and print with in place of a DecoratedBox, or, with ComicStateDecoration.box, of a Container that decorates.
-
ComicStateLerp<
T> - The look's one state motion. A face resolves what it draws (its decoration, its ink) for its current states, and this carries value from where the face is to where those states now put it, by lerp, on ComicMotion.state; under Reduce Motion it changes at once. A change that comes mid-way turns from where the face is, with no jump back.
- ComicStatusView
- A screen's whole state in one place: loading, empty, failed or done, each the look's own (the thought balloon's dots, the empty panel, the error panel with its retry, the success caption).
- ComicStepPanel
-
A numbered step: its number in a lamp's corner, a drawn cell with a sound effect, then a sentence and an action. The cell stands
at its start on a phone and on top on a desktop. long is the slow step of a method: on a phone its picture goes over its
words, wide. Lay them in a
ComicTier. - ComicStepProgress
- Progress along a finite sequence; display only, not a row of buttons.
- ComicStrokes
- The weight of Comic's ink, in two steps: standard, the look's own contours part by part, and bold, rims at 4 and a focused part's print at 5. Each step names the widths every styled part's rims and rules read, in logical pixels: hairline for the rules inside a part (the act plate's inner rule, a segment's, a card's second line), regular for a part's rim, heavy for a focused part's print and a chosen part's rim; null keeps the look's own ink contours.
- ComicSuccessState
- A successful result with optional follow-up action.
- ComicSwipeActions
-
A row with commands hidden behind its edge: slide it to show them, press one, or slide all the way to run the first.
A destructive one is inked in the danger tone. An action's
data, when it is anIconData, is drawn over its words. Keep every action reachable another way. - ComicSwitch
- An animated lever on an outlined track, lit by the caption ink while on.
- ComicSwitchRow
-
A setting: a label, a line under it, a
ComicSwitchat the end. The whole row presses, and the label never crushes. - ComicTab
- A tab with an icon, a label and an optional key for its tap target.
- ComicTabBar
- Tabs between views: one trough at the control corner and a field's height, with no dividers, the chosen tab a thumb (the trough's outline moved in by its rim and 2 px) that slides. On a phone every tab takes one width across the bar; from 600 up each keeps to its words and the bar stands at the start. It scrolls sideways when the tabs need more room than the row has.
- ComicTable
- A table that becomes labelled ledger rows below 600 logical pixels.
- ComicTag
- A small square tag: a status, a kind, a count of what's left. It hugs its word. Leave tone off for a plain one.
- ComicTally
- A question said out loud, its options with bars true to their counts and the people behind them, and who's still to answer. Stands in a panel. of is how many could answer. It reads for any vote, ranking or tally of people.
- ComicTapTarget
- Minimum hit areas for Comic controls, in logical pixels. ComicTheme uses 44 for a pointer and 48 for touch. An enclosing DesignTapTargetScope can supply different sizes.
- ComicTextArea
- A multiline field, using Flutter's editor and Comic's selection menu.
- ComicTextContextMenu
-
The menu over a selection: Cut, Copy, Paste, Select all and what else the platform offers, as an inked caption on a
phone and a card of rows by a desktop's pointer. Its words are
ComicLocalizations'. - ComicTextField
- A field on the control surface. onPaper uses the paper surface for a reply by day; by night every field is on the night card. Its outline remains on the same corner scale. maxLines above one makes a note box; trailing holds a send button or a unit.
- ComicTextSelectionControls
- Comic's selection handles: a square ink mark on a stem, under the selection's ends. On a desktop there are none, as a pointer selects by dragging.
- ComicTextTheme
- The type scale. Bangers is the lettering: titles, numbers from 24 up, buttons. Shantell Sans is the text. Every style is already right for the current width. Bangers styles are set in caps by the parts; write them in plain case.
- ComicTheme
-
Puts Comic in scope for everything under it, its type set for the window's width, as Material's
Themedoes. It is the whole install: put one in any app'sbuilder:, under aMaterialApp, aCupertinoAppor aWidgetsApp, and every look installs the same way (<Look>Theme(data: <Look>ThemeData.preset(...))). Under it, Flutter's own text field and scroll bar wear Comic's caret, selection and bar, with no ink.ComicHostputs one at the root; another restyles a part of the tree. AnInheritedTheme, so what a route or an overlay captures keeps the Comic it was raised in. - ComicThemeData
-
What
ComicTheme.of(context)returns: a print run in one appearance, as Material'sThemeDatais a theme. Immutable, with copyWith, lerp,==,hashCodeanddebugFillProperties. - ComicThemeDataTween
- A tween between two Comic themes, through ComicThemeData.lerp.
- ComicThought
- A thought: a scalloped cloud grown from its words, three bubbles trailing to a side. It keeps to its column, wrapping its words to stay on the page, and stands at the column's start.
- ComicTier
-
A tier of a comic page: panels side by side from 600 up (a tablet, a desk), sharing a height and a 16 gutter, reflowed
on a phone (under 600) with a 10 gutter. Give it plain children, usually
ComicPanels. It picks their shares by how many there are: one takes the row, two halves, three thirds, four quarters, five with the last one wider. spans sets them yourself, in parts of their sum, from 600 up only: on a phone the tier reflows by phone and the spans don't hold. Where a column would be under 130 (grown with the text size) it reflows as on a phone, however wide the window. Keep it to two or three tiers before a splash breaks them up. slanted cuts the gutter between two panels on a lean, once a page. - ComicTime
- A value representing a time of day without a Material type.
- ComicTimedRow
- A row with a time or a short figure in the lettering in a fixed column, then a title and a meta: an agenda, a schedule. selected is the row that matters now, a step off the panel.
- ComicTimeline
- Events down an inked rail, oldest first: each a disc on the rail (inked when done, the caption's when now, open when to come) with its title, time and words beside it. The rail is solid up to now and broken after.
- ComicTimelineEntry
- One entry on a ComicTimeline.
- ComicTimePicker
- Time selected from labelled caption menus, wrapping at narrow widths.
- ComicToast
- A brief confirmation that needs nothing back: "Link copied", "Saved". Smaller than a ComicSnackBar, it holds one line and an optional status mark, never an action, and leaves by itself. showComicToast owns its lifetime.
-
ComicToggleGroup<
T> - A group of toggle buttons with a shared selection track. Set multiple to allow several selections. Arrow keys move focus within the group. Space and Enter toggle the focused button.
- ComicToneMark
- A different mark for every meaning, so colour is never the only cue.
- ComicTones
- Four semantic inks, each legible on the current panel ground.
- ComicTooltip
- Explains its child on hover, keyboard focus or long press: ui_core's DesignTooltip in Comic's balloon (ComicTooltipFace), under the child, centred on it.
- ComicTooltipFace
- The balloon drawn by a tooltip, also useful in a static specimen.
- ComicTotalRow
- The row a list of numbers ends on, under the full contour: a word, a big lettered value.
- ComicTrack
- The trough: shape filled with fill and ringed by rim, holding cells in reading order.
- ComicTrackFace
- A cell's face inside a trough: child centred gap inside the cell, with the press's marks in shape, so its wash and its focus print are concentric with the trough and the thumb. Where the row is too narrow for a cell's words they shrink on one line rather than break, so every cell keeps one height and its words their place.
-
ComicTreeView<
T extends Object> - A nested list that opens and closes: folders, chapters, an org chart. Press a parent to open it, a leaf to activate it; arrows walk it and left and right fold it.
- ComicTrough
- A trough round cells it does not lay out: shape filled with fill and ringed by rim over child, which stands the rim in from each end and spans the rim's bands above and below, as a ComicTrack's cells do (a tab bar's strip sits in it). With clip the child is cut to the outline, for a strip that scrolls under the rim.
- ComicTypeface
- The two faces the type is set in: display for heads, numerals and the balance (the look's Bangers), text for everything read (the look's ShantellSans), each from displayPackage and textPackage (the package that bundles it, null for the app's own fonts). The look's faces are the default; an app's own fonts work when it declares them in its pubspec and loads them before the first frame. Each face's cap height (displayCapHeight, textCapHeight) sets its capitals on a control's middle: name it with the face. Sizes follow the platform's text scaling.
- ComicUnitColumn
- One column of ComicUnits.
- ComicUnits
- Counts drawn as stacks of little inked boxes, one a thing: how many plans a month, how many cups a day. Up to about 14 columns at 390. The stacks scale so the tallest fits. An empty list draws nothing.
- ComicVoicePanel
- Someone speaking in a panel of a strip: the time in a caption, what they said in a balloon, their portrait under it, their name on a plate. Four of these make a thread read as a strip, on alternating dots, warm on every other one.
- ComicVote
- One option of a ComicTally.
- ComicWell
- A box inside a panel, a step off its fill: one room of three, one figure of three.
-
ComicWheelPicker<
T> - One value off a turning drum, on ui_core's DesignWheelPicker: the rows roll past a caption band that holds the chosen one. A drag or a fling turns it; Up and Down step it, Page Up and Down by five, Home and End to the ends, and typing jumps to a value's words; a screen reader hears it as an adjustable value.
- 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.
- DisplayFormat
- English display formats for amounts, counts and dates.
- Lettered
-
Marks child as standing on a filled ground whose letters a
ComicLetteringScopechose (a lamp panel, a chosen row): a part popping there keeps that fill behind its words rather than laying its own. - 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.
-
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. - PopInside
- Marks child as a row standing edge to edge with its neighbours (a tree's row, a swipe row's plate): a focus pop there cannot lift over them, so the part's print shows inside its outline instead.
- 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).
- RenderComicAutoRow
- Lays out and paints the ComicAutoRow widget.
- RenderComicBeside
- Lays out and paints the ComicBeside widget.
- RenderComicColumn
- Lays out and paints the ComicColumn widget.
- RenderComicEqualRow
- Lays out and paints the ComicEqualRow widget.
- RenderComicFitRow
- Lays out and paints the ComicFitRow widget.
- RenderComicLettering
- Lays out and paints the ComicLettering widget. It lays out again when the system's fonts change, as a paragraph does: on the web a glyph the faces lack (Arabic in the lettering) comes from a fallback font that arrives after the first frame, and painters laid out before it would keep its boxes.
- RenderComicOutward
- The render box of a ComicOutward.
- RenderComicSplit
- Lays out and paints the ComicSplit widget.
- 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.
- RenderRowLit
- The render object of RowLit.
- RenderRowReach
- The render object of RowReach.
- RingInClip
- Marks content cut at its clipping ancestor's edge (a panel's). Comic's focus pop reaches 3 px past a part, inside the room a part keeps from a panel's edge, so it draws whole there; this no longer changes what is drawn.
- 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.
- RowFrame
- Hands the rows of one group the outline their fill takes, how far they reach past the group's padding on each side, and the group's RowLights.
- RowGroup
- A group's rows, one under another at the full width, drawing into the reach past their own edges.
- RowLights
- Which rows of a group are lit, so the rules beside them stand aside. A rule reads the lit rows' places as it paints, after every row has its place, and repaints when a row lights or goes out.
- RowLit
- Marks a group's row lit while lit, so the rules beside it stand aside.
- RowMark
-
Marks child as drawn inside a row that takes the press;
ComicTapTarget.targetOfreads it as no reach. - RowReach
- A row that reaches reach past its own edges, left and right, in what it draws (its fill, its press's shade); it lays out as wide as its slot, and a tap and a screen reader reach that slot, the one box.
- 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.
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.
- ComicBarFill
-
Which ink fills a bar.
dotsthe group's halftone,leadthe lamp with drama dots,youthe flat act. - ComicButtonSize
- A button's visual scale. Its input target remains at least 48 on touch.
- ComicChartType
- What a ComicChart draws its series as.
- ComicFitAlign
- Vertical alignment of a fitted row's children.
- ComicPanelFill
- Backgrounds for ComicPanel. The tinted fills use full-strength text ink.
- ComicPresentation
- How a page stands in its preview.
-
Which ink fills a share:
lamppaid or done,dotsan estimate,denseDotsa heavier one,dramaDotsthe odd one out. - ComicSpeaker
-
Who a filled label belongs to:
lampis the narrator and today,inka fact in full contour,youis yours,shadethe group,papera plain box. Each brings its own letters. - ComicSplashLayout
- Where a splash's title stands: low over a full scene, or high beside a thing drawn on action lines.
- ComicTail
-
Where a balloon's tail leaves it.
bottomStartandbottomEndhang under it,sidepoints back at a speaker standing at its start,toprises from it,noneis a caption in a balloon's shape. - ComicTierLayout
-
How a tier stands on a phone.
pairs: two across, a lone last taking the row.strip: two, one, two, one, as a comic page breaks up a grid.stack: one under another, for panels of words. - ComicTimelineStatus
- Where a ComicTimelineEntry stands.
- ComicTone
- Meaning expressed by both an ink and a distinct mark.
- 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.
- 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
-
ComicScreenedRoute<
T> - A modal route which lays a ComicScreenScrim of screenInk under its barrier, which still takes the presses. Give the route no barrier colour of its own.
Extensions
- ComicDarkPage on ComicColors
-
The look's own shorthand for a dark page, inside the library:
brightness == Brightness.dark. Hidden from the barrel; a caller readsbrightness. - ComicDarkTheme on ComicThemeData
- The same shorthand on the theme, inside the library.
-
ComicPressStates
on Set<
WidgetState> -
A press's states read by name, for a face that draws its own:
states.hovered,states.pressedand so on. - ComicTextStyle on TextStyle
- Convenient text-style variants used by Comic typography.
- ComicThemeContext on BuildContext
-
context.comicTheme: the theme in scope. - DesignSpringDrive on AnimationController
- Runs an AnimationController on a spring instead of a duration.
- PreviewPlatformDevice on PreviewPlatform
- The platform's device, as data on the enum.
Constants
-
comicCupertinoWordsDelegate
→ const LocalizationsDelegate<
CupertinoLocalizations> - The Cupertino localizations for the current locale, with English as the fallback.
- comicDarkTones → const ComicTones
- Default semantic inks for dark paper.
- comicDeskWidth → const double
- The width where the phone layout becomes the 12-column desktop layout.
- comicDisabledDotPitch → const double
- Legacy dot dimensions for artwork matching the 0.2.0 print screen.
- comicDisabledDotRadius → const double
- Legacy dot dimensions for artwork matching the 0.2.0 print screen.
- comicDisabledScreen → const double
- How far a disabled face is screened back toward its paper: half way, opaque.
- comicDisabledWordsContrast → const double
- Minimum word contrast on a disabled control's fill.
- comicDropdownMost → const double
- The most a dropdown's closed face takes from 600 up (a dropdown's width): its content's width or a form grid's cell, never a whole column.
- comicEmanataGap → const double
- Emanata at the corners of the focus ring Comic drew before its focus became the pop: each tick this many ring widths long and this fraction of its weight, comicEmanataGap clear of the ring, fanned comicEmanataSpread radians either side of the corner's diagonal.
- comicEmanataLength → const double
- Emanata at the corners of the focus ring Comic drew before its focus became the pop: each tick this many ring widths long and this fraction of its weight, comicEmanataGap clear of the ring, fanned comicEmanataSpread radians either side of the corner's diagonal.
- comicEmanataSpread → const double
- Emanata at the corners of the focus ring Comic drew before its focus became the pop: each tick this many ring widths long and this fraction of its weight, comicEmanataGap clear of the ring, fanned comicEmanataSpread radians either side of the corner's diagonal.
- comicEmanataWeight → const double
- Emanata at the corners of the focus ring Comic drew before its focus became the pop: each tick this many ring widths long and this fraction of its weight, comicEmanataGap clear of the ring, fanned comicEmanataSpread radians either side of the corner's diagonal.
- comicFieldWords → const double
- Where a boxed control's words start inside its box, before density: a text field's 16 inside its 2.5 rim. Fields, selects and choices stacked in a panel share it, so their words stand on one inner keyline.
- comicFocusLift → const double
- How far a part lifts up and to the start under the keyboard's focus, off its print, in logical pixels.
- comicFontPackage → const String?
-
The package that bundles Comic's faces, or null when the app does. Every Comic text style passes it as
TextStyle.package. - comicInFieldIcon → const ComicStyle
- The style of an icon button inside a field: no rim, no fill.
- comicLetteringMost → const double
- The largest a control's lettering grows: what a 16 px label reaches at 200%. Comic letters its controls at 18 and 20 px, so at 200% they would stand at 40 px and push a row's neighbours out; they grow with the reader's setting until 32 px and stop there, never below their own size.
- comicLightTones → const ComicTones
- Default semantic inks for light paper.
-
comicMaterialWordsDelegate
→ const LocalizationsDelegate<
MaterialLocalizations> - The Material localizations for the current locale, with English as the fallback.
-
comicPageTransitions
→ const Map<
TargetPlatform, PageTransitionsBuilder> -
Comic's page change for every platform, a map of the widgets layer's
PageTransitionsBuilders: one map fits both Materials'PageTransitionsTheme. Comic's own Material theme carries it, for apps on material_ui. An app on Flutter's ownMaterialAppputs it in its ownThemeData, as the example does: Flutter'sMaterialPageRoutereads Flutter's theme, which Comic doesn't reach, and would fly in. See ComicPageTransitionsBuilder. On iOS the cut stands in ui_core'sDesignSwipeBackPageTransitionsBuilder, so the swipe from the screen's leading edge still takes a page back, the page following the finger. - comicPressPlate → const double
- The distance between a raised control and its hard shadow, in logical pixels.
- comicRaisedPlate → const double
- The offset of the solid ink shadow under a raised surface, in logical pixels.
- comicScaleWordsMost → const double
- The most a chart's scale words grow with the reader's text size: 1.3 times, as Material's slider value label. They stand side by side under the bar; larger, one leaves the other too narrow for its words.
- comicScrimPitch → const double
- Legacy grid dimensions for artwork matching the 0.2.0 modal screen.
- comicScrimRadius → const double
- Legacy grid dimensions for artwork matching the 0.2.0 modal screen.
- comicStateCurve → const Curve
- The curve every change of a face's state moves on: a quick cut that lands without a drift.
- comicWeekdayScaleMost → const double
- The most a calendar's weekday initials grow with the reader's text size: twice, as Material's calendar. Larger, seven initials fill a phone's row of day cells and touch.
- 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):
Properties
- comicInventory → DesignInventory
-
Every row of the shared component inventory, each answered by a live Comic part.
final
Functions
-
burstPoints(
double w, double h, {int spikes = 14, int seed = 3, double inner = .72, double jitter = .09, double pad = 4}) → List< Offset> -
The points of a jagged star in a box
wbyh: every other point out on the rim, every other in atinner. -
comicAnchorFaceOf(
RenderBox root) → RenderBox -
The box a menu opens from when anchored on
root: the one marked face underroot(a labelled field's box, not its label), orrootitself when there is none or more than one. -
comicBalloonPath(
double w, double h, ComicTail tail, double radius, {double? at, bool rtl = false, double scale = 1}) → Path -
A balloon's whole outline for a body of
wbyh: rounded body and tail, one path.atplaces the tail's tip: how far along its edge, 0 to 1, or the usual distance from the start if null. A tail's base stays on the straight of the edge. -
comicCappedShape(
OutlinedBorder shape, double most) → OutlinedBorder -
shapewith no corner abovemost: a rounded rectangle's corners are reduced by the same inset, so the result stays concentric withshape; other shapes are returned as they are. -
comicCarryTo(
BuildContext context, ) → Widget Function(BuildContext, Widget) -
Carries the current theme, text direction and localizations into a route on
navigator. -
comicCompactHere(
BuildContext context) → bool - Whether a star should draw its compact form: inside a compact frame, on a phone.
-
comicCornerInset(
OutlinedBorder? shape, TextDirection direction, {double? shortestSide}) → double - Extra inset that keeps a rectangular content box clear of a rounded corner. Border dimensions reserve its stroke; this reserves the curved corner area. For a circle or capsule, pass the smaller side of its content bounds.
-
comicDisplayFor(
String words, TextStyle style) → TextStyle - Keeps the visual weight of Bangers when a right-to-left word uses a fallback face. Connected letters use the font's own spacing.
-
comicDropdownWidth(
BuildContext context, Widget face) → Widget -
face, a dropdown's closed face with its label, kept to comicDropdownMost at the start of the width it is given from 600 up; on a phone it takes its column. The face is marked (ComicAnchorFace) so a menu anchored on the wider room around it opens from the face. -
comicFieldInError(
BuildContext context) → bool - Whether an enclosing form field is showing an error.
-
comicFieldInset(
ComicThemeData t) → EdgeInsetsDirectional -
The room inside a picker's box under
t's density: its words on comicFieldWords, as a text field's; a select's list sets its words on EdgeInsetsDirectional.start. -
comicFieldListWords(
ComicThemeData t, [ComicStyle? style]) → double - Where a row's words start inside a list that opens from a field : on the field's words, less the frame's rim and the 4 its rows stand in. Never under 6.
-
comicFieldTrouble(
{required bool error, required Widget child}) → Widget -
Applies an error outline to field controls below
childwhileerroris true. -
comicFieldWordsAt(
ComicThemeData t) → double -
comicFieldWords under
t's density. -
comicFlatInk(
Color? color) → bool -
Whether
coloris a flat ink: opaque, or wholly clear (which stands for none). -
comicFontFamily(
String family) → String -
familyunder the name Flutter registers it by:ShantellSanswhen the app bundles it,packages/comic_ui/ShantellSansfrom the package. A test that loads the faces itself loads them under this name. -
comicInkOn(
Color ground, Color wanted, Iterable< Color> inks) → Color -
Letters drawn on a face of their own (an avatar's), which keeps its own fill
where a filled ground around it rescopes the theme's inks:
wantedwhen it reads 4.5:1 onground, else whichever ofinksreads best there. -
comicInsetShape(
OutlinedBorder shape, double inset) → OutlinedBorder -
The concentric shape inside
shape, with each corner reduced byinset. Circles and capsules remain circles and capsules in their smaller bounds. -
comicLetteringScaler(
BuildContext context, TextStyle style) → TextScaler -
The reader's text scaler, capped so
style's lettering stops growing at comicLetteringMost. -
comicListOnLiftedField(
BuildContext field, Widget list) → Widget - Wraps the list a person types for in a focused field (a combobox's, a multi-select's): the field's face stands comicFocusLift toward the start while it has the focus, and the list starts on the face as drawn, its words on the field's. It keeps its height: the face's print stands under the face.
-
comicLoadFonts(
) → Future< void> -
Loads the faces Comic bundles, so the first frame is set in them. Await it before
runApp: on the web a bundled face otherwise arrives after the first frames, which flash in a fallback face. An app that names its own faces (ComicTypeface.app) loads those itself, the same way, with aFontLoader. -
comicMaterialWords(
BuildContext context) → List< LocalizationsDelegate> - Supplies missing Material and Cupertino localizations to an overlay route.
-
comicMenuRow(
Set< WidgetState> states, Widget face(Set<WidgetState> states)) → Widget -
A design-kit menu row's face, built by
facefor the states it shows: the current row (hovered or focused, which ui_core gives one row of a menu at most) as focused, Comic's one lit face, and nothing else of the pointer's or the keys'. -
comicMenuRowShape(
ComicThemeData t) → OutlinedBorder - The outline of a row inside a ComicRaisedFrame: the frame's own, inset by its rim and 4, so a lit row stays concentric with the rim.
-
comicOutsetShape(
OutlinedBorder shape, double gap) → OutlinedBorder -
The concentric shape
gapoutsideshape, for a mark round a part: each rounded corner grows bygap, a square corner stays square, and circles and capsules stay circles and capsules in their larger bounds. -
comicOwnSize(
{double? width, double? height, AlignmentGeometry alignment = AlignmentDirectional.topStart, required Widget child}) → Widget -
A part with its own size keeps it, whatever its parent asks. A stretching Column or Row hands tight constraints, which a
SizedBox can't refuse: a paint that reads its declared size and a
Centerthat reads the real width come apart. Here the part stands atalignmentin the room (the start edge unless it is centred by design: left in LTR, mirrored in RTL) and, if the room is smaller than the part, scales down whole. Give one side, or none, for a part whose other side follows its content. -
comicPanelInset(
ComicThemeData t) → EdgeInsets - The everyday inside of a panel: 14 on a phone, 20 22 22 on a desktop.
-
comicRaisedSurface(
BuildContext context, Animation< double> presence, Size maxSize, List<Widget> items, {double width = 320}) → Widget -
The menu's raised face around design-kit rows, fading in on
presenceand scrolling pastmaxSize. -
comicRightToLeftScript(
String text) → bool -
Whether
textholds a letter of a right-to-left script (Hebrew, Arabic and their presentation forms). The lettering face has none of their letters, and its slanted punctuation, drawn to follow a capital, sat over the script's last letter: words in such a script are set in the text face. -
comicRim(
ComicThemeData theme, ComicStyleOf look, Color fallback, [double own = 2.5]) → BorderSide -
The rim a styled part draws: DesignStyleOf.side when set, else DesignStyleOf.edge (or
fallback) at the theme's regular stroke. -
comicSearchFailed(
BuildContext context, DesignSearchError failure, [ComicStyle? style]) → Widget -
A field's list after its search threw (
failure): that it failed, and Try again as a menu row, lit while the keys are on it or the pointer is over it. -
comicSearchNote(
BuildContext context, String words, [ComicStyle? style]) → Widget - A line in a field's list that is no option, in the secondary ink where the options' words start: nothing matches, a search is looking, or it failed.
-
comicSlantInset(
BuildContext context) → (double, double) - How much room the slanted gutter takes from a panel's end and its start: (start, end). A bleeding panel's own band reads it.
-
comicStates(
{bool enabled = true, bool hovered = false, bool focused = false, bool pressed = false, bool selected = false, bool error = false}) → Set< WidgetState> - The states a painted control is in, for its style.
-
comicStyleOf(
List< DesignStyle?> layers, Set<WidgetState> states) → DesignStyleOf -
Resolves
layersforstatesand checks that fills and overlays are opaque in debug mode. -
comicToneInks(
ComicSpeaker tone, ComicColors c) → (Color, Color) -
The background and foreground inks for
tone. -
comicTouchEditing(
TargetPlatform platform) → bool -
Whether
platformedits by touch: handles and a menu over the selection, rather than a pointer's right-click menu. -
comicWidestWord(
String text, TextStyle style, {TextScaler textScaler = TextScaler.noScaling}) → double -
The width of the widest word of
textinstyleattextScaler(pass the context's,MediaQuery.textScalerOf): below it, Flutter breaks a word in two. -
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. -
fillPaint(
Color color) → Paint -
A solid fill paint using
color. -
polar(
double cx, double cy, double r, double a) → Offset -
A point at radius
rand angleain degrees around (cx,cy). -
polyPath(
Iterable< Offset> pts, {bool close = true}) → Path -
Connects
ptsin order and closes the contour whencloseis true. -
showComicActionSheet<
T> (BuildContext context, {required List< ComicSheetAction< actions, String? title, String? message, String? cancelLabel}) → Future<T> >T?> - Raises a ComicActionSheet and returns the chosen value, or null on cancel or dismissal.
-
showComicBottomSheet<
T> (BuildContext context, {required WidgetBuilder builder, bool barrierDismissible = true, String? closeLabel}) → Future< T?> - Raises a sheet from the page's foot on ui_core's DesignBottomSheetRoute, carrying its theme and direction. It travels in on a spring and stops at its edge, as tall as its content up to the window less 24; a drag down or a fling puts it away, and a ComicBottomSheet inside hands its scroll over to that drag. Escape, back and a press on the screen close it, and focus returns to what opened it.
-
showComicCommand(
BuildContext context, {required List< DesignCommand> commands, String? hint, String? label, double maxHeight = 340}) → Future<void> - Raises the ComicCommand palette over the page with the field ready for typing. Choosing closes it, then runs the command; Escape or a press on the scrim closes it and focus goes back where it was.
-
showComicDatePicker(
BuildContext context, {DateTime? value, DateTime? firstDate, DateTime? lastDate, DateTime? currentDate, String? title, String? confirm, String? cancel}) → Future< DateTime?> - Raises a calendar and returns the confirmed day, or null on dismissal.
-
showComicDateRangePicker(
BuildContext context, {required DateTime firstDate, required DateTime lastDate, DesignDateRange? value, DateTime? currentDate, String? title, String? confirm, String? cancel}) → Future< DesignDateRange?> - Raises a ComicDateRangePicker in the dialog and returns the confirmed span, or null on dismissal.
-
showComicDialog<
T> (BuildContext context, {required WidgetBuilder builder, bool barrierDismissible = true, String? closeLabel}) → Future< T?> -
Shows a dialog and returns the result passed to Navigator.pop.
Escape and back dismiss the dialog. Focus returns to the control that opened it.
Set
barrierDismissibleto control whether tapping the backdrop dismisses it. -
showComicMenu<
T> (BuildContext context, {ComicStyle? style, required Rect anchor, required List< ComicMenuItem< items, bool matchAnchorWidth = false, String? closeLabel}) → Future<T> >T?> -
Opens a menu beside a rectangle in global coordinates and returns its value.
matchAnchorWidthgives a select menu the field's width, within the viewport. The dismissal barrier is transparent; dialogs and sheets retain their scrims. -
Raises a navigation drawer from the start edge, the window's full height, over a scrim: the phone's form of the
side navigation. Escape, back and a press on the scrim close it, and focus returns to what opened it. Pop it with a
value (the destination chosen) from inside, as a ComicNavigationDrawer's
onDestinationSelecteddoes. -
showComicSheet<
T> (BuildContext context, {required WidgetBuilder builder, DesignSheetEdge edge = DesignSheetEdge.end, double width = 384, bool barrierDismissible = true, String? closeLabel, String? label}) → Future< T?> -
Raises
builder's ComicSheet from the screen's side: the end edge unlessedgesays otherwise. A tap on the scrim or a drag toward the edge closes it. Completes with what the sheet popped. -
showComicSnackBar(
BuildContext context, String message, {ComicStyle? style, String? title, ComicTone? tone, String? actionLabel, VoidCallback? onAction, Duration duration = const Duration(seconds: 4), String? dismissLabel}) → ComicRaised - Shows one announcement per navigator, replacing the previous one. Actions remain available indefinitely when accessible navigation is on.
-
showComicTimePicker(
BuildContext context, {ComicTime? value, int minuteStep = 1, bool? use24hFormat, String? title, String? confirm, String? cancel}) → Future< ComicTime?> - Raises a clock and returns the confirmed time, or null on dismissal.
-
showComicToast(
BuildContext context, String message, {ComicTone? tone, IconData? icon, ComicStyle? style, Duration duration = const Duration(milliseconds: 2500)}) → ComicRaised -
Shows
messageas a ComicToast above the page's foot forduration, replacing the navigator's previous toast. It takes no focus and no press: a toast that needs an answer is a showComicSnackBar. -
showComicTooltip(
BuildContext context, {ComicStyle? style, required String message, required Rect anchor}) → ComicRaised - Shows a tooltip without taking keyboard focus. Escape dismisses it.
-
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. -
strokePaint(
Color color, double width) → Paint -
A stroke paint using
colorand the logical-pixelwidth.
Typedefs
- ComicStyle = DesignStyle
-
How one part 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). - ComicStyleOf = DesignStyleOf
-
A styled part's layers for its states: its own
style:, then its component theme. Each getter is the first layer's value for the states, or null, so the part goes on to the theme-wide knobs and its own default. -
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.
Exceptions / Errors
- DesignInventoryError
- Thrown by DesignInventory.verify: the rows an inventory answers wrong.