| Index: third_party/polymer/v1_0/components-chromium/paper-item/README.md
|
| diff --git a/third_party/polymer/v1_0/components-chromium/paper-item/README.md b/third_party/polymer/v1_0/components-chromium/paper-item/README.md
|
| index 8c446dbd22df9f49855251215699f334bbb1b22f..ea5c50a215f1954d5c957b0cb1ca74b167152670 100644
|
| --- a/third_party/polymer/v1_0/components-chromium/paper-item/README.md
|
| +++ b/third_party/polymer/v1_0/components-chromium/paper-item/README.md
|
| @@ -7,107 +7,119 @@ paper-icon-item.html paper-item-behavior.html paper-item-body.html paper-item
|
| Edit those files, and our readme bot will duplicate them over here!
|
| Edit this file, and the bot will squash your changes :)
|
|
|
| +The bot does some handling of markdown. Please file a bug if it does the wrong
|
| +thing! https://github.com/PolymerLabs/tedium/issues
|
| +
|
| -->
|
|
|
| -[](https://travis-ci.org/PolymerElements/paper-item)
|
| +[](https://travis-ci.org/PolymerElements/paper-item)
|
|
|
| -_[Demo and API Docs](https://elements.polymer-project.org/elements/paper-item)_
|
| +_[Demo and API docs](https://elements.polymer-project.org/elements/paper-item)_
|
|
|
|
|
| ##<paper-item>
|
|
|
| -
|
| Material design: [Lists](https://www.google.com/design/spec/components/lists.html)
|
|
|
| `<paper-item>` is an interactive list item. By default, it is a horizontal flexbox.
|
|
|
| - <paper-item>Item</paper-item>
|
| +```html
|
| +<paper-item>Item</paper-item>
|
| +```
|
|
|
| Use this element with `<paper-item-body>` to make Material Design styled two-line and three-line
|
| items.
|
|
|
| - <paper-item>
|
| - <paper-item-body two-line>
|
| - <div>Show your status</div>
|
| - <div secondary>Your status is visible to everyone</div>
|
| - </paper-item-body>
|
| - <iron-icon icon="warning"></iron-icon>
|
| - </paper-item>
|
| +```html
|
| +<paper-item>
|
| + <paper-item-body two-line>
|
| + <div>Show your status</div>
|
| + <div secondary>Your status is visible to everyone</div>
|
| + </paper-item-body>
|
| + <iron-icon icon="warning"></iron-icon>
|
| +</paper-item>
|
| +```
|
|
|
| ### Styling
|
|
|
| The following custom properties and mixins are available for styling:
|
|
|
| -Custom property | Description | Default
|
| -------------------------------|----------------------------------------------|----------
|
| -`--paper-item-min-height` | Minimum height of the item | `48px`
|
| -`--paper-item` | Mixin applied to the item | `{}`
|
| -`--paper-item-selected-weight`| The font weight of a selected item | `bold`
|
| -`--paper-item-selected` | Mixin applied to selected paper-items | `{}`
|
| -`--paper-item-disabled-color` | The color for disabled paper-items | `--disabled-text-color`
|
| -`--paper-item-disabled` | Mixin applied to disabled paper-items | `{}`
|
| -`--paper-item-focused` | Mixin applied to focused paper-items | `{}`
|
| -`--paper-item-focused-before` | Mixin applied to :before focused paper-items | `{}`
|
| +| Custom property | Description | Default |
|
| +| --- | --- | --- |
|
| +| `--paper-item-min-height` | Minimum height of the item | `48px` |
|
| +| `--paper-item` | Mixin applied to the item | `{}` |
|
| +| `--paper-item-selected-weight` | The font weight of a selected item | `bold` |
|
| +| `--paper-item-selected` | Mixin applied to selected paper-items | `{}` |
|
| +| `--paper-item-disabled-color` | The color for disabled paper-items | `--disabled-text-color` |
|
| +| `--paper-item-disabled` | Mixin applied to disabled paper-items | `{}` |
|
| +| `--paper-item-focused` | Mixin applied to focused paper-items | `{}` |
|
| +| `--paper-item-focused-before` | Mixin applied to :before focused paper-items | `{}` |
|
|
|
| ### Accessibility
|
|
|
| This element has `role="listitem"` by default. Depending on usage, it may be more appropriate to set
|
| `role="menuitem"`, `role="menuitemcheckbox"` or `role="menuitemradio"`.
|
|
|
| - <paper-item role="menuitemcheckbox">
|
| - <paper-item-body>
|
| - Show your status
|
| - </paper-item-body>
|
| - <paper-checkbox></paper-checkbox>
|
| - </paper-item>
|
| +```html
|
| +<paper-item role="menuitemcheckbox">
|
| + <paper-item-body>
|
| + Show your status
|
| + </paper-item-body>
|
| + <paper-checkbox></paper-checkbox>
|
| +</paper-item>
|
| +```
|
|
|
|
|
|
|
| ##<paper-icon-item>
|
|
|
| -
|
| `<paper-icon-item>` is a convenience element to make an item with icon. It is an interactive list
|
| item with a fixed-width icon area, according to Material Design. This is useful if the icons are of
|
| varying widths, but you want the item bodies to line up. Use this like a `<paper-item>`. The child
|
| node with the attribute `item-icon` is placed in the icon area.
|
|
|
| - <paper-icon-item>
|
| - <iron-icon icon="favorite" item-icon></iron-icon>
|
| - Favorite
|
| - </paper-icon-item>
|
| - <paper-icon-item>
|
| - <div class="avatar" item-icon></div>
|
| - Avatar
|
| - </paper-icon-item>
|
| +```html
|
| +<paper-icon-item>
|
| + <iron-icon icon="favorite" item-icon></iron-icon>
|
| + Favorite
|
| +</paper-icon-item>
|
| +<paper-icon-item>
|
| + <div class="avatar" item-icon></div>
|
| + Avatar
|
| +</paper-icon-item>
|
| +```
|
|
|
| ### Styling
|
|
|
| The following custom properties and mixins are available for styling:
|
|
|
| -Custom property | Description | Default
|
| -------------------------------|------------------------------------------------|----------
|
| -`--paper-item-icon-width` | Width of the icon area | `56px`
|
| -`--paper-icon-item` | Mixin applied to the item | `{}`
|
| -`--paper-item-selected-weight`| The font weight of a selected item | `bold`
|
| -`--paper-item-selected` | Mixin applied to selected paper-items | `{}`
|
| -`--paper-item-disabled-color` | The color for disabled paper-items | `--disabled-text-color`
|
| -`--paper-item-disabled` | Mixin applied to disabled paper-items | `{}`
|
| -`--paper-item-focused` | Mixin applied to focused paper-items | `{}`
|
| -`--paper-item-focused-before` | Mixin applied to :before focused paper-items | `{}`
|
| +| Custom property | Description | Default |
|
| +| --- | --- | --- |
|
| +| `--paper-item-icon-width` | Width of the icon area | `56px` |
|
| +| `--paper-item-icon` | Mixin applied to the icon area | `{}` |
|
| +| `--paper-icon-item` | Mixin applied to the item | `{}` |
|
| +| `--paper-item-selected-weight` | The font weight of a selected item | `bold` |
|
| +| `--paper-item-selected` | Mixin applied to selected paper-items | `{}` |
|
| +| `--paper-item-disabled-color` | The color for disabled paper-items | `--disabled-text-color` |
|
| +| `--paper-item-disabled` | Mixin applied to disabled paper-items | `{}` |
|
| +| `--paper-item-focused` | Mixin applied to focused paper-items | `{}` |
|
| +| `--paper-item-focused-before` | Mixin applied to :before focused paper-items | `{}` |
|
|
|
|
|
| -##<paper-item-body>
|
|
|
| +##<paper-item-body>
|
|
|
| Use `<paper-item-body>` in a `<paper-item>` or `<paper-icon-item>` to make two- or
|
| three- line items. It is a flex item that is a vertical flexbox.
|
|
|
| - <paper-item>
|
| - <paper-item-body two-line>
|
| - <div>Show your status</div>
|
| - <div secondary>Your status is visible to everyone</div>
|
| - </paper-item-body>
|
| - </paper-item>
|
| +```html
|
| +<paper-item>
|
| + <paper-item-body two-line>
|
| + <div>Show your status</div>
|
| + <div secondary>Your status is visible to everyone</div>
|
| + </paper-item-body>
|
| +</paper-item>
|
| +```
|
|
|
| The child elements with the `secondary` attribute is given secondary text styling.
|
|
|
| @@ -115,12 +127,12 @@ The child elements with the `secondary` attribute is given secondary text stylin
|
|
|
| The following custom properties and mixins are available for styling:
|
|
|
| -Custom property | Description | Default
|
| -----------------|-------------|----------
|
| -`--paper-item-body-two-line-min-height` | Minimum height of a two-line item | `72px`
|
| -`--paper-item-body-three-line-min-height` | Minimum height of a three-line item | `88px`
|
| -`--paper-item-body-secondary-color` | Foreground color for the `secondary` area | `--secondary-text-color`
|
| -`--paper-item-body-secondary` | Mixin applied to the `secondary` area | `{}`
|
| +| Custom property | Description | Default |
|
| +| --- | --- | --- |
|
| +| `--paper-item-body-two-line-min-height` | Minimum height of a two-line item | `72px` |
|
| +| `--paper-item-body-three-line-min-height` | Minimum height of a three-line item | `88px` |
|
| +| `--paper-item-body-secondary-color` | Foreground color for the `secondary` area | `--secondary-text-color` |
|
| +| `--paper-item-body-secondary` | Mixin applied to the `secondary` area | `{}` |
|
|
|
|
|
|
|
|
|