mirror of
https://github.com/ionic-team/ionic-framework.git
synced 2026-03-13 10:22:08 +08:00
docs(breaking): update breaking changes to include colors and item
This commit is contained in:
104
BREAKING.md
104
BREAKING.md
@@ -6,7 +6,7 @@ A list of the breaking changes introduced in Ionic Angular v4.
|
||||
- [Dynamic Mode](#dynamic-mode)
|
||||
- [Button](#button)
|
||||
- [Chip](#chip)
|
||||
- [Cordova](#cordova)
|
||||
- [Colors](#colors)
|
||||
- [Datetime](#datetime)
|
||||
- [FAB](#fab)
|
||||
- [Fixed Content](#fixed-content)
|
||||
@@ -21,6 +21,7 @@ A list of the breaking changes introduced in Ionic Angular v4.
|
||||
- [Option](#option)
|
||||
- [Radio](#radio)
|
||||
- [Range](#range)
|
||||
- [Sass](#sass)
|
||||
- [Segment](#segment)
|
||||
- [Select](#select)
|
||||
- [Text/Typography](#text-typography)
|
||||
@@ -173,6 +174,36 @@ Buttons inside of an `<ion-chip>` container should now be written as an `<ion-ch
|
||||
</ion-chip>
|
||||
```
|
||||
|
||||
|
||||
## Colors
|
||||
|
||||
The default Ionic theme colors have changed. Previously we had:
|
||||
|
||||
```
|
||||
primary: #327eff
|
||||
secondary: #32db64
|
||||
danger: #f53d3d
|
||||
light: #f4f4f4
|
||||
dark: #222
|
||||
```
|
||||
|
||||
Some of their values have changed and we now include more colors by default:
|
||||
|
||||
```
|
||||
primary: #3880ff
|
||||
secondary: #0cd1e8
|
||||
tertiary: #7044ff
|
||||
success: #10dc60
|
||||
warning: #ffce00
|
||||
danger: #f04141
|
||||
light: #f4f5f8
|
||||
medium: #989aa2
|
||||
dark: #222428
|
||||
```
|
||||
|
||||
The `secondary` color saw the largest change. If you were previously using our `secondary` color we recommend switching to `success` instead.
|
||||
|
||||
|
||||
## Datetime
|
||||
|
||||
The Datetime classes and interfaces have changed capitalization from `DateTime` to `Datetime`. This is more consistent with other components and their tags.
|
||||
@@ -189,24 +220,6 @@ import { DateTime } from 'ionic-angular';
|
||||
import { Datetime } from 'ionic-angular';
|
||||
```
|
||||
|
||||
## Cordova
|
||||
|
||||
Sass variables for changing the cordova statusbar have been renamed to app:
|
||||
|
||||
**Old Usage Example:**
|
||||
|
||||
```css
|
||||
$cordova-ios-statusbar-padding: 20px;
|
||||
$cordova-md-statusbar-padding: 20px;
|
||||
```
|
||||
|
||||
**New Usage Example:**
|
||||
|
||||
```css
|
||||
$app-ios-statusbar-padding: 20px;
|
||||
$app-md-statusbar-padding: 20px;
|
||||
```
|
||||
|
||||
## FAB
|
||||
|
||||
### Markup Changed
|
||||
@@ -338,7 +351,7 @@ $input-highlight-color-valid: #32db64;
|
||||
|
||||
### Markup Changed
|
||||
|
||||
Item should now be written as an `<ion-item>` element. Ionic will determine when to render an anchor tag based on the presence of an `href` attribute, and a button tag based on the presence of a click. Otherwise, it will render a div.
|
||||
Item should now be written as an `<ion-item>` element. Ionic will determine when to render an anchor tag based on the presence of an `href` attribute, and a button tag based on the presence of an `onclick` or `tappable` attribute. Otherwise, it will render a div.
|
||||
|
||||
**Old Usage Example:**
|
||||
|
||||
@@ -363,7 +376,7 @@ Item should now be written as an `<ion-item>` element. Ionic will determine when
|
||||
Default Item
|
||||
</ion-item>
|
||||
|
||||
<ion-item (click)="doSomething()">
|
||||
<ion-item tappable (click)="doSomething()">
|
||||
Button Item
|
||||
</ion-item>
|
||||
|
||||
@@ -420,6 +433,36 @@ These have been renamed to the following:
|
||||
</ion-item>
|
||||
```
|
||||
|
||||
### Detail Push
|
||||
|
||||
The attributes to show/hide the detail arrows on items have been converted to a single property and value. Instead of writing `detail-push` or `detail-none` to show/hide the arrow, it should be written `detail`/`detail="true"` or `detail="false"`.
|
||||
|
||||
**Old Usage Example:**
|
||||
|
||||
```html
|
||||
<button ion-item detail-none>
|
||||
<ion-label>Item Label</ion-label>
|
||||
</button>
|
||||
|
||||
<ion-item detail-push>
|
||||
<ion-label>Item Label</ion-label>
|
||||
</ion-item>
|
||||
```
|
||||
|
||||
**New Usage Example:**
|
||||
|
||||
```html
|
||||
<ion-item tappable detail="false">
|
||||
<ion-label>Item Label</ion-label>
|
||||
</ion-item>
|
||||
|
||||
<ion-item detail>
|
||||
<ion-label>Item Label</ion-label>
|
||||
</ion-item>
|
||||
```
|
||||
|
||||
By default, items that render buttons or anchor tags will show the arrow in `ios` mode.
|
||||
|
||||
## Item Divider
|
||||
|
||||
### Label Required
|
||||
@@ -708,6 +751,25 @@ These have been renamed to the following:
|
||||
```
|
||||
|
||||
|
||||
## Sass
|
||||
|
||||
Sass variables for changing the cordova statusbar have been renamed to app:
|
||||
|
||||
**Old Usage Example:**
|
||||
|
||||
```css
|
||||
$cordova-ios-statusbar-padding: 20px;
|
||||
$cordova-md-statusbar-padding: 20px;
|
||||
```
|
||||
|
||||
**New Usage Example:**
|
||||
|
||||
```css
|
||||
$app-ios-statusbar-padding: 20px;
|
||||
$app-md-statusbar-padding: 20px;
|
||||
```
|
||||
|
||||
|
||||
## Segment
|
||||
|
||||
The markup hasn't changed for Segments, but now writing `<ion-segment-button>` will render a native button element inside of it.
|
||||
|
||||
Reference in New Issue
Block a user