TypeScript-first, lightning fast Forms for React.js and React Native. The @lynxts/web package provides abstractions and helpers specifically for React DOM, which makes working with forms simpler, more maintainable, and intuitive.
- lynxts/core: Same as the
@lynxts/webversion used - React.js: >=16.8.0
- React DOM: >=16.8.0
Using Yarn:
yarn add @lynxts/core @lynxts/web
Using NPM:
npm i @lynxts/core @lynxts/web
To make using forms in React.js web applications as simple as possible, @lynxts/web provides a <Form> React component, which is nothing more than a
element wrapped around Lynx.ts <FormProvider>. This component accepts all the attributes of a <form> plus all the <FormProvider> props which you can use to set up the context. With this approach, your forms will not only be semantically correct, but you can also use aor an to trigger the submit action.
Additionally, this package provides helper components of the basic form elements: <input>, <select>, and <textarea>. These components adds a <label> and error handling and their intention is for users to quickly jump into using simple forms. However, we strongly recommend creating you own custom field abstractions to get better control and customization.
import { Form, inputOf } from "@lynxts/web";
import { ReactElement, memo, useCallback } from "react";
import { ObjectSchema, object, string } from "yup";
interface Login {
email: string;
password: string;
}
const schema: ObjectSchema<Login> = object({
email: string().email().required(),
password: string().required(),
});
const Input = inputOf<Login>();
const SignIn = memo((): ReactElement => {
const handleSubmit = useCallback((values: Login): void => {
const { email, password } = values;
// Use the validated value to sign in!
}, []);
return (
<Form onSubmit={handleSubmit} validation={schema}>
<Input name="email" label="Email:" />
<Input name="password" label="Password:" />
<button type="submit">{"SignIn"}</button>
</Form>
);
});You can find the complete API refence here 📚
Suggestions are always welcome! Please create an issue describing the request, feature, or bug. We'll try to look into it as soon as possible 🙂
Contributions are very welcome! To do so, please fork this repository and open a Pull Request to the main branch.