react-nested-validation

    0.2.4 • Public • Published

    react-nested-validation

    A toolkit for performing nested validation of forms in React. Please find a live demo here.

    Rationale

    There is a diverse array of React packages designed to help render and validate forms. However there was no obvious choice that provided the following features:

    • Ability to deeply nest forms and collate errors at the top level.

    • Allow for complex validation rules.

    • Unopinionated about how to render presentational components.

    We found a need for a light weight validation toolkit that could be used with a variety of presentational frameworks, and so we made react-nested-validation.

    Design

    No components are offered to help render your presentational components. You are able to render them any way you choose, using any framework. Three main categories of components are provided:

    • Forms.

    • Validator functions.

    • React component wrappers.

    Forms are the main interface for designing both the validation, and the nested structure of your validation. Forms are ES6 classes that contain links to nested forms, and allow for methods to be overidden in order to validate both fields and general form errors.

    Validator functions are conveniences for performing common validation operations, e.g. required fields. Presently there are only two prepackaged validators: required and emptyWarning.

    The React component wrappers are two higher-order components to help apply Forms to your presentational React comonents. They wrap any other React component, transforming it into a managed form. A single prop, form, is given to the inner component which contains all the information not just for the current form, but all nested forms too.

    More to come

    While we're working on improving the design documentation, please take a look at the live examples for more of an idea how to get started.

    Keywords

    none

    Install

    npm i react-nested-validation

    DownloadsWeekly Downloads

    248

    Version

    0.2.4

    License

    MIT

    Unpacked Size

    25.8 kB

    Total Files

    9

    Last publish

    Collaborators

    • dreadera
    • williamchuuptick
    • uptick-admin
    • bor3ham
    • jlo-1
    • jarekwg
    • alexdonald
    • marcfister