@bpmn-io/form-js-viewer
TypeScript icon, indicating that this package has built-in type declarations

1.8.1 • Public • Published

@bpmn-io/form-js-viewer

This library exports a form viewer for viewing and submitting forms. Use our editor to create and edit forms.

Installation

npm install @bpmn-io/form-js-viewer

Usage

import { Form } from '@bpmn-io/form-js-viewer';

const schema = {
  components: [
    {
      key: 'creditor',
      label: 'Creditor',
      type: 'textfield',
      validate: {
        required: true
      }
    }
  ]
};

const data = {
  creditor: 'John Doe Company'
};

const form = new Form({
  container: document.querySelector('#form')
});

await form.importSchema(schema, data);

// add event listeners
form.on('submit', event => {
  console.log('Form <submit>', event);
});

// provide a priority to event listeners
form.on('changed', 500, event => {
  console.log('Form <changed>', event);
});

Check out a full example.

Styling

For proper styling include the form-js.css stylesheet and font used:

<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400&display=swap" rel="stylesheet">

<link href="https://unpkg.com/@bpmn-io/form-js/dist/assets/form-js.css" rel="stylesheet">

API

Form

Create a new form with options { container?: HTMLElement }.

import { Form } from '@bpmn-io/form-js-viewer';

const form = new Form({
  container: document.querySelector('#form')
});

Form#importSchema(schema: Schema, data?: Data) => Promise<Result, Error>

Display a form represented via a form schema and the optional data.

try {
  await form.importSchema(schema);
} catch (err) {
  console.log('importing form failed', err);
}

Form#submit() => { data: Data, errors: Errors }

Submit a form programatically.

const {
  data,
  errors
} = form.submit();

if (Object.keys(errors).length) {
  console.error('Form submitted with errors', errors);
}

Form#validate() => Errors

Validate a form programatically.

const errors = form.validate();

if (Object.keys(errors).length) {
  console.error('Form has errors', errors);
}

Form#reset() => void

Reset a form programatically.

Form#setProperty(key, value) => void

Set a form property such as readOnly.

Form#attachTo(parentNode: HTMLElement) => void

Attach the form to a parent node.

Form#detach() => void

Detach the form from its parent node.

Form#on(event, fn) => void

Subscribe to an event.

Form#destroy() => void

Remove form from the document.

Events

changed :: { data, errors }

Fired off every time there is a form state change.

submit :: { data, errors }

Fired off on form submission.

import.done :: { error, warnings }

Fired whenever a schema has finished importing, whether it succeeds or fails.

Layouting events

  • form.layoutCleared
  • form.layoutCalculated :: { rows }

Lifecycle Events

  • detach
  • attach
  • form.init
  • form.clear
  • form.destroy
  • diagram.clear
  • diagram.destroy

Formfield events

  • formField.add :: { formField }
  • formField.remove :: { formField }
  • formField.focus :: { formField }
  • formField.blur :: { formField }
  • formField.search :: { formField, value }

License

Use under the terms of the bpmn.io license.

Dependents (7)

Package Sidebar

Install

npm i @bpmn-io/form-js-viewer

Weekly Downloads

5,059

Version

1.8.1

License

SEE LICENSE IN LICENSE

Unpacked Size

1.93 MB

Total Files

117

Last publish

Collaborators

  • vsgoulart
  • skaiir-camunda
  • marstamm
  • bpmn-io-admin
  • nikku
  • barmac
  • philippfromme
  • maxtru