angularLocalStorage

The simpliest localStorage module you will ever use. Allowing you to set, get, and bind variables.

Features:

• Two way bind your $scope variable value to a localStorage key/pair which will be updated whenever the model is updated.
• You can directly store Objects, Arrays, Floats, Booleans, and Strings. No need to convert your javascript values from strings.
• Fallback to Angular $cookies if localStorage is not supported (REMEMBER to add angular-cookies.min.js script to your project or remove 'ngCookies' from a dependency);

How to use

1. Just add this module to your app as a dependency var yourApp = angular.module('yourApp', [..., 'angularLocalStorage']
2. Now inside your controllers simply pass the storage factory like this yourApp.controller('yourController', function( $scope, storage){
3. Using the storage factory

// binding it to a $scope.variable (minimal)
storage.bind($scope,'varName');
// binding full
storage.bind($scope,'varName',{defaultValue: 'randomValue123' ,storeName: 'customStoreKey'});
// the params are ($scope, varName, opts(optional))
// $scope - pass a reference to whatever scope the variable resides in
// varName - the variable name so for $scope.firstName enter 'firstName'
// opts - custom options like default value or unique store name
// 	Here are the available options you can set:
// 		* defaultValue: the default value
// 		* storeName: add a custom store key value instead of using the scope variable name

// will constantly be updating $scope.viewType
// to change the variable both locally in your controller and in localStorage just do
$scope.viewType = 'ANYTHING';
// that's it, it will be updated in localStorage

// just storing something in localStorage with cookie backup for unsupported browsers
storage.set('key','value');
// getting that value
storage.get('key');

// clear all localStorage values
storage.clearAll();

Bower

This module is available as bower package, install it with this command:

bower install angularLocalStorage

or

bower install git://github.com/agrublev/angularLocalStorage.git

Example

For live example please checkout - http://plnkr.co/edit/Y1mrNVRkInCItqvZXtto?p=preview

Suggestions?

Please add an issue with ideas, improvements, or bugs! Thanks!

---

(c) 2013 MIT License