Skip to content

Coobaha/tcomb-form

 
 

Repository files navigation

build status dependency status

"Simplicity is the ultimate sophistication" (Leonardo da Vinci)

Domain Driven Forms

The tcomb library provides a concise but expressive way to define domain models in JavaScript.

The tcomb-validation library builds on tcomb, providing validation functions for tcomb domain models.

This library builds on those two and realizes an old dream of mine.

Benefits

With tcomb-form you simply call <Form type={Model} /> to generate a form based on that domain model. What does this get you?

  1. Write a lot less HTML
  2. Usability and accessibility for free (automatic labels, inline validation, etc)
  3. No need to update forms when domain model changes

Flexibility

  • tcomb-forms lets you override automatic features or add additional information to forms.
  • You often don't want to use your domain model directly for a form. You can easily create a form specific model with tcomb that captures the details of a particular feature, and then define a function that uses that model to process the main domain model.

Documentation

Browser compatibility: same as React >=0.13.0

Contributions

Thanks so much to Chris Pearce for pointing me in the right direction and for supporting me in the v0.4 rewrite.

Special thanks to William Lubelski (@uiwill), without him this library would be less magic.

Thanks to Esa-Matti Suuronen for the excellent humanize() function.

Thanks to Andrey Popp for writing react-forms, great inspiration for list management.

Contributing

CONTRIBUTING.md

Packages

No packages published

Languages

  • JavaScript 99.9%
  • HTML 0.1%