// 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. /// Time series chart with line annotation example /// /// The example future range annotation extends beyond the range of the series /// data, demonstrating the effect of the [Charts.RangeAnnotation.extendAxis] /// flag. This can be set to false to disable range extension. /// /// Additional annotations may be added simply by adding additional /// [Charts.RangeAnnotationSegment] items to the list. // 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 TimeSeriesLineAnnotationChart extends StatelessWidget { final List> seriesList; final bool? animate; const TimeSeriesLineAnnotationChart(this.seriesList, {this.animate, Key? key}) : super(key: key); /// Creates a [TimeSeriesChart] with sample data and no transition. factory TimeSeriesLineAnnotationChart.withSampleData() { return TimeSeriesLineAnnotationChart( _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 TimeSeriesLineAnnotationChart.withRandomData() { return TimeSeriesLineAnnotationChart(_createRandomData()); } /// Create random data. static List> _createRandomData() { final random = Random(); final data = [ TimeSeriesSales(DateTime(2017, 9, 19), random.nextInt(100)), TimeSeriesSales(DateTime(2017, 9, 26), random.nextInt(100)), TimeSeriesSales(DateTime(2017, 10, 3), random.nextInt(100)), TimeSeriesSales(DateTime(2017, 10, 10), random.nextInt(100)), ]; return [ 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 charts.TimeSeriesChart(seriesList, animate: animate, behaviors: [ charts.RangeAnnotation([ charts.LineAnnotationSegment( DateTime(2017, 10, 4), charts.RangeAnnotationAxisType.domain, startLabel: 'Oct 4'), charts.LineAnnotationSegment( DateTime(2017, 10, 15), charts.RangeAnnotationAxisType.domain, endLabel: 'Oct 15'), ]), ]); } /// Create one series with sample hard coded data. static List> _createSampleData() { final data = [ TimeSeriesSales(DateTime(2017, 9, 19), 5), TimeSeriesSales(DateTime(2017, 9, 26), 25), TimeSeriesSales(DateTime(2017, 10, 3), 100), TimeSeriesSales(DateTime(2017, 10, 10), 75), ]; return [ 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); }