Graphset
[ root » graphset ]
graphset is an array of graph objects. It allows you to render multiple graphs at once in the same area and gives you the ability to control the layout of your graphs as well as share interactions between the graphs.
| Attribute | Type | Description |
|---|---|---|
| 3daspect 3d-aspect | Object | Sets the 3D properties for 3D chart types. Allows you to change the viewing angle, chart depth, zoom level, and 3D engine type. Chart types: 3D Charts |
| alpha | Number | Sets the transparency level of the object. Values must range between 0.0 and 1.0, with 0.0 being completely transparent and 1.0 being completely opaque. Note that values require the leading 0 before the decimal point. Default Value: 1 |
| anchor | String | Allows you to set an object's anchor position Accepted Values: ['tl', 'tr', 'bl', 'br', 'c', 't', 'r', 'b', 'l'] Default Value: 'tl' |
| angle | Number | Sets the rotation angle of the object/shape. Default Value: 0 |
| angleEnd angle-end | Number | Sets the end angle of a pie shape. Default Value: 360 |
| angleStart angle-start | Number | Sets the beginning angle of a pie shape. Default Value: 0 |
| animateType animate-type | String | Sets the animation routine on the chart. If set to 'initial', then the chart will ONLY animate on render. The chart will not animate on zoom and subsequent actions. Accepted Values: ['initial', 'always'] Default Value: 'always' |
| arrows | Array | Creates a container to hold any number of chart arrow objects, which are great for drawing attention to a specific area of your chart. Default Value: [] |
| async | Boolean | Paints the graph's plots in an async mode, one by one with a small delay between each one, making the chart more responsive in case of a large number of plots. Default Value: false |
| backgroundClip background-clip | Boolean | Clips the background image to the margins of the shape/box. Default Value: true |
| backgroundColor background-color | String | Sets the background color of the object. Colors can be entered by name (e.g., "purple", "blue"), hexadecimal notation (e.g., "#666699", #33ccff"), or RGB notation (e.g., "rgb(255,0,0)", "rgb(0,0,255)") Default Value: null |
| backgroundColor1 background-color-1 | String | Sets the first color of a 2 color background gradient of the object. To be used with background-color-2. Default Value: null |
| backgroundColor2 background-color-2 | String | Sets the second color of a 2 color background gradient of the object. To be used with background-color-1. Default Value: null |
| backgroundFit background-fit | String | Sets the direction/s on which the background image is being "stretched". Default Value: '' |
| backgroundImage background-image | String | Sets a background image for the object. Value can be a local file or a web image's location. Default Value: '' |
| backgroundPosition background-position | String | Sets the position of the background when the background-repeat value is no-repeat. Default Value: '50% 50%' |
| backgroundRepeat background-repeat | String | Sets the repeating mode for the background image. Default Value: 'repeat' |
| backgroundScale background-scale | Number | Scales the background image using the specified ratio. Default Value: 1 |
| border | String,Number | Sets the border width of the object. Can be a single value or a string of values, setting the values in the order "top right bottom left" |
| borderAlpha border-alpha | Number | Sets the transparency level of the border on the object. Values must range between 0.0 and 1.0, with 0.0 being completely transparent and 1.0 being completely opaque. Note that values require the leading 0 before the decimal point. Default Value: 1 Introduced in: v2.1.1 |
| borderBottom border-bottom | String | Sets the object's bottom border style. Accepts solid, dashed, and dotted styles. Default Value: '' |
| borderColor border-color | String | Sets the border color of the object. Default Value: '#000' |
| borderLeft border-left | String | Sets the object's left border style. Accepts solid, dashed, and dotted styles. |
| borderRadius border-radius | Number | Sets the object's border radius for rounded corners. Larger values create rounder corners, while smaller values create sharper corners. A single value will affect all 4 corners; multiple values will have separate effects on each corner, with the first value affecting the top-left corner, the second value affecting the top-right corner, and so on, in a clockwise direction. A negative value will cut a corner off without rounding. Default Value: 0 |
| borderRadiusBottomLeft border-radius-bottom-left | Number | Sets the object's bottom-left border radius for rounded corners. Larger values create rounder corners, while smaller values create sharper corners. A negative value will cut a corner off without rounding. Default Value: 0 |
| borderRadiusBottomRight border-radius-bottom-right | Number | Sets the object's bottom-right border radius for rounded corners. Larger values create rounder corners, while smaller values create sharper corners. A negative value will cut a corner off without rounding. Default Value: 0 |
| borderRadiusTopLeft border-radius-top-left | Number | Sets the object's top-left border radius for rounded corners. Larger values create rounder corners, while smaller values create sharper corners. A negative value will cut a corner off without rounding. Default Value: 0 |
| borderRadiusTopRight border-radius-top-right | Number | Sets the object's top-right border radius for rounded corners. Larger values create rounder corners, while smaller values create sharper corners. A negative value will cut a corner off without rounding. Default Value: 0 |
| borderRight border-right | String | Sets the object's right border style. Accepts solid, dashed, and dotted styles. Default Value: '' |
| borderTop border-top | String | Sets the object's top border style. Accepts solid, dashed, and dotted styles. Default Value: '' |
| borderWidth border-width | Number | Sets the border width of the object. Default Value: 0 |
| bottomState bottom-state | Object | Sets the style for a copy of the object which is placed below the object itself. Introduced in: v1.14.0 |
| callout | Boolean | Sets whether an object will have a callout arrow or not. Default Value: false |
| calloutExtension callout-extension | Number | Sets the length of the extension that extends beyond the tip of the callout arrow. Default Value: 0 |
| calloutHeight callout-height | Number | Sets the height of the object's callout arrow. A larger value will create a taller callout arrow. Default Value: 8 |
| calloutHook callout-hook | Array. | Sets the point of the tip of the callout arrow to a specified coordinate on the chart, with the starting point of [0,0] being the top left corner of the chart. Default Value: null |
| calloutOffset callout-offset | Number | Sets the offset along the callout direction of the arrow's base. Positive and negative values can be used to offset the callout arrow up, down, left, or right depending on the callout-position. Default Value: 0 |
| calloutPosition callout-position | String | Sets the position for the object's callout arrow. The position is "bottom" by default. Default Value: 'bottom' |
| calloutRatio callout-ratio | Array. | Sets how much to stretch/squeeze the callout arrow on its two sides. A zero value for example on one side would create like a half callout arrow. Negative values can also be set, in order to create various aspects. Default Value: [1, 1] |
| calloutTip callout-tip | ZCStyle | To style the tip of the callout. You can modify the shape with a "type" attribute. Value options include "circle", "diamond", "cross", and "arrow". For styling, use attributes such as "background-color", "border-color", "border-width", "line-color", "line-width", and so on. Default Value: null |
| calloutWidth callout-width | Number | Sets the width of the object's callout arrow. A larger value will create a wider callout arrow. Default Value: 8 |
| centerRef center-ref | Boolean | Sets the (0,0) x/y coordinates as the center of the box (instead of the top-left corner). Default Value: false |
| class | String | Sets a class value on the object. Default Value: null |
| crosshairX crosshair-x | Object | Object to style the x axis crosshair. Crosshairs are interactive labels that appear when users hover over the data points (or node values) on your chart. Default Value: null |
| crosshairY crosshair-y | Object | Object to style the y axis crosshair. Crosshairs are interactive labels that appear when users hover over the data points (or node values) on your chart. Default Value: null |
| csv | Object | Configure CSV import |
| csv | String | Allows you to either import data from an external CSV file (and a few other similar file types) or import data using a data string within the JSON code. Default Value: null |
| cursor | String | Sets the cursor shape when hovering over the object. Default Value: 'auto' Introduced in: v1.9.0 |
| description | string | Allows you to set a specific description for your chart |
| fillAngle fill-angle | Number | Sets the angle of the axis along which the linear gradient is drawn. Default Value: 90 |
| fillOffsetX fill-offset-x | Number | Sets an X offset to apply to the fill. Default Value: 0 |
| fillOffsetY fill-offset-y | Number | Sets a Y offset to apply to the fill. Default Value: 0 |
| fillType fill-type | String,Number | Sets the background gradient fill type to either linear or radial. Default Value: 'linear' |
| flat | Boolean | Disables the active area (used for tooltip) for the object. Default Value: false |
| gradientColors gradient-colors | String | Sets a set of colors for a complex background gradient consisting of 2 or more colors. To be used with gradient-stops. Default Value: '' |
| gradientStops gradient-stops | String | Sets the gradient stops for a complex background gradient consisting of 2 or more colors. To be used with gradient-colors. Default Value: '' |
| height | Number | Set the object's height. Default Value: 0 |
| id | String | ID of the shape Default Value: '' |
| id | String | Sets the id of the object. Default Value: '' |
| images | Array | Creates a container to hold any number of chart image objects. Images can be styled and placed anywhere on a chart. Default Value: [] |
| item | String | Sets the item id of the map on which the object/shape is being added. Default Value: '' |
| labels | Array | Standalone chart labels can be used to display text, URLs, images, and more. When utilized with tokens, they become dynamic labels that users can interact with. To create them, use the `labels` array, which will act as the container for all of your label objects. Default Value: [] |
| legend | Object | Create a `legend` object to add a legend to your chart. Default Value: null |
| lineCap line-cap | String | Sets the stroke-linecap attribute on SVGs Accepted Values: ['butt', 'round', 'square'] Default Value: 'butt' |
| lineColor line-color | String | Sets the line color of the object, applicable on non-closed shapes. See also border-color for closed shapes. Default Value: '#000' |
| lineGapSize line-gap-size | String,Number | Can be used to create custom dashed or dotted lines when used with line-segment-size. This will control the size of the gaps between each line segment. Default Value: 0 |
| lineJoin line-join | String | Sets the stroke-linejoin attribute on SVGs Accepted Values: ['round', 'miter'] Default Value: 'round' |
| lineSegmentSize line-segment-size | String,Number | Can be used to create custom dashed or dotted lines when used with line-gap-size. This will control the size of the visible segment of line. Default Value: 0 |
| lineStyle line-style | String | Sets the line style of the object. Default Value: '' |
| lineWidth line-width | Number | Sets the line width of the object, applicable on non-closed shapes. See also border-width for closed shapes. Default Value: 0 |
| map | String | Sets the map id of the map on which the object/shape is being added. |
| margin | Number | Sets the object's margin/s from the top-left of the chart. Default Value: 0 |
| marginBottom margin-bottom | Number | Sets the object's bottom margin. Default Value: -1 |
| marginLeft margin-left | Number | Sets the object's left margin. Default Value: -1 |
| marginRight margin-right | Number | Sets the object's right margin. Default Value: -1 |
| marginTop margin-top | Number | Sets the object's top margin. Default Value: -1 |
| mediaRules media-rules | Object | Configure media rules |
| noData no-data | Object | No Data attribute gives your charts the ability to let the user know when no graph data has been loaded into a chart. The look and size of the chart will be rendered, but the plotarea will be masked off. Default Value: null |
| offsetR offset-r | Number | Sets an R offset to apply when positioning the object/shape. Default Value: 0 |
| offsetX offset-x | Number | Sets an X offset to apply when positioning the object/shape. Default Value: 0 |
| offsetY offset-y | Number | Sets a Y offset to apply when positioning the object/shape. Default Value: 0 |
| offsetZ offset-z | Number | Sets a Z offset to apply when positioning the object/shape. Default Value: 0 |
| options | Object | Object to configure graph-specific properties Chart types: Boxplot,Bubble-pack,Calendar,Chord,Depth,Multi-guide Module,Dragging Module,Flame,Grid,Heat-map,Interactive-maps,,Pareto,Pop-pyramid,Rankflow,Scorecard,Stream,Sunburst,Tilemap,,Tree-module,Treemap,Variwide,Vectorplot,Violin,Waterfall,Wordcloud,Zoom-buttons |
| page | Number | Sets a page number for the current graph. At one moment, on a multi-graph graphset, only graphs with the same page will be displayed. By default all graphs are placed on first page (0) so they are all displayed. |
| palette | Array. | Sets the color palette used for styling the chart. |
| plot | Object | Set plot specific properties |
| plotArea plotarea | Object | Allows you to style the plotarea, which is the area directly behind a chart's plotted data. This area is delimited by the ends of the X and Y scales. To style the area outside of the scales, place the styling attributes within the main graph object. Default Value: null |
| points | Array. | Sets the coordinates of the object/shape points. Default Value: [] |
| position | String | Sets the object's position relative to its container. Similar results can be obtained by setting [margin] and [margin-...] attributes. Uses x,y coordinates originating from the top left of the chart. Default Value: '' |
| preview | Object | Preview charts are a miniaturized version of the main chart, allowing users to zoom in and examine sections of a chart while still viewing it in its entirety. Use the `preview` object to style the object, active area, background area, and preview chart handles. Default Value: null |
| rectShortcut rect-shortcut | Boolean | Used to force the library to create rectangles using a faster drawing API (instead of painting them like a closed polygon). However, using this would disable effects like rounded borders. It is a performance setting for edge cases. Default Value: false |
| refresh | Object | Sets the chart's automated data refresh system. Default Value: null |
| resources | Array | Preload links using the resources attribute |
| scale | Object | Configure scale |
| scaleK scale-k | scaleK | Configure scale-k |
| scaleR scale-r | Object | Configure scale-r |
| scaleV scale-v | Object | Configure scale-v |
| scaleX scale-x | Object | Configure scale-x |
| scaleY scale-y | Object | Configure scale-y |
| scrollX scroll-x | Object | Use to style the bar and handle portions of the X scrollbar Default Value: null |
| scrollY scroll-y | Object | Use to style the bar and handle portions of the Y scrollbar Default Value: null |
| selection | Array. | Sets the initial selection state for chart nodes. The format is an array of arrays of node indexes, each set of node indexes corresponds to a plot. |
| selection | Boolean | Enables and disables selection |
| series | Object | Set series specific properties |
| shadow | Boolean | Sets whether the object's shadow is visible or not. Has limited effect on HTML5 implementation. Default Value: false |
| shadowAlpha shadow-alpha | Number | Sets the transparency of the shadow of the object. The higher the value, the less transparent the shadow will be. Default Value: 0.75 |
| shadowAngle shadow-angle | Number | Sets the angle of the shadow underneath the object. Default Value: 45 |
| shadowBlur shadow-blur | String,Number | Sets the blur effect size for the shadow of the object. Has limited effect on HTML5 implementation. Default Value: 0 |
| shadowColor shadow-color | String | Sets the color of the shadow of the object. Default Value: '#999' |
| shadowDistance shadow-distance | String,Number | Sets the distance between the shadow and the object. Default Value: 2 |
| shapes | Array | An array that contains objects defining chart shapes. Shapes can be styled and placed anywhere on a chart. Default Value: [] |
| size | Number | Sets the size of the object/shape. Default Value: 0 |
| size2 size-2 | Number | Sets the secondary size of the object/shape. Used on ellipses or rectangle shapes. Default Value: 0 |
| slice | Number | Sets the radius of the inner ring of a pie shape. Default Value: 0 |
| source | Object | Places a text label on a chart to indicate a data source. By default, the source will appear in the bottom right corner of a chart. Default Value: null |
| stackType stack-type | String | Changes the stacking logic for stacked charts. Accepted Values: ['normal', '100%', '] Default Value: 'normal' |
| stacked | Boolean | Setting 'stacked': true will take each of the 'series': [] value sets and stack them on top of one another Default Value: false |
| subtitle | Object | Allows you to include a chart subtitle that will, by default, appear just below a title (if one is included). Default Value: null |
| target | String | Sets the target for the URL. Depending on its value, it either opens the URL or uses the content fetched from the URL (when target is graph=ID). Accepted Values: _blank, _top, _parent, _window=NAME, graph=ID Default Value: null |
| timeZone time-zone | Number | Time-Series Charts only: To set the UTC timezone. Use with the 'utc' attribute and 'transform' object in the applicable scale object. Default Value: 0 |
| title | Object | Displays a title across the top of the chart. Default Value: null |
| tooltip | Object | Sets the definition for a tooltip object. Default Value: null |
| topState top-state | ZCShape | Sets the style for a copy of the object which is placed above the object itself. Introduced in: v1.14.0 |
| type | String | Sets the chart type Default Value: '' |
| type | String | Sets the type of the object/shape. Accepted Values: ['arc', 'arrow', 'circle', 'cross', 'diamond', 'ellipse','gear3', 'gear4', 'gear5', 'gear6', 'gear7', 'gear8', 'gear9', 'hamburger', 'line', 'parallelogram', 'pie','plus', 'poly', 'rect', 'rpoly3', 'rpoly4', 'rpoly5', 'rpoly6', 'rpoly7', 'rpoly8', 'rpoly9', 'square', 'star3', 'star4', 'star5', 'star6', 'star7', 'star8', 'star9', 'trapezoid', 'triangle'] Default Value: 'poly' |
| url | String | Sets an URL associated with this object. Used mostly on nodes/labels/shapes with their associated click events. Default Value: null |
| urlData url-data | String | Sets the url used for full http refresh feed. Default Value: null |
| utc | Boolean | Time-Series Charts only: To set the chart to UTC time. Use with the 'timezone' attribute and 'transform' object in the applicable scale object. Default Value: false |
| visible | Boolean | Sets the visibility of the object. Allows you to turn off the object without removing lines of JSON. Default Value: true |
| widgets | Object | A way to extend default ZingChart functionality with object syntax. |
| width | Number | Sets the object's width. Default Value: 0 |
| x | Number | Sets the X position of the object. Default Value: -1 |
| y | Number | Sets the Y position of the object. |
| zIndex z-index | Number | Sets the z position of the object. Objects with higher z indexes will appear "above" those with lower z index values. Default Value: 1 |
| zSort z-sort | Number | Used to force the sorting of the active areas (which trigger the tooltip) of two shapes in case they overlap. Default Value: 1 |
| zoom | Object | Chart zooming is an interactive chart feature that allows users to select a zoom area by clicking and dragging. Use the `zoom` object to style the zoom area, add zooming labels, turn on shared zooming, and more. Default Value: null |