README.zh-CN.md

@tethys/store

一个小巧且强大的 Angular 状态管理类库.

English | 中文文档

特性

• 完美结合 Angular 的设计理念，Store 即服务
• 领域驱动，多 Store 模型，每个 Store 属于一个领域，状态存储和操作聚合一起，
• 简单易上手的 API，无需过多学习成本

安装

npm install @tethys/store --save
# or if you are using yarn
yarn add @tethys/store

简单使用

import { Injectable } from '@angular/core';
import { Action, Store } from '@tethys/store';
import { of } from 'rxjs';
import { tap } from 'rxjs/operators';

interface CounterState {
    count: number;
}

@Injectable()
export class CounterStore extends Store<CounterState> {
    static countSelector(state: CounterState) {
        return state.count;
    }

    constructor() {
        super({ count: 0 });
    }

    @Action()
    increase() {
        return of(true).pipe(
            tap(() => {
                this.update({ count: this.snapshot.count + 1 });
            })
        );
    }

    @Action()
    decrease() {
        return of(true).pipe(
            tap(() => {
                this.update((state) => {
                    return {
                        count: state.count - 1
                    };
                });
            })
        );
    }
}

@Component({
    selector: 'thy-store-counter-example',
    template: `<div>Count: {{ count$ | async }}</div>
               <button class="dg-btn dg-btn-primary dg-btn-sm" (click)="increase()">+</button>
               <button class="dg-btn dg-btn-primary dg-btn-sm" (click)="decrease()">-</button>
`,
    styleUrls: ['./counter.component.scss']
})
export class ThyStoreCounterExampleComponent implements OnInit {
    count$: Observable<number> = this.counterStore.select(CounterStore.countSelector);

    constructor(public counterStore: CounterStore) {}

    ngOnInit(): void {}

    increase() {
        this.counterStore.increase();
    }

    decrease() {
        this.counterStore.decrease();
    }
}

文档

• 介绍
• 快速开始
• Store
• Entity Store
• Entity Store with References
• FAQ

Development

$ git clone https://github.com/worktile/store
$ cd store && yarn
$ yarn start:docs // open http://localhost:8887

Release & Publish

yarn release
yarn pub

LICENSE

MIT License