// 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. /// Example of a time series chart with range annotations configured to render /// labels in the chart margin area. // 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'; class TimeSeriesRangeAnnotationMarginChart extends StatelessWidget { final List seriesList; final bool animate; TimeSeriesRangeAnnotationMarginChart(this.seriesList, {this.animate}); /// Creates a [TimeSeriesChart] with sample data and no transition. factory TimeSeriesRangeAnnotationMarginChart.withSampleData() { return new TimeSeriesRangeAnnotationMarginChart( _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 TimeSeriesRangeAnnotationMarginChart.withRandomData() { return new TimeSeriesRangeAnnotationMarginChart(_createRandomData()); } /// Create random data. static List> _createRandomData() { final random = new Random(); final data = [ new TimeSeriesSales(new DateTime(2017, 9, 19), random.nextInt(100)), new TimeSeriesSales(new DateTime(2017, 9, 26), random.nextInt(100)), new TimeSeriesSales(new DateTime(2017, 10, 3), random.nextInt(100)), // Fix one of the points to 100 so that the annotations are consistently // placed. new TimeSeriesSales(new DateTime(2017, 10, 10), 100), ]; return [ new charts.Series( id: 'Sales', domainFn: (TimeSeriesSales sales, _) => sales.time, measureFn: (TimeSeriesSales sales, _) => sales.sales, data: data, ) ]; } // EXCLUDE_FROM_GALLERY_DOCS_END @override Widget build(BuildContext context) { return new charts.TimeSeriesChart(seriesList, animate: animate, // Allow enough space in the left and right chart margins for the // annotations. layoutConfig: new charts.LayoutConfig( leftMarginSpec: new charts.MarginSpec.fixedPixel(60), topMarginSpec: new charts.MarginSpec.fixedPixel(20), rightMarginSpec: new charts.MarginSpec.fixedPixel(60), bottomMarginSpec: new charts.MarginSpec.fixedPixel(20)), behaviors: [ // Define one domain and two measure annotations configured to render // labels in the chart margins. new charts.RangeAnnotation([ new charts.RangeAnnotationSegment( new DateTime(2017, 10, 4), new DateTime(2017, 10, 15), charts.RangeAnnotationAxisType.domain, startLabel: 'D1 Start', endLabel: 'D1 End', labelAnchor: charts.AnnotationLabelAnchor.end, color: charts.MaterialPalette.gray.shade200, // Override the default vertical direction for domain labels. labelDirection: charts.AnnotationLabelDirection.horizontal), new charts.RangeAnnotationSegment( 15, 20, charts.RangeAnnotationAxisType.measure, startLabel: 'M1 Start', endLabel: 'M1 End', labelAnchor: charts.AnnotationLabelAnchor.end, color: charts.MaterialPalette.gray.shade300), new charts.RangeAnnotationSegment( 35, 65, charts.RangeAnnotationAxisType.measure, startLabel: 'M2 Start', endLabel: 'M2 End', labelAnchor: charts.AnnotationLabelAnchor.start, color: charts.MaterialPalette.gray.shade300), ], defaultLabelPosition: charts.AnnotationLabelPosition.margin), ]); } /// Create one series with sample hard coded data. static List> _createSampleData() { final data = [ new TimeSeriesSales(new DateTime(2017, 9, 19), 5), new TimeSeriesSales(new DateTime(2017, 9, 26), 25), new TimeSeriesSales(new DateTime(2017, 10, 3), 100), new TimeSeriesSales(new DateTime(2017, 10, 10), 75), ]; return [ new charts.Series( id: 'Sales', domainFn: (TimeSeriesSales sales, _) => sales.time, measureFn: (TimeSeriesSales sales, _) => sales.sales, data: data, ) ]; } } /// Sample time series data type. class TimeSeriesSales { final DateTime time; final int sales; TimeSeriesSales(this.time, this.sales); }