Features

• jsRule attribute can now be applied on main crosshairX and crosshairY objects, allowing crosshair line customization. This feature will allow you more flexible styling of crosshairs based on chart values. Like hiding the crosshair if the value is null
  • Custom data tokens can now be added on dynamic labels using %plot-IDX-data-customname constructs. This is good to display plot information in a static label.
  • Implemented display logic for overlapping scaleX crosshair items (alpha applied on obscured elements).
  • plot_click event information includes now plottext attribute.

New Documentation

• New gallery layout with search and filters by: chart type, features and use cases

Notable Fixes

• Added plotid as parameter for select and deselect API's.
• Fixed issue with bubble pack labels.
• Tilemap plugin fixes
• Fixed positioning issues.
• Fixed ability to use multiple tilemaps in same graphset.
• Fixed issue when zooming range chart with spline aspect.
• Fixed issue with maps flipping when negative zoom is applied.
• Fixed formatting issues on value-box objects.
• Added support for custom data-xxx tokens in sunburst charts.
• Fixed navigation reset on sunburst when the chart is deleted and reloaded with a different data.
• Fixed bug with timestamp formatting on data table view and data export when timezone parameter is used.
• Fixed issue with sorting crosshair plots by value when using "sort-by-value" : "asc" | "desc" attribute.
• Fixed issue with objects API not working when applied directly on map elements.
• Fixed broken scrolling logic on charts with y-axis scrolling

Features

• Change <zgparam> buildRestUrl to restmode
• Added celleditor attribute to turn off cell editing when editor or editorcontrols are set When celleditor is set to disabled and editor is turned on, double click edits the row
• Added XHTTPMethodOverride header when sending POSTs for PUT, DELETE, and PATCH Modified before CRUD events to allow manipulation of data
• Modified validator to allow manipulation of data
• Added ability to connect to Firebase SDK subscription
• Added <zgparam> name subscription to set to true
• Added ability to cancel certain actions via before event handlers. Use event.preventDefault:
  
  • data:record:beforedelete
  • data:record:beforechange
  • data:cell:beforechange
  • data:record:beforeinsert
• Added display message when no records are found in the grid
  
  • To customize message, added [nodata] attribute on <zinggrid>
  • To customize message, added <zgnodata> element that can be created under <zinggrid>
• Return the value of the id field on <zgcolumn index="recordkey"></zgcolumn> when data is array of objects (previously only worked on named objects)
• Added <zgparam> options for setting server error message
  
  • serverErrorMessage Sets the error message to display for the server error
  • serverErrorPath Sets the path to the error message in the case of a JSON response
• Added token [[serverMessage]] to place returned message from the server in the error message
• Added numbertypeformatter attribute to turn off auto formatting
• Added validators
  
  • date
  • url
  • email
  • range
• Added support for custom validators
• Added ZingGrid.registerValidator API method
• Added built in Number Validator
• Added validation error class to ZGDialog and ZGEditorRow
• Added validation error message to ZGDialog and ZGStatus
• Added <zinggrid> attribute validationerrormessage
• <zgparam> New Options
  
  • buildRestUrl True by default. Set to false to prevent REST URLs from being constructed
  • urlSuffix If using REST URLs, set a suffix to be appended to the URL. Usually an extension or a slash
• <zgparam> Shortcuts
  
  • createSrc
  • readSrc
  • updateRowSrc
  • updateCellSrc
  • deleteSrc
  • createMethod
  • readMethod
  • updateRowMethod
  • updateCellMethod
  • deleteMethod
• Added record token parsing within a URL Added django as an adapter option
• Added support for required columns for editing
• Added [required] attribute for <zgcolumn>
• Added [validationrequiredmessage] for <zgcolumn>
• Added [validationrequiredmessage] for <zinggrid>

Notable Fixes

• Fixed issue with src being set on <zgdata> or in <zgparam>
• Fixed issues with 204 responses on PUT, PATCH, and DELETE
• Fixed the 'multicell' selector in card layout from overlapping the cell content below it. Changed the location of the selector checkbox inside the card cell to the righthand edge.
• Added fullwidth to the <cite> element inside <zgsource> shadowDOM to fill the horizontal space. zgsourcetextalign now works as intended.
• Fixed issues with zgstatus closing
• Fixed bug where data is added to grid when server returns error Fixed bug where editor mode is turned on when editorcontrols is set to "false" or "disabled"
• Fixes for dynamic <zgparam> additions and removals
• Fixed bug with custom deleteBody
• Fixed issues with dynamic updating of <zgcolumn>

