JavaScript Frameworks

A list of all the Progressive Web Application frameworks supported by the Form.io platform.

PreviousJavaScript SDK NextJavaScript Utilities

Last updated 1 month ago

Was this helpful?

JavaScript Frameworks

A list of all the Progressive Web Application frameworks supported by the Form.io platform.

JavaScript

At its core, the Form.io platform uses a plain JavaScript (aka Vanilla JavaScript) renderer to render the forms within an application. This renderer, as well as all documentation, can be found on Github @ . For the full documentation, please take a look at in the help guides.

This renderer is able to easily render a form using the following code within your application either via Script embedding or application embedding.

Script Embedding

This allows the embedding of a form directly within an HTML application using the script tags within the header. The scripts and CSS that need to be included are as follows.

<link rel='stylesheet' href='https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css'>
<link rel='stylesheet' href='https://cdn.form.io/formiojs/formio.full.min.css'>
<script src='https://cdn.form.io/formiojs/formio.full.min.js'></script>
<div id='formio'></div>
<script type='text/javascript'>
  Formio.createForm(
    document.getElementById('formio'), 
    'https://examples.form.io/example'
  );
</script>

The Form Builder can also be embedded using the following code.

<div id="builder"></div>
<script type="text/javascript">
  Formio.builder(document.getElementById('builder'), {}, {});
</script>

Application Embedding

The form renderer can also be embedded within an application by first including the formiojs renderer as an NPM dependency and then using the following code.

npm install formiojs

import { Formio } from 'formiojs';
Formio.createForm(document.getElementById('formio'), 'https://examples.form.io/example');

And the following CSS should also be included in your application SASS file.

@import "~formiojs/dist/formio.form.min.css";

For more documentation on the JavaScript renderer, please check out the following links.

Angular

Angular Renderer

To use this within your application, you will start by importing the dependencies via NPM.

npm install --save formiojs @formio/angular

Once the library is imported into your Angular application, you can render a form using the following code.

import { FormioModule } from '@formio/angular';
@NgModule({
    imports: [
        ...,
        FormioModule
    ],
    ...
})
export class AppModule { }

And then the following can be used within your templates to render a form.

<formio src='https://examples.form.io/example'></formio>

There are many other modules and helper components within the Angular library, so we recommend checking out the list of other documentation and examples at the following links.

Angular Starter Application

Angular Demo Application

Angular Other Resources

React

React is a popular JavaScript library for building PWA applications. It is maintained by Facebook. The Form.io integration libraries provide a simple wrapper around the JavaScript renderer library but expose a number of helper components and modules that enable rapid application development within React.

React Renderer

To use this within your application, you will start by importing the dependencies via NPM.

npm install --save formiojs @formio/react

Once the library is imported into your React application, you can render a form using the following code.

import React from 'react';
import { Form } from '@formio/react';

const App = () => (
  <div className="container" id="main">
    <Form src="https://examples.form.io/example" />
  </div>
);

Form components provide many helpful properties which allow you to configure your form. Here are the most common of them.

If you need to take more control of the wrapped formio Form instance (e.g., conditionally prepopulate it with some data, or control the behavior of a few components inside the form), you can use formReady prop and save the form instance using React Ref.

import React from 'react';
import { Form } from '@formio/react';

const App = () => {
  const formRef = React.useRef(null);
  const onFormReady = React.useCallback((form) => {
    formRef.current = form;
  }, []);

  return (
    <div className="container" id="main">
      <Form src="https://examples.form.io/example" />
    </div>
  );
};

There are many other modules and helper components within the React library, so we recommend checking out the list of other documentation and examples at the following links.

React Starter Application

React Components vs Form.io Components

React and Form.io both use the word "components" to refer to discreet modules of reusable code, but they are distinctly different and the difference must be understood.

In React, components are UI building blocks that render elements on the page, while in Form.io, components are data-driven form elements that power dynamic forms, workflows, and APIs. Form.io components are not just the data field UI, they define data structures, validation, and API interactions, to create a fully integrated form and data management system.

React Wrapper

Form.io provides a React wrapper that makes embedding forms in a React application completely seamless. Developers should not try to import custom React components directly into Form.io forms. Instead, use the React wrapper to integrate the rendered forms seamlessly alongside any other React component. This allows for tight integration with React’s state management, event handling, and styling, while still benefiting from the Form.io Platform's schema-driven approach.

Integrating forms with the React wrapper

Rather than treating the Form.io Platform as an isolated system, the React wrapper integrates a React app and the Form.io form engine. Forms may trigger React state updates, listen to events, and interact with other components in the app without breaking the schema-driven approach of Form.io

This ensures:

