Skip to content

Conversation

@ShaneK
Copy link
Member

@ShaneK ShaneK commented Jul 12, 2025

Issue number: resolves #30389


What is the current behavior?

Currently, when the element an ion-modal was presented from is removed, the modal stays presented and can be broken depending on the framework. This is unlike #30540, where children of open modals were being kept open. In this case, specifically the DOM element is being removed for whatever reason and the modal is staying open.

What is the new behavior?

We're now identifying our parent component on load and watching it with a mutation observer to determine if it gets removed from the DOM. If it does, we trigger a dismiss. This, conveniently, works nicely with #30540 and will dismiss all children and grandchildren as well.

Does this introduce a breaking change?

  • Yes
  • No

Other information

The issue this resolves was already marked closed, but on closer inspection I determined that was a mistake. I believed this issue was related to another one I was dealing with and it is, but it wasn't quite the same.

After this issue is merged, I believe we will have handled all avenues of possibly ending up with broken modals because of parent elements or modals being removed.

Relevant Test Page

Current dev build:

8.6.5-dev.11752329407.10f7fc80

@ShaneK ShaneK requested a review from a team as a code owner July 12, 2025 11:28
@ShaneK ShaneK requested a review from brandyscarney July 12, 2025 11:28
@vercel
Copy link

vercel bot commented Jul 12, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
ionic-framework ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 13, 2025 9:44pm

@github-actions github-actions bot added the package: core @ionic/core package label Jul 12, 2025
…numbers of grandparents being removed, causing the modal to be removed by nothing to observe it
Copy link
Member

@brandyscarney brandyscarney left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fix looks good! Great work! 🤖

@ShaneK ShaneK added this pull request to the merge queue Jul 14, 2025
Merged via the queue into main with commit 850338c Jul 14, 2025
81 of 96 checks passed
@ShaneK ShaneK deleted the fix/remove-modal-when-parent-removed branch July 14, 2025 18:06
github-merge-queue bot pushed a commit that referenced this pull request Dec 10, 2025
#30845)

Issue number: resolves internal

---------

## What is the current behavior?

When using ModalController to present a modal in Angular applications,
the browser becomes non-responsive and hangs in some circumstances. This
regression was introduced in #30544 with the addition of a
MutationObserver that watches document.body with subtree: true to detect
when a modal's parent element is removed from the DOM. For
controller-based modals, this observer fires on every DOM mutation in
the document, causing severe performance issues during Angular's change
detection cycles.

## What is the new behavior?

The MutationObserver for parent removal detection is now skipped for
controller-based modals and when the cached parent is the app root
(document.body or ion-app). These parents are never removed from the
DOM, so observing them is unnecessary. This prevents the performance
issues while still maintaining the parent removal detection behavior for
inline modals with meaningful parent elements.

## Does this introduce a breaking change?

- [ ] Yes
- [X] No

<!--
  If this introduces a breaking change:
1. Describe the impact and migration path for existing applications
below.
  2. Update the BREAKING.md file with the breaking change.
3. Add "BREAKING CHANGE: [...]" to the commit description when merging.
See
https://github.com/ionic-team/ionic-framework/blob/main/docs/CONTRIBUTING.md#footer
for more information.
-->


## Other information

<!-- Any other information that is important to this PR such as
screenshots of how the component looks before and after the change. -->

Current dev build:
```
8.7.12-dev.11765231260.1def96ab
```

---------

Co-authored-by: Maria Hutt <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

package: core @ionic/core package

Projects

None yet

Development

Successfully merging this pull request may close these issues.

bug: [Angular] inline ion-modal is not and cannot be dismissed when the parent component is destroyed

3 participants