Sha256: 83b65c3e78618b38b4b9dad2dc783a5499e1902d8081da025be838ff40286c28

Contents?: true

Size: 1.87 KB

Versions: 6

Compression:

Stored size: 1.87 KB

Contents

iron-image
==========

`iron-image` is an element for displaying an image that provides useful sizing and
preloading options not found on the standard `<img>` tag.

The `sizing` option allows the image to be either cropped (`cover`) or
letterboxed (`contain`) to fill a fixed user-size placed on the element.

The `preload` option prevents the browser from rendering the image until the
image is fully loaded.  In the interim, either the element's CSS `background-color`
can be be used as the placeholder, or the `placeholder` property can be
set to a URL (preferably a data-URI, for instant rendering) for an
placeholder image.

The `fade` option (only valid when `preload` is set) will cause the placeholder
image/color to be faded out once the image is rendered.

Examples:

Basically identical to `<img src="...">` tag:

```html
<iron-image src="http://lorempixel.com/400/400"></iron-image>
```

Will letterbox the image to fit:

```html
<iron-image style="width:400px; height:400px;" sizing="contain"
  src="http://lorempixel.com/600/400"></iron-image>
```

Will crop the image to fit:

```html
<iron-image style="width:400px; height:400px;" sizing="cover"
  src="http://lorempixel.com/600/400"></iron-image>
```

Will show light-gray background until the image loads:

```html
<iron-image style="width:400px; height:400px; background-color: lightgray;"
  sizing="cover" preload src="http://lorempixel.com/600/400"></iron-image>
```

Will show a base-64 encoded placeholder image until the image loads:

```html
<iron-image style="width:400px; height:400px;" placeholder="data:image/gif;base64,..."
  sizing="cover" preload src="http://lorempixel.com/600/400"></iron-image>
```

Will fade the light-gray background out once the image is loaded:

```html
<iron-image style="width:400px; height:400px; background-color: lightgray;"
  sizing="cover" preload fade src="http://lorempixel.com/600/400"></iron-image>
```

Version data entries

6 entries across 6 versions & 2 rubygems

Version Path
polymer-elements-rails-1.0.1 app/assets/components/iron-image/README.md
polymer-elements-rails-1.0.0 app/assets/components/iron-image/README.md
polymer-elements-rails-1.0.0.pre.rc.1 app/assets/components/iron-image/README.md
polymer-iron-rails-1.0.0.pre.rc.3 app/assets/components/iron-image/README.md
polymer-iron-rails-1.0.0.pre.rc.2 app/assets/components/iron-image/README.md
polymer-iron-rails-1.0.0.pre.rc.1 app/assets/components/iron-image/README.md