Repository navigation
docs(breaking): add minimum browser versions for v10 - #31605
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This was referenced Oct 23, 2026
thetaPC
approved these changes
Nov 2, 2026
thetaPC
left a comment
Contributor
There was a problem hiding this comment.
LGTM! Please make a PR for the docs major-v10 to reflect these changes.
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>
Member
Author
|
Created docs PR to update there: ionic-team/ionic-docs#4858 |
This branch was successfully deployed
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
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.
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-ratioin Gallery. Several components already useaspect-ratiowithout a fallback, so technically the floor was incorrect before this component was added. Chrome (88+), Safari (15+) and Edge (88+) already supportaspect-ratioat their current minimums, so only Firefox changes for this reason.I checked to see the earliest use of
aspect-ratioand 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 whendirchanges 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 asion-labeldon'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.