Skip to content

feat(chip): sync the ios theme with iOS 17 - #31780

Open
thetaPC wants to merge 8 commits into
chip-md-syncfrom
chip-ios-sync
Open

thetaPC wants to merge 8 commits into
chip-md-syncfrom
chip-ios-sync

Conversation

@thetaPC

@thetaPC thetaPC commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Issue number: internal


What is the current behavior?

The ios chip uses the same layout as the md chip: 32px tall with 6px 12px padding, a 14px label with inherited line height and letter spacing, 8px between an icon and the label, and 10px corners by default. A chip with a color has an 8% background, and a disabled chip has an opacity of 0.4. Its rem and em values are rounded to two decimals, so it renders slightly larger than on next.

What is the new behavior?

iOS has no chip, so the ios chip follows the closest native control: the bezeled capsule buttons in the iOS 17 design kit. Chips are one size below buttons, as in Material Design 2 (a 32px chip next to a 36px button), so the large chip matches the small bezeled button rather than the default one:

  • Pill shape by default (round)
  • The large chip matches the small bezeled button: 28px tall, 4px 10px padding, and a 15px label with a 20px line height and -0.016em letter spacing (the Subheadline style and Apple's tracking for 15pt)
  • The small chip stays 24px tall, with 3px 8px padding and a 13px label with an 18px line height and -0.006em letter spacing (the Footnote style), since iOS has no smaller capsule
  • 4px between a slotted icon and the label
  • A chip with a color is tinted like the bezeled button: 15% of the color, with hover and focus at 19% and pressed at 23%
  • Disabled opacity is 0.5, matching the ios button
  • Font, icon and avatar sizes are no longer rounded, so they match next

The pressed background stays, since ios chips have no ripple to show the press.

Does this introduce a breaking change?

  • Yes
  • No

The ios chip changes its size, typography, icon spacing, colored background and disabled opacity. The chip section of BREAKING.md lists each one with the global token and CSS variable that revert it.

Other information

How to test

Check Before After What to look for
Shape and size Before After Chips are pills. Large chips are shorter (28px) with a slightly bigger label, and icons sit closer to the label
Colors Before After Solid chips with a color have a stronger tint
States Before After Tap a colored chip: the background darkens while pressed. Disabled chips are a touch less faded

@thetaPC
thetaPC added this pull request to stack #31781 November 18, 2026 23:43
@vercel

vercel Bot commented Nov 18, 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 18, 2026 11:58pm UTC

Request Review

@github-actions github-actions Bot added the package: core @ionic/core package label Nov 18, 2026
@thetaPC
thetaPC marked this pull request as ready for review November 19, 2026 01:44
@thetaPC
thetaPC requested a review from a team as a code owner November 19, 2026 01:44
@thetaPC
thetaPC requested a review from ShaneK November 19, 2026 01:44

@ShaneK ShaneK left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Looks good to me! Just a couple of small things on the sizing.

Comment on lines +1126 to +1128
top: 'var(--ion-spacing-xxs)',
end: 'var(--ion-spacing-250)',
bottom: 'var(--ion-spacing-xxs)',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
top: 'var(--ion-spacing-xxs)',
end: 'var(--ion-spacing-250)',
bottom: 'var(--ion-spacing-xxs)',
top: 'var(--ion-spacing-75)',
end: 'var(--ion-spacing-250)',
bottom: 'var(--ion-spacing-75)',

Outline chips come out 2px taller than solid ones now, 30px vs 28px on large and 26px vs 24px on small, so a row mixing the two won't line up. The padding plus the line height already fills the min-height, so the outline's border can only add to it. With 3px here and 2px (--ion-spacing-xxxs) on small, every fill comes out 28px and 24px, and the solid, size, shape and avatar screenshots don't change.

The one catch is that solid chips at large font sizes get 2px shorter too (chip-scale goes from 38px to 36px). If you'd rather avoid that, I think taking the border width off the outline chip's padding in chip.scss would work instead. Either way, the padding in the breaking changes entry would need updating.

Comment thread BREAKING.md
- In the `md` theme, the border of an outline chip without a `color` is now `12%` of the text color instead of `32%`, in accordance with the Material Design 2 guidelines. To revert to the previous appearance, set `IonChip.hue.bold.outline.default.border.color` to `rgba(var(--ion-text-color-rgb, 0, 0, 0), 0.32)` for global styles, or `--ion-chip-hue-bold-outline-default-border-color` for component-specific styles.
- In the `md` theme, a focused chip without a `color` now has a background of `21%` of the text color instead of `16%`, or `10%` instead of `4%` with an outline fill. A pressed chip now keeps its resting background under the ripple instead of darkening. Both follow the Material Design 2 guidelines. To revert to the previous appearance, set `IonChip.hue.bold.solid.focus.background`, `IonChip.hue.bold.outline.focus.background` and the `activated.background` of each hue and fill for global styles, or the matching `--ion-chip-hue-*-focus-background` and `--ion-chip-hue-*-activated-background` variables for component-specific styles.
- In the `md` theme, a disabled chip now has an opacity of `0.38` instead of `0.4`, in accordance with the Material Design 2 guidelines. To revert to the previous appearance, set `IonChip.state.disabled.opacity` to `0.4` for global styles, or `--ion-chip-state-disabled-opacity` for component-specific styles.
- In the `ios` theme, the chip is now `28px` tall instead of `32px`, with `4px` `10px` padding instead of `6px` `12px`, and its label is `15px` with a `20px` line height and `-0.016em` letter spacing instead of `14px` with inherited line height and letter spacing, in accordance with the iOS guidelines for small bezeled buttons. To revert to the previous appearance, set `IonChip.size.large.min.height` to `32px`, `IonChip.size.large.padding` to `6px` on the top and bottom and `12px` on the start and end, `IonChip.size.large.font.size` to `clamp(13px, 0.875rem, 22px)`, and `IonChip.size.large.line.height` and `IonChip.size.large.letterSpacing` to `inherit` for global styles, or the matching `--ion-chip-size-large-*` variables for component-specific styles.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
- In the `ios` theme, the chip is now `28px` tall instead of `32px`, with `4px` `10px` padding instead of `6px` `12px`, and its label is `15px` with a `20px` line height and `-0.016em` letter spacing instead of `14px` with inherited line height and letter spacing, in accordance with the iOS guidelines for small bezeled buttons. To revert to the previous appearance, set `IonChip.size.large.min.height` to `32px`, `IonChip.size.large.padding` to `6px` on the top and bottom and `12px` on the start and end, `IonChip.size.large.font.size` to `clamp(13px, 0.875rem, 22px)`, and `IonChip.size.large.line.height` and `IonChip.size.large.letterSpacing` to `inherit` for global styles, or the matching `--ion-chip-size-large-*` variables for component-specific styles.
- In the `ios` theme, the chip is now `28px` tall instead of `32px`, with `4px` `10px` padding instead of `6px` `12px`, and its label is `15px` with a `20px` line height and `-0.016em` letter spacing instead of `14px` with inherited line height and letter spacing, in accordance with the iOS guidelines for small bezeled buttons. To revert to the previous appearance, set `IonChip.size.large.min.height` to `32px`, `IonChip.size.large.padding` to `6px` on the top and bottom and `12px` on the start and end, `IonChip.size.large.font.size` to `clamp(13px, 0.875rem, 22px)`, `IonChip.size.large.line.height` and `IonChip.size.large.letterSpacing` to `inherit`, `IonChip.icon.font.size` to `1.43em`, and `IonChip.avatar.width` and `IonChip.avatar.height` to `1.71em` for global styles, or the matching `--ion-chip-size-large-*`, `--ion-chip-icon-font-size` and `--ion-chip-avatar-*` variables for component-specific styles.

The icon and avatar sizes are based on the label size, so after this revert they're still smaller than before, an 18.67px icon and a 22.4px avatar instead of 20px and 24px. Setting these two as well brings them back to exactly what they were.

This branch was successfully deployed

1 active deployment
Preview — 0ee14d6d Deployed Nov 18, 2026 by vercel[bot]
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.

2 participants