https://github.com/niklaspor/ngrx-clean-forms

NgRx integration for forms in Angular.
https://github.com/niklaspor/ngrx-clean-forms

angular forms ngrx

Last synced: 3 months ago
JSON representation

NgRx integration for forms in Angular.

• Host: GitHub
• URL: https://github.com/niklaspor/ngrx-clean-forms
• Owner: NiklasPor
• License: mit
• Created: 2019-12-07T17:09:51.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-05-07T11:43:34.000Z (over 1 year ago)
• Last Synced: 2024-10-11T00:05:16.872Z (3 months ago)
• Topics: angular, forms, ngrx
• Language: TypeScript
• Homepage: https://ngrx-clean-forms.surge.sh
• Size: 4.27 MB
• Stars: 2
• Watchers: 3
• Forks: 1
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ngrx-clean-forms

[![npm version](https://badge.fury.io/js/ngrx-clean-forms.svg)](https://badge.fury.io/js/ngrx-clean-forms)

[![codecov](https://codecov.io/gh/NiklasPor/ngrx-clean-forms/branch/master/graph/badge.svg)](https://codecov.io/gh/NiklasPor/ngrx-clean-forms)

![license](https://img.shields.io/npm/l/ngrx-clean-forms)

This framework takes an opinionated approach to managing forms. Following goals were set while composing this framework:

-   The complete state of a form should be leveraged to be in one central place (NgRx store).

-   The state of a form should be as minimal as possible. Every value that can be calculated from the minimal values of the state is not in the state, but instead retrieved in an abstraction function (selector). A prime example for this are errors, which are based on validators.

-   The state of a form can be manipulated in any way, as the values in it do **not** depend on each other. Updates can be applied manually or with functions provided by the framework.

-   The whole data flow (actions + selectors) between the form state and the actual form should be manually set by the user. **No magic.**

-   Types are available at every point of interaction with the form.

While all of these goals were met during the implementation of this framework, it comes at the same cost as NgRx. The necessary boilerplate code in comparison to Reactive Forms is significantly larger.

[Getting Started Guide](https://ngrx-clean-forms.surge.sh/docs/getting-started)

[Example Application](https://example.ngrx-clean-forms.surge.sh)

[Official Docs](https://ngrx-clean-forms.surge.sh)