Skip to content

docs(img): deprecate ion-img and update migration guide to reflect this#4565

Open
brandyscarney wants to merge 3 commits into
major-9.0from
FW-7304
Open

docs(img): deprecate ion-img and update migration guide to reflect this#4565
brandyscarney wants to merge 3 commits into
major-9.0from
FW-7304

Conversation

@brandyscarney

@brandyscarney brandyscarney commented Jun 30, 2026

Copy link
Copy Markdown
Member

Documents that ion-img is deprecated (slated for removal in Ionic 10) and guides users to the native <img> with loading="lazy".

  • API reference: adds the deprecation notice on the ion-img page and updates the Accordion animation section to use <img>.
  • Migration guide: adds an "Img" section to the v9 upgrade guide covering the markup swap, event replacements, and styling changes.
  • Usage: Replaces all ion-img playground usage with img except for the img folder as that should remain the same until removal in v10.

Out of scope: existing ion-img usage in the Your First App tutorials was migrated in #4571

Previews:

@vercel

vercel Bot commented Jun 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ionic-docs Ready Ready Preview, Comment Jul 2, 2026 8:05pm

Request Review

@brandyscarney brandyscarney marked this pull request as ready for review July 1, 2026 21:04
@brandyscarney brandyscarney requested a review from a team as a code owner July 1, 2026 21:04
@brandyscarney brandyscarney requested review from gnbm and removed request for a team July 1, 2026 21:04
| **Edge** | 89+ | 79+ | 79+ | 79+ ||
| **Firefox** | 75+ | 70+ | 63+ |||
| **IE 11** | **X** | **X** | **X** | **X** | **X** |
| Browser | Ionic v9 | Ionic v8 | Ionic v7 | Ionic v6 | Ionic v5 | Ionic v4 |

@gnbm gnbm Jul 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@brandyscarney what was the source for deciding these versions for v9?

@gnbm gnbm left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM..Great work!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants