seimin 55b3368751 项目初始化		3 lat temu
..
test	55b3368751 项目初始化	3 lat temu
.bower.json	55b3368751 项目初始化	3 lat temu
.bowerrc	55b3368751 项目初始化	3 lat temu
.gitignore	55b3368751 项目初始化	3 lat temu
CHANGELOG.md	55b3368751 项目初始化	3 lat temu
Gruntfile.js	55b3368751 项目初始化	3 lat temu
LICENSE	55b3368751 项目初始化	3 lat temu
README.md	55b3368751 项目初始化	3 lat temu
bower.json	55b3368751 项目初始化	3 lat temu
ngStorage.js	55b3368751 项目初始化	3 lat temu
ngStorage.min.js	55b3368751 项目初始化	3 lat temu
package.json	55b3368751 项目初始化	3 lat temu

ngStorage

An AngularJS module that makes Web Storage working in the Angular Way. Contains two services: $localStorage and $sessionStorage.

Differences with Other Implementations

No Getter 'n' Setter Bullshit - Right from AngularJS homepage: "Unlike other frameworks, there is no need to [...] wrap the model in accessors methods. Just plain old JavaScript here." Now you can enjoy the same benefit while achieving data persistence with Web Storage.
sessionStorage - We got this often-overlooked buddy covered.
Cleanly-Authored Code - Written in the Angular Way, well-structured with testability in mind.
No Cookie Fallback - With Web Storage being readily available in all the browsers AngularJS officially supports, such fallback is largely redundant.

Install

bower install ngstorage

Usage

Require ngStorage and Inject the Services

angular.module('app', [
    'ngStorage'
]).controller('Ctrl', function(
    $scope,
    $localStorage,
    $sessionStorage
){});

Read and Write | Demo

Pass $localStorage (or $sessionStorage) by reference to a hook under $scope in plain ol' JavaScript:

$scope.$storage = $localStorage;

And use it like you-already-know:

<body ng-controller="Ctrl">
    <button ng-click="$storage.counter = $storage.counter + 1">{{$storage.counter}}</button>
</body>

Optionally, specify default values using the $default() method:

> $scope.$storage = $localStorage.$default({
>     counter: 42
> });
> ```

With this setup, changes will be automatically sync'd between `$scope.$storage`, `$localStorage`, and localStorage - even across different browser tabs!

### Read and Write Alternative (Not Recommended) | [Demo](http://plnkr.co/edit/9ZmkzRkYzS3iZkG8J5IK?p=preview)

If you're not fond of the presence of `$scope.$storage`, you can always use watchers:

```javascript
$scope.counter = $localStorage.counter || 42;

$scope.$watch('counter', function() {
    $localStorage.counter = $scope.counter;
});

$scope.$watch(function() {
    return angular.toJson($localStorage);
}, function() {
    $scope.counter = $localStorage.counter;
});

This, however, is not the way ngStorage is designed to be used with. As can be easily seen by comparing the demos, this approach is way more verbose, and may have potential performance implications as the values being watched quickly grow.

Delete | Demo

Plain ol' JavaScript again, what else could you better expect?

// Both will do
delete $scope.$storage.counter;
delete $localStorage.counter;

This will delete the corresponding entry inside the Web Storage.

Delete Everything | Demo

If you wish to clear the Storage in one go, use the $reset() method:

javascript $localStorage.$reset();`

Optionally, pass in an object you'd like the Storage to reset to:
$localStorage.$reset({
    counter: 42
});

Permitted Values | Demo

You can store anything except those not supported by JSON:

Infinity, NaN - Will be replaced with null.
undefined, Function - Will be removed.

Minification

Just run $ npm install to install dependencies. Then run $ grunt for minification.

Todos

ngdoc Documentation
Namespace Support
Unit Tests
Grunt Tasks

Any contribution will be appreciated.

README.md