// Copyright 2018 the Charts project authors. Please see the AUTHORS file // for details. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // EXCLUDE_FROM_GALLERY_DOCS_START import 'dart:math'; // EXCLUDE_FROM_GALLERY_DOCS_END import 'package:charts_flutter/flutter.dart' as charts; import 'package:flutter/material.dart'; import 'package:flutter/scheduler.dart'; /// This is just a simple line chart with a behavior that adds slider controls. /// /// A [Slider] behavior is added manually to enable slider controls, with an /// initial position at 1 along the domain axis. /// /// An onChange event handler has been configured to demonstrate updating a div /// with data from the slider's current position. An "initial" drag state event /// will be fired when the chart is drawn because an initial domain value is /// set. /// /// [Slider.moveSliderToDomain] can be called to programmatically position the /// slider. This is useful for synchronizing the slider with external elements. class SliderLine extends StatefulWidget { final List> seriesList; final bool? animate; const SliderLine(this.seriesList, {this.animate, Key? key}) : super(key: key); /// Creates a [LineChart] with sample data and no transition. factory SliderLine.withSampleData() { return SliderLine( _createSampleData(), // Disable animations for image tests. animate: false, ); } // EXCLUDE_FROM_GALLERY_DOCS_START // This section is excluded from being copied to the gallery. // It is used for creating random series data to demonstrate animation in // the example app only. factory SliderLine.withRandomData() { return SliderLine(_createRandomData()); } /// Create random data. static List> _createRandomData() { final random = Random(); final data = [ LinearSales(0, random.nextInt(100)), LinearSales(1, random.nextInt(100)), LinearSales(2, random.nextInt(100)), LinearSales(3, random.nextInt(100)), ]; return [ charts.Series( id: 'Sales', domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: data, ) ]; } // EXCLUDE_FROM_GALLERY_DOCS_END // We need a Stateful widget to build the selection details with the current // selection as the state. @override State createState() => _SliderCallbackState(); /// Create one series with sample hard coded data. static List> _createSampleData() { final data = [ LinearSales(0, 5), LinearSales(1, 25), LinearSales(2, 100), LinearSales(3, 75), ]; return [ charts.Series( id: 'Sales', domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: data, ) ]; } } class _SliderCallbackState extends State { num? _sliderDomainValue; String? _sliderDragState; Point? _sliderPosition; // Handles callbacks when the user drags the slider. _onSliderChange(Point point, dynamic domain, String roleId, charts.SliderListenerDragState dragState) { // Request a build. void rebuild(_) { setState(() { _sliderDomainValue = (domain * 10).round() / 10; _sliderDragState = dragState.toString(); _sliderPosition = point; }); } SchedulerBinding.instance!.addPostFrameCallback(rebuild); } @override Widget build(BuildContext context) { // The children consist of a Chart and Text widgets below to hold the info. final children = [ SizedBox( height: 150.0, child: charts.LineChart( widget.seriesList, animate: widget.animate, // Configures a [Slider] behavior. // // Available options include: // // [eventTrigger] configures the type of mouse gesture that controls // the slider. // // [handleRenderer] draws a handle for the slider. Defaults to a // rectangle. // // [initialDomainValue] sets the initial position of the slider in // domain units. The default is the center of the chart. // // [onChangeCallback] will be called when the position of the slider // changes during a drag event. // // [roleId] optional custom role ID for the slider. This can be used to // allow multiple [Slider] behaviors on the same chart. Normally, there can // only be one slider (per event trigger type) on a chart. This setting // allows for configuring multiple independent sliders. // // [snapToDatum] configures the slider to snap snap onto the nearest // datum (by domain distance) when dragged. By default, the slider // can be positioned anywhere along the domain axis. // // [style] takes in a [SliderStyle] configuration object, and // configures the color and sizing of the slider line and handle. behaviors: [ charts.Slider( initialDomainValue: 1.0, onChangeCallback: _onSliderChange), ], )), ]; // If there is a slider change event, then include the details. if (_sliderDomainValue != null) { children.add(Padding( padding: const EdgeInsets.only(top: 5.0), child: Text('Slider domain value: $_sliderDomainValue'))); } if (_sliderPosition != null) { children.add(Padding( padding: const EdgeInsets.only(top: 5.0), child: Text( 'Slider position: ${_sliderPosition!.x}, ${_sliderPosition!.y}'))); } if (_sliderDragState != null) { children.add(Padding( padding: const EdgeInsets.only(top: 5.0), child: Text('Slider drag state: $_sliderDragState'))); } return Column(children: children); } } /// Sample linear data type. class LinearSales { final int year; final int sales; LinearSales(this.year, this.sales); }