Skip to content

Conversation

rugoncalves
Copy link

@rugoncalves rugoncalves commented Aug 28, 2025

What is the current behavior?

The existing grid component (ion-grid, ion-row, and ion-col) in Ionic was developed several years ago and has not received significant updates since then. As a result, it does not leverage modern CSS features. For example, the gutter (spacing) between columns is implemented using the border property, which is an outdated technique.

What is the new behavior?

  • --ion-grid-gap: this new CSS variable, will indicate the gap size in the grid. Defaults to 0px - the current value.
  • ion-col: has a new way to calculate the width of the column. Additionally a new property order (and responsive variants) was added, and will control the order of the column.
  • ion-row: uses the newly introduced custom property --ion-grid-gap. This property will indicate the gap size in the grid.

Does this introduce a breaking change?

  • Yes
  • No

The properties pull and push from ion-col, have been removed. The functionality achieved with them, is now achieved with the new property order and the existing size. More information and migration examples can be read in BREAKING.md file.

Other information

@rugoncalves rugoncalves requested a review from a team as a code owner August 28, 2025 11:04
Copy link

vercel bot commented Aug 28, 2025

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

Project Deployment Preview Comments Updated (UTC)
ionic-framework Ready Ready Preview Comment Aug 28, 2025 1:05pm

@github-actions github-actions bot added package: core @ionic/core package package: angular @ionic/angular package package: vue @ionic/vue package labels Aug 28, 2025
/**
* @prop --col-unit-size: The size of each Column unit.
*/
--col-unit-size: calc((100% - (var(--ion-grid-columns, 12) - 1) * var(--ion-grid-gap)) / var(--ion-grid-columns, 12));
Copy link
Contributor

Choose a reason for hiding this comment

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

Would it make sense to instead of 12, add a --grid-type variable here, that by default would be 12?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
package: angular @ionic/angular package package: core @ionic/core package package: vue @ionic/vue package
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants