[![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.
### Tech notes:
* `value.*` is observed, and saved on modifications. You must use
path change notifification 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.
`