Catalog
Every Fortal widget with its sizes, variants, defaults, and supported behavior
Every widget below is recorded in Fortal’s own contract that melos fortal:check holds against the Dart recipes, so the sizes, variants, and defaults on this page are the ones a caller actually gets.
This is the API reference. Start with the Fortal overview for installation and theming. For live examples and source, choose a component in the sidebar, such as Button.
A — value means the widget does not expose that axis. When values are listed but their default is —, the parameter is nullable with no pinned value. That is the typography path: an omitted size or weight resolves from the active scope's tokens (text3, regular) rather than from an enum, so a host text run cannot resize Fortal text. See Typography.
Search by name, or browse the categories below.
At a glance
| Widget | Sizes | Size default | Variants | Variant default |
|---|---|---|---|---|
FortalAccordion | size1, size2, size3 | size2 | surface, soft | surface |
FortalAppBar | — | — | — | — |
FortalAvatar | size1, size2, size3, size4, size5, size6, size7, size8, size9 | size3 | soft, solid | soft |
FortalBadge | size1, size2, size3 | size1 | solid, soft, surface, outline | soft |
FortalButton | size1, size2, size3, size4 | size2 | solid, soft, surface, outline, ghost | solid |
FortalCallout | size1, size2, size3 | size2 | soft, surface, outline | soft |
FortalCard | size1, size2, size3, size4, size5 | size1 | surface, ghost | surface |
FortalCheckbox | size1, size2, size3 | size2 | surface, soft | surface |
FortalCode | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — | solid, soft, outline, ghost | soft |
FortalDataList | size1, size2, size3 | size2 | — | — |
FortalDataTable | size1, size2, size3 | size2 | surface, ghost | ghost |
FortalDialog | size1, size2, size3, size4 | size3 | — | — |
FortalDisclosure | size1, size2, size3 | size2 | surface, soft | surface |
FortalDivider | size1, size2, size3, size4 | size1 | — | — |
FortalHeading | size1, size2, size3, size4, size5, size6, size7, size8, size9 | size6 | — | — |
FortalIconButton | size1, size2, size3, size4 | size2 | solid, soft, surface, outline, ghost | solid |
FortalKbd | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — | soft | soft |
FortalLineChart | — | — | — | — |
FortalLink | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — | — | — |
FortalMenu | size1, size2 | size2 | solid, soft | solid |
FortalPopover | size1, size2, size3, size4 | size2 | — | — |
FortalProgress | size1, size2, size3 | size2 | surface, soft | surface |
FortalRadio | size1, size2, size3 | size2 | surface, soft | surface |
FortalSegmentedControl | size1, size2, size3 | size2 | surface | surface |
FortalSelect | size1, size2, size3 | size2 | surface, soft, ghost | surface |
FortalSidebar | — | — | — | — |
FortalSidebarLayout | — | — | — | — |
FortalSkeleton | — | — | — | — |
FortalSlider | size1, size2, size3 | size2 | surface, soft | surface |
FortalSpinner | size1, size2, size3 | size2 | — | — |
FortalSwitch | size1, size2, size3 | size2 | surface, soft | surface |
FortalTabBar | size1, size2 | size2 (on FortalTab) | — | — |
FortalText | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — | — | — |
FortalTextArea | size1, size2, size3 | size2 | surface, soft | surface |
FortalTextField | size1, size2, size3 | size2 | surface, soft | surface |
FortalToast | size1, size2, size3 | size2 | surface, classic | classic |
FortalToggle | size1, size2, size3 | size2 | ghost, outline | ghost |
FortalToggleGroup | size1, size2, size3 | size2 | soft, surface | soft |
FortalTooltip | — | — | — | — |
Actions and inputs
FortalButton
Recipe registry_source/lib/src/fortal/components/button.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4 | size2 |
variant | solid, soft, surface, outline, ghost | solid |
Named constructors: FortalButton.ghost, FortalButton.outline, FortalButton.soft, FortalButton.solid, FortalButton.surface
Other defaults: enabled: true, highContrast: false, loading: false
Style props: color, radius, highContrast
States: idle, hovered, pressed, focused, disabled, loading, highContrast
FortalIconButton
Recipe registry_source/lib/src/fortal/components/icon_button.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4 | size2 |
variant | solid, soft, surface, outline, ghost | solid |
Named constructors: FortalIconButton.ghost, FortalIconButton.outline, FortalIconButton.soft, FortalIconButton.solid, FortalIconButton.surface
Other defaults: enabled: true, highContrast: false, loading: false, semanticLabel: required
Style props: color, radius, highContrast
States: idle, hovered, pressed, focused, disabled, loading, highContrast
FortalCheckbox
Recipe registry_source/lib/src/fortal/components/checkbox.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalCheckbox.soft, FortalCheckbox.surface
Other defaults: enabled: true, highContrast: false, selected: false, tristate: false
Style props: color, highContrast
States: unchecked, checked, indeterminate, hovered, pressed, focused, disabled, highContrast
FortalRadio
Recipe registry_source/lib/src/fortal/components/radio.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalRadio.soft, FortalRadio.surface
Other defaults: enabled: true, highContrast: false
Style props: color, highContrast
States: unchecked, checked, hovered, pressed, focused, disabled, highContrast, group
FortalSelect
Recipe registry_source/lib/src/fortal/components/select.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft, ghost | surface |
Named constructors: FortalSelect.ghost, FortalSelect.soft, FortalSelect.surface
Other defaults: contentHighContrast: false, open: null
Style props: color, radius, highContrast
States: closed, open, placeholder, selected, highlighted, disabled, highContrast
FortalSlider
Recipe registry_source/lib/src/fortal/components/slider.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalSlider.soft, FortalSlider.surface
Other defaults: highContrast: false, inverted: false, max: 100, min: 0, minSpacing: 0, step: 1
Style props: color, radius, highContrast
States: idle, hovered, pressed, focused, disabled, highContrast, rtl
FortalSwitch
Recipe registry_source/lib/src/fortal/components/switch.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalSwitch.soft, FortalSwitch.surface
Other defaults: enabled: true, highContrast: false, selected: false
Style props: color, radius, highContrast
States: unchecked, checked, hovered, pressed, focused, disabled, highContrast
FortalTextArea
Recipe registry_source/lib/src/fortal/components/textfield.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalTextArea.soft, FortalTextArea.surface
Other defaults: enabled: true, error: false, maxLines: null, readOnly: false
Style props: color, radius
States: idle, hovered, focused, disabled, readOnly, invalid
FortalTextField
Recipe registry_source/lib/src/fortal/components/textfield.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalTextField.soft, FortalTextField.surface
Other defaults: enabled: true, error: false, readOnly: false
Style props: color, radius
States: idle, hovered, focused, disabled, readOnly, invalid, leading, trailing
FortalToggle
Recipe registry_source/lib/src/fortal/components/toggle.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | ghost, outline | ghost |
Named constructors: FortalToggle.ghost, FortalToggle.outline
Other defaults: enabled: true, highContrast: false, selected: false
Style props: color, radius, highContrast
States: off, on, hovered, pressed, focused, disabled, highContrast
FortalToggleGroup
Recipe registry_source/lib/src/fortal/components/toggle_group.dart
| Parameter | Values | Default |
|---|---|---|
orientation | horizontal, vertical | horizontal |
size | size1, size2, size3 | size2 |
variant | soft, surface | soft |
Named constructors: FortalToggleGroup.soft, FortalToggleGroup.surface
Other defaults: enabled: true, highContrast: false, loop: true
Style props: color, radius, highContrast
States: unselected, selected, hovered, pressed, focused, disabled, highContrast, rtl
Navigation
FortalAppBar
Recipe registry_source/lib/src/fortal/components/app_bar.dart
FortalLink
Recipe registry_source/lib/src/fortal/components/link.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — |
underline | auto, always, hover, none | auto |
weight | light, regular, medium, bold | — |
Other defaults: autofocus: false, enableFeedback: true, enabled: true, excludeSemantics: false, highContrast: false, softWrap: true, truncate: false
Style props: color, radius, highContrast
States: idle, hovered, focused, disabled, highContrast, inert, truncated, semantic
FortalMenu
Recipe registry_source/lib/src/fortal/components/menu.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2 | size2 |
variant | solid, soft | solid |
Named constructors: FortalMenu.soft, FortalMenu.solid
Other defaults: highContrast: false, submenuOpenDelayMilliseconds: 100
Style props: color, highContrast
States: closed, open, highlighted, disabled, checked, unchecked, submenuOpen, rtl, escape, focusRestored, highContrast
FortalSegmentedControl
Recipe registry_source/lib/src/fortal/components/segmented_control.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface | surface |
Named constructors: FortalSegmentedControl.surface
Other defaults: enabled: true, loop: true, orientation: horizontal
Style props: radius
States: unselected, selected, hovered, pressed, focused, disabled, rtl
FortalSidebar
Recipe registry_source/lib/src/fortal/components/sidebar.dart
FortalTabBar
Recipe registry_source/lib/src/fortal/components/tabs.dart
| Parameter | Values | Default |
|---|---|---|
activationMode | automatic, manual | automatic |
orientation | horizontal, vertical | horizontal |
size | size1, size2 | size2 (on FortalTab) |
Other defaults: highContrast: false
Style props: color, highContrast
States: inactive, active, hovered, pressed, focused, disabled, automatic, manual, rtl, highContrast
Overlays
FortalDialog
Recipe registry_source/lib/src/fortal/components/dialog.dart
| Parameter | Values | Default |
|---|---|---|
align | start, center | center |
size | size1, size2, size3, size4 | size3 |
Other defaults: maxWidth: 600, modal: true, width: infinity
States: closed, open, modal
FortalPopover
Recipe registry_source/lib/src/fortal/components/popover.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4 | size2 |
Other defaults: arrow: false, maxWidth: 480
States: closed, open, escape, outsideTap, focusRestored
FortalTooltip
Recipe registry_source/lib/src/fortal/components/tooltip.dart
Other defaults: arrow: true, collisionPadding: 10, delayMilliseconds: 200, disableHoverableContent: false, maxWidth: 360, sideOffset: 4
States: closed, delayedOpen, triggerHovered, focused, touch, escape
FortalToast
Recipe registry_source/lib/src/fortal/components/toast.dart
| Parameter | Values | Default |
|---|---|---|
intent | accent, neutral, error | accent |
size | size1, size2, size3 | size2 |
variant | surface, classic | classic |
Named constructors: FortalToast.classic, FortalToast.surface
Feedback
FortalCallout
Recipe registry_source/lib/src/fortal/components/callout.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | soft, surface, outline | soft |
Named constructors: FortalCallout.outline, FortalCallout.soft, FortalCallout.surface
Other defaults: highContrast: false
Style props: color, highContrast
States: idle, highContrast
FortalProgress
Recipe registry_source/lib/src/fortal/components/progress.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalProgress.soft, FortalProgress.surface
Other defaults: durationMilliseconds: 5000, highContrast: false, max: 100, value: null
Style props: color, radius, highContrast
States: determinate, highContrast
FortalSkeleton
Recipe registry_source/lib/src/fortal/components/skeleton.dart
Other defaults: loading: true
States: loading, loaded, animationDisabled
FortalSpinner
Recipe registry_source/lib/src/fortal/components/spinner.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
Other defaults: color: currentColor, leafCount: 8, loading: true
States: spinning, animationDisabled
Layout
FortalAccordion
Recipe registry_source/lib/src/fortal/components/accordion.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalAccordion.soft, FortalAccordion.surface
Other defaults: enabled: true
Style props: color, radius
States: collapsed, expanded, hovered, pressed, focused, disabled
FortalCard
Recipe registry_source/lib/src/fortal/components/card.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4, size5 | size1 |
variant | surface, ghost | surface |
Named constructors: FortalCard.ghost, FortalCard.surface
Other defaults: enabled: true
States: idle, passive
FortalDisclosure
Recipe registry_source/lib/src/fortal/components/disclosure.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, soft | surface |
Named constructors: FortalDisclosure.soft, FortalDisclosure.surface
Other defaults: defaultExpanded: false, enabled: true, expanded: null
Style props: color, radius
States: collapsed, expanded, hovered, pressed, focused, disabled
FortalDivider
Recipe registry_source/lib/src/fortal/components/divider.dart
| Parameter | Values | Default |
|---|---|---|
orientation | horizontal, vertical | horizontal |
size | size1, size2, size3, size4 | size1 |
Other defaults: color: gray, decorative: true, lengths: [16, 32, 64, full], thickness: 1
Style props: color
States: decorative, semantic
Data display
FortalAvatar
Recipe registry_source/lib/src/fortal/components/avatar.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4, size5, size6, size7, size8, size9 | size3 |
variant | soft, solid | soft |
Named constructors: FortalAvatar.soft, FortalAvatar.solid
Other defaults: highContrast: false
Style props: color, radius, highContrast
States: idle, loading, loaded, error, highContrast
FortalBadge
Recipe registry_source/lib/src/fortal/components/badge.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size1 |
variant | solid, soft, surface, outline | soft |
Named constructors: FortalBadge.outline, FortalBadge.soft, FortalBadge.solid, FortalBadge.surface
Other defaults: highContrast: false
Style props: color, radius, highContrast
States: idle, highContrast
FortalDataList
Recipe registry_source/lib/src/fortal/components/data_list.dart
| Parameter | Values | Default |
|---|---|---|
alignment | start, center, end, baseline, stretch | baseline |
orientation | horizontal, vertical | horizontal |
size | size1, size2, size3 | size2 |
Other defaults: highContrast: false
Style props: highContrast
States: idle, highContrast, customChild, rtl
FortalDataTable
Recipe registry_source/lib/src/fortal/components/data_table.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3 | size2 |
variant | surface, ghost | ghost |
Named constructors: FortalDataTable.ghost, FortalDataTable.surface
Other defaults: enabled: true
States: idle, passive, hovered, selected
Layout and charts
FortalLineChart
Recipe registry_source/lib/src/fortal/components/chart.dart
FortalSidebarLayout
Recipe registry_source/lib/src/fortal/components/sidebar_layout.dart
Typography
FortalHeading
Recipe registry_source/lib/src/fortal/components/heading.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4, size5, size6, size7, size8, size9 | size6 |
weight | light, regular, medium, bold | bold |
Other defaults: accent: false, align: null, excludeSemantics: false, headingLevel: 1, highContrast: false, softWrap: true, truncate: false
Style props: color, highContrast
States: idle, accent, highContrast, truncated, semantic
FortalText
Recipe registry_source/lib/src/fortal/components/text.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — |
weight | light, regular, medium, bold | — |
Other defaults: accent: false, align: null, highContrast: false, softWrap: true, truncate: false
Style props: color, highContrast
States: idle, accent, highContrast, truncated
FortalCode
Recipe registry_source/lib/src/fortal/components/code.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — |
variant | solid, soft, outline, ghost | soft |
weight | light, regular, medium, bold | — |
Named constructors: FortalCode.ghost, FortalCode.outline, FortalCode.soft, FortalCode.solid
Other defaults: accent: false, highContrast: false, softWrap: true, truncate: false
Style props: color, radius, highContrast
States: idle, accent, highContrast, truncated
FortalKbd
Recipe registry_source/lib/src/fortal/components/kbd.dart
| Parameter | Values | Default |
|---|---|---|
size | size1, size2, size3, size4, size5, size6, size7, size8, size9 | — |
variant | soft | soft |
Named constructors: FortalKbd.soft
Other defaults: excludeSemantics: false
Style props: radius
States: idle, explicitDark, semantic