Neurological Phenomenon Multiplexer

    @phillipleblanc/chartjs-plugin-boxselect
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.6-dev11 • Public • Published

    chartjs-plugin-boxselect

    A Chart.js plugin to select points using click-and-drag boxes.
    Works with scatter and line chart types.

    Installation

    To install with npm

    npm install --save chartjs-plugin-boxselect
    

    To use with a <script> tag

    <script src="https://cdn.jsdelivr.net/npm/chart.js@2.9.4/dist/Chart.bundle.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/chartjs-plugin-boxselect"></script>
    

    Configuration

    To configure the box-select plugin, add a new config option to a chart config.

    plugins: {
        boxselect: {
            select: {
                enabled: true,
                direction: 'xy'
            },
            callbacks: {
                beforeSelect: function(startX, endX, startY, endY) {
                    // return false to cancel selection
                    return true;
                }
                afterSelect: function(startX, endX, startY, endY, datasets) {
    
                }
            }
        },
    }

    Options

    The direction setting defines which box shapes can be drawn. The options are x, xy, or y. The default is xy.

    The datasets parameter in the afterSelect callback is the same size as the array of datasets in the chart.
    Each dataset has the parameters data, labels, and indexes.
    data contains an array of points that fell inside the selection box.
    indexes contains the corresponding index of each point that was selected from the original dataset.data labels contains the labels (if any) from the dataset that correspond to the selected points.

    Samples

    A sample chart that shows how the afterSelect callback can be used to highlight data is in the /samples directory.

    Development

    rollup is required to build.
    The built boxselect.js file is in the /dist directory.
    The build command is npm run build.

    Credits

    Created by Thomas Humphries.
    Code inspired by chartjs-plugin-crosshair and chartjs-plugin-zoom.

    Licence

    chartjs-plugin-boxselect.js is available under the MIT licence.

    Install

    npm i @phillipleblanc/chartjs-plugin-boxselect

    DownloadsWeekly Downloads

    2

    Version

    1.0.6-dev11

    License

    MIT

    Unpacked Size

    10.9 kB

    Total Files

    4

    Last publish

    Collaborators

    • phillipleblanc