-
Notifications
You must be signed in to change notification settings - Fork 6.7k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat(): add slide-toggle component. #362
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,66 @@ | ||
# MdSlideToggle | ||
`MdSlideToggle` is a two-state control, which can be also called `switch` | ||
|
||
### Screenshots | ||
![image](https://material.angularjs.org/material2_assets/slide-toggle/toggles.png) | ||
|
||
## `<md-slide-toggle>` | ||
### Bound Properties | ||
|
||
| Name | Type | Description | | ||
| --- | --- | --- | | ||
| `disabled` | boolean | Disables the `slide-toggle` | | ||
| `color` | `"primary" | "accent" | "warn"` | The color palette of the `slide-toggle` | | ||
| `checked` | boolean | Sets the value of the `slide-toggle` | | ||
|
||
### Events | ||
| Name | Type | Description | | ||
| --- | --- | --- | | ||
| `change` | boolean | Event will be emitted on every value change.<br/>It emits the new `checked` value. | | ||
|
||
### Examples | ||
A basic slide-toggle would have the following markup. | ||
```html | ||
<md-slide-toggle [(ngModel)]="slideToggleModel"> | ||
Default Slide Toggle | ||
</md-slide-toggle> | ||
``` | ||
|
||
Slide toggle can be also disabled. | ||
```html | ||
<md-slide-toggle disabled> | ||
Disabled Slide Toggle | ||
</md-slide-toggle> | ||
``` | ||
|
||
The `slide-toggle` can be also set to checked without a `ngModel` | ||
```html | ||
<md-slide-toggle [checked]="isChecked"> | ||
Input Binding | ||
</md-slide-toggle> | ||
``` | ||
|
||
You may also want to listen on changes of the `slide-toggle`<br/> | ||
The `slide-toggle` always emits the new value to the event binding `(change)` | ||
```html | ||
<md-slide-toggle (change)="printValue($event)"> | ||
Prints Value on Change | ||
</md-slide-toggle> | ||
``` | ||
|
||
## Theming | ||
A slide-toggle is default using the `accent` palette for its styling. | ||
|
||
Modifying the color on a `slide-toggle` can be easily done, by using the following markup. | ||
```html | ||
<md-slide-toggle color="primary"> | ||
Primary Slide Toggle | ||
</md-slide-toggle> | ||
``` | ||
|
||
The color can be also set dynamically by using a property binding. | ||
```html | ||
<md-slide-toggle [color]="myColor"> | ||
Dynamic Color | ||
</md-slide-toggle> | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,22 @@ | ||
<label class="md-slide-toggle-label"> | ||
<div class="md-slide-toggle-container"> | ||
<div class="md-slide-toggle-bar"></div> | ||
<div class="md-slide-toggle-thumb-container"> | ||
<div class="md-slide-toggle-thumb"></div> | ||
</div> | ||
|
||
<input #input class="md-slide-toggle-checkbox" type="checkbox" | ||
[id]="getInputId()" | ||
[tabIndex]="tabIndex" | ||
[checked]="checked" | ||
[disabled]="disabled" | ||
[attr.name]="name" | ||
[attr.aria-label]="ariaLabel" | ||
[attr.aria-labelledby]="ariaLabelledby" | ||
(blur)="onTouched()" | ||
(change)="onChangeEvent()"> | ||
</div> | ||
<span class="md-slide-toggle-content"> | ||
<ng-content></ng-content> | ||
</span> | ||
</label> |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,153 @@ | ||
@import "../../core/style/variables"; | ||
@import "../../core/style/mixins"; | ||
@import "../../core/style/elevation"; | ||
|
||
//TODO(): remove the default theme. | ||
@import "../../core/style/default-theme"; | ||
|
||
$md-slide-toggle-width: 36px !default; | ||
$md-slide-toggle-height: 24px !default; | ||
$md-slide-toggle-bar-height: 14px !default; | ||
$md-slide-toggle-thumb-size: 20px !default; | ||
$md-slide-toggle-margin: 16px !default; | ||
|
||
@mixin md-switch-checked($palette) { | ||
.md-slide-toggle-thumb { | ||
background-color: md-color($palette); | ||
} | ||
|
||
.md-slide-toggle-bar { | ||
background-color: md-color($palette, 0.5); | ||
} | ||
} | ||
|
||
:host { | ||
display: flex; | ||
height: $md-slide-toggle-height; | ||
|
||
margin: $md-slide-toggle-margin 0; | ||
line-height: $md-slide-toggle-height; | ||
|
||
white-space: nowrap; | ||
user-select: none; | ||
|
||
outline: none; | ||
|
||
&.md-checked { | ||
@include md-switch-checked($md-accent); | ||
|
||
&.md-primary { | ||
@include md-switch-checked($md-primary); | ||
} | ||
|
||
&.md-warn { | ||
@include md-switch-checked($md-warn); | ||
} | ||
|
||
.md-slide-toggle-thumb-container { | ||
transform: translate3d(100%, 0, 0); | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Why There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Translate3d pushes the CSS animations into hardware acceleration. This should increase the performance and guarantee more fps. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Yea, I think you typically always want to use |
||
} | ||
} | ||
|
||
&.md-disabled { | ||
|
||
.md-slide-toggle-label, .md-slide-toggle-container { | ||
cursor: default; | ||
} | ||
|
||
.md-slide-toggle-thumb { | ||
// The thumb of the slide-toggle always uses the hue 400 of the grey palette in dark or light themes. | ||
// Since this is very specific to the slide-toggle component, we're not providing | ||
// it in the background palette. | ||
background-color: md-color($md-grey, 400); | ||
} | ||
.md-slide-toggle-bar { | ||
background-color: md-color($md-foreground, divider); | ||
} | ||
} | ||
} | ||
|
||
// The label is our root container for the slide-toggle / switch indicator and label text. | ||
// It has to be a label, to support accessibility for the visual hidden input. | ||
.md-slide-toggle-label { | ||
display: flex; | ||
flex: 1; | ||
|
||
cursor: pointer; | ||
} | ||
|
||
// Container for the composition of the slide-toggle / switch indicator. | ||
.md-slide-toggle-container { | ||
cursor: grab; | ||
width: $md-slide-toggle-width; | ||
height: $md-slide-toggle-height; | ||
|
||
position: relative; | ||
user-select: none; | ||
|
||
margin-right: 8px; | ||
} | ||
|
||
// The thumb container is responsible for the dragging functionality. | ||
// It moves around and holds the actual circle as a thumb. | ||
.md-slide-toggle-thumb-container { | ||
position: absolute; | ||
top: $md-slide-toggle-height / 2 - $md-slide-toggle-thumb-size / 2; | ||
left: 0; | ||
z-index: 1; | ||
|
||
width: $md-slide-toggle-width - $md-slide-toggle-thumb-size; | ||
|
||
transform: translate3d(0, 0, 0); | ||
|
||
transition: $swift-linear; | ||
transition-property: transform; | ||
} | ||
|
||
// The thumb will be elevated from the slide-toggle bar. | ||
// Also the thumb is bound to its parent thumb-container, which manages the movement of the thumb. | ||
.md-slide-toggle-thumb { | ||
position: absolute; | ||
margin: 0; | ||
left: 0; | ||
top: 0; | ||
|
||
height: $md-slide-toggle-thumb-size; | ||
width: $md-slide-toggle-thumb-size; | ||
border-radius: 50%; | ||
|
||
background-color: md-color($md-background, background); | ||
@include md-elevation(1); | ||
} | ||
|
||
// Horizontal bar for the slide-toggle. | ||
// The slide-toggle bar is shown behind the thumb container. | ||
.md-slide-toggle-bar { | ||
position: absolute; | ||
left: 1px; | ||
top: $md-slide-toggle-height / 2 - $md-slide-toggle-bar-height / 2; | ||
|
||
width: $md-slide-toggle-width - 2px; | ||
height: $md-slide-toggle-bar-height; | ||
|
||
// The bar of the slide-toggle always uses the hue 500 of the grey palette in dark or light themes. | ||
// Since this is very specific to the slide-toggle component, we're not providing | ||
// it in the background palette. | ||
background-color: md-color($md-grey, 500); | ||
|
||
border-radius: 8px; | ||
} | ||
|
||
// The slide toggle shows a visually hidden checkbox inside of the component. | ||
// This checkbox allows us to take advantage of the browsers support. | ||
// Like accessibility and keyboard interaction. | ||
.md-slide-toggle-checkbox { | ||
@include md-visually-hidden(); | ||
} | ||
|
||
.md-slide-toggle-bar, | ||
.md-slide-toggle-thumb { | ||
transition: $swift-linear; | ||
transition-property: background-color; | ||
transition-delay: 0.05s; | ||
} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should be able to just do
[name]
without theattr.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a good point. I also had that before. But this will cause issues with a falsy value.
For example, if the user, uses
[name]="myName", and the
myNameproperty is set to
null` will result inIf you want to confirm it yourself. You can try setting
$0.name = null
in the Dev Tools on an input.The advantage of
[attr.name]
is, that it removes the attribute, when it's falsy.Same as in #447
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
After trying it out, you're right,
attr.name
is what we want for now.