Notable Fixes

• Updates to zoom related events - added ev parameter which holds the event object - added beforezoom event which can completely stop zooming operation if event handler returns false
• Fixes issue with scrolling legend not properly displaying markers and text items
• Fixes issue affecting vector chart plugin
• Fixes issue with selection tool throwing errors on null nodes
• Fixes issue with value boxes not appearing on line3d and area3d charts
• Fixes issues related to log scales allowing overlapping items
• Fixed sorting of legend items using order attribute
• Fixed formatting on %pietotalvalue token
• Fixed issues with bad parsing of < and > tokens

Features

• Accessibility - All grids are WCAG 2.0 AA & 508 compliant
• Keyboard navigation and shortcuts added
• Screen reader compatibility, tested with JAWS and VoiceOver
• Inclusion of ARIA attributes for screen readers
• Screen size adjustments will not break layout or content of grid

New Documentation

• Accessibility

Notable Fixes

• Added reference to DOM cell on cell events
• grid:select will include cell and cells in the case of multiple cells selected
• Added zg-source to keyboard navigable region
• Fixed keyboard nav issues when card mode is rendered based on width
• Fixed focus issues with cancelling edit via esc key
• Fixed navigation issues for removing rows button
• Fixed selection of internal column types
• Added ability to navigate to user elements within zg-footer
• Added ability to navigate to zg-status
• Added ability to navigate to zg-watermark
• Added ability to navigate to user elements within zg-caption
• Fixed issue with up key navigating down
• Fixed issue with modal editor losing focus on close
• Fixed issue with width based card mode acting like row mode
• Fixed dialog focus bug
• Fixed keyboard nav after search and filter remove rows
• Fixed keyboard nav when all columns are hidden
• Saved focus state after using insert row
• Fixed inability to double tap edit on mobile
• Fixed mobile edit sporadic closing editor issue
• Fixed issue with cancel button appearing on edit when no delete button is in the row
• Fixed navigation issues when sort and/or filter of single columns are turned off
• Fixed select editor focusing issues
• Fixed bug with ZingGrid.setLanguage global function
• Fixed issue with grid click and then keyboard press not selecting correct item

Features

• New Chart Type: Violin Charts
• New Chart Type: Flame Charts
• Added item > highlightstate and marker > highlightstate on legend
• Extended boxplot format of data to [key, min, lowerq, med, upperq, max] format demo here

New Documentation

• New Flame Chart Docs
• New Violin Chart Docs
• New JSON Docs

Notable Fixes

