GitHub - agrublev/angularLocalStorage: The simplest angular localStorage implementation you will ever use. (original) (raw)

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 $cookieStore 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 dependencyvar yourApp = angular.module('yourApp', [..., 'angularLocalStorage']
Now inside your controllers simply pass the storage factory like thisyourApp.controller('yourController', function( $scope, storage){
Using the storage factory

// Note: if the scope variable already exists, it takes precedence over the default and stored values // 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');

// Getting an unset key will return null console.log(storage.get('keyThatIsUndefined')) // null

// checking if the cookie fallback is being used right now, so you don't try to store fairly big data in cookies if(!storage.isCookieFallbackActive()) { ... }

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

// gets all the keys in the storage system returned as an array storage.getKeys(); // ['key','key2']

Bower

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

bower install angularLocalStorage

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

Angular Requirements

0.3.0 requires AngularJS 1.3.0+.

0.2.0 requires AngularJS 1.2.x.

Example

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

Suggestions?

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