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

Just add this module to your app as a dependency var yourApp = angular.module('yourApp', [..., 'angularLocalStorage']
Now inside your controllers simply pass the storage factory like this yourApp.controller('yourController', function( $scope, storage){
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

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!

qraynaud / angularLocalStorage