Separation of concerns: Control of the broader application’s UI is handled entirely by React, while the the form’s behavior is handled entirely with the Form.io Platform.
Scalabilty: The app remains scalable without needing to modify form components at the code level.
Flexibility: The Form.io Platform's JSON-driven forms stay flexible and dynamic while still aligning with the application’s design system.

Vue

Vue Renderer

To use this within your application, you will start by importing the dependencies via NPM.

npm install --save @formio/vue

Once the library is imported into your Vue application, you can render a form using the following code.

<template>
  <formio :src="formUrl" @submit="onSubmitMethod" />
</template>
<script>
import { Form } from 'vue-formio';

export default {
  data: function() {
    // Load these from vuex or some other state store system.
    return {
      formUrl: "https://examples.form.io/example"
    }
  },
  components: {
    formio: Form
  },
  methods: {
    onSubmitMethod: function(submission) {
      console.log(submission);
    }
  }
};
</script>

Form components provide many helpful properties which allow you to configure your form. Here are the most common of them.

Property

Description

Value example

src

An embed URL to load a form

form

Form JSON schema, can be used instead of the src

{

type: 'form', display: 'form',

components: [...],

}

submission

Submission to set when the form is loaded

{ data: {...}, state: 'submitted', }

options

Form options

{ readOnly: true, noAlerts: false, saveDraft: false, }

There are many other modules and helper components within the Vue library, so we recommend checking out the list of other documentation and examples at the following links.

Vue Starter Application

Aurelia

Aurelia Renderer

Aurelia Starter Application

AngularJS

AngularJS Renderer

This library is meant to be used in conjunction with Form.io to provide dynamic JSON form rendering capabilities. This allows you to render any form using the schemas provided by Form.io.

The following snippet of code will dynamically render the form within Form.io, as well as automatically hook that form up to the REST API generated from the same schema.

<formio src="'https://myapp.form.io/myform'"></formio>

Installation

There are several ways to add this library to your application. Each of these installation types are for specific use cases.

Full Installation

Includes: Everything including Angular.js and jQuery.
Usage: Use this installation if your application does not already have Angular and jQuery and you wish to display a single form on a page.
Installation: Place the following within your application.

<link rel="stylesheet" href="https://rawgit.com/formio/ngFormio/master/dist/formio-full.min.css" />
<script src="https://rawgit.com/formio/ngFormio/master/dist/formio-full.min.js"></script>

Complete Installation

Includes: Everything except Angular.js and jQuery
Usage: Use this if you are embedding a form within an application that already has Angular.js and jQuery installed.
Installation: Place the following within your application.

<link rel="stylesheet" href="https://rawgit.com/formio/ngFormio/master/dist/formio-complete.min.css" />
<script src="https://rawgit.com/formio/ngFormio/master/dist/formio-complete.min.js"></script>

Basic Installation: (Bower Installation)

Includes: Only the ngFormio renderer library with no dependencies.
First install the dependency using Bower

bower install --save ng-formio

Then, you can add the following to your application.

<html>
<head>
  <!-- bower:css -->
  <!-- endbower -->
</head>
<body>
  <!-- bower:js -->
  <!-- endbower -->
</body>
</html>

Then run Wiredep to wire it up.

$ node
> require('wiredep')({ src: 'index.html' });

Usage

Now that you have the library installed, you can then do the following to add a form to your application.

Create a new project.
Create a Form within your project. This will then give you an API url like the following. https://myapp.form.io/myform.
You can then embed this form within your application by providing the following.

<formio src="'https://myapp.form.io/myform'"></formio>

This not only renders the form dynamically within your application, but also automatically hooks up that form to the API backend that is provided by Form.io.

AngularJS Form Builder

AngularJS Helper Libraries

AngularJS Submission Grid

AngularJS Application Starterkit

Angular Material

Installation

To install this library into your application, you will need to run the following.

npm install formiojs @formio/angular @formio/angular-material

Then, you will need to add the following to your codebase.

import { MatFormioModule } from '@formio/angular-material';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    BrowserAnimationsModule,
    MatFormioModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

Using this library

For example, the following will render a dynamic JSON form within your application.

<mat-formio src="https://examples.form.io/kitchensink"></mat-formio>

You can also use this to render JSON forms as follows.

<mat-formio [form]="{
  components: [
    {
      type: 'textfield',
      label: 'First Name',
      key: 'firstName'
    },
    {
      type: 'textfield',
      label: 'Last Name',
      key: 'lastName'
    },
    {
      type: 'button',
      action: 'submit',
      label: 'Submit',
      key: 'submit'
    }
  ]
}" (submit)="onSubmit($event)"></mat-formio>

PreviousJavaScript SDK NextJavaScript Utilities

Last updated 1 month ago

Was this helpful?