Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stefanpenner/ember-state-services
https://github.com/stefanpenner/ember-state-services
Last synced: 13 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/stefanpenner/ember-state-services
- Owner: stefanpenner
- License: mit
- Created: 2015-02-07T04:10:34.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2021-10-04T09:03:37.000Z (about 3 years ago)
- Last Synced: 2024-10-27T09:12:09.598Z (16 days ago)
- Language: JavaScript
- Size: 287 KB
- Stars: 226
- Watchers: 9
- Forks: 30
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-ember - ember-state-services
README
# Ember State Services
[](https://travis-ci.org/stefanpenner/ember-state-services)
[](https://codeclimate.com/github/stefanpenner/ember-state-services)
[](http://emberobserver.com/addons/ember-state-services)
[](http://badge.fury.io/js/ember-state-services)
This addon introduces a state management pattern for your ambitious applications.
State management is one of the most complex aspects of large application design and when done wrong often leads to bugs and errors. EmberJS contains 2 high-level avenues for storing state: controllers (long-term state) and components (short-term state). Controllers are singletons and any state you set on them will stay there until your application is reloaded or you override the previous value. Components on the other hand are created and destroyed as they enter/leave the DOM and any state that is set on them will be removed/reset each time they are recreated. As you build more complex applications you will find yourself needing a way to have some sort of middle ground solution. Something that has properties of both long-term state and short-term state. This is what ember-state-services sets out to provide.
An example could be a master/detail experience where the detail view is a component which allows editing of content. It would be unfortunate if navigating would lose un-saved changes (short-term state); it would also be unfortunate if the state between the edit components were to leak between each other (long-term state). Instead, the addon issues a unique state per reference key, which keeps management safe and easy.
[](https://vimeo.com/141974064)
## Installation
```shell
ember install ember-state-services
```
## Setup
### State file
```js
/*
* First create a state file that returns an object within app/states/.js
*/
import Ember from 'ember';
export default Ember.Object.extend();
```
## Usage
### Component
```js
import Ember from 'ember';
import stateFor from 'ember-state-services/state-for';
export default Ember.Component.extend({
tagName: 'form',
/*
* stateFor returns a computed property that provides a given
* state object based on the 'email' property. Whenever email
* changes a new state object will be returned.
*
* This allows us to create private state, accessible only to those
* with access to the given model (email in this case) and the state
* bucket ( in this case).
*/
data: stateFor('', 'email'),
actions: {
submitForm() {
// apply changes to the email model
this.get('email').setProperties(this.get('data'));
}
}
});
```
### Template
```js
Subject: {{input value=data.subject}}
from: {{input value=data.from}}
body: {{textarea value=data.body}}
Submit Form
```
## Advanced
### Setting initial state
```js
import Ember from 'ember';
const MyStateObject = Ember.Object.extend();
MyStateObject.reopenClass({
initialState(instance) {
return {
foo: 'bar',
hello: 'world'
};
}
});
export default MyStateObject;
```
### Using ember-buffered-proxy
```js
import BufferedProxy from 'ember-buffered-proxy/proxy';
const MyStateObject = BufferedProxy.extend();
MyStateObject.reopenClass({
initialState() {
return {
content: {
foo: 'bar',
hello: 'world'
}
};
}
});
export default MyStateObject;
```
Learn more about buffered proxy: https://github.com/yapplabs/ember-buffered-proxy
## Example Demo
```
git clone [email protected]:stefanpenner/ember-state-services.git
cd ember-state-services
npm i; bower i
ember server
```
Then visit the demo app: http://localhost:4200 in your browser