blob: 1e6309005fa5dd565bd99a453d1ecf05b95ce013 [file] [log] [blame]
<!--
@license
Copyright (c) 2015 The Polymer Project Authors. All rights reserved.
This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt
The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt
The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt
Code distributed by Google as part of the polymer project is also
subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt
-->
<link rel="import" href="../polymer/polymer.html">
<link rel="import" href="../paper-behaviors/paper-checked-element-behavior.html">
<link rel="import" href="../paper-styles/default-theme.html">
<link rel="import" href="../iron-flex-layout/iron-flex-layout.html">
<!--
Material design: [Radio button](https://www.google.com/design/spec/components/selection-controls.html#selection-controls-radio-button)
`paper-radio-button` is a button that can be either checked or unchecked.
User can tap the radio button to check or uncheck it.
Use a `<paper-radio-group>` to group a set of radio buttons. When radio buttons
are inside a radio group, exactly one radio button in the group can be checked
at any time.
Example:
<paper-radio-button></paper-radio-button>
<paper-radio-button>Item label</paper-radio-button>
### Styling
The following custom properties and mixins are available for styling:
Custom property | Description | Default
----------------|-------------|----------
`--paper-radio-button-unchecked-background-color` | Radio button background color when the input is not checked | `transparent`
`--paper-radio-button-unchecked-color` | Radio button color when the input is not checked | `--primary-text-color`
`--paper-radio-button-unchecked-ink-color` | Selected/focus ripple color when the input is not checked | `--primary-text-color`
`--paper-radio-button-checked-color` | Radio button color when the input is checked | `--primary-color`
`--paper-radio-button-checked-ink-color` | Selected/focus ripple color when the input is checked | `--primary-color`
`--paper-radio-button-size` | Size of the radio button | `16px`
`--paper-radio-button-ink-size` | Size of the ripple | `48px`
`--paper-radio-button-label-color` | Label color | `--primary-text-color`
`--paper-radio-button-label-spacing` | Spacing between the label and the button | `10px`
`--paper-radio-button-radio-container` | A mixin applied to the internal radio container | `{}`
`--paper-radio-button-label` | A mixin applied to the internal label | `{}`
`--paper-radio-button-label-checked` | A mixin applied to the internal label when the radio button is checked | `{}`
This element applies the mixin `--paper-font-common-base` but does not import `paper-styles/typography.html`.
In order to apply the `Roboto` font to this element, make sure you've imported `paper-styles/typography.html`.
@group Paper Elements
@element paper-radio-button
@hero hero.svg
@demo demo/index.html
-->
<dom-module id="paper-radio-button">
<template strip-whitespace>
<style>
:host {
display: inline-block;
line-height: 0;
white-space: nowrap;
cursor: pointer;
@apply(--paper-font-common-base);
--calculated-paper-radio-button-size: var(--paper-radio-button-size, 16px);
/* -1px is a sentinel for the default and is replace in `attached`. */
--calculated-paper-radio-button-ink-size: var(--paper-radio-button-ink-size, -1px);
}
:host(:focus) {
outline: none;
}
#radioContainer {
@apply(--layout-inline);
@apply(--layout-center-center);
position: relative;
width: var(--calculated-paper-radio-button-size);
height: var(--calculated-paper-radio-button-size);
vertical-align: middle;
@apply(--paper-radio-button-radio-container);
}
#ink {
position: absolute;
top: 50%;
left: 50%;
right: auto;
width: var(--calculated-paper-radio-button-ink-size);
height: var(--calculated-paper-radio-button-ink-size);
color: var(--paper-radio-button-unchecked-ink-color, --primary-text-color);
opacity: 0.6;
pointer-events: none;
-webkit-transform: translate(-50%, -50%);
transform: translate(-50%, -50%);
}
#ink[checked] {
color: var(--paper-radio-button-checked-ink-color, --primary-color);
}
#offRadio, #onRadio {
position: absolute;
box-sizing: border-box;
top: 0;
left: 0;
width: 100%;
height: 100%;
border-radius: 50%;
}
#offRadio {
border: 2px solid var(--paper-radio-button-unchecked-color, --primary-text-color);
background-color: var(--paper-radio-button-unchecked-background-color, transparent);
transition: border-color 0.28s;
}
#onRadio {
background-color: var(--paper-radio-button-checked-color, --primary-color);
-webkit-transform: scale(0);
transform: scale(0);
transition: -webkit-transform ease 0.28s;
transition: transform ease 0.28s;
will-change: transform;
}
:host([checked]) #offRadio {
border-color: var(--paper-radio-button-checked-color, --primary-color);
}
:host([checked]) #onRadio {
-webkit-transform: scale(0.5);
transform: scale(0.5);
}
#radioLabel {
line-height: normal;
position: relative;
display: inline-block;
vertical-align: middle;
margin-left: var(--paper-radio-button-label-spacing, 10px);
white-space: normal;
color: var(--paper-radio-button-label-color, --primary-text-color);
@apply(--paper-radio-button-label);
}
:host([checked]) #radioLabel {
@apply(--paper-radio-button-label-checked);
}
:host-context([dir="rtl"]) #radioLabel {
margin-left: 0;
margin-right: var(--paper-radio-button-label-spacing, 10px);
}
#radioLabel[hidden] {
display: none;
}
/* disabled state */
:host([disabled]) #offRadio {
border-color: var(--paper-radio-button-unchecked-color, --primary-text-color);
opacity: 0.5;
}
:host([disabled][checked]) #onRadio {
background-color: var(--paper-radio-button-unchecked-color, --primary-text-color);
opacity: 0.5;
}
:host([disabled]) #radioLabel {
/* slightly darker than the button, so that it's readable */
opacity: 0.65;
}
</style>
<div id="radioContainer">
<div id="offRadio"></div>
<div id="onRadio"></div>
</div>
<div id="radioLabel"><content></content></div>
</template>
<script>
Polymer({
is: 'paper-radio-button',
behaviors: [
Polymer.PaperCheckedElementBehavior
],
hostAttributes: {
role: 'radio',
'aria-checked': false,
tabindex: 0
},
properties: {
/**
* Fired when the checked state changes due to user interaction.
*
* @event change
*/
/**
* Fired when the checked state changes.
*
* @event iron-change
*/
ariaActiveAttribute: {
type: String,
value: 'aria-checked'
}
},
ready: function() {
this._rippleContainer = this.$.radioContainer;
},
attached: function() {
var inkSize = this.getComputedStyleValue('--calculated-paper-radio-button-ink-size').trim();
// If unset, compute and set the default `--paper-radio-button-ink-size`.
if (inkSize === '-1px') {
var size = parseFloat(this.getComputedStyleValue('--calculated-paper-radio-button-size').trim());
var defaultInkSize = Math.floor(3 * size);
// The button and ripple need to have the same parity so that their
// centers align.
if (defaultInkSize % 2 !== size % 2) {
defaultInkSize++;
}
this.customStyle['--paper-radio-button-ink-size'] = defaultInkSize + 'px';
this.updateStyles();
}
},
})
</script>
</dom-module>