kevinchappell / form-builder
jQuery formBuilder
Package info
github.com/kevinchappell/formBuilder
Language:JavaScript
pkg:composer/kevinchappell/form-builder
Requires
None
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- dev-master
- v3.23.9
- v3.23.8
- v3.23.7
- v3.23.6
- v3.23.5
- v3.23.4
- v3.23.3
- v3.23.2
- v3.23.1
- v3.23.0
- v3.22.2
- v3.22.1
- v3.22.0
- v3.21.1
- v3.21.0
- v3.20.2
- v3.20.1
- v3.20.0
- v3.19.15
- v3.19.14
- v3.19.13
- v3.19.12
- v3.19.11
- v3.19.10
- v3.19.9
- v3.19.8
- v3.19.7
- v3.19.6
- v3.19.5
- v3.19.4
- v3.19.3
- v3.19.2
- v3.19.1
- v3.19.0
- v3.18.0
- v3.17.3
- v3.17.2
- v3.17.1
- v3.17.0
- v3.16.13
- v3.16.12
- v3.16.11
- v3.16.10
- v3.16.9
- v3.16.8
- v3.16.7
- v3.16.6
- v3.16.5
- v3.16.4
- v3.16.3
- v3.16.2
- v3.16.1
- v3.16.0
- v3.15.1
- v3.15.0
- v3.14.0
- v3.13.2
- v3.13.1
- v3.13.0
- v3.12.4
- v3.12.3
- v3.12.2
- v3.12.1
- v3.12.0
- v3.11.1
- v3.11.0
- v3.10.6
- v3.10.5
- v3.10.4
- v3.10.3
- v3.10.2
- v3.10.1
- v3.10.0
- v3.9.18
- v3.9.17
- v3.9.16
- v3.9.15
- v3.9.14
- v3.9.13
- v3.9.12
- v3.9.11
- v3.9.10
- v3.9.9
- v3.9.8
- v3.9.7
- v3.9.6
- v3.9.5
- v3.9.4
- v3.9.3
- v3.9.2
- v3.9.1
- v3.9.0
- v3.8.3
- v3.8.2
- v3.8.1
- v3.8.0
- v3.7.4
- v3.7.3
- v3.7.2
- v3.7.1
- v3.7.0
- v3.6.2
- v3.6.1
- v3.6.0
- v3.5.2
- v3.5.1
- v3.5.0
- v3.4.5
- v3.4.4
- v3.4.3
- v3.4.2
- v3.4.1
- v3.4.0
- v3.3.5
- v3.3.4
- v3.3.3
- v3.3.2
- v3.3.1
- v3.3.0
- v3.2.6
- v3.2.5
- v3.2.4
- v3.2.3
- v3.2.2
- v3.2.1
- v3.2.0
- v3.1.3
- v3.1.2
- v3.1.1
- v3.1.0
- v3.0.2
- v3.0.1
- v3.0.0
- v2.10.9
- v2.10.8
- v2.10.7
- v2.10.6
- v2.10.5
- v2.10.4
- v2.10.3
- v2.10.2
- v2.10.1
- v2.10.0
- v2.9.8
- v2.9.7
- v2.9.6
- v2.9.5
- v2.9.4
- v2.9.3
- v2.9.2
- v2.9.1
- v2.9.0
- v2.8.0
- v2.7.0
- v2.6.0
- v2.5.3
- v2.5.2
- v2.5.1
- v2.5.0
- v2.4.1
- v2.4.0
- v2.3.5
- v2.3.4
- v2.3.3
- v2.3.2
- v2.3.1
- v2.3.0
- v2.2.8
- v2.2.7
- v2.2.6
- v2.2.5
- v2.2.4
- v2.2.3
- v2.2.2
- v2.2.1
- v2.2.0
- v2.1.2
- v2.1.1
- v2.1.0
- v2.0.0
- v2.0-beta
- v1.24.7
- v1.24.6
- v1.24.5
- v1.24.3
- v1.24.2
- v1.24.1
- v1.24.0
- v1.23.1
- v1.23.0
- v1.22.1
- v1.22.0
- v1.21.3
- v1.21.2
- v1.21.1
- v1.21.0
- v1.20.3
- v1.20.2
- v1.20.1
- v1.20.0
- v1.19.4
- v1.19.3
- v1.19.2
- v1.19.1
- v1.19.0
- v1.18.0
- v1.17.2
- v1.17.1
- v1.17.0
- v1.16.0
- v1.15.6
- v1.15.5
- v1.15.4
- v1.15.3
- v1.15.2
- v1.15.0
- v1.14.6
- v1.14.5
- dev-fix/strip-trailing-br-header-label
- dev-fix/1671-replace-mi18n-with-draggable-i18n
- dev-fix/unminified
- dev-fix/npm-audit
- dev-chore/1490
- dev-fix/missing-labels
- dev-chore/wrapper-plugin
- dev-chore/update-node-sass
- dev-fix/line-breaks
- dev-fix/radio-group-remove
- dev-fix/icon-name-conflict
- dev-fix/local-langs
- dev-fix/adblock-issues
- dev-fix/vendor-scripts
- dev-fix/missing-src
- dev-option/disabledFieldButtons
- dev-develop
This package is auto-updated.
Last update: 2026-11-17 22:35:19 UTC
README
A jQuery plugin for building forms with drag and drop, plus a companion plugin to render them.
- formBuilder is a client-side drag-and-drop form editor. Users drag fields (text, textarea, select, checkbox and radio groups, date, number, file, autocomplete, button, header, paragraph, hidden and more) onto a stage, then edit each field's label, name, options and other attributes. The form definition is exported as JSON (default) or XML
formData. - formRender takes that
formDataand renders it as a working HTML form. It can also read back what a user entered (userData) or prefill values.
A common setup is formBuilder in an admin area and formRender on the public side.
Demos
- Editor demo
- API demo
- Docs demos: formBuilder basic, formRender basic
Installation
npm / yarn
npm install formBuilder
# or
yarn add formBuilder
The package name is case-sensitive: formBuilder. The built files are in dist/ (form-builder.min.js, form-render.min.js).
CDN (jsDelivr)
<script src="https://cdn.jsdelivr.net/npm/formBuilder@3/dist/form-builder.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/formBuilder@3/dist/form-render.min.js"></script>
formBuilder@3 loads the latest 3.x release. For production, pin an exact version such as formBuilder@3.23.5.
Dependencies
- jQuery (
>=3.4.1), required by both plugins. Thedistfiles use the globaljQuery, so load jQuery first. If you use a bundler, exposewindow.jQuerybefore you import formBuilder. - jQuery UI Sortable, required by formBuilder for drag and drop. You can use the
jquery-ui-sortablepackage or a full jQuery UI build.
CSS is injected by the scripts, so you don't need a separate stylesheet.
Quick start
formBuilder
<meta charset="utf-8"> <div id="fb-editor"></div> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.13.2/jquery-ui.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/formBuilder@3/dist/form-builder.min.js"></script> <script> jQuery(($) => { const fbPromise = $('#fb-editor').formBuilder({ disableFields: ['autocomplete'], onSave: (evt, formData) => console.log(formData), }).promise fbPromise.then((formBuilder) => { const json = formBuilder.actions.getData('json') // 'js' (default), 'json' or 'xml' console.log(json) }) }) </script>
formBuilder starts up asynchronously, so actions aren't ready the moment you call .formBuilder(). Wait on the promise property, or call actions later, for example from a click handler.
formRender
<div id="fb-render"></div> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/formBuilder@3/dist/form-render.min.js"></script> <script> jQuery(($) => { const formData = '[{"type":"text","label":"Full Name","name":"full-name","subtype":"text"}]' const renderer = $('#fb-render').formRender({ formData }) // later, read what the user entered console.log(renderer.userData) }) </script>
formData can be a JSON string or the array returned by getData(). To use XML, pass dataType: 'xml'.
Documentation
Full docs: https://formbuilder.online/docs/ · Getting started · formBuilder overview
Common formBuilder options: formData, disableFields, i18n, onSave, typeUserAttrs
Common formBuilder actions: getData, setData, addField, save, setLang
Custom fields: Controls · Control plugins
formRender: Options · userData
Translations (i18n)
Translations are handled by @draggable/i18n. The language files come from formBuilder-languages. en-US is bundled. Other locales are fetched as <location><locale>.lang, and location defaults to the relative path assets/lang/. Set the i18n option to choose a locale and where its file is loaded from:
$('#fb-editor').formBuilder({ i18n: { locale: 'de-DE', location: 'https://cdn.jsdelivr.net/npm/formbuilder-languages@1.2.2/', }, })
Translators welcome!
As more people use formBuilder, it needs to be available in more languages. New languages and fixes to existing ones are always welcome. See Contributing Languages for how to help.
Browser support
The build targets the browserslist defaults query, which covers current versions of the major browsers:
![]() |
![]() |
![]() |
![]() |
![]() |
|---|---|---|---|---|
| Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ |
Internet Explorer is not supported.
Contributing
Contributions are welcome. See CONTRIBUTING.md and the development docs (contributing guide on the site).
git clone https://github.com/kevinchappell/formBuilder.git cd formBuilder npm ci npm start # local demo with Vite (alias: npm run dev) npm test # Vitest with coverage npm run lint # ESLint on ./src npm run build # build dist/ (form-builder + form-render, minified and unminified) npm run build:all # plugins, vendor, build and copy to the demo
Commit messages follow Conventional Commits and are checked by commitlint. semantic-release uses them to publish releases from master.
Support
Report bugs and request features on GitHub Issues. Include your formBuilder version, the options you used, your browser and steps to reproduce.
Related
- Changelog
- Ng2FormBuilder, a community Angular 2/4 version





