Parity catalog
A data-driven index of Material provenance, fidelity dimensions, adaptations, and known gaps.
What this catalog means
This catalog combines the structured component provenance used by fidelity summaries with the generated Material conformance report used by CI. It is an index of documented evidence, reviewed capability coverage, and fidelity claims, not a percentage score and not a claim that every pixel or internal Compose mechanism is reproduced literally on the web.
42 documented component contracts
App bar action columnsStructured fidelity
- Compose mapping
- AppBarColumn · AppBarColumnScope
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Lays out the same action/toggle/custom item model on the block axis, observes local item heights and available container height, honors maxItemCount, and moves the non-fitting suffix into an overflow menu.
- Behavior fidelity
- adapted: The column responds only to its own measured height. It does not choose a navigation rail, drawer, pane arrangement, or adaptive window class; overflow interaction is delegated to the same React Aria-backed menu behavior as AppBarRow.
- Semantics fidelity
- adapted: The column responds only to its own measured height. It does not choose a navigation rail, drawer, pane arrangement, or adaptive window class; overflow interaction is delegated to the same React Aria-backed menu behavior as AppBarRow.
- Adaptations
- The column responds only to its own measured height. It does not choose a navigation rail, drawer, pane arrangement, or adaptive window class; overflow interaction is delegated to the same React Aria-backed menu behavior as AppBarRow.
App bar action rowsStructured fidelity
- Compose mapping
- AppBarRow · AppBarRowScope
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Lays out action, toggle, and custom app-bar items on the inline axis, observes the local container and item widths, preserves maxItemCount, and moves only the suffix that no longer fits into a Material overflow menu.
- Behavior fidelity
- adapted: Overflow is resolved from the component's own measured available width, not from viewport classes or responsive navigation policy. Built-in actions retain button/toggle semantics and React Aria Menu owns overflow positioning, keyboard interaction, and focus restoration.
- Semantics fidelity
- adapted: Overflow is resolved from the component's own measured available width, not from viewport classes or responsive navigation policy. Built-in actions retain button/toggle semantics and React Aria Menu owns overflow positioning, keyboard interaction, and focus restoration.
- Adaptations
- Overflow is resolved from the component's own measured available width, not from viewport classes or responsive navigation policy. Built-in actions retain button/toggle semantics and React Aria Menu owns overflow positioning, keyboard interaction, and focus restoration.
BadgesStructured fidelity
- Compose mapping
- Badge · BadgedBox
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements Material dot and content badge geometry plus logical top-end BadgedBox positioning, with canonical error/on-error defaults and explicit container/content color overrides.
- Behavior fidelity
- adapted: Badge and BadgedBox do not guess the semantic meaning of a dot or count and do not rewrite the anchor accessible name. Applications decide whether the visual badge is aria-hidden and include meaningful status wording on the anchor, or label a standalone badge directly when it conveys independent information.
- Semantics fidelity
- adapted: Badge and BadgedBox do not guess the semantic meaning of a dot or count and do not rewrite the anchor accessible name. Applications decide whether the visual badge is aria-hidden and include meaningful status wording on the anchor, or label a standalone badge directly when it conveys independent information.
- Adaptations
- Badge and BadgedBox do not guess the semantic meaning of a dot or count and do not rewrite the anchor accessible name. Applications decide whether the visual badge is aria-hidden and include meaningful status wording on the anchor, or label a standalone badge directly when it conveys independent information.
Bottom app barsStructured fidelity
- Compose mapping
- BottomAppBar · FlexibleBottomAppBar · BottomAppBarState · BottomAppBarScrollBehavior
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements regular and flexible Material bottom app bars with action content, optional FAB composition, configurable flexible arrangement, token-backed elevation/color, and explicit exit-always collapsed state.
- Behavior fidelity
- adapted: The bar does not infer viewport class or attach scrolling behavior to the document. Applications feed collapsed state from their own scrolling composition. Actions and FABs preserve their own React Aria-backed semantics rather than making the whole bar interactive.
- Semantics fidelity
- adapted: The bar does not infer viewport class or attach scrolling behavior to the document. Applications feed collapsed state from their own scrolling composition. Actions and FABs preserve their own React Aria-backed semantics rather than making the whole bar interactive.
- Adaptations
- The bar does not infer viewport class or attach scrolling behavior to the document. Applications feed collapsed state from their own scrolling composition. Actions and FABs preserve their own React Aria-backed semantics rather than making the whole bar interactive.
Bottom sheetsStructured fidelity
- Compose mapping
- ModalBottomSheet · SheetState · BottomSheetScaffold sheet surface
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements a local non-modal BottomSheet and a true ModalBottomSheet sharing one SheetState anchor model, deterministic hidden/partial/expanded anchors, drag settling, accessible handle actions, scrim configuration, theme-aware portals, and reduced-motion-aware dismissal completion.
- Behavior fidelity
- adapted: The non-modal sheet remains a local region whose parent owns stacking and background interaction. ModalBottomSheet uses React Aria ModalOverlay/Modal for portal placement, focus containment, outside interaction, Escape, scroll locking, and focus restoration. Anchor measurement is local to the sheet containing block and is not an adaptive window-size or pane system.
- Semantics fidelity
- adapted: The non-modal sheet remains a local region whose parent owns stacking and background interaction. ModalBottomSheet uses React Aria ModalOverlay/Modal for portal placement, focus containment, outside interaction, Escape, scroll locking, and focus restoration. Anchor measurement is local to the sheet containing block and is not an adaptive window-size or pane system.
- Adaptations
- The non-modal sheet remains a local region whose parent owns stacking and background interaction. ModalBottomSheet uses React Aria ModalOverlay/Modal for portal placement, focus containment, outside interaction, Escape, scroll locking, and focus restoration. Anchor measurement is local to the sheet containing block and is not an adaptive window-size or pane system.
Button groupsStructured fidelity
- Compose mapping
- ButtonGroup · ConnectedButtonGroup
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements standard action groups with AndroidX-style pressed-width redistribution and a tokenized local overflow menu, plus connected single/multiple selection groups across the audited extra-small through extra-large size family.
- Behavior fidelity
- adapted: Standard groups contain independent React Aria-backed actions and use ResizeObserver to move a suffix into a component-local menu when the row cannot fit; that is local overflow, not adaptive window layout. Connected single selection uses React Aria RadioGroup/Radio semantics, while connected multiple selection uses ToggleButton semantics.
- Semantics fidelity
- adapted: Standard groups contain independent React Aria-backed actions and use ResizeObserver to move a suffix into a component-local menu when the row cannot fit; that is local overflow, not adaptive window layout. Connected single selection uses React Aria RadioGroup/Radio semantics, while connected multiple selection uses ToggleButton semantics.
- Adaptations
- Standard groups contain independent React Aria-backed actions and use ResizeObserver to move a suffix into a component-local menu when the row cannot fit; that is local overflow, not adaptive window layout. Connected single selection uses React Aria RadioGroup/Radio semantics, while connected multiple selection uses ToggleButton semantics.
ButtonsStructured fidelity
- Compose mapping
- Button · ElevatedButton · FilledTonalButton · OutlinedButton · TextButton
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implemented with canonical Material tokens, all five Material button variants, expressive size helpers, icon slots, disabled treatment, ripple/state layers, and optional pressed-shape morphing.
- Behavior fidelity
- adapted: React Aria owns browser button semantics and pointer, keyboard, focus, and hover interaction state. Material tokens remain authoritative for geometry, typography, color, elevation, shape, and state-layer presentation.
- Semantics fidelity
- adapted: React Aria owns browser button semantics and pointer, keyboard, focus, and hover interaction state. Material tokens remain authoritative for geometry, typography, color, elevation, shape, and state-layer presentation.
- Adaptations
- React Aria owns browser button semantics and pointer, keyboard, focus, and hover interaction state. Material tokens remain authoritative for geometry, typography, color, elevation, shape, and state-layer presentation.
CardsStructured fidelity
- Compose mapping
- Card · ElevatedCard · OutlinedCard
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements filled, elevated, and outlined Material card surfaces with canonical color, border, shape, elevation, motion, disabled, hover, focus, pressed, and ripple presentation.
- Behavior fidelity
- adapted: Static cards remain semantic div containers. Supplying `onPress` enables pointer and keyboard activation and focusability, but the component does not infer an ARIA role; consumers must supply the semantic role that matches the card action when the whole card is interactive.
- Semantics fidelity
- adapted: Static cards remain semantic div containers. Supplying `onPress` enables pointer and keyboard activation and focusability, but the component does not infer an ARIA role; consumers must supply the semantic role that matches the card action when the whole card is interactive.
- Adaptations
- Static cards remain semantic div containers. Supplying `onPress` enables pointer and keyboard activation and focusability, but the component does not infer an ARIA role; consumers must supply the semantic role that matches the card action when the whole card is interactive.
CarouselsStructured fidelity
- Compose mapping
- HorizontalMultiBrowseCarousel · HorizontalUncontainedCarousel · HorizontalCenteredHeroCarousel · CarouselState
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements multi-browse, uncontained, and centered-hero Material carousel geometry with keyline masking, focal item state, controlled/uncontrolled navigation, programmatic scrolling, RTL-aware direction, pointer dragging, and reduced-motion behavior.
- Behavior fidelity
- adapted: The carousel is exposed as a named region with aria-roledescription="carousel" and a focusable viewport supporting logical Arrow keys plus Home/End. Native horizontal scrolling and pointer dragging update the same current-item state. ResizeObserver measures only the carousel viewport for local geometry and does not create adaptive window classes.
- Semantics fidelity
- adapted: The carousel is exposed as a named region with aria-roledescription="carousel" and a focusable viewport supporting logical Arrow keys plus Home/End. Native horizontal scrolling and pointer dragging update the same current-item state. ResizeObserver measures only the carousel viewport for local geometry and does not create adaptive window classes.
- Adaptations
- The carousel is exposed as a named region with aria-roledescription="carousel" and a focusable viewport supporting logical Arrow keys plus Home/End. Native horizontal scrolling and pointer dragging update the same current-item state. ResizeObserver measures only the carousel viewport for local geometry and does not create adaptive window classes.
CheckboxesStructured fidelity
- Compose mapping
- Checkbox
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements unchecked, checked, indeterminate, disabled, hover, focus, and pressed presentation using canonical control tokens and the shared Material ripple engine.
- Behavior fidelity
- adapted: React Aria owns checkbox semantics, selection state, keyboard interaction, focus visibility, and labeling. The Material box, mark, minimum interactive target, and state layer are rendered around those web semantics.
- Semantics fidelity
- adapted: React Aria owns checkbox semantics, selection state, keyboard interaction, focus visibility, and labeling. The Material box, mark, minimum interactive target, and state layer are rendered around those web semantics.
- Adaptations
- React Aria owns checkbox semantics, selection state, keyboard interaction, focus visibility, and labeling. The Material box, mark, minimum interactive target, and state layer are rendered around those web semantics.
ChipsStructured fidelity
- Compose mapping
- AssistChip · SuggestionChip · FilterChip · InputChip
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements assist, suggestion, filter, and input chip families, including elevated assist/suggestion/filter forms, visual slots, selected/disabled states, elevation motion, ripple layers, and optional expressive selected-shape morphing for selectable chips.
- Behavior fidelity
- adapted: Assist and suggestion chips use React Aria button semantics; filter and input chips use checkbox-style selectable semantics. Visual icons and avatars are presentation slots while React Aria remains the interaction, focus, disabled, and selection-state owner.
- Semantics fidelity
- adapted: Assist and suggestion chips use React Aria button semantics; filter and input chips use checkbox-style selectable semantics. Visual icons and avatars are presentation slots while React Aria remains the interaction, focus, disabled, and selection-state owner.
- Adaptations
- Assist and suggestion chips use React Aria button semantics; filter and input chips use checkbox-style selectable semantics. Visual icons and avatars are presentation slots while React Aria remains the interaction, focus, disabled, and selection-state owner.
- Known gaps
- InputChip does not currently expose an independent trailing remove action; trailing visuals remain presentational rather than a second interactive target.
Date pickersStructured fidelity
- Compose mapping
- DatePicker · DateRangePicker · DatePickerState-style date-only selection
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements single-date and range Material picker surfaces, calendar and native date-input modes, locale and first-day-of-week presentation, unavailable dates, year bounds, controlled display state, and modal/docked visual variants.
- Behavior fidelity
- adapted: React Aria Calendar and RangeCalendar own calendar semantics while input mode uses native date inputs. Public selection remains timezone-free ISO calendar-date strings. The modal variant is only the Material picker surface; applications compose Dialog for overlay, scrim, focus containment, and dismissal lifecycle.
- Semantics fidelity
- adapted: React Aria Calendar and RangeCalendar own calendar semantics while input mode uses native date inputs. Public selection remains timezone-free ISO calendar-date strings. The modal variant is only the Material picker surface; applications compose Dialog for overlay, scrim, focus containment, and dismissal lifecycle.
- Adaptations
- React Aria Calendar and RangeCalendar own calendar semantics while input mode uses native date inputs. Public selection remains timezone-free ISO calendar-date strings. The modal variant is only the Material picker surface; applications compose Dialog for overlay, scrim, focus containment, and dismissal lifecycle.
DialogsStructured fidelity
- Compose mapping
- Material dialog surface, headline, supporting text, icon, and actions
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implemented as Material dialog primitives for scrim, container surface, title, description, icon, and actions, with theme-aware portal placement.
- Behavior fidelity
- adapted: React Aria owns modal focus scope, focus restoration, Escape handling, outside dismissal, portal behavior, and accessible dialog relationships. Material styling is layered on those native web interaction semantics.
- Semantics fidelity
- adapted: React Aria owns modal focus scope, focus restoration, Escape handling, outside dismissal, portal behavior, and accessible dialog relationships. Material styling is layered on those native web interaction semantics.
- Adaptations
- React Aria owns modal focus scope, focus restoration, Escape handling, outside dismissal, portal behavior, and accessible dialog relationships. Material styling is layered on those native web interaction semantics.
DividersStructured fidelity
- Compose mapping
- HorizontalDivider · VerticalDivider
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements horizontal and vertical Material dividers with canonical outline-variant color and audited thickness defaults, while allowing deliberate CSS color and thickness overrides.
- Behavior fidelity
- adapted: Both variants render a real separator role with explicit aria-orientation. Custom color/thickness values are web composition overrides rather than new canonical tokens, and semantic dividers should not be inserted merely to create spacing where no meaningful boundary exists.
- Semantics fidelity
- adapted: Both variants render a real separator role with explicit aria-orientation. Custom color/thickness values are web composition overrides rather than new canonical tokens, and semantic dividers should not be inserted merely to create spacing where no meaningful boundary exists.
- Adaptations
- Both variants render a real separator role with explicit aria-orientation. Custom color/thickness values are web composition overrides rather than new canonical tokens, and semantic dividers should not be inserted merely to create spacing where no meaningful boundary exists.
FABStructured fidelity
- Compose mapping
- FloatingActionButton · ExtendedFloatingActionButton
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements small, baseline, medium, and large FAB families, matching extended FAB sizes, container-role variants, default/lowered elevation, interactive elevation motion, extended collapse behavior, and the pinned branded/material-web variants present in the audited source surface.
- Behavior fidelity
- adapted: React Aria Button owns action semantics and interaction state. Icon-only FAB content is presentation-only and therefore requires an accessible name; collapsed extended FABs derive one from string label content when possible. Branded and solid/surface variant vocabulary is preserved as an audited Material Web compatibility surface rather than presented as a Compose-only API.
- Semantics fidelity
- adapted: React Aria Button owns action semantics and interaction state. Icon-only FAB content is presentation-only and therefore requires an accessible name; collapsed extended FABs derive one from string label content when possible. Branded and solid/surface variant vocabulary is preserved as an audited Material Web compatibility surface rather than presented as a Compose-only API.
- Adaptations
- React Aria Button owns action semantics and interaction state. Icon-only FAB content is presentation-only and therefore requires an accessible name; collapsed extended FABs derive one from string label content when possible. Branded and solid/surface variant vocabulary is preserved as an audited Material Web compatibility surface rather than presented as a Compose-only API.
Floating action button menusStructured fidelity
- Compose mapping
- FloatingActionButtonMenu · FloatingActionButtonMenuItem · ToggleFloatingActionButton
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements controlled FAB-menu expansion, logical start/end alignment, staggered action reveal, bounded overflow content, disabled action items, keyboard focus transfer/restoration, and a baseline/medium/large toggle FAB that morphs to close geometry.
- Behavior fidelity
- adapted: The action collection is a labeled role=group of ordinary button actions rather than an ARIA menu. The trigger keeps aria-expanded/aria-controls, expanded state remains application-owned, and reduced motion removes stagger/morph timing without changing focus or controlled state semantics.
- Semantics fidelity
- adapted: The action collection is a labeled role=group of ordinary button actions rather than an ARIA menu. The trigger keeps aria-expanded/aria-controls, expanded state remains application-owned, and reduced motion removes stagger/morph timing without changing focus or controlled state semantics.
- Adaptations
- The action collection is a labeled role=group of ordinary button actions rather than an ARIA menu. The trigger keeps aria-expanded/aria-controls, expanded state remains application-owned, and reduced motion removes stagger/morph timing without changing focus or controlled state semantics.
Floating toolbarsStructured fidelity
- Compose mapping
- HorizontalFloatingToolbar · VerticalFloatingToolbar · FloatingToolbarState · FloatingToolbarExitDirection · FloatingToolbarDefaults
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements horizontal and vertical floating toolbars, standard/vibrant variants, expanded/collapsed conditional content, optional adjacent FAB placement, token-backed elevation/shape, and offset-based exit translation.
- Behavior fidelity
- adapted: The root exposes toolbar semantics and orientation. Expanded state and scroll offset are explicit application-owned inputs; the component does not subscribe to page scroll or choose a navigation mode. Logical start/end exit translation respects RTL.
- Semantics fidelity
- adapted: The root exposes toolbar semantics and orientation. Expanded state and scroll offset are explicit application-owned inputs; the component does not subscribe to page scroll or choose a navigation mode. Logical start/end exit translation respects RTL.
- Adaptations
- The root exposes toolbar semantics and orientation. Expanded state and scroll offset are explicit application-owned inputs; the component does not subscribe to page scroll or choose a navigation mode. Logical start/end exit translation respects RTL.
Icon buttonsStructured fidelity
- Compose mapping
- IconButton · IconToggleButton
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements standard, filled, filled-tonal, and outlined action and toggle icon buttons with the audited extra-small through extra-large size family, narrow/default/wide widths, round/square shapes, state layers, and expressive shape helpers.
- Behavior fidelity
- adapted: React Aria Button and ToggleButton own action/toggle semantics, disabled state, keyboard/pointer behavior, selection, hover, and focus visibility. The icon is visually hidden from accessibility so every icon-only control needs an accessible name on the button itself.
- Semantics fidelity
- adapted: React Aria Button and ToggleButton own action/toggle semantics, disabled state, keyboard/pointer behavior, selection, hover, and focus visibility. The icon is visually hidden from accessibility so every icon-only control needs an accessible name on the button itself.
- Adaptations
- React Aria Button and ToggleButton own action/toggle semantics, disabled state, keyboard/pointer behavior, selection, hover, and focus visibility. The icon is visually hidden from accessibility so every icon-only control needs an accessible name on the button itself.
Lists4 reviewed capabilities
- Compose mapping
- ListItem · SegmentedListItem · ListItemDefaults.segmentedShapes
- Reviewed capability coverage
- Standard passive and action rows [supported] → ListItem
- Single-selection list rows [supported] → ListItem, ListItemSelectionGroup
- Multiple-selection list rows [supported] → ListItem
- Segmented list composition and positional geometry [supported] → ListItem, SegmentedListItemGroup
- Visual fidelity
- aligned: Reviewed standard and segmented ListItem geometry, positional shapes, state shapes, spacing, and Material roles are covered by canonical tokens and browser evidence.
- Behavior fidelity
- adapted: Passive rows remain div content; action rows use React Aria Button semantics. Single-selection rows expose radio semantics and an optional roving-focus ListItemSelectionGroup, while multiple-selection rows expose checkbox semantics. Segmented grouping is presentation-only: DOM position determines the idle base corners, while hover/focus/press/selected/dragged states still replace the full shape. Dragged state does not implement browser drag-and-drop by itself.
- Semantics fidelity
- adapted: Passive rows remain div content; action rows use React Aria Button semantics. Single-selection rows expose radio semantics and an optional roving-focus ListItemSelectionGroup, while multiple-selection rows expose checkbox semantics. Segmented grouping is presentation-only: DOM position determines the idle base corners, while hover/focus/press/selected/dragged states still replace the full shape. Dragged state does not implement browser drag-and-drop by itself.
- Adaptations
- Passive rows remain div content; action rows use React Aria Button semantics. Single-selection rows expose radio semantics and an optional roving-focus ListItemSelectionGroup, while multiple-selection rows expose checkbox semantics. Segmented grouping is presentation-only: DOM position determines the idle base corners, while hover/focus/press/selected/dragged states still replace the full shape. Dragged state does not implement browser drag-and-drop by itself.
Loading indicatorStructured fidelity
- Compose mapping
- LoadingIndicator · ContainedLoadingIndicator
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements the expressive morphing loading indicator and contained variant with the canonical Material shape sequence, Compose-derived motion timing, 0..1 determinate morphing, indeterminate shape cycling, and reduced-motion freezing.
- Behavior fidelity
- adapted: React Aria ProgressBar owns progress semantics. Omitting `value` selects indeterminate mode and supplying a value selects determinate mode; the SVG renderer is aria-hidden and consumers must provide an accessible name. The Material Shapes port remains an internal renderer mechanism rather than a new public shape contract.
- Semantics fidelity
- adapted: React Aria ProgressBar owns progress semantics. Omitting `value` selects indeterminate mode and supplying a value selects determinate mode; the SVG renderer is aria-hidden and consumers must provide an accessible name. The Material Shapes port remains an internal renderer mechanism rather than a new public shape contract.
- Adaptations
- React Aria ProgressBar owns progress semantics. Omitting `value` selects indeterminate mode and supplying a value selects determinate mode; the SVG renderer is aria-hidden and consumers must provide an accessible name. The Material Shapes port remains an internal renderer mechanism rather than a new public shape contract.
Menus7 reviewed capabilities
- Compose mapping
- DropdownMenu · DropdownMenuItem · SelectableDropdownMenuItem · CheckableDropdownMenuItem · DropdownMenuGroup · cascading submenu composition · ExposedMenu read-only selection · ExposedDropdownMenu editable/read-only combobox and listbox selection
- Reviewed capability coverage
- Action menu items [supported] → Menu, MenuItem
- Single-selection menu items [supported] → Menu, MenuItem
- Multiple-selection/checkable menu items [supported] → Menu, MenuItem
- Segmented groups and vibrant presentation [supported] → MenuSection
- Cascading submenu composition [supported] → MenuSubmenu
- Read-only exposed menu selection [supported] → ExposedMenu
- Editable or read-only exposed combobox/listbox [adapted] → ExposedDropdownMenu — The browser mapping uses a combobox input plus listbox/options so native text editing can remain editable; isReadOnly preserves the non-editable form of the same public surface.
- Visual fidelity
- aligned: Reviewed action, selectable/checkable, segmented/vibrant group, submenu, and exposed-menu surfaces use audited Material geometry, roles, states, elevation, and color treatment.
- Behavior fidelity
- adapted: React Aria owns menu/menuitem/menuitemradio/menuitemcheckbox semantics, selection state, roving focus, Arrow/Home/End movement, typeahead, logical-direction submenu disclosure, Escape, outside dismissal, overlay positioning, and focus restoration. MenuSubmenu maps Material cascading-menu presentation onto React Aria SubmenuTrigger rather than duplicating its focus or keyboard engine. ExposedMenu is a React Aria MenuTrigger/Button rendered with the Material filled TextField presentation, so React Aria also owns trigger press/keyboard/open/focus and aria-haspopup/expanded behavior. ExposedDropdownMenu is a separate browser-native combobox/listbox mapping: it can be editable or read-only, keeps text editing on the input, and leaves filtering/query policy to application code.
- Semantics fidelity
- adapted: React Aria owns menu/menuitem/menuitemradio/menuitemcheckbox semantics, selection state, roving focus, Arrow/Home/End movement, typeahead, logical-direction submenu disclosure, Escape, outside dismissal, overlay positioning, and focus restoration. MenuSubmenu maps Material cascading-menu presentation onto React Aria SubmenuTrigger rather than duplicating its focus or keyboard engine. ExposedMenu is a React Aria MenuTrigger/Button rendered with the Material filled TextField presentation, so React Aria also owns trigger press/keyboard/open/focus and aria-haspopup/expanded behavior. ExposedDropdownMenu is a separate browser-native combobox/listbox mapping: it can be editable or read-only, keeps text editing on the input, and leaves filtering/query policy to application code.
- Adaptations
- React Aria owns menu/menuitem/menuitemradio/menuitemcheckbox semantics, selection state, roving focus, Arrow/Home/End movement, typeahead, logical-direction submenu disclosure, Escape, outside dismissal, overlay positioning, and focus restoration. MenuSubmenu maps Material cascading-menu presentation onto React Aria SubmenuTrigger rather than duplicating its focus or keyboard engine. ExposedMenu is a React Aria MenuTrigger/Button rendered with the Material filled TextField presentation, so React Aria also owns trigger press/keyboard/open/focus and aria-haspopup/expanded behavior. ExposedDropdownMenu is a separate browser-native combobox/listbox mapping: it can be editable or read-only, keeps text editing on the input, and leaves filtering/query policy to application code.
Non-interactive scrollbarStructured fidelity
- Compose mapping
- Modifier.nonInteractiveScrollbar · NonInteractiveScrollbarDefaults
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements vertical and horizontal visual scroll-position indicators with overflow detection, minimum/maximum thumb geometry, optional fading, ResizeObserver/mutation updates, custom metrics adapters, and RTL-aware horizontal offsets.
- Behavior fidelity
- adapted: The rendered scrollbar is aria-hidden and pointer-events:none by design. Native or application scroll containers remain the interaction owner; the overlay only observes scroll metrics and never becomes an alternate scrolling control.
- Semantics fidelity
- adapted: The rendered scrollbar is aria-hidden and pointer-events:none by design. Native or application scroll containers remain the interaction owner; the overlay only observes scroll metrics and never becomes an alternate scrolling control.
- Adaptations
- The rendered scrollbar is aria-hidden and pointer-events:none by design. Native or application scroll containers remain the interaction owner; the overlay only observes scroll metrics and never becomes an alternate scrolling control.
Progress indicatorsStructured fidelity
- Compose mapping
- LinearProgressIndicator · CircularProgressIndicator · LinearWavyProgressIndicator · CircularWavyProgressIndicator
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements standard linear/circular progress plus M3 Expressive wavy linear/circular variants, determinate and indeterminate states, canonical stop/track geometry, reduced-motion behavior, and the current Compose-derived wavy amplitude and wavelength lifecycle.
- Behavior fidelity
- adapted: React Aria ProgressBar owns progressbar semantics and value ranges; indicators require an accessible name because the visual has no label. Standard `bufferValue` and indeterminate `fourColor` remain audited Material Web renderer adaptations and are intentionally not inherited by the wavy Compose-aligned APIs.
- Semantics fidelity
- adapted: React Aria ProgressBar owns progressbar semantics and value ranges; indicators require an accessible name because the visual has no label. Standard `bufferValue` and indeterminate `fourColor` remain audited Material Web renderer adaptations and are intentionally not inherited by the wavy Compose-aligned APIs.
- Adaptations
- React Aria ProgressBar owns progressbar semantics and value ranges; indicators require an accessible name because the visual has no label. Standard `bufferValue` and indeterminate `fourColor` remain audited Material Web renderer adaptations and are intentionally not inherited by the wavy Compose-aligned APIs.
Pull to refreshStructured fidelity
- Compose mapping
- PullToRefreshBox · PullToRefreshState · PullToRefreshDefaults.Indicator
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements Material pull progress, armed/refreshing lifecycle, thresholded release, app-controlled refreshing state, a customizable indicator render contract, and top-edge arbitration across nested scrollable content.
- Behavior fidelity
- adapted: Pointer input and DOM scroll inspection replace Compose nested-scroll plumbing. The component claims a downward gesture only when the relevant scroll roots are at their top edge, invokes onRefresh once after an armed release, and exposes the default refreshing indicator through a polite status region while the application remains the owner of refresh completion.
- Semantics fidelity
- adapted: Pointer input and DOM scroll inspection replace Compose nested-scroll plumbing. The component claims a downward gesture only when the relevant scroll roots are at their top edge, invokes onRefresh once after an armed release, and exposes the default refreshing indicator through a polite status region while the application remains the owner of refresh completion.
- Adaptations
- Pointer input and DOM scroll inspection replace Compose nested-scroll plumbing. The component claims a downward gesture only when the relevant scroll roots are at their top edge, invokes onRefresh once after an armed release, and exposes the default refreshing indicator through a polite status region while the application remains the owner of refresh completion.
Radio buttonsStructured fidelity
- Compose mapping
- RadioButton · RadioGroup
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements Material radio-button selection visuals plus a group primitive with label, description, validation error, and vertical or horizontal arrangement.
- Behavior fidelity
- adapted: React Aria owns radio-group selection, keyboard navigation, labeling, descriptions, validation, and focus semantics. Material tokens and ripple presentation are layered onto that browser interaction model.
- Semantics fidelity
- adapted: React Aria owns radio-group selection, keyboard navigation, labeling, descriptions, validation, and focus semantics. Material tokens and ripple presentation are layered onto that browser interaction model.
- Adaptations
- React Aria owns radio-group selection, keyboard navigation, labeling, descriptions, validation, and focus semantics. Material tokens and ripple presentation are layered onto that browser interaction model.
ScrimStructured fidelity
- Compose mapping
- Scrim · ScrimDefaults
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements the token-backed Material scrim color and alpha contract in passive and dismissible forms. The primitive only renders the obscuring layer and optional dismissal action.
- Behavior fidelity
- adapted: A passive scrim is aria-hidden. Supplying onDismiss renders a native button with an accessible name, but the scrim still does not own a portal, focus trap, Escape handling, modal state, or stacking policy; those belong to the surrounding overlay composition.
- Semantics fidelity
- adapted: A passive scrim is aria-hidden. Supplying onDismiss renders a native button with an accessible name, but the scrim still does not own a portal, focus trap, Escape handling, modal state, or stacking policy; those belong to the surrounding overlay composition.
- Adaptations
- A passive scrim is aria-hidden. Supplying onDismiss renders a native button with an accessible name, but the scrim still does not own a portal, focus trap, Escape handling, modal state, or stacking policy; those belong to the surrounding overlay composition.
Scroll fieldStructured fidelity
- Compose mapping
- ScrollField · ScrollFieldState · rememberScrollFieldState
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements Material scroll-wheel selection with a centered selected option, controlled/uncontrolled indices, fixed or generated item content, wheel/pointer/keyboard input, disabled state, and reduced-motion-aware scrolling.
- Behavior fidelity
- adapted: The wheel is exposed as one spinbutton with value min/max/now/text instead of many repeated selectable nodes. getItemText supplies the accessibility description corresponding to Compose fieldAccessibilityDescription, and ResizeObserver measures only the local field height for presentation rather than adaptive layout.
- Semantics fidelity
- adapted: The wheel is exposed as one spinbutton with value min/max/now/text instead of many repeated selectable nodes. getItemText supplies the accessibility description corresponding to Compose fieldAccessibilityDescription, and ResizeObserver measures only the local field height for presentation rather than adaptive layout.
- Adaptations
- The wheel is exposed as one spinbutton with value min/max/now/text instead of many repeated selectable nodes. getItemText supplies the accessibility description corresponding to Compose fieldAccessibilityDescription, and ResizeObserver measures only the local field height for presentation rather than adaptive layout.
Search6 reviewed capabilities
- Compose mapping
- SearchBar · ExpandedDockedSearchBar · ExpandedDockedSearchBarWithGap · ExpandedFullScreenSearchBar · ExpandedFullScreenContainedSearchBar · AppBarWithSearch
- Reviewed capability coverage
- Collapsed search bar/input [supported] → SearchBar, SearchBarInput
- Attached docked expanded search [supported] → ExpandedDockedSearchBar
- Split docked search with results gap [supported] → ExpandedDockedSearchBarWithGap
- Full-screen expanded search [supported] → ExpandedFullScreenSearchBar
- Contained full-screen expanded search [supported] → ExpandedFullScreenContainedSearchBar
- App bar with integrated search [adapted] → AppBarWithSearch — AppBarWithSearch preserves the reviewed Material composition and scrolled color state, while the application supplies an explicit overlap fraction instead of installing Compose-style nested-scroll ownership.
- Visual fidelity
- aligned: Reviewed collapsed, docked, split docked, full-screen contained, and app-bar search surfaces use the audited Material hierarchy, geometry, roles, and color states.
- Behavior fidelity
- adapted: SearchBarInput renders a native search form and search input. React Aria owns full-screen modal/dialog focus and dismissal behavior; docked surfaces use narrow outside-pointer/Escape handling without owning scroll. AppBarWithSearch consumes an application-owned overlappedFraction rather than installing Compose-style nested-scroll machinery. Search-result retrieval remains application-owned.
- Semantics fidelity
- adapted: SearchBarInput renders a native search form and search input. React Aria owns full-screen modal/dialog focus and dismissal behavior; docked surfaces use narrow outside-pointer/Escape handling without owning scroll. AppBarWithSearch consumes an application-owned overlappedFraction rather than installing Compose-style nested-scroll machinery. Search-result retrieval remains application-owned.
- Adaptations
- SearchBarInput renders a native search form and search input. React Aria owns full-screen modal/dialog focus and dismissal behavior; docked surfaces use narrow outside-pointer/Escape handling without owning scroll. AppBarWithSearch consumes an application-owned overlappedFraction rather than installing Compose-style nested-scroll machinery. Search-result retrieval remains application-owned.
Segmented buttonsStructured fidelity
- Compose mapping
- SingleChoiceSegmentedButtonRow · MultiChoiceSegmentedButtonRow · SegmentedButton
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements the Material outlined segmented-button geometry, selected/unselected color and state layers, default selected check mark, optional inactive/selected icon slots, and separate single-choice and multi-choice row primitives.
- Behavior fidelity
- adapted: Single-choice rows use React Aria RadioGroup/Radio semantics while multi-choice segments use independent React Aria Checkbox semantics inside a grouped container. The separate APIs preserve the accessibility model instead of collapsing radio and multi-toggle state into one generic selection contract.
- Semantics fidelity
- adapted: Single-choice rows use React Aria RadioGroup/Radio semantics while multi-choice segments use independent React Aria Checkbox semantics inside a grouped container. The separate APIs preserve the accessibility model instead of collapsing radio and multi-toggle state into one generic selection contract.
- Adaptations
- Single-choice rows use React Aria RadioGroup/Radio semantics while multi-choice segments use independent React Aria Checkbox semantics inside a grouped container. The separate APIs preserve the accessibility model instead of collapsing radio and multi-toggle state into one generic selection contract.
SlidersStructured fidelity
- Compose mapping
- Slider · RangeSlider
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements single-value and range Material sliders, the audited size family, active/inactive track segments, stop indicator, accessible per-thumb labels, orientation, and stepped values.
- Behavior fidelity
- adapted: React Aria owns slider and thumb semantics, keyboard input, pointer dragging, value state, orientation, and accessible labels. `showTicks` and `showValueIndicator` are intentional Material Web adaptations layered onto the audited Material geometry.
- Semantics fidelity
- adapted: React Aria owns slider and thumb semantics, keyboard input, pointer dragging, value state, orientation, and accessible labels. `showTicks` and `showValueIndicator` are intentional Material Web adaptations layered onto the audited Material geometry.
- Adaptations
- React Aria owns slider and thumb semantics, keyboard input, pointer dragging, value state, orientation, and accessible labels. `showTicks` and `showValueIndicator` are intentional Material Web adaptations layered onto the audited Material geometry.
SnackbarStructured fidelity
- Compose mapping
- Snackbar surface
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements the Material snackbar surface, message, optional action, optional dismiss action, long-action-on-new-line composition, canonical colors/shape/elevation, and shared Material button interaction engines for actions.
- Behavior fidelity
- adapted: The message is exposed as a polite atomic live status region. Queueing, replacement, timeout, and host policy are intentionally not implemented by this surface; applications own that state layer. SnackbarAction and SnackbarDismissAction reuse the accessible React Aria button and icon-button engines.
- Semantics fidelity
- adapted: The message is exposed as a polite atomic live status region. Queueing, replacement, timeout, and host policy are intentionally not implemented by this surface; applications own that state layer. SnackbarAction and SnackbarDismissAction reuse the accessible React Aria button and icon-button engines.
- Adaptations
- The message is exposed as a polite atomic live status region. Queueing, replacement, timeout, and host policy are intentionally not implemented by this surface; applications own that state layer. SnackbarAction and SnackbarDismissAction reuse the accessible React Aria button and icon-button engines.
Split buttonsStructured fidelity
- Compose mapping
- SplitButton visual/action contract
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements filled, tonal, elevated, and outlined split buttons across the public Material button size family, with audited leading/trailing shape geometry, press morphing, independent disabled states, and trailing expanded or checked state exposure.
- Behavior fidelity
- adapted: Both halves reuse the React Aria-backed Material button engine. The trailing button can expose aria-expanded for an externally composed disclosure or aria-pressed for a true toggle, but SplitButton deliberately does not create or own a menu/popover; applications own that secondary surface and focus lifecycle.
- Semantics fidelity
- adapted: Both halves reuse the React Aria-backed Material button engine. The trailing button can expose aria-expanded for an externally composed disclosure or aria-pressed for a true toggle, but SplitButton deliberately does not create or own a menu/popover; applications own that secondary surface and focus lifecycle.
- Adaptations
- Both halves reuse the React Aria-backed Material button engine. The trailing button can expose aria-expanded for an externally composed disclosure or aria-pressed for a true toggle, but SplitButton deliberately does not create or own a menu/popover; applications own that secondary surface and focus lifecycle.
SurfaceStructured fidelity
- Compose mapping
- Surface passive/clickable/selectable/toggleable overloads
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements passive and interactive Material surfaces with explicit shape, border, content color, accumulated tonal elevation, shadow elevation, disabled state, and selectable/toggleable semantic roles.
- Behavior fidelity
- adapted: The web primitive renders a div and only becomes keyboard-focusable when an interaction contract is supplied. Enter/Space activation and aria-checked/selected/pressed state follow the requested semantic role, while nested native controls keep their own activation instead of bubbling into the parent Surface.
- Semantics fidelity
- adapted: The web primitive renders a div and only becomes keyboard-focusable when an interaction contract is supplied. Enter/Space activation and aria-checked/selected/pressed state follow the requested semantic role, while nested native controls keep their own activation instead of bubbling into the parent Surface.
- Adaptations
- The web primitive renders a div and only becomes keyboard-focusable when an interaction contract is supplied. Enter/Space activation and aria-checked/selected/pressed state follow the requested semantic role, while nested native controls keep their own activation instead of bubbling into the parent Surface.
Swipe to dismissStructured fidelity
- Compose mapping
- SwipeToDismissBox · SwipeToDismissBoxState · SwipeToDismissBoxValue
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements settled/start-to-end/end-to-start Material anchors, independent direction enablement, horizontal intent locking, positional and velocity settling, controlled/uncontrolled state, post-settle dismissal callbacks, RTL logical direction, and reduced-motion behavior.
- Behavior fidelity
- adapted: Pointer gesture arbitration rejects vertical intent so page scrolling survives, while foreground links, buttons, inputs, and other controls retain their own DOM semantics. Dismissal updates component state but collection removal, undo, and persistence remain application responsibilities.
- Semantics fidelity
- adapted: Pointer gesture arbitration rejects vertical intent so page scrolling survives, while foreground links, buttons, inputs, and other controls retain their own DOM semantics. Dismissal updates component state but collection removal, undo, and persistence remain application responsibilities.
- Adaptations
- Pointer gesture arbitration rejects vertical intent so page scrolling survives, while foreground links, buttons, inputs, and other controls retain their own DOM semantics. Dismissal updates component state but collection removal, undo, and persistence remain application responsibilities.
SwitchesStructured fidelity
- Compose mapping
- Switch
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements Material selected and unselected track/thumb states, optional thumb content, disabled treatment, hover and focus state layers, and both supported ripple focus treatments.
- Behavior fidelity
- adapted: React Aria owns switch semantics, selection state, keyboard and pointer interaction, focus visibility, and labeling. Optional thumb content maps Compose icon-sized thumb content into React content without changing the control semantics.
- Semantics fidelity
- adapted: React Aria owns switch semantics, selection state, keyboard and pointer interaction, focus visibility, and labeling. Optional thumb content maps Compose icon-sized thumb content into React content without changing the control semantics.
- Adaptations
- React Aria owns switch semantics, selection state, keyboard and pointer interaction, focus visibility, and labeling. Optional thumb content maps Compose icon-sized thumb content into React content without changing the control semantics.
TabsStructured fidelity
- Compose mapping
- PrimaryTabRow · SecondaryTabRow · PrimaryScrollableTabRow · SecondaryScrollableTabRow · Tab · LeadingIconTab
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements primary and secondary Material tab-list surfaces in fixed and scrollable modes, with labels, icons, disabled states, leading-icon mapping, canonical indicator geometry, divider composition, and reduced-motion-aware selected-item scrolling.
- Behavior fidelity
- adapted: React Aria Tabs, TabList, and Tab own tab semantics, roving keyboard focus, disabled state, and automatic keyboard activation. This component intentionally stops at the tab list; applications connect the selected key to their own route or panel content instead of receiving hidden tab panels from the visual primitive.
- Semantics fidelity
- adapted: React Aria Tabs, TabList, and Tab own tab semantics, roving keyboard focus, disabled state, and automatic keyboard activation. This component intentionally stops at the tab list; applications connect the selected key to their own route or panel content instead of receiving hidden tab panels from the visual primitive.
- Adaptations
- React Aria Tabs, TabList, and Tab own tab semantics, roving keyboard focus, disabled state, and automatic keyboard activation. This component intentionally stops at the tab list; applications connect the selected key to their own route or panel content instead of receiving hidden tab panels from the visual primitive.
Text fieldsStructured fidelity
- Compose mapping
- TextField · OutlinedTextField
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implemented as filled and outlined Material text fields with labels, supporting and error text, leading and trailing icons, prefix and suffix content, and single-line or multiline controls.
- Behavior fidelity
- adapted: React Aria owns field, label, description, validation, native input, and textarea semantics. The browser control model is preserved instead of recreating Compose text-input internals.
- Semantics fidelity
- adapted: React Aria owns field, label, description, validation, native input, and textarea semantics. The browser control model is preserved instead of recreating Compose text-input internals.
- Adaptations
- React Aria owns field, label, description, validation, native input, and textarea semantics. The browser control model is preserved instead of recreating Compose text-input internals.
Time pickers4 reviewed capabilities
- Compose mapping
- TimePicker · TimeInput · TimeScroll · TimePickerState.hourInput/minuteInput
- Reviewed capability coverage
- Clock-dial time selection [supported] → TimePicker
- Numeric time input [supported] → TimeInput
- Scroll-wheel time selection [supported] → TimeScroll
- Raw hour/minute draft state distinct from the last valid time [adapted] → TimeInput, TimeInputDraftValue — Browser-native drafts are exposed as strings so empty and invalid intermediate text can be represented without corrupting the normalized TimeOfDay value.
- Visual fidelity
- aligned: Reviewed dial, numeric input, and expressive scroll presentations use audited Material geometry, roles, theme paint, and 12/24-hour presentation.
- Behavior fidelity
- adapted: The active clock face uses slider semantics, AM/PM uses radio-group semantics, TimeScroll reuses the shared ScrollField keyboard/wheel/pointer engine, and TimeInput exposes raw browser text drafts as strings rather than porting Kotlin state objects. layout="auto" observes only the picker container to choose dial orientation; applications own any dialog or mode-switch composition.
- Semantics fidelity
- adapted: The active clock face uses slider semantics, AM/PM uses radio-group semantics, TimeScroll reuses the shared ScrollField keyboard/wheel/pointer engine, and TimeInput exposes raw browser text drafts as strings rather than porting Kotlin state objects. layout="auto" observes only the picker container to choose dial orientation; applications own any dialog or mode-switch composition.
- Adaptations
- The active clock face uses slider semantics, AM/PM uses radio-group semantics, TimeScroll reuses the shared ScrollField keyboard/wheel/pointer engine, and TimeInput exposes raw browser text drafts as strings rather than porting Kotlin state objects. layout="auto" observes only the picker container to choose dial orientation; applications own any dialog or mode-switch composition.
Toggle buttonsStructured fidelity
- Compose mapping
- ToggleButton · ElevatedToggleButton · FilledTonalToggleButton · OutlinedToggleButton
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements filled, elevated, filled-tonal, and outlined controlled toggle buttons with selected/unselected Material state, optional start icon, disabled treatment, expressive size buckets, token-backed shape/elevation/color transitions, and reduced-motion support.
- Behavior fidelity
- adapted: React Aria ToggleButton owns native button interaction and exposes the controlled selected state with aria-pressed. This intentionally differs from Compose checkbox-role semantics while preserving the browser-native pressable-toggle model, keyboard activation, focus behavior, and disabled state.
- Semantics fidelity
- adapted: React Aria ToggleButton owns native button interaction and exposes the controlled selected state with aria-pressed. This intentionally differs from Compose checkbox-role semantics while preserving the browser-native pressable-toggle model, keyboard activation, focus behavior, and disabled state.
- Adaptations
- React Aria ToggleButton owns native button interaction and exposes the controlled selected state with aria-pressed. This intentionally differs from Compose checkbox-role semantics while preserving the browser-native pressable-toggle model, keyboard activation, focus behavior, and disabled state.
Tooltips3 reviewed capabilities
- Compose mapping
- PlainTooltip · RichTooltip · TooltipDefaults.caretSize/caretShape · TooltipBox/tooltip state behavior
- Reviewed capability coverage
- Plain tooltip [supported] → PlainTooltip
- Rich tooltip [supported] → RichTooltip
- Optional tooltip caret with collision-aware orientation [adapted] → PlainTooltip, RichTooltip — The Material 16×8 caret is CSS presentation while React Aria remains the sole owner of overlay measurement, collision flipping, and resolved physical placement.
- Visual fidelity
- aligned: Reviewed plain/rich tooltip surfaces and the canonical 16×8 optional caret are covered across placement, theme, and collision-flip presentation.
- Behavior fidelity
- adapted: Plain tooltips use the React Aria tooltip pattern and accessible description wiring. Rich tooltips can contain actions, so they intentionally use non-modal dialog semantics with aria-haspopup/expanded/controls relationships instead of misusing the non-interactive ARIA tooltip role. Logical start/end caret placement is normalized to physical placement from explicit dir or React Aria locale direction, while React Aria still owns measurement, collision, and flipping.
- Semantics fidelity
- adapted: Plain tooltips use the React Aria tooltip pattern and accessible description wiring. Rich tooltips can contain actions, so they intentionally use non-modal dialog semantics with aria-haspopup/expanded/controls relationships instead of misusing the non-interactive ARIA tooltip role. Logical start/end caret placement is normalized to physical placement from explicit dir or React Aria locale direction, while React Aria still owns measurement, collision, and flipping.
- Adaptations
- Plain tooltips use the React Aria tooltip pattern and accessible description wiring. Rich tooltips can contain actions, so they intentionally use non-modal dialog semantics with aria-haspopup/expanded/controls relationships instead of misusing the non-interactive ARIA tooltip role. Logical start/end caret placement is normalized to physical placement from explicit dir or React Aria locale direction, while React Aria still owns measurement, collision, and flipping.
Top app barsStructured fidelity
- Compose mapping
- TopAppBar · CenterAlignedTopAppBar · MediumTopAppBar · LargeTopAppBar · MediumFlexibleTopAppBar · LargeFlexibleTopAppBar · TopAppBarScrollBehavior
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements small, center-aligned, medium, medium-flexible, large, and large-flexible top app bar variants with title/navigation/action slots, flexible subtitles, token-backed collapsed/expanded geometry, scrolled container treatment, and explicit scroll-state helpers.
- Behavior fidelity
- adapted: The component renders a semantic header and receives scroll fractions/state as data rather than installing a page scroll listener. Icon controls remain independently accessible Material buttons, while centered-title measurement observes only the app bar and its own slots.
- Semantics fidelity
- adapted: The component renders a semantic header and receives scroll fractions/state as data rather than installing a page scroll listener. Icon controls remain independently accessible Material buttons, while centered-title measurement observes only the app bar and its own slots.
- Adaptations
- The component renders a semantic header and receives scroll fractions/state as data rather than installing a page scroll listener. Icon controls remain independently accessible Material buttons, while centered-title measurement observes only the app bar and its own slots.
Vertical drag handleStructured fidelity
- Compose mapping
- VerticalDragHandle · DragHandleShapes
- Visual fidelity
- partial: Legacy visual fidelity has not received an explicit reviewed disposition. Current implementation evidence: Implements the Material vertical drag-handle visual, press/ripple feedback, and controlled dragged-state shape treatment through isDragged.
- Behavior fidelity
- adapted: The primitive deliberately does not invent resize state or a drag recognizer. The owner supplies separator semantics, keyboard resizing, pointer movement, aria-valuemin/max/now, and the controlled isDragged state that matches its actual resize lifecycle.
- Semantics fidelity
- adapted: The primitive deliberately does not invent resize state or a drag recognizer. The owner supplies separator semantics, keyboard resizing, pointer movement, aria-valuemin/max/now, and the controlled isDragged state that matches its actual resize lifecycle.
- Adaptations
- The primitive deliberately does not invent resize state or a drag recognizer. The owner supplies separator semantics, keyboard resizing, pointer movement, aria-valuemin/max/now, and the controlled isDragged state that matches its actual resize lifecycle.
Reviewed 1.5.x release-note dispositions
- bottom-app-bar: adapted — The reviewed vibrant sample customizes container color through ordinary composition; the existing web surface already exposes equivalent color/style composition and does not need a Kotlin-shaped sample API.
- slider: supported — Vertical orientation is already a public Slider/RangeSlider capability owned by React Aria semantics and Material presentation.
- pull-to-refresh: adapted — The reviewed IndicatorMaxDistance default is observably covered by the existing threshold/indicator-distance contract; no duplicate Kotlin constant is needed on the web surface.
- top-app-bar: adapted — Web composition/style overrides already express app-bar content padding; source-shape parity alone does not justify another public Kotlin-shaped parameter.
- chip: adapted — Existing slots and web style composition can express custom content padding/spacing while canonical defaults stay token-owned.
- text-field: adapted — Native password-input semantics are the intentional browser mapping; Compose obfuscation plumbing is not copied as a second text-editing engine.
- layout-three-pane-scaffold: excluded — Compose saveable-state holder mechanics are implementation plumbing rather than a browser public-contract requirement; the web lifecycle adaptation is documented separately.
- button: excluded — MutableInteractionSource internals are not a public web capability; React Aria normalized interaction state remains the browser source of truth.
- search-bar: excluded — Compose scroll-state holder and nested-scroll plumbing are not ported when observable search/app-bar state can be represented by explicit application-owned web state.
How to read it
Every entry separates provenance into spec, compose, web, and adaptation evidence. Material overview, guideline, and specification links are recorded independently when they are available; an Android Developers reference is treated as Compose evidence rather than silently promoted to Material-site guidance.
Visual, behavior, and semantics fidelity are independent fields. aligned, adapted, partial, and not-applicable are descriptive states, not percentages. Families that have completed an upstream capability review also show semantic capability dispositions (supported, adapted, excluded, or a tracked gap) and their public m3-ui mappings. Intentional adaptations, exclusions, and known gaps stay explicit rather than being folded into an ambiguous parity sentence.
Source-of-truth boundary
This page contains no second component inventory. allComponentDocs remains the documented component inventory, while allComponentProvenance resolves that inventory into the structured fidelity contract consumed by this catalog and the MDX fidelity renderer. Reviewed capability groups and the final release-note dispositions come from the generated material-conformance report, which is the same registry/report validated by CI. Sparse provenance overrides enrich individual entries without copying the full inventory.
Canonical dimensions, typography, color roles, motion values, and component tokens continue to come from the generated token graph and audited component runtime rather than this documentation surface.
Current exclusions
The catalog covers component guides that are intentionally published today. It does not promote BottomSheetScaffold, adaptive pane policy, window-size classes, or navigation-mode switching into this component registry while the dedicated layout/adaptive subsystem is evolving separately.
Foundations such as color, typography, and theming also remain outside the component count because they have their own runtime contracts and documentation sections.