@o3r/forms

Otter forms

This package is an Otter Framework Module.

Description

One of the approaches for writing forms that Angular provides is called model-driven or reactive forms, which "provide a model-driven approach to handling form inputs whose values change over time". This type of form is applicable in many use cases, but there are a couple of exceptions where additional utilities may be useful.

These use cases include:

• A container/presenter structure for components
• Handling form submission at page level
• Displaying the error message outside the form

To handle these, this module provides utilities to enhance the build of Angular reactive forms, including:

• An asynchronous decorator (@AsyncInput) to ensure subscriptions are handled if the references of the input observables change.
• Basic and custom validators to validate user input for accuracy and completeness.
• A dedicated NgRX store for form errors to have the possibility of displaying error messages outside the form component.
• Helper functions to handle the interactions with the forms.

How to install

ng add @o3r/forms

[!WARNING] This module requires @o3r/core to be installed.

Details

Find more information in the documentation.