Wijmo UI for the Web
seriesList Field

Creates an array of series objects that contain data values and labels to display in the chart. Each series object consists of a label and a data attribute with its own array of X, Y, and Y1 values. X values are generally text values, while Y and Y1 values are numeric. The X value determines where the bubble appears in relation to the X axis, the Y value determines where it appears in relation to the Y axis, and the Y1 value determines the size of the bubble.

The seriesList for a bubble chart also allows you to specify shapes or images to use instead of a bubble for each value.

Type: Array

Default: []

Syntax
Javascript (Usage) 
var value; // Type: array
value = jQuery.wijmo.wijbubblechart.options.seriesList;
Javascript (Specification) 
var seriesList : array;
Example
This example has an array of two series objects, one with x, y, and y1 data values, and the other with xy and y1 values. See code comments for an explanation of the xy values.
$("#bubblechart").wijbubblechart({
   seriesList: [{
           label: "Q1",
           legendEntry: true,
           data: {
                   x: [1, 2, 3, 4, 5],
                   y: [12, 21, 9, 29, 30],
                   y1:[3, 5, 1, 6, 2]
                 },
           offset: 0
       }, {
           label: "Q2",
           legendEntry: true,
           data: {
                   // In this case, using xy causes the array
                   // to split up so that the 1st, 3rd, 5th, 7th, and 9th
                   // values are assigned to x, while the 2nd, 4th,
                   // 6th, 8th, and 10th values are assigned to y.
                   xy: [1, 21, 2, 10, 3, 19, 4, 31, 5, 20],
                   y1:[3, 5, 1, 6, 2]
                 },
           offset: 0
           }]
    });
This example uses date objects for the array of x data values.
$("#bubblechart").wijbubblechart({         
seriesList: [{
            label: "Q1",
            legendEntry: true,
            data: {
                    x: [new Date(1978, 0, 1), 
					    new Date(1980, 0, 1),
						new Date(1981, 0, 1), 
						new Date(1982, 0, 1),
						new Date(1983, 0, 1)],
                    y: [12, 21, 9, 29, 30],
                    y1:[3, 5, 1, 6, 2]
                  },
            offset: 0
        }]
    });
Remarks
Each series object in the seriesList array is defined with the following options.

data

An object that contains arrays of X, Y, and Y1 data for the chart series.

Type: Object

Default: {}

x

An array of data strings to display along the x axis, against which to plot the center point of the bubble.

Type: array

Default: []

y

An array of numeric data values to plot along the y axis, against which to plot the center point of the bubble.

Type: array

Default: []

y1

An array of numeric data values to use in plotting the size of each bubble. The sizingMethod option determines whether y1 specifies the area or diameter of the bubble.

Type: array

Default: []

label

A string value used to label the chart series. By default, this value appears in the legend entry for the series and in the hint when you mouse over a bubble in the series. To prevent a series label from appearing in the legend, see legendEntry, below. If you do not provide a label for a series, the label for the series appears as "undefined" in the hint and in the legend.

Type: string

Default: ""

legendEntry

A value that indicates whether to display the label and color of the series in the legend of the chart. Set this value to false to leave a series out of the legend.

Type: Boolean

Default: true

markers

An object containing the type of marker to use for each bubble in the chart. You can specify an image (symbol), or an included shape (type).

Type: object

Default: {type: "circle"}

symbol

A collection of objects that indicate the index of the series in the seriesList and the URL of the image to use as the marker for the bubble. See BubbleChart Symbols for a demonstration, or see the How To topic: Use Images for Bubbles.

Type: object

Default: []

index

A value that indicates the index of the X value in the series for which to use the image as a bubble. Use index values to apply a different image to each bubble in a series, where 1 applies to the first bubble, 2 to the second, etc.

Type: number

Default: 1

url

A value that indicates the URL, or web address, of the image to use for the bubble indicated by the index of the symbol.

Type: string

Default: ""

type

A value that indicates the type of marker to display for the series. If you want to use images, specify a symbol instead.

Valid Values:

  • box
  • circle
  • cross
  • diamond
  • invertedTri
  • tri

Type: string

Default: "circle"

Browser Compatibility
7
5
5

See Also

Reference

options type

 

 


© 2013 All Rights Reserved.

Send comments on this topic.