Registry / forms / uniforms-bridge-json-schema

uniforms-bridge-json-schema

library4.0.0jsnpmunverified

JSON Schema bridge for uniforms, a React library for generating forms from schemas. Current stable version is 4.0.0. This package allows you to use JSON Schema as the schema definition for uniforms forms, translating JSON Schema constraints into form fields and validation. It is part of the uniforms ecosystem, which also supports other schema formats like GraphQL, SimpleSchema, and Zod. The bridge requires uniforms 4.0.0 as a peer dependency and is written in TypeScript with type definitions included.

forms validation

npm install uniforms-bridge-json-schema

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · UNIFORMS-BRIDGE-JS

uniforms-bridge-json-schema

formsjavascriptv4.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

JSONSchemaBridge

✓ import { JSONSchemaBridge } from 'uniforms-bridge-json-schema'

✗ const JSONSchemaBridge = require('uniforms-bridge-json-schema')

ESM-only since v3; CommonJS require() is not supported.

JSONSchemaBridge

✓ import { createSchemaBridge } from 'uniforms'; import JSONSchemaBridge from 'uniforms-bridge-json-schema'; const bridge = createSchemaBridge(schema, JSONSchemaBridge);

✗ import { JSONSchemaBridge } from 'uniforms-bridge-json-schema'; const bridge = new JSONSchemaBridge(schema);

The bridge is used with uniforms' createSchemaBridge factory function. Direct instantiation is deprecated.

default (JSONSchemaBridge)

✓ import JSONSchemaBridge from 'uniforms-bridge-json-schema'; const bridge = new JSONSchemaBridge(schema);

✗ import { default as JSONSchemaBridge } from 'uniforms-bridge-json-schema';

The package exports JSONSchemaBridge as a named export, not default. But for backward compatibility, default export also works in some versions.

Creates a form from a JSON Schema using the JSONSchemaBridge and uniforms' AutoForm component.

import React from 'react'; import { AutoForm, createSchemaBridge } from 'uniforms'; import JSONSchemaBridge from 'uniforms-bridge-json-schema'; const schema = { type: 'object', properties: { name: { type: 'string' }, age: { type: 'integer', minimum: 0 }, email: { type: 'string', format: 'email' } }, required: ['name', 'email'] }; const bridge = createSchemaBridge(schema, JSONSchemaBridge); export default function MyForm() { return ( <AutoForm schema={bridge} onSubmit={console.log} /> ); }

Debug

Known issues

breakingUniforms v4 requires peer dependency uniformity 4.0.0 exactly. Incompatibility with older uniforms versions (3.x or earlier).

fix

Ensure you have uniforms@4.0.0 installed as a dependency.

affects: >=4.0.0

deprecatedDirect instantiation of JSONSchemaBridge with 'new JSONSchemaBridge(schema)' is deprecated in favor of using uniforms' createSchemaBridge factory function.

fix

Use createSchemaBridge(schema, JSONSchemaBridge) instead of new JSONSchemaBridge(schema).

affects: >=4.0.0

gotchaJSON Schema formats (e.g., 'email', 'date-time') are not natively supported by uniforms for validation. You must provide a custom validation function or use a separate validator.

fix

Provide a custom validation function to the bridge or use a library like ajv to validate before submission.

affects: *

gotchaThe schema must be a valid JSON Schema object; otherwise the bridge may throw or produce incorrect fields. Ensure the schema conforms to the Draft 4/7 specification supported by uniforms.

fix

Validate your JSON Schema against the supported draft before passing it to the bridge.

affects: *

Errors

Common errors & fixes

TypeError: Class extends value undefined is not a constructor or null

Missing or incorrect version of uniforms peer dependency.

fix

Install uniforms@4.0.0: npm install uniforms@4.0.0

Error: [uniforms] No schema bridge factory for this type.

Using the wrong bridge or incorrect import; likely not using createSchemaBridge.

fix

Import createSchemaBridge from 'uniforms' and call it with your schema and JSONSchemaBridge: createSchemaBridge(schema, JSONSchemaBridge).

Module not found: Can't resolve 'uniforms-bridge-json-schema'

Package not installed or import path incorrect.

fix

Install the package: npm install uniforms-bridge-json-schema

Upgrade

Version history

4.0.0latest on npm

Audit

Dependencies

uniformsrequiredPeer dependency: core uniforms library required for form rendering and schema bridge interface.

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/vazco/uniforms#master ↗

packageuniforms-bridge-json-schema ↗

homepagehttps://github.com/vazco/uniforms/tree/master#readme ↗