@ezform/mui5 v1.0.1

EZForm is an easy form and field-level validation library for react using MUI components

Build Project

npm install -g typescript; npm install; npm run build;

Demo

You can find a working demo here:

(https://codesandbox.io/s/mui5-wl388c)

Install

npm i moment --save
npm i @mui/material @emotion/react @emotion/styled --save
npm i @mui/x-date-pickers --save
npm i @ezform/mui5 --save

(https://www.npmjs.com/package/@ezform/mui5)

Usage

This package makes use of @ezform/core and MUI to implement a set of form fields.

Click Here to learn more about the core library.

Example usage:

const ezform = useForm({
    onSubmit: (values) => {
        console.log("Form got submitted. Form values:", values);
    },
    initialState: {
        firstName: "Johnny",
        lastName: "Silverhand",
        address: {
            city: "New York",
            country: "United States"
        }
    },
    formatMessage: (messageKey) => translate(messageKey),
});

...
<FieldText name="firstName" form={ezform} validator={requiredValidator} />
<FieldText name="lastName" form={ezform} validator={requiredValidator} />
<FieldText name="address.city" form={ezform} validator={requiredValidator} />
<FieldText name="address.country" form={ezform} validator={requiredValidator} />

You can create fully dynamic forms. Specify an object path to define fields:

// Map this fields value to 'firstName' property of first client
<FieldText name="clients[0].firstName" form={ezform} validator={requiredValidator} />

// or map 5 fields iteratively
{ Array(5).fill().map((num, index) => (
    <FieldText name={"clients[" + index + "].firstName"} form={ezform} validator={requiredValidator} />
))}

Global Config

You can define a global configuration for some props of inputs:

import { EzformMuiConfig } from "@ezform/mui";

// set config globally
EzformMuiConfig({
    buttonLabel: "Select file",
    noFileSelectedText: "No file selected",
    fileSelectedText: "$n file(s) selected",
});

// get global config
const config = EzformMuiConfig();

Components

This library provides a basic set of form fields based on MUI components. You can also create your own components to use with EZForm. Click here to find out how.

FieldBase interface

This interface acts as a base for all field properties. All form components described below (except FieldList and FieldCondition) can take the following properties:

• name: string;
• form: FormRefObject;
• id?: string;
• validator?: ValidatorType;
• disabled?: boolean;
• readonly?: boolean;
• label?: string;
• defaultValue?: any;

OptionType

This interface is used for inputs that take list options (like Selects, Radio Groups etc.)

type OptionType = {
  key: string;
  value: string | number;
  label: string;
  disabled?: boolean;
}

FieldText

Basic text input

• multiline?: boolean
• variant?: "filled" | "outlined" | "standard";
• color?: "primary" | "secondary";
• placeholder?: string;

FieldPassword

Same as text field, but for passwords

• variant?: "filled" | "outlined" | "standard";
• color?: "primary" | "secondary";
• placeholder?: string;

FieldSelect

Select dropdown

• options: OptionType[];
• variant?: "filled" | "outlined" | "standard";

FieldMultiSelect

Simple multiple select dropdown

• options: OptionType[];
• variant?: "filled" | "outlined" | "standard";

FieldComboSelect

Multiple select dropdown with chips rendering selected options

• options: OptionType[];
• variant?: "filled" | "outlined" | "standard";
• color?: "primary" | "secondary";
• chipVariant?: "default" | "outlined";
• chipColor?: "primary" | "secondary";
• chipSize?: "medium" | "small";

FieldCheckbox

Single checkbox

• color?: "default" | "primary" | "secondary";

FieldSwitch

Switch input

• color?: "default" | "primary" | "secondary";
• labelBefore?: string;
• size?: "medium" | "small";

FieldCheckboxGroup

Multiple checkboxes under the same field name

• options: OptionType[];
• color?: "default" | "primary" | "secondary";

FieldRadioGroup

Multiple radio inputs under the same field name

• options: OptionType[];
• color?: "default" | "primary" | "secondary";

FieldSearchSelect

Experimental select with search ability

• options: OptionType[];
• variant?: "filled" | "outlined" | "standard";

FieldDate

MUI's date input.

The date will be stored in the form fields as a UNIX timestamp. Default type is "date".

• format: string;
• placeholder?: string;
• closeOnSelect?: boolean;
• disableToolbar?: boolean;
• variant?: "filled" | "outlined" | "standard";
• minDate?: any;
• maxDate?: any;
• disablePast?: boolean;
• disableFuture?: boolean;
• type?: "date" | "datetime" | "time";

EZForm uses moment to convert dates

FieldFile

Simple file upload using native input type="file". This field will be rendered as a button.

• buttonLabel?: string;
• defaultHelperText?: string;
• noFileSelectedText?: string;
• fileSelectedText?: string;
• variant?: "contained" | "outlined" | "text";
• color?: "default" | "inherit" | "primary" | "secondary";
• multiple?: boolean;
• accept?: string;

The submitted value will be of type File or FileList in case the multiple prop is passed.

FieldList

Component to make dynamic lists containing fields.

Below is an example of a list (array) with objects containing an entry of two fields each (firstName, lastName).

The example validates only the first row of the list, effectively making only the first list entry obligatory.

<FieldList
    form={ezform}
    name="arrayExample"
    extraRows={1}
    renderRow={({ add, remove, index, total }) => (
        <React.Fragment key={"list" + index}>
            <FieldText
                form={ezform}
                name={"arrayExample[" + index + "].firstName"}
                label="First name"
                validator={index < 1 ? requiredValidator : undefined}
            />
            <FieldText
                form={ezform}
                name={"arrayExample[" + index + "].lastName"}
                validator={index < 1 ? requiredValidator : undefined}
                label="Last name"
                variant="outlined"
            />
            
            {index < total ? (
                <Button onClick={remove(index)}>Remove</Button>
            ) : (
                <Button onClick={add()}>Add</Button>
            )}
        </React.Fragment>
    )}
/>

FieldCondition

You can wrap any elements inside this component and render them conditionally.

This can be helpful to organize a more complex form.

<FieldCondition when={ foo === "bar" && isTheMoonShining() }>
    <p>I will only be rendered when foo equals 'bar' and isTheMoonShining() returns true</p>
</FieldCondition>