OLD | NEW |
| (Empty) |
1 | |
2 <!--- | |
3 | |
4 This README is automatically generated from the comments in these files: | |
5 paper-icon-item.html paper-item-behavior.html paper-item-body.html paper-item
.html | |
6 | |
7 Edit those files, and our readme bot will duplicate them over here! | |
8 Edit this file, and the bot will squash your changes :) | |
9 | |
10 The bot does some handling of markdown. Please file a bug if it does the wrong | |
11 thing! https://github.com/PolymerLabs/tedium/issues | |
12 | |
13 --> | |
14 | |
15 [](https://travis-ci.org/PolymerElements/paper-item) | |
16 | |
17 _[Demo and API docs](https://elements.polymer-project.org/elements/paper-item)_ | |
18 | |
19 | |
20 ##<paper-item> | |
21 | |
22 Material design: [Lists](https://www.google.com/design/spec/components/lists.htm
l) | |
23 | |
24 `<paper-item>` is an interactive list item. By default, it is a horizontal flexb
ox. | |
25 | |
26 ```html | |
27 <paper-item>Item</paper-item> | |
28 ``` | |
29 | |
30 Use this element with `<paper-item-body>` to make Material Design styled two-lin
e and three-line | |
31 items. | |
32 | |
33 ```html | |
34 <paper-item> | |
35 <paper-item-body two-line> | |
36 <div>Show your status</div> | |
37 <div secondary>Your status is visible to everyone</div> | |
38 </paper-item-body> | |
39 <iron-icon icon="warning"></iron-icon> | |
40 </paper-item> | |
41 ``` | |
42 | |
43 ### Styling | |
44 | |
45 The following custom properties and mixins are available for styling: | |
46 | |
47 | Custom property | Description | Default | | |
48 | --- | --- | --- | | |
49 | `--paper-item-min-height` | Minimum height of the item | `48px` | | |
50 | `--paper-item` | Mixin applied to the item | `{}` | | |
51 | `--paper-item-selected-weight` | The font weight of a selected item | `bold` | | |
52 | `--paper-item-selected` | Mixin applied to selected paper-items | `{}` | | |
53 | `--paper-item-disabled-color` | The color for disabled paper-items | `--disabl
ed-text-color` | | |
54 | `--paper-item-disabled` | Mixin applied to disabled paper-items | `{}` | | |
55 | `--paper-item-focused` | Mixin applied to focused paper-items | `{}` | | |
56 | `--paper-item-focused-before` | Mixin applied to :before focused paper-items |
`{}` | | |
57 | |
58 ### Accessibility | |
59 | |
60 This element has `role="listitem"` by default. Depending on usage, it may be mor
e appropriate to set | |
61 `role="menuitem"`, `role="menuitemcheckbox"` or `role="menuitemradio"`. | |
62 | |
63 ```html | |
64 <paper-item role="menuitemcheckbox"> | |
65 <paper-item-body> | |
66 Show your status | |
67 </paper-item-body> | |
68 <paper-checkbox></paper-checkbox> | |
69 </paper-item> | |
70 ``` | |
71 | |
72 | |
73 | |
74 ##<paper-icon-item> | |
75 | |
76 `<paper-icon-item>` is a convenience element to make an item with icon. It is an
interactive list | |
77 item with a fixed-width icon area, according to Material Design. This is useful
if the icons are of | |
78 varying widths, but you want the item bodies to line up. Use this like a `<paper
-item>`. The child | |
79 node with the attribute `item-icon` is placed in the icon area. | |
80 | |
81 ```html | |
82 <paper-icon-item> | |
83 <iron-icon icon="favorite" item-icon></iron-icon> | |
84 Favorite | |
85 </paper-icon-item> | |
86 <paper-icon-item> | |
87 <div class="avatar" item-icon></div> | |
88 Avatar | |
89 </paper-icon-item> | |
90 ``` | |
91 | |
92 ### Styling | |
93 | |
94 The following custom properties and mixins are available for styling: | |
95 | |
96 | Custom property | Description | Default | | |
97 | --- | --- | --- | | |
98 | `--paper-item-icon-width` | Width of the icon area | `56px` | | |
99 | `--paper-item-icon` | Mixin applied to the icon area | `{}` | | |
100 | `--paper-icon-item` | Mixin applied to the item | `{}` | | |
101 | `--paper-item-selected-weight` | The font weight of a selected item | `bold` | | |
102 | `--paper-item-selected` | Mixin applied to selected paper-items | `{}` | | |
103 | `--paper-item-disabled-color` | The color for disabled paper-items | `--disabl
ed-text-color` | | |
104 | `--paper-item-disabled` | Mixin applied to disabled paper-items | `{}` | | |
105 | `--paper-item-focused` | Mixin applied to focused paper-items | `{}` | | |
106 | `--paper-item-focused-before` | Mixin applied to :before focused paper-items |
`{}` | | |
107 | |
108 | |
109 | |
110 ##<paper-item-body> | |
111 | |
112 Use `<paper-item-body>` in a `<paper-item>` or `<paper-icon-item>` to make two-
or | |
113 three- line items. It is a flex item that is a vertical flexbox. | |
114 | |
115 ```html | |
116 <paper-item> | |
117 <paper-item-body two-line> | |
118 <div>Show your status</div> | |
119 <div secondary>Your status is visible to everyone</div> | |
120 </paper-item-body> | |
121 </paper-item> | |
122 ``` | |
123 | |
124 The child elements with the `secondary` attribute is given secondary text stylin
g. | |
125 | |
126 ### Styling | |
127 | |
128 The following custom properties and mixins are available for styling: | |
129 | |
130 | Custom property | Description | Default | | |
131 | --- | --- | --- | | |
132 | `--paper-item-body-two-line-min-height` | Minimum height of a two-line item |
`72px` | | |
133 | `--paper-item-body-three-line-min-height` | Minimum height of a three-line ite
m | `88px` | | |
134 | `--paper-item-body-secondary-color` | Foreground color for the `secondary` are
a | `--secondary-text-color` | | |
135 | `--paper-item-body-secondary` | Mixin applied to the `secondary` area | `{}` | | |
136 | |
137 | |
138 | |
139 <!-- No docs for Polymer.PaperItemBehavior found. --> | |
OLD | NEW |