Custom Widgets for SurveyJS

IMPORTANT: Using a custom widget is no longer the recommended approach to customizing SurveyJS forms. For current best practices and available options, refer to the following help topic: Question Customization Options.

• select2: site, repo, license: MIT

• select2tagbox: site, repo, license: MIT

• icheck: site, repo, license: MIT

• inputmask: site, repo, license: MIT

• jquerybarrating: site, repo, license: MIT

• jqueryuidatepicker: site, repo, license: https://github.com/jquery/jquery-ui/blob/master/LICENSE.txt

• nouislider: site, repo, license: https://github.com/leongersen/noUiSlider/blob/master/LICENSE

• sortablejs: site, repo, license: MIT

• ckeditor: site, repo, license: https://github.com/ckeditor/ckeditor-dev/blob/major/LICENSE.md

• pretty-checkbox: site, repo, license: https://github.com/lokesh-coder/pretty-checkbox/blob/master/LICENSE

• bootstrap-slider: site, repo, license: https://github.com/seiyria/bootstrap-slider/blob/master/LICENSE.md

• recordrtc: site, repo, license MIT

• imageHotArea repo, licence: MIT

Getting started

es5 examples: https://surveyjs.io/Examples/Library/?id=custom-widget-select2-tagbox
es modules examples: https://stackblitz.com/edit/surveyjs-widgets-react

Install the library using es5.

<script src="https://unpkg.com/surveyjs-widgets"></script>

Install the library using npm.

npm install surveyjs-widgets

Or use unpkg CDN: https://unpkg.com/surveyjs-widgets@{version-number}/surveyjs-widgets.min.js

You find all versions/builds in the surveyjs/build repo.

Building surveyjs-widgets from sources

To build library yourself:

1. Clone the repo from GitHub

   git clone https://github.com/surveyjs/widgets.git
   cd surveyjs-widgets

2. Acquire build dependencies. Make sure you have Node.js installed on your workstation. This is only needed to build surveyjs from sources.

   npm install

3. Build the library

   npm run build

   After that you should have the libraries (angular, jquery, knockout, react and vue) at 'packages' directory.

4. Add your own custom widget

   Please go to this plunker and select customwidget.js to review the code and comments.

   The same plunker example, but for Survey Creator / Form Builder

License

MIT license