Skip to content

docs(breaking): add minimum browser versions for v10 - #31605

Merged
brandyscarney merged 3 commits into
nextfrom
v10-browser-support
Nov 17, 2026
Merged

brandyscarney merged 3 commits into
nextfrom
v10-browser-support

Conversation

@brandyscarney

@brandyscarney brandyscarney commented Oct 19, 2026 •

Copy link
Copy Markdown
Member

Updates the minimum browser and platform versions for v10.

Firefox: 75 → 89

Raise the documented minimum Firefox version from 75 to 89 due to the use of aspect-ratio in Gallery. Several components already use aspect-ratio without a fallback, so technically the floor was incorrect before this component was added. Chrome (88+), Safari (15+) and Edge (88+) already support aspect-ratio at their current minimums, so only Firefox changes for this reason.

I checked to see the earliest use of aspect-ratio and it looks like we have been using it since v7:

Safari and iOS: 16 → 17

Safari and iOS move up one major from v9, as they have in previous majors (13+ in v6, 14+ in v7, 15+ in v8, 16+ in v9).

This also covers RTL in shadow components. The RTL mixins output a :host-context([dir=rtl]) selector, which only Chromium supports, and a :dir(rtl) selector for Firefox and Safari. Safari supports :dir() from 16.4, and in 16.4 - 16.x it does not update when dir changes after the page loads (WebKit bug 257133). With Safari 17 as the minimum, the RTL styles work in every supported Safari version, so shadow components such as ion-label don't need render-time RTL classes.

Mobile platforms

Adds the Minimum Mobile Platform Versions table back for v10, with iOS 17+ and Android unchanged from v9.

@brandyscarney
brandyscarney marked this pull request as ready for review October 19, 2026 22:07
@brandyscarney
brandyscarney requested a review from a team as a code owner October 19, 2026 22:07
@brandyscarney
brandyscarney requested a review from ShaneK October 19, 2026 22:07
@vercel

vercel Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
ionic-framework Ready Ready Preview Nov 17, 2026 8:57pm UTC

Request Review

@thetaPC thetaPC 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! Please make a PR for the docs major-v10 to reflect these changes.

@ShaneK ShaneK mentioned this pull request Nov 2, 2026
1 of 2 tasks
brandyscarney added a commit that referenced this pull request Nov 12, 2026
Issue number: internal

---------

## What is the current behavior?

`ion-label` uses `scoped` encapsulation.

## What is the new behavior?

- Converts `ion-label` to Shadow DOM.
- Label styles only reach direct children through `::slotted()`, so
heading and paragraph styles now apply to `h1`-`h6` and `p` elements
that are direct children of `ion-label`.
- The global heading styles in `typography.css` and
`typography.ionic.css` now skip headings that are direct children of
`ion-label`, using selectors like `h1:where(:not(ion-label > h1))` for
each heading level, so the label's heading styles apply to them. The
`:where()` keeps the original specificity.
- Item now sets the size and margins of stacked, floating and fixed
labels, because item's `::slotted(ion-label)` styles take precedence
over label's own styles in shadow DOM.
- The disabled label opacity and the skeleton text overflow moved from
label to item, because they depend on item state that changes after the
label renders.
- Label checks for an item parent with tag names instead of
`:host-context`, which only Chromium supports in shadow DOM.
- RTL uses the `transform-origin` mixin instead of a render-time
`label-rtl` class.
- Removes legacy `:host-context` rules for item classes that are no
longer set (`item-input`, `item-textarea`, `item-has-focus`,
`item-has-value`, `item-has-placeholder`), along with the focused and
invalid color rules for stacked and floating labels.
- Updates the component guide with a section on checking a parent's
context in shadow components, and rewrites the RTL section to use
logical properties, the RTL mixins, or `isRTL()` checked when needed,
instead of render-time classes.

## Does this introduce a breaking change?

- [x] Yes
- [ ] No

BREAKING CHANGE:

`ion-label` has been converted to use [Shadow
DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM).

- Default heading and paragraph styles only apply to `h1`-`h6` and `p`
elements that are direct children of `ion-label`. Nested headings, such
as `<ion-label><ion-text><h3>`, no longer get label styles and get the
global typography instead. Move `ion-text` inside the heading or
paragraph, or set `color` on `ion-label`.
- Global element styles such as `h2 { font-size: 20px; }` now take
precedence over label's heading and paragraph styles. Scope them with
`h2:not(ion-label > h2)` to keep the label styles.
- App styles that target `ion-label` directly, such as a class that sets
`color`, now take precedence over the default label styles.

## Other information

- **Requires #31605.** The `:not()` and `:where()` selectors in the
global typography need Firefox 84+ and 78+, and #31605 raises the
documented minimum to Firefox 89.

---------

Co-authored-by: Brandy Smith <6577830+brandyscarney@users.noreply.github.com>
@brandyscarney

Copy link
Copy Markdown
Member Author

Created docs PR to update there: ionic-team/ionic-docs#4858

@brandyscarney
brandyscarney merged commit 83efcc2 into next Nov 17, 2026
54 checks passed
@brandyscarney
brandyscarney deleted the v10-browser-support branch November 17, 2026 21:11

This branch was successfully deployed

1 active deployment
Preview — dc8a6129 Deployed Nov 17, 2026 by vercel[bot]
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