[![Build status](https://travis-ci.org/PolymerElements/iron-localstorage.svg?branch=master)](https://travis-ci.org/PolymerElements/iron-localstorage) _[Demo and API docs](https://elements.polymer-project.org/elements/iron-localstorage)_ ##<iron-localstorage> Element access to Web Storage API (window.localStorage). Keeps `value` property in sync with localStorage. Value is saved as json by default. ### Usage: `ls-sample` will automatically save changes to its value. ```html ``` ### Tech notes: * `value.*` is observed, and saved on modifications. You must use path change notification methods such as `set()` to modify value for changes to be observed. * Set `auto-save-disabled` to prevent automatic saving. * Value is saved as JSON by default. * To delete a key, set value to null Element listens to StorageAPI `storage` event, and will reload upon receiving it. __Warning__: do not bind value to sub-properties until Polymer [bug 1550](https://github.com/Polymer/polymer/issues/1550) is resolved. Local storage will be blown away. `