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 Sep 10, 2025 9:36pm

@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
Copy link
Member

@ShaneK ShaneK left a comment

Choose a reason for hiding this comment

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

This is looking pretty good! Just a few issues I found

@include margin-horizontal(var(--margin-calc), 0);
}

$grid-col-number: 12;
Copy link
Member

@ShaneK ShaneK Sep 10, 2025

Choose a reason for hiding this comment

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

This caps generated classes at 12, but --ion-grid-columns is configurable. If somebody sets a higher number of columns in --ion-grid-columns, then their width will be calculated for that number of columns, but the number of generated columns will be incorrect.

Either change how you get this ceiling so it comes from the configured variable, or document that spans/orders/offsets > 12 require custom CSS.

Copy link
Author

Choose a reason for hiding this comment

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

The configuration --ion-grid-columns will be set after the framework is compiled, and while is being used by the developer. And what you're mentioning will be handled by the future Ionic modular approach as talked with @brandyscarney - hence this was left like this. Let me know, if I should leave any special comment regarding the matter.

Copy link
Member

Choose a reason for hiding this comment

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

Cool! It might be worth adding a comment to document that then, currently it just looks like a possibly-unintended issue and somebody reviewing this in the future might not have this context.

configs({ modes: ['md'] }).forEach(({ title, screenshot, config }) => {
test.describe(title('grid: offsets'), () => {
test('should not have visual regressions', async ({ page }) => {
await page.goto(`/src/components/grid/test/offsets`, config);
Copy link
Member

Choose a reason for hiding this comment

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

Is this the right path? It's kind of odd that this test exists under offsets-pull-push, but is testing against offsets. Maybe this test should be in the offsets e2e and there should be tests here for offsets-pull-push? Or maybe you just accidentally used the wrong path? Not sure.

Copy link
Author

Choose a reason for hiding this comment

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

It was a lapse. These tests for now will have show case the deprecated features Pull & Push, not being applied, as they are deprecated. It might be useful for the future. If you think otherwise, we can remove it completely.

display: flex;

flex-wrap: wrap;

gap: var(--ion-grid-gap, 0px);
Copy link
Member

Choose a reason for hiding this comment

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

This will always be 0px, I believe, since you're setting this var and using it in the same block. Is this intended? Seems redundant.

Copy link
Author

Choose a reason for hiding this comment

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

Agree and changed.

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.

5 participants