close
Skip to content

refactor(dialog): improve composition model and accessibility #4933

@ruben-rebelo

Description

@ruben-rebelo

Refactor Dialog to improve Material Design 3 compliance, remove problematic children patterns, improve performance characteristics, and modernize the public API.

Problems

  • Current API relies heavily on children composition in ways that are difficult to optimize
  • Internal layout logic is tightly coupled to arbitrary child structures
  • MD3 behaviors and visuals are not fully aligned with current Material guidelines
  • Rendering performance can degrade in large lists or frequently updated screens
  • Type safety and discoverability of the API can be improved
  • The component has inconsistent behavior between platforms and edge cases

Focus Areas

  • Simplify Dialog.Title / Dialog.Content / Dialog.Actions hierarchy
  • Improve keyboard and accessibility handling
  • Improve MD3 spacing and tonal elevation
  • Reduce excessive wrappers

Proposed API Direction

<Dialog title="Delete item" content="Are you sure?" actions={[...]} />

Performance Opportunities

  • Reduce nested layout complexity
  • Improve portal interaction handling
  • Reduce unnecessary rerenders during visibility updates

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions