paper-icon-item.html 3.16 KB
Copyright (c) 2015 The Polymer Project Authors. All rights reserved.
This code may only be used under the BSD style license found at
The complete set of authors may be found at
The complete set of contributors may be found at
Code distributed by Google as part of the polymer project is also
subject to an additional IP rights grant found at

<link rel="import" href="../polymer/polymer.html">
<link rel="import" href="../iron-behaviors/iron-control-state.html">
<link rel="import" href="../iron-behaviors/iron-button-state.html">
<link rel="import" href="../paper-styles/paper-styles.html">
<link rel="import" href="paper-item-shared-styles.html">

`<paper-icon-item>` is a convenience element to make an item with icon. It is a non 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.

      <iron-icon icon="favorite" item-icon></iron-icon>
      <div class="avatar" item-icon></div>

### 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 | `{}`


<dom-module id="paper-icon-item">
    <style include="paper-item-shared-styles"></style>
      :host {


      .content-icon {
        width: var(--paper-item-icon-width, 56px);

    <div id="contentIcon" class="content-icon layout horizontal center">
      <content select="[item-icon]"></content>

      is: 'paper-icon-item',

      hostAttributes: {
        'role': 'listitem',
        'tabindex': '0'

      behaviors: [