Index: third_party/polymer/v0_8/components/iron-image/iron-image.html |
diff --git a/third_party/polymer/v0_8/components/iron-image/iron-image.html b/third_party/polymer/v0_8/components/iron-image/iron-image.html |
new file mode 100644 |
index 0000000000000000000000000000000000000000..07eb4585161c032e82204878c3725cf6e6f59bca |
--- /dev/null |
+++ b/third_party/polymer/v0_8/components/iron-image/iron-image.html |
@@ -0,0 +1,394 @@ |
+<!-- |
+@license |
+Copyright (c) 2015 The Polymer Project Authors. All rights reserved. |
+This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt |
+The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt |
+The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt |
+Code distributed by Google as part of the polymer project is also |
+subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt |
+--> |
+ |
+<link rel="import" href="../polymer/polymer.html"> |
+<link rel="import" href="../iron-flex-layout/classes/iron-flex-layout.html"> |
+ |
+<!-- |
+`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: |
+ |
+ <iron-image src="http://lorempixel.com/400/400"></iron-image> |
+ |
+ Will letterbox the image to fit: |
+ |
+ <iron-image style="width:400px; height:400px;" sizing="contain" |
+ src="http://lorempixel.com/600/400"></iron-image> |
+ |
+ Will crop the image to fit: |
+ |
+ <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: |
+ |
+ <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: |
+ |
+ <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: |
+ |
+ <iron-image style="width:400px; height:400px; background-color: lightgray;" |
+ sizing="cover" preload fade src="http://lorempixel.com/600/400"></iron-image> |
+ |
+ |
+@group Iron Elements |
+@element iron-image |
+@demo demo/index.html |
+--> |
+ |
+<dom-module id="iron-image"> |
+ |
+ <style> |
+ |
+ :host { |
+ display: inline-block; |
+ overflow: hidden; |
+ position: relative; |
+ } |
+ |
+ :host([sizing]) #img { |
+ display: none; |
+ } |
+ |
+ #placeholder { |
+ background-color: inherit; |
+ opacity: 1; |
+ } |
+ |
+ #placeholder.faded-out { |
+ transition: opacity 0.5s linear; |
+ opacity: 0; |
+ } |
+ |
+ </style> |
+ |
+ <template> |
+ |
+ <img id="img" role="none" hidden$="[[_computeImageVisibility(sizing)]]"> |
+ <div id="placeholder" hidden$="[[_computePlaceholderVisibility(fade,loaded,preload)]]" class$="[[_computePlaceholderClassName(fade,loaded,preload)]]"></div> |
+ <content></content> |
+ |
+ </template> |
+ |
+</dom-module> |
+ |
+<script> |
+ |
+ Polymer({ |
+ |
+ is: 'iron-image', |
+ |
+ properties: { |
+ /** |
+ * The URL of an image. |
+ * |
+ * @attribute src |
+ * @type string |
+ * @default '' |
+ */ |
+ src: { |
+ observer: '_srcChanged', |
+ type: String, |
+ value: '' |
+ }, |
+ |
+ /** |
+ * When true, the image is prevented from loading and any placeholder is |
+ * shown. This may be useful when a binding to the src property is known to |
+ * be invalid, to prevent 404 requests. |
+ * |
+ * @attribute preventLoad |
+ * @type boolean |
+ * @default false |
+ */ |
+ preventLoad: { |
+ type: Boolean, |
+ value: false |
+ }, |
+ |
+ /** |
+ * Sets a sizing option for the image. Valid values are `contain` (full |
+ * aspect ratio of the image is contained within the element and |
+ * letterboxed) or `cover` (image is cropped in order to fully cover the |
+ * bounds of the element), or `null` (default: image takes natural size). |
+ * |
+ * @attribute sizing |
+ * @type string |
+ * @default null |
+ */ |
+ sizing: { |
+ type: String, |
+ value: null |
+ }, |
+ |
+ /** |
+ * When a sizing option is uzed (`cover` or `contain`), this determines |
+ * how the image is aligned within the element bounds. |
+ * |
+ * @attribute position |
+ * @type string |
+ * @default 'center' |
+ */ |
+ position: { |
+ type: String, |
+ value: 'center' |
+ }, |
+ |
+ /** |
+ * When `true`, any change to the `src` property will cause the `placeholder` |
+ * image to be shown until the |
+ * |
+ * @attribute preload |
+ * @type boolean |
+ * @default false |
+ */ |
+ preload: { |
+ type: Boolean, |
+ value: false |
+ }, |
+ |
+ /** |
+ * This image will be used as a background/placeholder until the src image has |
+ * loaded. Use of a data-URI for placeholder is encouraged for instant rendering. |
+ * |
+ * @attribute placeholder |
+ * @type string |
+ * @default null |
+ */ |
+ placeholder: { |
+ type: String, |
+ value: null |
+ }, |
+ |
+ /** |
+ * When `preload` is true, setting `fade` to true will cause the image to |
+ * fade into place. |
+ * |
+ * @attribute fade |
+ * @type boolean |
+ * @default false |
+ */ |
+ fade: { |
+ type: Boolean, |
+ value: false |
+ }, |
+ |
+ /** |
+ * Read-only value that is true when the image is loaded. |
+ * |
+ * @attribute preloaded |
+ * @type boolean |
+ * @default false |
+ */ |
+ loaded: { |
+ notify: true, |
+ type: Boolean, |
+ value: false |
+ }, |
+ |
+ /** |
+ * Read-only value that tracks the loading state of the image when the `preload` |
+ * option is used. |
+ * |
+ * @attribute loading |
+ * @type boolean |
+ * @default false |
+ */ |
+ loading: { |
+ notify: true, |
+ type: Boolean, |
+ value: false |
+ }, |
+ |
+ /** |
+ * Can be used to set the width of image (e.g. via binding); size may also be |
+ * set via CSS. |
+ * |
+ * @attribute width |
+ * @type number |
+ * @default null |
+ */ |
+ width: { |
+ observer: '_widthChanged', |
+ type: Number, |
+ value: null |
+ }, |
+ |
+ /** |
+ * Can be used to set the height of image (e.g. via binding); size may also be |
+ * set via CSS. |
+ * |
+ * @attribute height |
+ * @type number |
+ * @default null |
+ */ |
+ height: { |
+ observer: '_heightChanged', |
+ type: Number, |
+ value: null |
+ }, |
+ |
+ _placeholderBackgroundUrl: { |
+ type: String, |
+ computed: '_computePlaceholderBackgroundUrl(preload,placeholder)', |
+ observer: '_placeholderBackgroundUrlChanged' |
+ }, |
+ |
+ requiresPreload: { |
+ type: Boolean, |
+ computed: '_computeRequiresPreload(preload,loaded)' |
+ }, |
+ |
+ canLoad: { |
+ type: Boolean, |
+ computed: '_computeCanLoad(preventLoad, src)' |
+ } |
+ |
+ }, |
+ |
+ observers: [ |
+ '_transformChanged(sizing, position)', |
+ '_loadBehaviorChanged(canLoad, preload, loaded)', |
+ '_loadStateChanged(src, preload, loaded)', |
+ ], |
+ |
+ ready: function() { |
+ if (!this.hasAttribute('role')) { |
+ this.setAttribute('role', 'img'); |
+ } |
+ }, |
+ |
+ _computeImageVisibility: function() { |
+ return !!this.sizing; |
+ }, |
+ |
+ _computePlaceholderVisibility: function() { |
+ return !this.preload || (this.loaded && !this.fade); |
+ }, |
+ |
+ _computePlaceholderClassName: function() { |
+ if (!this.preload) { |
+ return ''; |
+ } |
+ |
+ var className = 'fit'; |
+ if (this.loaded && this.fade) { |
+ className += ' faded-out'; |
+ } |
+ return className; |
+ }, |
+ |
+ _computePlaceholderBackgroundUrl: function() { |
+ if (this.preload && this.placeholder) { |
+ return 'url(' + this.placeholder + ')'; |
+ } |
+ |
+ return null; |
+ }, |
+ |
+ _computeRequiresPreload: function() { |
+ return this.preload && !this.loaded; |
+ }, |
+ |
+ _computeCanLoad: function() { |
+ return Boolean(!this.preventLoad && this.src); |
+ }, |
+ |
+ _widthChanged: function() { |
+ this.style.width = isNaN(this.width) ? this.width : this.width + 'px'; |
+ }, |
+ |
+ _heightChanged: function() { |
+ this.style.height = isNaN(this.height) ? this.height : this.height + 'px'; |
+ }, |
+ |
+ _srcChanged: function(newSrc, oldSrc) { |
+ if (newSrc !== oldSrc) { |
+ this.loaded = false; |
+ } |
+ }, |
+ |
+ _placeholderBackgroundUrlChanged: function() { |
+ this.$.placeholder.style.backgroundImage = |
+ this._placeholderBackgroundUrl; |
+ }, |
+ |
+ _transformChanged: function() { |
+ var placeholderStyle = this.$.placeholder.style; |
+ |
+ this.style.backgroundSize = |
+ placeholderStyle.backgroundSize = this.sizing; |
+ |
+ this.style.backgroundPosition = |
+ placeholderStyle.backgroundPosition = |
+ this.sizing ? this.position : null; |
+ |
+ this.style.backgroundRepeat = |
+ placeholderStyle.backgroundRepeat = |
+ this.sizing ? 'no-repeat' : null; |
+ }, |
+ |
+ _loadBehaviorChanged: function() { |
+ var img; |
+ |
+ if (!this.canLoad) { |
+ return; |
+ } |
+ |
+ if (this.requiresPreload) { |
+ img = new Image(); |
+ img.src = this.src; |
+ |
+ this.loading = true; |
+ |
+ img.onload = function() { |
+ this.loading = false; |
+ this.loaded = true; |
+ }.bind(this); |
+ } else { |
+ this.loaded = true; |
+ } |
+ }, |
+ |
+ _loadStateChanged: function() { |
+ if (this.requiresPreload) { |
+ return; |
+ } |
+ |
+ if (this.sizing) { |
+ this.style.backgroundImage = this.src ? 'url(' + this.src + ')': ''; |
+ } else { |
+ this.$.img.src = this.src || ''; |
+ } |
+ } |
+ }); |
+ |
+</script> |