• Added legendmouseover and legendmouseout events
• Added option to set license information to zingchart namespace with `zingchart.
• BoxPlot updates:
  • Fixed issue with attributes from series items not being transferred to boxplot series
• Data export updates: Fixed issue with datetime values in HTML table ignoring utc and timezone parameters
• Added data_export event which fires for every value being exported and allows for optional preformatting
• Added more flexibility to range plots in mixed chart context
• BubblePie charts work now when placed in a multichart graphset
• Cleared WorldCountries map removed specific @EUROPE filters for NOR and ISL. RUS@EUROPE and RUS@ASIA will however stay as a different tokens due to geographic specificity
• Fixed sorting of plots via legend
• Fixed bug with chart auto layout when browsing legend pages
• Fixed issue with ring charts loaded via custom build
• Fixed problem with custom builds (created via build generator) failing to render ring charts.
• Fixed issue with shadow not being rendered in specific cases
• Fixed issues with global 'mouseout' event
• Fixed issues with legend items text setup
• Fixed issues with scale string labels being treated as numbers
• Fixed issues with selection not being reset in specific cases
• Fixed maps blocking page scroll (via mouse wheel). Page scroll is no longer blocked by map charts. In case scrolling on maps is enabled, use the ALT key to force page scroll instead of map zooming.
• Renamed conflicting API's. Renamed object related 'getobjectinfo' API to 'getlabelinfo' and 'getshapeinfo' to prevent name conflict with the generic 'getobjectinfo' API
• Added Math.log10() polyfill for IE

Release V1.1.2

A minor release version of bug fixes and small updates.

New Documentation

• Internationalization

Notable Fixes

• Fixed Internationalization Issues
• Updated code to allow inserts after all existing rows are deleted
• Updated code to allow inserts on an empty grid based on column definitions
• Fixed dir issues Fixed lang issues
• Fixed bug with refreshes adding extra blank options to select filter and editors
• Added ability to change language after grid loads
• Added tooltips for all buttons
• Added missing language strings
• Added getLang and setLang on the <zinggrid> object
• Added getDir and setDir on the <zinggrid> object
• Updated watermark to be language specific

Release v1.1.1

• Added internationalization
  • en.js is the default file used. When you define another language lang="es" it will look for that registered lang file es.js. If that file doesn't exist then the grid will use smart defaults for that language as best as it can for currency and date columns.
  • Defaults to lang set on html tag <html lang=”es”>
  • Can set lang per grid <zing-grid lang=”es”>
  • Can set global lang through api ZingGrid.setLanguage(‘es’);
  • Can set custom lang file with ZingGrid.registerLanguage(obj, 'custom') and the appropriate language file JavaScript object.
• Added HTML standard direction dir="rtl" and dir="ltr"
• Added internationalization to date columns. If you define <zg-column type="data" locale="de"> it will add the appropriate formatting to that column. The columns will default to the global <html lang attribute, then <zing-grid lang and the <zg-column lang will override all.
• Added conventionally standard tokens (moment.js) to date columns for custom date formatting <zg-column type=”date” type-date-format=”[Month:] MM”>
• Refined currency columns for smart defaults to detect lang to format numbers. You still need the type-currency="EUR" attribute to define the currency symbol.
• Added locale to number renderer
• Refined filter/search to match the current language
  • If the default lang on the page is english then we use standard sort. If you have any other language defined you can override sort/filter functionality with the following properties:
  • You can turn this off with <zing-grid sort-intl=”disabled”>
  • You can turn this ON with <zing-grid sort-intl> and <zg-column sort-intl>
• Added defaultdisplay attribute to zinggrid and zgcolumn to display when the data value is null or undefined
• Added [position="both"] attribute to <zgsource>
• Added compact property to <zinggrid> to mirror [compact] attribute
• Added params property (not attribute) to ZingGrid to allow setting of data params via JavaScript
• Added params property to new ZingGrid to allow setting of data params on object render

  // define params for fetching data
  const params = {
    // define the main source for the API
    src: 'https://swapi.co/api/people/',
    // define the path in the JSON to get the array of results. In this case it is body.results
    recordPath: 'results',
    // if loadByPage is set to true it will go to the server for each new page of data
    loadByPage: 'true',
    // define the "page" query parameter
    pageKey: 'page',
    // Need to tell ZG how many records were returned so it knows how to divide up the page-size
    countPath: 'count',
    // define the path in the result JSON to find next/prev urls
    nextPath: 'next',
    // define the path in the result JSON to find next/prev urls
    prevPath: 'previous',
    // Need to tell ZG how mto search the API
    searchKey: 'search',
  };

• Changed getWidth() and getHeight() API methods to return the actual <zinggrid> width and height.
• Modified <zinggrid> [width] attribute to take values besides px. If no unit is specified, defaults to px
• Added sorter style to the footer on sorting

Bug Fixes

• Fixed issues with Number Renderer
• Fixed data being returned on events to always be an object
• Fixed autoscroll bug on resizing

Release V2.8.7

Features

autoFit: [false,true] will allow for autofiting the scales on [min,max] values to be set individually. autoFit: true will default to [true,true].

es6 export/import version of the library. Allows for import of the library through script modules with import zingchart from 'zingchart/es6';

After download from npm you can import ZingChart with the following:

import {zingchart, ZC} from 'zingchart/es6';
import {pareto} from 'zingchart/modules-es6/zingchart-pareto.min.js';

New Documentation

• Site docs on getting started
• API Events
• API Methods

Notable Fixes

• Fixed CSV download for time-series returning false values.
• Fixed issue with custom tooltip tokens.
• Fixed %scale-key-text returning wrong value.
• Fixed commenting scaleX object label causing error in CSV excel spreadsheet.
• Fixed complications between autofit and valueboxes.
• Fixed edge case where legend was overlapping charts.
• Fixed null value in bullet charts still showing up.
• Fixed issue with collapse:true on legends without minimize:true.
• Fixed “zoom-to-values” not working in scaleX.
• Fixed missing ticks in Chord diagrams.
• Fixed ghost value boxes appearing in select zoom circumstances.
• Fixed scale angling bug with 3D bar charts.
• Fixed setseriesvalues API bug with plotindex parameter
• Fixed setguide API method on mobile
• Fixed chord diagram missing ticks
• Fixed collpase:true breaking legend
• Fixed null values on bullet charts
• Fixed shared legend on population pyramids
• Fixed border: 'alpha' not showing up with animations

Release V1.1.0

• NPM Download
• Github Download

Features

• Renamed attribute attach to position on <zg-caption>
• Renamed event cell:contextmenu to cell:rightclick
• Renamed attributeselector-control to row-selector on <zing-grid>
• Renamed column type rownumber to row-number
• Renamed attribute server-render to server-rendered on <zing-grid>
• Renamed attribute value search="false" to search="disabled" on <zg-column>
• Renamed attribute value sort="false" to sort="disabled" on <zg-column>
• Renamed attribute value filter="false" to filter="disabled" on <zg-column>
• Renamed attribute value enctype to requestType on <zg-param>
• Added both as an option for attach attribute on <zg-caption>
• Added attribute position to <zg-pager>
• Added attribute position to <zg-source>
• Added attribute loadmask to <zing-grid>
• Added attribute value disabled to loadmask to turn off the loadmask
• Added attribute pagerposition to accept pager position options (top, bottom)
• Added zgbuttonpadding in the padding chain for custom <zg-button> elements, with a default fallback
• Added attribute [hidden] to <zg-param> and <zg-data>
• Added event grid:contextmenuopen to fire when static-menu is opened
• Added attribute loading-text on <zing-grid> it will set the text that displays in the <zg-load-mask> on load
• Added new CSS variables for button states
• Added new css variables for <zg-card>
• Added event grid:pageprev
• Added event grid:pagenext
• Added event grid:pagefirst
• Added event grid:pagelast
• Added method select to programatically select cells
• Changed attribute pager to be a presence attribute. No longer accepts values
• Changed attribute value draggable="false" to draggable="disabled" on <zg-column>
• Changed attribute value header-auto-format="false" to header-auto-format="disabled" on <zg-column>
• Changed attribute value header-auto-format="false" to header-auto-format="disabled" on <zing-grid>
• Changed the even and odd CSS variables to have a clearer semantic naming
• Changed CSS variable zgrowcardheadbackground_editor_even to zgrowcardbackground_editor_even
• Changed CSS variable zgrowcardheadbackground_editor_odd to zgrowcardbackground_editor_odd
• Updated/added CSS variables (normal and hover states)
• Updated zinggridborder variable usage
• Updated attribute static-menu is set and context-menu is not set, context-menu is added in.
• Updated cardmode item CSS variables when in editor mode
• Updated zg-input to accept value and type when no action is set.
• Moved the default value into the var chain instead of defining in default.css
• Moved the location of this variable call so that it now affects the message icon and text together
• Removed variable as fallback value from interior elements to limit the scope to just the <zing-grid> tag
• Removed zgfootwidth
• Removed CSS variable for process that should be avoided/discouraged
• Removed explicit setting of the cursor via javascript
• When using a <zg-card> editor, it is now possible to use the editor attribute with or without an edit-template
• Audited all <zg-button> CSS variables
• Split sorter into sort and sorter on <zing-grid> sort is a boolean indicating if sort is turned on or off. sorter sets the custom sorting function if overriding the default.
• Normalized element CSS variables
• Modified how the zinggridborderradius CSS variable applies due to the limitations of html table display.If variable is defined, and a caption and/or pager is shown, those elements will get the radius. Otherwise,additional CSS will need to be applied to add the radius to other grid elements.

New Documentation

• API Intro
• API Elements
• API Columns
• API Params
• API Methods
• API Events
• API CSS Variables
• API Search

Notable Fixes

• Fixed bug where boolean attributes were not being reflected via API Methods.
• Fixed bug where setSort was not working for either true or false
• Fixed toggleColumn API Method to auto detect if the column should be hidden or shown
• Fixed getHeaderAutoFormat() response when value is not set.
• Fixed setCardTemplate method to set a card template after the grid has rendered
• Fixed grid:scroll event bug Fixed grid:keydown:esc event bug
• Fixed bugs related to contentwidth attribute on <zg-column>
• Fixed <zg-foot> behavior to apply border variables correctly
• Fixed the event record:beforeinsert to return the proper data as listed in the docs
• Fixed bugs with deselecting cells on escape or layout change

Features

• Context menu styling for adding a record at the: beginning, end or current cursor position

New Documentation

• zg-button

Notable Fixes

• Input field not showing up in <zg-dialog> for editing records
• Firefox loading screen not showing
• Firefox dragging modal text padding not being applied
• Safari type-image-mask="circle" not rounding image corners