WYSIWYG Editor

A CodeMirror based WYSIWYG editor with lint (error reporting) can be used to write Funnel Query Language. The editor is easy to add to your project using NPM.
The editor is designed to make it easy to write Funnel Queries for non-technical users.
FunnelQL Editor
Online Editor
An online demo of the editor is available om https://funnelql.com/.
Installation
npm install funnelql-editor
Including the editor
The FunnelQL editor library can be included like any regular javascript file, is safe to include in concatenation and can be loaded asynchronously.
The editor consists of a mode and lint extension for CodeMirror with a custom WYSIWYG toolbar and application frame.
The editor provides a combination package that includes CodeMirror funnelql-editor+codemirror.js and a extension-only file funnelql-editor.js.
When using the extension-only file you need to manually load lib/codemirror.js and addon/lint/lint.js from the CodeMirror package that can be installed using NPM:
npm install codemirror
It is not required to install CodeMirror when using the combination package.
FunnelQL editor + codemirror combined
<link rel="stylesheet" href="css/funnelql-editor+codemirror.css" />
<script src="js/funnelql-editor+codemirror.js" async></script>
FunnelQL editor extension only
If CodeMirror is already present on a page you can include just the FunnelQL extension-only files.
<!-- Optional: from CodeMirror package -->
<link rel="stylesheet" href="node_modules/codemirror/lib/codemirror.css" />
<link rel="stylesheet" href="node_modules/codemirror/addon/lint/lint.css" />
<script src="node_modules/lib/codemirror.js"></script>
<script src="node_modules/addon/lint/lint.js"></script>
​
<!-- Required: FunnelQL editor extension -->
<link rel="stylesheet" href="css/funnelql-editor.css" />
<script src="js/funnelql-editor.js" async></script>
Setup
The editor can be installed on any <textarea>. The FunnelQL Javascript library should be loaded before a FunnelQL editor is instantiated.
<textarea type="text" id="funnelql_editor" style="width:100%;height:250px;"></textarea>
The editor can be loaded using the Javascript constructor FunnelQLEditor with as first parameter a string ID reference or HTML element of a <textarea> and optionally a second parameter with CodeMirror Options.
var fql_editor = FunnelQLEditor('funnelql_editor', {
    /* Optional: CodeMirror options */
});
To make sure that the FunnelQL library and database are loaded before the editor is instantiated, use the onload callback provided by the Javascript library:
$FQL.on('load')
  .then(function() {
​
    /* load editor */
​
  });
FunnelQL CodeMirror API extension
The FunnelQLEditor constructor returns a CodeMirror editor object enhanced with additional API methods.
Method
Description
parse
Parse the FunnelQL input and return the parsed JSON via a Promise.
For information about the CodeMirror API, see https://codemirror.net/doc/manual.html#api​

Javascript API

Guides

Last modified 4yr ago

Method	Description
`parse`	Parse the FunnelQL input and return the parsed JSON via a Promise.