mirror of
https://github.com/ionic-team/ionic-framework.git
synced 2026-03-13 10:22:08 +08:00
4dae03f2ac
Issue number: internal --------- ## What is the current behavior? The `shape` property defaults to `"soft"` for `ios` and `"round"` for the `md` and `ionic` themes. **Default button size**: | Property Value | CSS Value (`ionic`) | CSS Value (`ios`) | CSS Value (`md`) | | --------------- | ------ | ----------- | ----------- | | `undefined` | `8px` | `14px` | `4px` | | `"round"` | `999px` | unsupported | unsupported | | `"rectangular"` | `0px` | unsupported | unsupported | **Large button size**: | Property Value | CSS Value (`ionic`) | CSS Value (`ios`) | CSS Value (`md`) | | --------------- | ------ | ----------- | ----------- | | `undefined` | `8px` | `16px` | `4px` | **Small button size**: | Property Value | CSS Value (`ionic`) | CSS Value (`ios`) | CSS Value (`md`) | | --------------- | ------ | ----------- | ----------- | | `undefined` | `4px` | `6px` | `4px` | ## What is the new behavior? The `shape` property defaults to `undefined` which evaluates to the "Soft" shape for all themes. **Default button size**: | Property Value | CSS Value (`ionic`) | CSS Value (`ios`) | CSS Value (`md`) | | --------------- | ------- | ------ | -------- | | `"soft"` | `8px` | `6px` | `4px` | | `"round"` | `999px` | `999px` | `999px` | | `"rectangular"` | `0px` | `0px` | `0px` | **Large button size**: | Property Value | CSS Value (`ionic`) | CSS Value (`ios`) | CSS Value (`md`) | | --------------- | ------ | ----------- | ----------- | | `soft` | `8px` | `8px` | `4px` | **Small button size**: | Property Value | CSS Value (`ionic`) | CSS Value (`ios`) | CSS Value (`md`) | | --------------- | ------ | ----------- | ----------- | | `soft` | `4px` | `4px` | `4px` | - Adds support for the `"soft"` shape in the `ionic` theme using the existing values for `undefined` - Adds support for the `"rectangular"` and `"round"` shapes in `ios` and `md` using `0px` and `999px` border radius - Sets the default shape property to `"round"` for the `ionic` and `md` themes and `"soft"` for `ios` and updates the `border-radius` to apply to the shape classes instead of `:host` - Updates the `"soft"` shape border radius for `ios` in the various sizes to match the buttons created in SwiftUI (their "rounded" is our "soft"):  - Fixed the icon only buttons in the `"ionic"` theme so that they are not styled based on the size while always following the proper aspect ratio. This was broken for the default size due to an incorrect padding value & I made it so we don't have to specify the padding for each size: | Before | After | | ---| ---| |  |  | ## Does this introduce a breaking change? - [x] Yes - [ ] No BREAKING CHANGE: The `border-radius` of the `ios` and `md` button now defaults to `6px` and `999px` instead of `14px` and `4px`, respectively, in accordance with the iOS and Material Design 3 guidelines. To revert to the previous appearance, set the `shape` to `"soft"` for `md` and override the `--border-radius` CSS variable for `ios` to `14px`, or set it to a different value entirely. --------- Co-authored-by: ionitron <hi@ionicframework.com>
35 lines
1.8 KiB
Markdown
35 lines
1.8 KiB
Markdown
# Breaking Changes
|
|
|
|
This is a comprehensive list of the breaking changes introduced in the major version releases of Ionic Framework.
|
|
|
|
## Versions
|
|
|
|
- [Version 9.x](#version-9x)
|
|
- [Version 8.x](./BREAKING_ARCHIVE/v8.md)
|
|
- [Version 7.x](./BREAKING_ARCHIVE/v7.md)
|
|
- [Version 6.x](./BREAKING_ARCHIVE/v6.md)
|
|
- [Version 5.x](./BREAKING_ARCHIVE/v5.md)
|
|
- [Version 4.x](./BREAKING_ARCHIVE/v4.md)
|
|
- [Legacy](https://github.com/ionic-team/ionic-v3/blob/master/CHANGELOG.md)
|
|
|
|
## Version 9.x
|
|
|
|
- [Components](#version-9x-components)
|
|
- [Button](#version-9x-button)
|
|
- [Card](#version-9x-card)
|
|
- [Chip](#version-9x-chip)
|
|
|
|
<h2 id="version-9x-components">Components</h2>
|
|
|
|
<h4 id="version-9x-button">Button</h4>
|
|
|
|
- The `border-radius` of the `ios` and `md` button now defaults to `6px` and `999px` instead of `14px` and `4px`, respectively, in accordance with the iOS and Material Design 3 guidelines. To revert to the previous appearance, set the `shape` to `"soft"` for `md` and override the `--border-radius` CSS variable for `ios` to `14px`, or set it to a different value entirely.
|
|
|
|
<h4 id="version-9x-card">Card</h4>
|
|
|
|
- The `border-radius` of the `ios` and `md` card now defaults to `14px` and `12px` instead of `8px` and `4px`, respectively, in accordance with the iOS and Material Design 3 guidelines. To revert to the previous appearance, set the `shape` to `"soft"`, or override the `--border-radius` CSS variable to specify a different value.
|
|
|
|
<h4 id="version-9x-chip">Chip</h4>
|
|
|
|
- The `border-radius` of the `ios` and `md` chip now defaults to `10px` and `8px`, respectively, instead of `16px` in accordance with the iOS and Material Design 3 guidelines. To revert to the previous appearance, set the `shape` to `"round"`, or override the `--border-radius` CSS variable to specify a different value.
|