Merge pull request #173 from gcanti/80

add support for lists, ref #80

README.md

@@ -951,6 +951,95 @@ var options = {
 
 This will completely skip the rendering of the component, while the default value will be available for validation purposes.
 
+# Lists
+
+You can handle a list with the `t.list` combinator:
+
+```js
+const Person = t.struct({
+  name: t.String,
+  tags: t.list(t.String) // a list of strings
+});
+```
+
+## Items configuration
+
+To configure all the items in a list, set the `item` option:
+
+```js
+const Person = t.struct({
+  name: t.String,
+  tags: t.list(t.String) // a list of strings
+});
+
+const options = {
+  fields: { // <= Person options
+    tags: {
+      item: { // <= options applied to each item in the list
+        label: 'My tag'
+      }
+    }
+  }
+});
+```
+
+## Nested structures
+
+You can nest lists and structs at an arbitrary level:
+
+```js
+const Person = t.struct({
+  name: t.String,
+  surname: t.String
+});
+
+const Persons = t.list(Person);
+```
+
+# Managing unions
+
+**Example**
+
+```js
+const AccountType = t.enums.of([
+  'type 1',
+  'type 2',
+  'other'
+], 'AccountType')
+
+const KnownAccount = t.struct({
+  type: AccountType
+}, 'KnownAccount')
+
+const UnknownAccount = t.struct({
+  type: AccountType,
+  label: t.String
+}, 'UnknownAccount')
+
+// the union type
+const Account = t.union([KnownAccount, UnknownAccount], 'Account')
+
+// you must define a dispatch function returning the suitable type
+// based on the current form value
+Account.dispatch = value => {
+  return value && value.type === 'other' ? UnknownAccount : KnownAccount
+}
+
+const Type = Account
+
+// options can be a list of options, one for each type of the union
+const options = [
+  // options of the KnownAccount type
+  {
+    label: 'KnownAccount'
+  },
+  // options of theUnknownAccount type
+  {
+    label: 'UnknownAccount'
+  }
+]
+```
+
 # Customizations
 
 ## Stylesheets