Home
Macro Language Elements
The section contains detailed specifications for all 1010data Macro Language elements.
Application Development
<widget>
<widget> is used to define all visual components of a QuickApp, including drop-downs, text boxes, tables, and calendars. The form a widget takes is controlled by the class_ attribute.
class_="terminal"
Provides an xterm-compatible terminal emulator as a widget.

Macro Language Elements
The section contains detailed specifications for all 1010data Macro Language elements.
- Data Transformation
  Data transformation operations use functions and expressions to functionally alter tabular data. These operations take 0, 1, or 2 tables as input and produce a single table as a result.
- Blocks
  Blocks allow users to reuse sections of Macro Language code and to parameterize values in that code for greater flexibility and power.
- Application Development
  - <dynamic>
    The <dynamic> element creates an environment in 1010data that maintains the state of system interactions and controls the running of queries.
  - <render>
    The <render> element provides the ability to configure certain QuickApp widgets when rendered to available output targets. A single <render> element contains one or more elements that specify output targets and settings for the final output.
  - <layout>
    The <layout> element is a nestable pseudo-operation that can be used to organize <widget> elements and other <layout> elements.
  - <widget>
    <widget> is used to define all visual components of a QuickApp, including drop-downs, text boxes, tables, and calendars. The form a widget takes is controlled by the class_ attribute.
    - class_="alert"
      The alert widget displays a message to the user when an event triggers an alert. (Available as of prod-9)
    - class_="bokehchart"
      <widget class_="bokehchart"> allows you to create data visualizations. (Available as of version 13.30)
    - class_="browser"
      Using <widget class_="browser"> creates a file-browser that enables the end-user of the QuickApp to select 1010data objects such as tables, folders, and queries.
    - class_="buildgrid"
      Using <widget class_="buildgrid"> provides an editable, expandable grid for entering data into a temp table.
    - class_="button"
      Using <widget class_="button"> creates a button that can be configured to perform many actions and initiate interactions.
    - class_="chart"
      Using <widget class_="chart"> allows you to create client-side data visualizations rendered by the Kendo UI ®charting engine. (Available as of version 10.16)
    - class_="checkbox"
      Using <widget class_="checkbox"> creates a simple checkbox with a label.
    - class_="checklist"
      Using <widget class_="checklist"> creates a set of checkboxes with horizontal or vertical orientation.
    - class_="color"
      Using <widget class_="color"> creates a widget that allows the end-user to select a color value.
    - class_="date"
      Using <widget class_="date"> creates an input field with an accompanying calendar widget for easier date selection.
    - class_="draggable"
      Using <widget class_="draggable"> creates drag-and-drop biscuits to add columns to different drop zones.(Available as of version 13.04)
    - class_="dropdown"
      Using <widget class_="dropdown"> creates a drop-down menu.
    - class_="dropdownlist"
      Using <widget class_="dropdownlist"> creates a drop-down menu with multi-select capabilities that preserve the order of items clicked. (Available as of prod-9)
    - class_="editgrid" (deprecated)
      Using <widget class_="editgrid"> creates a table whose cells can be edited in the browser.
    - class_="expression"
      The expression widget provides assistance in composing 1010data expressions. (Available as of version 11.18)
    - class_="field"
      Using <widget class_="field"> creates a text input field.
    - class_="font"
      Using <widget class_="font"> creates a widget that allows the end user to select a font and related properties such as size and style.
    - class_="gauge"
      Using <widget class_="gauge"> creates a linear or radial gauge that displays scalar data on a specified range of values. (Available as of prod-9)
    - class_="gmap"
      Using <widget class_="gmap"> creates a graphical map that can be used to display geographical information. This widget is powered by the Google Maps service.
    - class_="graphics"
      Using <widget class_="graphics"> creates a graph generated by 1010data's visualization engine.
    - class_="grid"
      Using <widget class_="grid">, the results from a 1010data query can be displayed in a tabular format.
    - class_="image"
      Using <widget class_="image"> inserts an image into the layout of a QuickApp.
    - class_="lineup"
      The <widget class_="lineup"> is a specialized alternative to <widget class_="sorter">, which allows for selection, ordering, and sorting from a collection of columns or similar objects. (Available as of version 12.06)
    - class_="link"
      Using <widget class_="link"> creates an HTML hyperlink.
    - class_="list"
      Using <widget class_="list"> creates a scrollable box with a list of values that can be selected by clicking or lassoing.
    - class_="logout"
      Sends a logout command to the server.
    - class_="menu"
      Using <widget class_="menu"> creates a hierarchical menu bar with cascading submenus that can submit action or alter variables on selection. (Available as of prod-9)
    - class_="nest"
      Using <widget class_="nest">, widgets can be dynamically generated based on parameterized values.
    - class_="progressbar"
      Using <widget class_="progressbar"> creates a progress bar with several display modes. (Available as of prod-9)
    - class_="querytree"
      Using <widget class_="querytree"> provides a display of hierarchical data with nested parent/child nodes. (Available as of prod-9)
    - class_="radio"
      Using <widget class_="radio"> creates a set of radio buttons with horizontal or vertical orientation.
    - class_="radiobutton"
      Using <widget class_="radiobutton"> creates a button that assigns the value of a specified expression to a dynamic variable when the button is clicked. The button can assume different guises.
    - class_="receiver"
      Using <widget class_="receiver"> updates dynamic variables when it receives JavaScript messages sent from external web applications.
    - class_="slider"
      Using <widget class_="slider"> creates a sliding value widget.
    - class_="sorter"
      Using <widget class_="sorter"> creates a scrollable box with a list of values that can be sorted, or two lists in which values that can be moved from one to the other and sorted within each individual list.
    - class_="spy"
      Detects the size of the display area used to show a QuickApp and changes values in a package variable when the dimensions of the display area change. These values can then be used to change dimensional aspects of the QuickApp.
    - class_="table"
      Using <widget class_="table"> creates a fixed table ideal for displaying a relatively small dataset. The current maximum size for a table widget is 1000 rows and 500 columns. Any results from a 1010data query can be displayed in this table/grid element.
    - class_="taglist"
      Provides an input box for multiple strings which are then parsed into tags. (Available as of version 15.04)
    - class_="terminal"
      Provides an xterm-compatible terminal emulator as a widget.
    - class_="text"
      Using <widget class_="text"> displays text in the QuickApp.
    - class_="textbox"
      Using <widget class_="textbox"> creates a large text field for entering and editing arbitrary text, including 1010data Macro Language code.
    - class_="transmitter"
      Using <widget class_="transmitter"> sends a JavaScript message to the web application in which the QuickApp is contained, notifying it when the values of specified dynamic variables have changed.
    - class_="value"
      A value widget displays the value of its bound variable, formatted appropriately for its type. (Available as of version 11.19)
  - <do>
    A <do> clause within a <dynamic> provides the ability for <dynamic> variables to be updated when some variable within the scope of the <dynamic> is changed.
  - <do action_="sql">
    <do action_="sql"> provides a programmatic API to the SQL metadata store. (Available as of version 17.29)
  - <loop>
    <loop> is a special operation that allows one query to iteratively reference the data from each row in the results of another query.

