Modal Navigation Helpers
Component Detail
User Interface
medium complexity
Shared Component
mobile
2
Dependencies
0
Dependents
0
Entities
0
Integrations
Description
Widget utilities managing modal presentation, dismissal, and focus trapping to meet WCAG 2.2 focus management requirements. Traps keyboard focus within open modals, restores focus to the trigger element on close, and provides accessible dismiss controls with semantic labels.
modal-navigation-helpers
Responsibilities
- Trap focus within modal dialogs and bottom sheets while open
- Restore focus to the triggering element when modal is dismissed
- Provide a close button with semantic label 'Close dialog' as required parameter
- Announce modal open and close events to screen readers via Semantics live region
- Support both tap-outside and explicit close button dismissal with WCAG dragging alternatives
Interfaces
showAccessibleModal({required Widget content, required String semanticLabel})
showAccessibleBottomSheet({required Widget content, required String title})
ModalCloseButton({required VoidCallback onClose, String label = 'Close'})
AccessibleDialog({required String title, required Widget content})
dismissModal(BuildContext context)
restoreFocus(FocusNode triggerNode)
Relationships
Dependencies (2)
Components this component depends on