Add documentation for "components" property

Author: jarvelov

docs/api/components.md

@@ -0,0 +1,93 @@
+# components
+
+With Vue one can use both locally and globally registered components. If not all the components you want to use are globally registered you can use the `components` property to pass in additional components to `vue-form-json-schema`.
+
+## Provide locally registered components
+
+In this example we re-use the locally registered components and pass them along to `vue-form-json-schema`
+
+```html
+<template>
+  <vue-form-json-schema
+    v-model="model"
+    :schema="schema"
+    :ui-schema="uiSchema"
+    :components="$options.components"
+  />
+</template>
+
+<script>
+  import MyComponent from "./MyComponent"
+
+  export default {
+    components: {
+      "my-component": MyComponent
+    },
+    data() {
+      return {
+        model: {
+          firstName: "John",
+        },
+        schema: {
+          type: 'object',
+          properties: {
+            firstName: 'string'
+          }
+        },
+        uiSchema: [{
+          component: "my-component",
+          model: 'firstName',
+          fieldOptions: {
+            on: ['input']
+          }
+        }]
+      }
+    }
+  }
+</script>
+```
+
+## Use components directly without registering them
+
+In this example we pass the components along to `vue-form-json-schema` without registering them first
+
+```html
+<template>
+  <vue-form-json-schema
+    v-model="model"
+    :schema="schema"
+    :ui-schema="uiSchema"
+    :components="components"
+  />
+</template>
+
+<script>
+  import MyComponent from "./MyComponent"
+
+  export default {
+    data() {
+      return {
+        model: {
+          firstName: "John",
+        },
+        schema: {
+          type: 'object',
+          properties: {
+            firstName: 'string'
+          }
+        },
+        components: {
+          "my-component": MyComponent
+        },
+        uiSchema: [{
+          component: "my-component",
+          model: 'firstName',
+          fieldOptions: {
+            on: ['input']
+          }
+        }]
+      }
+    }
+  }
+</script>
+```

docs/api/vue-form-json-schema.md

@@ -9,6 +9,7 @@
 | options | `Object` | See [Options](options.md) |
 | schema | `Object` | A valid [JSON Schema]( http://json-schema.org/) (validated by [Ajv](https://github.com/epoberezkin/ajv)) |
 | ui-schema | `Object` | See [uiSchema](ui-schema.md) |
+| components | `Object` | See [components](components.md) |
 
 ## Events
 
@@ -26,6 +27,7 @@
     :options="options"
     :schema="schema"
     :ui-schema="uiSchema"
+    :components="components"
     v-on:change="onModelUpdate"
     v-on:state-change="onStateUpdate"
     v-on:validated="onValidatedUpdate"