Web Components Chart Selection

    The Ignite UI for Web Components selection feature in Web Components {ComponentTitle} allows users to interactively select, highlight, outline and vice-versa deselect single or multiple series within a chart. This provides many different possibilities with how users interact with the data presented in more meaningful ways.

    Configuring Selection

    The default behavior selectionMode turned off and requires opting into one of the following options. There are several selection modes available in the {ComponentName}:

    • Auto
    • None
    • Brighten
    • FadeOthers
    • GrayscaleOthers
    • FocusColorThickOutline
    • FocusColorOutline
    • SelectionColorThickOutline
    • SelectionColorOutline
    • FocusColorFill
    • SelectionColorFill
    • ThickOutline

    Brighten will fade the selected item while FadeOthers will cause the opposite effect occur. GrayscaleOthers will behave similarily to FadeOthers but instead show a gray color to the rest of the series. Note this will override any selectionBrush setting. SelectionColorOutline and SelectionColorThickOutline will draw a border around the series.

    In conjuction, a selectionBehavior is available to provide greater control on which items get selected. The default behavior for Auto is PerSeriesAndDataItemMultiSelect.

    • Auto
    • PerDataItemMultiSelect
    • PerDataItemSingleSelect
    • PerSeriesAndDataItemMultiSelect
    • PerSeriesAndDataItemSingleSelect
    • PerSeriesAndDataItemGlobalSingleSelect
    • PerSeriesMultiSelect
    • PerSeriesSingleSelect

    Configuring Selection via Color Fill

    The following example shows the combination of both SelectionColorFill and Auto selection behavior aka PerSeriesAndDataItemMultiSelect. Color Fills provide a useful visual cue as it changes the entire series item's back color. By clicking each item you'll see the item change from green to purple.

    Configuring Multiple Selection

    Other selection modes offer various methods of selection. For example using selectionBehavior with PerDataItemMultiSelect will effect all series in entire category when multiple series are present while allowing selection across categories. Compared to PerDataItemSingleSelect, only a single category of items can be selected at a time. This is useful if mutliple series are bound to different datasources and provides greater control of selection between categories. PerSeriesAndDataItemGlobalSingleSelect allows single series selection across all categories at a time.

    Configuring Outline Selection

    When focusBrush is applied, selected series will appear with a border when the selectionMode property is set to one of the focus options.

    Radial Series Selection

    This example demonstrates another series type via the IgcDataChartComponent where each radial series can be selected with different colors.

    Programmatic Selection

    Chart Selection can also be configured in code where selected items in the chart can be seen on startup or runtime. This can be achieved by adding items to the SelectedSeriesCollection of the IgcCategoryChartComponent. The Matcher property of the IgcChartSelection object allows for selecting a series based on a "matcher", ideal when you do not have access to the actual series from the chart. If you know the properties that your datasource contains, you can use the ValueMemberPath that the series would be.

    The matcher is ideal for using in charts, such as the IgcCategoryChartComponent when you do not have access to the actual series, like the IgcDataChartComponent. In this case you if you know the properties that your datasource contained you can surmise the ValueMemberPaths that the series would have. For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to highlight the series bound to Solar values, you can add a ChartSelection object to the selectedSeriesItems collection using a matcher with the following properties set

    For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to select the series bound to Solar values, you can add a ChartSelection object to the SelectedSeriesItems collection using a matcher with the following properties set.

    API References

    The following is a list of API members mentioned in the above sections:

    IgcCategoryChartComponent Properties IgcDataChartComponent Properties