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