OLD | NEW |
1 <!-- | 1 <!-- |
2 @license | 2 @license |
3 Copyright (c) 2015 The Polymer Project Authors. All rights reserved. | 3 Copyright (c) 2015 The Polymer Project Authors. All rights reserved. |
4 This code may only be used under the BSD style license found at http://polymer.g
ithub.io/LICENSE | 4 This code may only be used under the BSD style license found at http://polymer.g
ithub.io/LICENSE |
5 The complete set of authors may be found at http://polymer.github.io/AUTHORS | 5 The complete set of authors may be found at http://polymer.github.io/AUTHORS |
6 The complete set of contributors may be found at http://polymer.github.io/CONTRI
BUTORS | 6 The complete set of contributors may be found at http://polymer.github.io/CONTRI
BUTORS |
7 Code distributed by Google as part of the polymer project is also | 7 Code distributed by Google as part of the polymer project is also |
8 subject to an additional IP rights grant found at http://polymer.github.io/PATEN
TS | 8 subject to an additional IP rights grant found at http://polymer.github.io/PATEN
TS |
9 --> | 9 --> |
10 | 10 |
| 11 <link rel="import" href="../polymer/polymer.html"> |
| 12 <link rel="import" href="../iron-icon/iron-icon.html"> |
| 13 <link rel="import" href="../iron-flex-layout/iron-flex-layout.html"> |
| 14 <link rel="import" href="../paper-styles/default-theme.html"> |
| 15 <link rel="import" href="../paper-behaviors/paper-button-behavior.html"> |
| 16 <link rel="import" href="../paper-behaviors/paper-radio-button-behavior.html"> |
| 17 <link rel="import" href="../paper-ripple/paper-ripple.html"> |
| 18 |
| 19 <style is="custom-style"> |
| 20 :root { |
| 21 --paper-icon-button-disabled-text: var(--disabled-text-color); |
| 22 } |
| 23 </style> |
| 24 |
11 <!-- | 25 <!-- |
12 @group Paper Elements | |
13 | |
14 Material Design: <a href="http://www.google.com/design/spec/components/buttons.h
tml">Buttons</a> | 26 Material Design: <a href="http://www.google.com/design/spec/components/buttons.h
tml">Buttons</a> |
15 | 27 |
16 `paper-icon-button` is a button with an image placed at the center. When the use
r touches | 28 `paper-icon-button` is a button with an image placed at the center. When the use
r touches |
17 the button, a ripple effect emanates from the center of the button. | 29 the button, a ripple effect emanates from the center of the button. |
18 | 30 |
19 `paper-icon-button` includes a default icon set. Use `icon` to specify which ic
on | 31 `paper-icon-button` includes a default icon set. Use `icon` to specify which ic
on |
20 from the icon set to use. | 32 from the icon set to use. |
21 | 33 |
22 <paper-icon-button icon="menu"></paper-icon-button> | 34 <paper-icon-button icon="menu"></paper-icon-button> |
23 | 35 |
24 See [`iron-iconset`](#iron-iconset) for more information about | 36 See [`iron-iconset`](#iron-iconset) for more information about |
25 how to use a custom icon set. | 37 how to use a custom icon set. |
26 | 38 |
27 Example: | 39 Example: |
28 | 40 |
29 <link href="path/to/iron-icons/iron-icons.html" rel="import"> | 41 <link href="path/to/iron-icons/iron-icons.html" rel="import"> |
30 | 42 |
31 <paper-icon-button icon="favorite"></paper-icon-button> | 43 <paper-icon-button icon="favorite"></paper-icon-button> |
32 <paper-icon-button src="star.png"></paper-icon-button> | 44 <paper-icon-button src="star.png"></paper-icon-button> |
33 | 45 |
34 Styling | 46 ###Styling |
35 ------- | |
36 | 47 |
37 Style the button with CSS as you would a normal DOM element. If you are using th
e icons | 48 Style the button with CSS as you would a normal DOM element. If you are using th
e icons |
38 provided by `iron-icons`, they will inherit the foreground color of the button. | 49 provided by `iron-icons`, they will inherit the foreground color of the button. |
39 | 50 |
40 /* make a red "favorite" button */ | 51 /* make a red "favorite" button */ |
41 <paper-icon-button icon="favorite" style="color: red;"></paper-icon-button> | 52 <paper-icon-button icon="favorite" style="color: red;"></paper-icon-button> |
42 | 53 |
43 By default, the ripple is the same color as the foreground at 25% opacity. You m
ay | 54 By default, the ripple is the same color as the foreground at 25% opacity. You m
ay |
44 customize the color using this selector: | 55 customize the color using this selector: |
45 | 56 |
46 /* make #my-button use a blue ripple instead of foreground color */ | 57 /* make #my-button use a blue ripple instead of foreground color */ |
47 #my-button::shadow #ripple { | 58 #my-button::shadow #ripple { |
48 color: blue; | 59 color: blue; |
49 } | 60 } |
50 | 61 |
51 The opacity of the ripple is not customizable via CSS. | 62 The opacity of the ripple is not customizable via CSS. |
52 | 63 |
| 64 The following custom properties and mixins are available for styling: |
| 65 |
| 66 Custom property | Description | Default |
| 67 ----------------|-------------|---------- |
| 68 `--paper-icon-button-disabled-text` | The color of the disabled button | `--prim
ary-text-color` |
| 69 `--paper-icon-button-ink-color` | Selected/focus ripple color | `--default-prima
ry-color` |
| 70 `--paper-icon-button` | Mixin for a button | `{}` |
| 71 `--paper-icon-button-disabled` | Mixin for a disabled button | `{}` |
| 72 |
| 73 @group Paper Elements |
53 @element paper-icon-button | 74 @element paper-icon-button |
54 @homepage github.io | 75 @demo demo/index.html |
55 --> | 76 --> |
56 | 77 |
57 <link rel="import" href="../polymer/polymer.html"> | |
58 <link rel="import" href="../iron-icon/iron-icon.html"> | |
59 <link rel="import" href="../iron-flex-layout/iron-flex-layout.html"> | |
60 <link rel="import" href="../paper-styles/default-theme.html"> | |
61 <link rel="import" href="../paper-behaviors/paper-button-behavior.html"> | |
62 <link rel="import" href="../paper-ripple/paper-ripple.html"> | |
63 | |
64 <style is="x-style"> | |
65 * { | |
66 --paper-icon-button-disabled-text: var(--disabled-text-color); | |
67 } | |
68 </style> | |
69 | |
70 <dom-module id="paper-icon-button"> | 78 <dom-module id="paper-icon-button"> |
71 <style> | 79 <style> |
| 80 |
72 :host { | 81 :host { |
73 display: inline-block; | 82 display: inline-block; |
74 position: relative; | 83 position: relative; |
75 padding: 8px; | 84 padding: 8px; |
76 outline: none; | 85 outline: none; |
77 -webkit-user-select: none; | 86 -webkit-user-select: none; |
78 -moz-user-select: none; | 87 -moz-user-select: none; |
79 -ms-user-select: none; | 88 -ms-user-select: none; |
80 user-select: none; | 89 user-select: none; |
81 cursor: pointer; | 90 cursor: pointer; |
82 z-index: 0; | 91 z-index: 0; |
83 | 92 |
84 mixin(--paper-icon-button); | 93 @apply(--paper-icon-button); |
| 94 } |
| 95 |
| 96 :host #ink { |
| 97 color: var(--paper-icon-button-ink-color, --primary-text-color); |
| 98 opacity: 0.6; |
85 } | 99 } |
86 | 100 |
87 :host([disabled]) { | 101 :host([disabled]) { |
88 color: var(--paper-icon-button-disabled-text); | 102 color: var(--paper-icon-button-disabled-text, #fff); |
89 pointer-events: none; | 103 pointer-events: none; |
90 cursor: auto; | 104 cursor: auto; |
91 | 105 @apply(--paper-icon-button-disabled); |
92 mixin(--paper-icon-button-disabled); | |
93 } | 106 } |
94 </style> | 107 </style> |
95 <template> | 108 <template> |
96 <paper-ripple class="circle" recenters></paper-ripple> | 109 <paper-ripple id="ink" class="circle" center></paper-ripple> |
97 <iron-icon id="icon" src="[[src]]" icon="[[icon]]"></iron-icon> | 110 <iron-icon id="icon" src="[[src]]" icon="[[icon]]"></iron-icon> |
98 </template> | 111 </template> |
99 </dom-module> | 112 </dom-module> |
100 <script> | 113 <script> |
101 Polymer({ | 114 Polymer({ |
102 is: 'paper-icon-button', | 115 is: 'paper-icon-button', |
103 | 116 |
104 behaviors: [ | 117 behaviors: [ |
105 Polymer.PaperButtonBehavior | 118 Polymer.PaperButtonBehavior, |
| 119 Polymer.PaperRadioButtonBehavior |
106 ], | 120 ], |
107 | 121 |
108 enableCustomStyleProperties: true, | |
109 | |
110 properties: { | 122 properties: { |
111 /** | 123 /** |
112 * The URL of an image for the icon. If the src property is specified, | 124 * The URL of an image for the icon. If the src property is specified, |
113 * the icon property should not be. | 125 * the icon property should not be. |
114 */ | 126 */ |
115 src: { | 127 src: { |
116 type: String | 128 type: String |
117 }, | 129 }, |
118 | 130 |
119 /** | 131 /** |
120 * Specifies the icon name or index in the set of icons available in | 132 * Specifies the icon name or index in the set of icons available in |
121 * the icon's icon set. If the icon property is specified, | 133 * the icon's icon set. If the icon property is specified, |
122 * the src property should not be. | 134 * the src property should not be. |
123 */ | 135 */ |
124 icon: { | 136 icon: { |
125 type: String | 137 type: String |
126 } | 138 } |
127 } | 139 } |
128 }); | 140 }); |
129 </script> | 141 </script> |
130 | |
OLD | NEW |