Change prop name and update docs

Author: Mateusz Puczynski

docs/validation.md

@@ -51,29 +51,32 @@ render((
 
 To have your schemas validated against any other meta schema than draft-07 (the current version of [JSON Schema](http://json-schema.org/)), make sure your schema has a `$schema` attribute that enables the validator to use the correct meta schema. For example:
 
-```json 
+```json
 {
   "$schema": "http://json-schema.org/draft-04/schema#",
   ...
 }
 ```
 
-Note that react-jsonschema-form only supports the latest version of JSON Schema, draft-07, by default. To support additional meta schemas, you need to install `ajv` and import them, then pass your meta schemas through the `metaSchema` prop to your `Form` component:
+Note that react-jsonschema-form only supports the latest version of JSON Schema, draft-07, by default. To support additional meta schemas pass them through the `additionalMetaSchemas` prop to your `Form` component:
 
 ```jsx
-const metaSchema = require("ajv/lib/refs/json-schema-draft-04.json");
+const additionalMetaSchemas = require("ajv/lib/refs/json-schema-draft-04.json");
 
 render((
-  <Form schema={schema}
-        metaSchema={metaSchema} />
+  <Form schema={schema} 
+        additionalMetaSchemas={additionalMetaSchemas}/>
 ), document.getElementById("app"));
 ```
-`metaSchema` also accepts an array of meta schemas:
+
+In this example `schema` passed as props to `Form` component can be validated against draft-07 (default) and by draft-04 (added), depending on the value of `$schema` attribute.
+
+`additionalMetaSchemas` also accepts an array of meta schemas:
 
 ```jsx
 render((
-  <Form schema={schema}
-        metaSchema={[metaSchema1,metaSchema2]} />
+  <Form schema={schema} 
+        additionalMetaSchemas={[metaSchema1, metaSchema2]} />
 ), document.getElementById("app"));
 ```
 

src/components/Form.js

@@ -58,9 +58,9 @@ export default class Form extends Component {
     const { definitions } = schema;
     const formData = getDefaultFormState(schema, props.formData, definitions);
     const retrievedSchema = retrieveSchema(schema, definitions, formData);
-    const metaSchema = props.metaSchema;
+    const additionalMetaSchemas = props.additionalMetaSchemas;
     const { errors, errorSchema } = mustValidate
-      ? this.validate(formData, schema, metaSchema)
+      ? this.validate(formData, schema, additionalMetaSchemas)
       : {
           errors: state.errors || [],
           errorSchema: state.errorSchema || {},
@@ -80,7 +80,7 @@ export default class Form extends Component {
       edit,
       errors,
       errorSchema,
-      metaSchema,
+      additionalMetaSchemas,
     };
   }
 
@@ -91,7 +91,7 @@ export default class Form extends Component {
   validate(
     formData,
     schema = this.props.schema,
-    metaSchema = this.props.metaSchema
+    additionalMetaSchemas = this.props.additionalMetaSchemas
   ) {
     const { validate, transformErrors } = this.props;
     const { definitions } = this.getRegistry();
@@ -101,7 +101,7 @@ export default class Form extends Component {
       resolvedSchema,
       validate,
       transformErrors,
-      metaSchema
+      additionalMetaSchemas
     );
   }
 
@@ -300,7 +300,7 @@ if (process.env.NODE_ENV !== "production") {
     transformErrors: PropTypes.func,
     safeRenderCompletion: PropTypes.bool,
     formContext: PropTypes.object,
-    metaSchema: PropTypes.oneOfType(
+    additionalMetaSchemas: PropTypes.oneOfType(
       PropTypes.object,
       PropTypes.arrayOf(PropTypes.object)
     ),

src/validate.js

@@ -157,11 +157,11 @@ export default function validateFormData(
   schema,
   customValidate,
   transformErrors,
-  metaSchema
+  additionalMetaSchemas
 ) {
   // add more schemas to validate against
-  if (!addedMetaSchemas && metaSchema) {
-    ajv.addMetaSchema(metaSchema);
+  if (!addedMetaSchemas && additionalMetaSchemas) {
+    ajv.addMetaSchema(additionalMetaSchemas);
     addedMetaSchemas = true;
   }
   let validationErrors = null;

test/validate_test.js

@@ -768,7 +768,7 @@ describe("Validation", () => {
           schema,
           formData,
           liveValidate: true,
-          metaSchema: require("ajv/lib/refs/json-schema-draft-04.json"),
+          additionalMetaSchemas: require("ajv/lib/refs/json-schema-draft-04.json"),
           onSubmit,
           onError,
         });