`class_="terminal"`

Provides an xterm-compatible terminal emulator as a widget.

Description

Explicit Syntax

<dynamic x="">
  <widget class_="terminal" 
  value_="@x" 
  scrollback_="[NUMBER]" 
  blink_="0|1"
  splash_="[TEXT]" 
  connect_="[CONNECTION]"/>
</dynamic>

Attributes

value_

When this variable is changed, its value will be printed to the terminal and then reset to the empty string.

scrollback_

Specifies the length of the scrollback buffer.

The default is 1000.

blink_

Specifies whether or not the cursor should blink. Accepts a 0 or 1.

When blink_=0, the cursor does not blink.

When blink_=1, the cursor blinks.

The default is 1.

splash_

Defines text that should be printed when the terminal is first rendered, before the contents (if any) of value_ are printed.

connect_

Allows the terminal to be connected to an interactive connection handler; this will be used in the future with WebSocket endpoints, for example, but currently accepts connect_="jsconsole" to connect the terminal widget to the browser's JavaScript console.

Note: This attribute is mutually exclusive with value_.

Example: A simple "Parrot" QuickApp

Outputs whatever text is entered in the console window, using an ANSI escape sequence to display the entered text in a different color.

<dynamic t="">
  <do onchange_="@t" when_="{@t<>''}">
    <set t="{'&#27;\[32m'}{@t}{'&#27;\[39m&#13;'}"/>
  </do>
  <widget class_="terminal" value_="@t"/>
</dynamic>

Terminal window example.