Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://icebob.github.io/vue-form-generator
:clipboard: A schema-based form generator component for Vue.js
https://icebob.github.io/vue-form-generator
form generator schema vue vuejs2
Last synced: 3 months ago
JSON representation
:clipboard: A schema-based form generator component for Vue.js
- Host: GitHub
- URL: https://icebob.github.io/vue-form-generator
- Owner: vue-generators
- License: mit
- Created: 2016-04-27T19:54:13.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-11T20:26:18.000Z (almost 2 years ago)
- Last Synced: 2024-05-02T00:39:02.773Z (6 months ago)
- Topics: form, generator, schema, vue, vuejs2
- Language: JavaScript
- Homepage:
- Size: 6.74 MB
- Stars: 2,970
- Watchers: 82
- Forks: 532
- Open Issues: 144
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome - Vue-form-generator
README
# vue-form-generator [](https://www.npmjs.com/package/vue-form-generator) 
A schema-based form generator component for Vue.js.
[](https://www.codacy.com/app/mereg-norbert/vue-form-generator_2?utm_source=github.com&utm_medium=referral&utm_content=vue-generators/vue-form-generator&utm_campaign=Badge_Grade)
[](https://travis-ci.org/vue-generators/vue-form-generator)
[](https://coveralls.io/github/vue-generators/vue-form-generator?branch=master)
[]()
[](http://packagequality.com/#?package=vue-form-generator)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fvue-generators%2Fvue-form-generator?ref=badge_shield)
[](https://david-dm.org/vue-generators/vue-form-generator)
[](https://david-dm.org/vue-generators/vue-form-generator#info=devDependencies)
[](https://www.npmjs.com/package/vue-form-generator)
## Demo
[JSFiddle simple example](https://jsfiddle.net/zoul0813/d8excp36/)
[CodePen simple example](https://codepen.io/zoul0813/pen/OrNVNw)
[](https://jsfiddle.net/zoul0813/d8excp36/)
## Features
* reactive forms based on schemas
* multiple object editing
* 21 field types
* built-in validators
* core & full bundles (41kb and 50kb gzipped)
* Bootstrap friendly templates
* customizable styles
* can be extended easily with custom fields
* ...etc
## Documentation
[Online documentation on Gitbook](https://vue-generators.gitbook.io/vue-generators/)
## Dependencies
vue-form-generator uses [fecha](https://github.com/taylorhakes/fecha) and [lodash](https://lodash.com/) internally.
While built-in fields don't need external dependencies, optional fields may need other libraries.
These dependencies fall into two camps: jQuery or Vanilla. You can find almost the same functionality in both flavors.
In the end, it's your choice to depend on jQuery or not.
You can find details about dependencies in the official [documentation](https://vue-generators.gitbook.io/vue-generators/) under each specific component.
## Installation
### NPM
You can install it via [NPM](http://npmjs.org/) or [yarn](https://yarnpkg.com/).
#### Latest version for Vue 2.x
```
$ npm install vue-form-generator
```
#### Legacy version for Vue 1.0.x
```
$ npm install [email protected]
```
### Manual
Download zip package and unpack and add the vfg.css and vfg.js file to your project from dist folder.
```
https://github.com/vue-generators/vue-form-generator/archive/master.zip
```
### Core vs Full version
VueFormGenerator come in two version : `core` and `full`.
Core is a more minimal version with only half the fields.
Full is core + other fields.
* Full bundle: 172 kB (gzipped: 50 kB)
* Core bundle: 146 kB (gzipped: 41 kB)
If you don't know what to choose, don't worry, the full is the default version.
If you want the slim down version, here is the changes:
```js
// the "full" way
import VueFormGenerator from "vue-form-generator";
import "vue-form-generator/dist/vfg.css"; // optional full css additions
// the "core" way
import VueFormGenerator from "vue-form-generator/dist/vfg-core.js";
import "vue-form-generator/dist/vfg-core.css"; // optional core css additions
```
## Usage
```html
import Vue from 'vue'
import VueFormGenerator from 'vue-form-generator'
import 'vue-form-generator/dist/vfg.css'
Vue.use(VueFormGenerator)
export default {
data () {
return {
model: {
id: 1,
name: 'John Doe',
password: 'J0hnD03!x4',
skills: ['Javascript', 'VueJS'],
email: '[email protected]',
status: true
},
schema: {
fields: [
{
type: 'input',
inputType: 'text',
label: 'ID (disabled text field)',
model: 'id',
readonly: true,
disabled: true
},
{
type: 'input',
inputType: 'text',
label: 'Name',
model: 'name',
placeholder: 'Your name',
featured: true,
required: true
},
{
type: 'input',
inputType: 'password',
label: 'Password',
model: 'password',
min: 6,
required: true,
hint: 'Minimum 6 characters',
validator: VueFormGenerator.validators.string
},
{
type: 'select',
label: 'Skills',
model: 'skills',
values: ['Javascript', 'VueJS', 'CSS3', 'HTML5']
},
{
type: 'input',
inputType: 'email',
label: 'E-mail',
model: 'email',
placeholder: 'User\'s e-mail address'
},
{
type: 'checkbox',
label: 'Status',
model: 'status',
default: true
}
]
},
formOptions: {
validateAfterLoad: true,
validateAfterChanged: true,
validateAsync: true
}
}
}
}
```
Usage in local components
```js
import VueFormGenerator from "vue-form-generator";
//component javascript
export default {
components: {
"vue-form-generator": VueFormGenerator.component
}
};
```
## Development
This command will start a `webpack-dev-server` with content of `dev` folder.
```bash
npm run dev
```
## Build
This command will build a distributable version in the `dist` directory.
```bash
npm run build
```
## Test
```bash
npm test
```
or
```bash
npm run ci
```
## More fields _new_
VueFormGenerator supports custom fields. If you decide to release your custom field into the wild, please open a new issue so we can add you to a list here! Please try to use this naming convention for your custom field : vfg-field-\* Example :
* `vfg-field-myfield`
* `vfg-field-calendar`
* `vfg-field-awesome-dropdown`
This way, it will be easier for everyone to find it. Thank you !
### Public Custom Fields
* [vue-tel-input](https://github.com/EducationLink/vue-tel-input) - International Telephone Input Boilerplate with Vue (integrated with VueFormGenerator).
* [vfg-field-sourcecode](https://github.com/gwenaelp/vfg-field-sourcecode) - A source code field for vue-form-generator
* [vfg-field-array](https://github.com/gwenaelp/vfg-field-array) - A vue-form-generator field to handle arrays of items of any type.
* [vfg-field-object](https://github.com/gwenaelp/vfg-field-object) - A vue-form-generator field to handle objects, with or without schemas.
* [vfg-field-matrix](https://github.com/shwld/vfg-field-matrix) - A matrix field for vue-form-generator.
## Contribution
Please send pull requests improving the usage and fixing bugs, improving documentation and providing better examples, or providing some testing, because these things are important.
## License
vue-form-generator is available under the [MIT license](https://tldrlegal.com/license/mit-license).
## Contact
Copyright (C) 2017 Icebob
[](https://github.com/icebob) [](https://twitter.com/Icebobcsi)