docs(breaking): update breaking changes to include colors and item

This commit is contained in:
Brandy Carney
2018-02-22 13:22:10 -05:00
parent 67afbe1db9
commit 3b2c1c9b9a

View File

@@ -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.