Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tehSLy/efform
Form manager, based on effector state manager, designed to deliver high-quality DX
https://github.com/tehSLy/efform
effector forms state-management
Last synced: about 2 months ago
JSON representation
Form manager, based on effector state manager, designed to deliver high-quality DX
- Host: GitHub
- URL: https://github.com/tehSLy/efform
- Owner: tehSLy
- Created: 2020-07-23T12:28:57.000Z (over 4 years ago)
- Default Branch: dev
- Last Pushed: 2023-03-05T12:33:08.000Z (almost 2 years ago)
- Last Synced: 2024-04-25T23:22:11.490Z (8 months ago)
- Topics: effector, forms, state-management
- Language: TypeScript
- Homepage:
- Size: 1.23 MB
- Stars: 12
- Watchers: 1
- Forks: 1
- Open Issues: 29
-
Metadata Files:
- Readme: README.MD
Awesome Lists containing this project
- awesome - efform - Form manager, based on effector state manager, designed to deliver high-quality DX. (Packages / Form management)
README
# EFFORM
Form manager, based on `effector` state manager, designed to deliver high-quality DX
## Installation
Simply execute `npm i efform` in the terminal.
**Notice**: efform uses `effector` as a peer dependency, so if you don't have this package installed, install it by yourself
## Usage & Basics
```ts
import { createForm, string, number } from "efform";
import { forward, createEffect } from "effector";
const fxSendForm = createEffect({ handler: console.log });
const form = createForm({
name: string().required(),
age: number(18).max(100),
email: string().required().pattern(/.+@.+/),
});
forward({ from: form.submitted, to: fxSendForm });
form.submit();
// => {name: "", age: 18, email: ""}
```
In efform, **Forms** may consist of nested **Forms**, nested **Inline-Forms**, or **Fields**
### Form
This is the very common type of unit. It defines structure of data-slice, with validation, error and state management included.
```ts
type Form = {
submit: Event;
submitted: Event;
set: Event<{key: K; payload: T[K]>;
setErrors: Event>;
fill: Event>>;
validate: Effect;
values: Store;
errors: Store>;
validateField: Effect;
isValid: Store
fields: Record
getMeta(): FormMeta;
}
```
See example of basic form on following snippet:
```ts
const form = createForm({
age: number(),
name: string(),
});
```
### Nested Forms
It might be either dedicated, or inline-forms. Dedicated forms - are just forms, declared outside of parent, see example below:
```ts
const nestedForm = createForm({
name: string(),
age: number(),
});
const form = createForm({
// Notice, how nested form is used here, as a part of the main one
bio: nestedForm,
status: string(),
});
```
Aside from being basically a simple form, being child form provides us opportunity to manage it's state by it's parent. Let's break down nested form possible use-cases in the code below:
```ts
const nestedForm = createForm({
name: string(),
age: number(),
});
const form = createForm({
// Notice, how nested form is used here, as a part of the main one
bio: nestedForm,
status: string(),
});
form.values.watch(console.log);
// => {bio: {name: "", age: 0}, status: ""}
nestedForm.fill({ name: "John", age: 42 });
// => {bio: {name: "John", age: 42}, status: ""}
```
As you can see, any nested form lifting up it's state, errors, and other things like that. So you are free to separate complicated forms into simplier ones, and then, just combine them at the upper structure level, resulting in solid data structure.
The next thing on the list - is **Inline-Forms** which are appear to be nested by design. There is an example of such form in the code below:
```ts
const form = createForm({
bio: { // this field is actually an inline-form, and it is nested aswell
name: string(),
age: number()
},
status: string()
});
form.values.watch(console.log);
// => {bio: {name: "", age: 0}, status: ""}
form.fill({
bio: {
name: "Alice",
age: 28
}
})
// => {bio: {name: "Alice", age: 28}, status: ""}
```
### Fields
In short, **Field** refers to a part of the form.
```ts
type Field = {
set: Event;
value: Store;
error: Store;
validate: Effect, Error>;
};
```
It may be either simple field (e.g. string field, numeric field, etc) or even, reference to nested form. Let's look at the example below:
```ts
const nestedForm = createForm({
name: string(),
age: number(),
});
const form = createForm({
bio: nestedForm, // we have a nested form here
location: { // and we also do an inline one
country: string(),
city: string()
}
status: string(),
});
// Then, we have an access to form's fields
console.log(form.fields.bio.value.getState()) // => {name: "", age: 0}
form.fields.location.set({
country: "France",
city: "Paris"
})
console.log(form.values.getState()) // => {status: "", location: {country: "France", city: "Paris"}, bio: {name: "", age: 0}}
```