docs(angular): document Angular 21 support and bump playground scaffolding to v21#4529
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
2 tasks
brandyscarney
requested changes
Jun 4, 2026
Member
brandyscarney
left a comment
brandyscarney
left a comment
There was a problem hiding this comment.
This looks good! We also need to update this file:
Can we check to make sure other Angular guides don't need any updates, including:
Member
Author
|
Good catch! Did the updates in 6438a64 |
| ## Angular Version Support | ||
|
|
||
| Ionic Angular v8 supports Angular versions 16 and above. For detailed information on supported versions and our support policy, see the [Ionic Angular Support Policy](/docs/reference/support#ionic-angular). | ||
| Ionic Angular v9 supports Angular versions 18 through 21. For detailed information on supported versions and our support policy, refer to the [Ionic Angular Support Policy](/docs/reference/support#ionic-angular). |
Member
There was a problem hiding this comment.
Can we make the refer to change on the versioned docs too so this overview page stays consistent:
brandyscarney
approved these changes
Jun 5, 2026
Member
brandyscarney
left a comment
brandyscarney
left a comment
There was a problem hiding this comment.
Looks good overall! One request on versioned docs. 👍
ShaneK
added a commit
to ionic-team/ionic-framework
that referenced
this pull request
Jun 5, 2026
Issue number: resolves #30907 --------- ## What is the current behavior? Ionic Angular only currently supports Angular 16-20 ## What is the new behavior? Ionic Angular now supports Angular 18 through 21 and drops 16 and 17. The ng16/ng17 test apps are removed, an ng21 app is added, and the tsconfigs are tightened for the 18+ minimum. `autocorrect` on `ion-input` and `ion-searchbar` becomes a `boolean` (default `false`), mapped internally to the native `'on'`/`'off'` attribute. This is required by TypeScript 5.9, which is required by Angular 21. It is the primary breaking change that forced this into a major version release of Ionic Framework. Also bundles v9 housekeeping: `@stencil/core` bumped to 4.43.5 and TypeScript 5.9 in the React and Vue test apps. ## Does this introduce a breaking change? - [x] Yes - [ ] No The following changes are required for migration: - Apps on Angular 16 or 17 must upgrade to 18 or later. - Existing NgModule projects upgrading to Angular 21 must add `provideZoneChangeDetection()` to `bootstrapModule`'s `applicationProviders` in `main.ts`. `ng-add` only patches standalone `app.config.ts`, not `main.ts`, so the NgModule path is manual (documented in the schematic's JSDoc). - `autocorrect` now takes `true`/`false` instead of `'on'`/`'off'`. Replace `autocorrect="on"` with `[autocorrect]="true"` and `autocorrect="off"` (or the default) with `false`. ## Other information Preview: - Autcorrect (no visual difference, just it's not broken despite the new type): [input basic](https://ionic-framework-git-feat-angular-21-support-ionic1.vercel.app/src/components/input/test/basic) - [Angular 21](https://ionic-framework-git-feat-angular-21-support-ionic1.vercel.app/angular/) Current dev build (2025-06-02): ``` 8.8.9-dev.11780414486.1df2bd72 ``` Docs PR: ionic-team/ionic-docs#4529 --------- Co-authored-by: Maria Hutt <thetaPC@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR is a follow-up PR to the main repo's Angular 21 PR.
What's new?
This PR adds a v9 row to the support matrix (Angular 18 through 21.x, TypeScript 5.4+) with a footnote explaining that Angular 21 itself requires TypeScript 5.9+.
We're also rewriting the Angular section of the v9 upgrade guide to state v9 supports Angular 18 through 21 and that 16 and 17 are dropped.
Along with that, we also added a migration guide for the breaking changes we added.