angularLocalStorage

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

##Install

bower install angular-localstorage-modern --save

<script src="bower_components/dist/storage.js></script>

Warning

Break change after v0.8.0, original storage service split into storageUtils, storageOperate, storageUpdate service, and use directive storage-bind to achieve data-binding.

Attention

You can directly store Objects, Arrays, Floats, Booleans, and Strings. No need to convert your javascript values from strings. Till now, I add RegExps, Datessupport.
No Fallback to Angular $cookies if localStorage is not supported
TDD rule to code this module.
You can also see https://github.com/agrublev/angularLocalStorage

How to use

Just add this module to your app as a dependency
```
var app = angular.module('app', ['storage']
```

Now inside your controllers simply pass the storage factory like this

 app.controller('Controller', ['$scope','storageOperate', 'storageUpdate',
   function($scope, storageOperate,storageUpdate){
     $scope.title = 'angularLocalStorage';    
   }
 ])

Using the storageOperate service.

  // just storing something in localStorage
  storageOperate.set('key','value');

  // getting that value
  storageOperate.get('key');

  // getting that value through index
  storageOperate.getByIndex(1);

  // remove that key
  storageOperate.remove('key');

  // clear all localStorage values
  storageOperate.clear();

  // get localStorage length
  storageOperate.getSize();

Using the storageUpdate service.

method	feature
$inc	plus a number for the stored value(negative acceptable)
$verse	verse Booleans value
$push	push new value into the stored array
$addToset	push new value into the stored array, and ensure it's unique
$pull	remove specific item in an array
$unique	unique the stored array
$extend	extend stored object with pass-in object

For example:

storageOperate.set('love', 1);
storageUpdate.$inc('love', 5);
storageOperate.get('love') == 6;

storageOperate.set('love', ['first', 'second']);
storageUpdate.$push('love', 'third');
storageOperate.get('love') == ['first', 'second', 'third']

About data-binding.

 <input type="text" ng-model="sky" storage-bind="sky" storage-bind-direction="reverse" >

Directive storage-bind, use storage-bind-direction config the direction, require ng-model directive.

| direction           | instruction |
| :------------------: | :-------------|
| forward            | sync through model -->  localstorage --> view |
| reverse            | sync through view --> localstorage --> model |
| normal             | sync both way                  |

Compare with agrublev , I had modified all the code about data-binding for more simple use. And remember that, when localstorage value changes, it doesn't change the model or view value since v0.8.0, because I think this meaningless.

Feature coming soon

New update modify comes later,forget the get -> operate -> set order.

Please add an issue with ideas, improvements, or bugs! Thanks! You can send me email hjj491229492@hotmail.com

huang-xiao-jian/angularLocalStorage

angularLocalStorage

Warning

Attention

How to use

Feature coming soon