@lynxts/web

Web

Lynx.ts Web

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.

Requirements

• lynxts/core: Same as the @lynxts/web version used
• React.js: >=16.8.0
• React DOM: >=16.8.0

Install

Using Yarn:

yarn add @lynxts/core @lynxts/web

Using NPM:

npm i @lynxts/core @lynxts/web

Usage

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>
  );
});

API Reference

You can find the complete API refence here 📚

Something's missing?

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

Contributions are very welcome! To do so, please fork this repository and open a Pull Request to the main branch.

License

MIT License