Web

Last updated 1 year ago

Was this helpful?

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

: Same as the @lynxts/web version used
: >=16.8.0
: >=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

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