caolan / forms

An easy way to create, parse and validate forms in node.js
MIT License
1.01k stars 167 forks source link

Better docs? Better examples? A tutorial? #188

Open 0foo opened 8 years ago

0foo commented 8 years ago

I'm trying to use and it looks great but there's only one example and the docs are unclear. And obviously due to the name it's impossible to google.

How do I add CSS classes? What exactly is a widget?

etc. etc.

balupton commented 7 years ago

Not exactly sure a pull request is needed, just a description of what widgets are and how they are different to fields and how they work with fields would be useful.

As currently, there seems to be widgets for each field, and then some more. Should we use widgets or should we use fields?

ljharb commented 7 years ago

Fields determine behavior; widgets combine with a field to determine the HTML that results. You should use whichever you need :-)