How gravity-ui/dynamic-forms works
@gravity-ui/dynamic-forms is a JSON Schema-based React library for rendering editable forms and read-only views of form values. The principal workflow takes a spec and value into DynamicField or DynamicView and renders interactive inputs or an overview. The repository also contains an unstable schema-rendering implementation and a component kit. Internal links are limited where excerpts show calls; other plausible wiring is marked unverified rather than presented as inspected fact.
Main entry points: Controller.tsx Field controller · ViewController.tsx View controller · useSchemaRenderer.ts Schema renderer hook · DynamicField.tsx DynamicField
Components 22
Dynamic forms
- DynamicField
src/lib/core/components/Form/DynamicField.tsx - Field controller
src/lib/core/components/Form/Controller/Controller.tsx - Controller utilities
src/lib/core/components/Form/Controller/utils.tsx - Form hooks
src/lib/core/components/Form/hooks - Field search
src/lib/core/components/Form/hooks/useSearch/useSearch.tsx - Search state
src/lib/core/components/Form/hooks/useSearchStore.ts - Form spec types
src/lib/core/components/Form/types
Value views
- DynamicView
src/lib/core/components/View/DynamicView.tsx - View controller
src/lib/core/components/View/ViewController.tsx - View rendering hooks
src/lib/core/components/View/hooks - View spec types
src/lib/core/components/View/types
Component kit
- Form input components
src/lib/kit/components/Inputs - Value display components
src/lib/kit/components/Views - Layouts and helpers
src/lib/kit/components/Layouts - Localization
src/lib/kit/i18n/configure.tsx
Schema renderer
- SchemaRenderer
src/lib/unstable/core/SchemaRenderer/SchemaRenderer.tsx - Schema renderer node
src/lib/unstable/core/SchemaRendererNode/SchemaRendererNode.tsx - Schema renderer hook
src/lib/unstable/core/useSchemaRenderer/useSchemaRenderer.ts - Renderer state
src/lib/unstable/core/useSchemaRendererState/useSchemaRendererState.ts - Renderer tools
src/lib/unstable/core/useSchemaRendererTools/useSchemaRendererTools.ts - Schema UI kit
src/lib/unstable/kit
Other components
- Library consumer
Connections 17
- Library consumer → DynamicField: supplies spec
- Library consumer → DynamicView: supplies value
- Field controller → Controller utilities: calls utilities
src/lib/core/components/Form/Controller/Controller.tsx - Field controller → Form hooks: uses hooks
src/lib/core/components/Form/Controller/Controller.tsx - Field controller → Field search: filters fields
src/lib/core/components/Form/Controller/Controller.tsx - Field search → Search state: uses search context
- View controller → View rendering hooks: resolves and renders
src/lib/core/components/View/ViewController.tsx - DynamicField → Field controller: delegates fields
- DynamicView → View controller: renders values
- View controller → Value display components: renders display
- Field controller → Form input components: renders inputs
- Field controller → Form spec types: uses spec types
src/lib/core/components/Form/Controller/Controller.tsx - View controller → View spec types: uses spec types
src/lib/core/components/View/ViewController.tsx - SchemaRenderer → Schema renderer node: renders nodes
- Schema renderer hook → Renderer state: updates state
- Schema renderer hook → Renderer tools: uses tools
- Schema renderer node → Schema UI kit: renders entities