// 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 stacked area chart with null measure values. /// /// Null values will be visible as gaps in lines and area skirts. Any data /// points that exist between two nulls in a line will be rendered as an /// isolated point, as seen in the green series. /// /// In a stacked area chart, no data above a null value in the stack will be /// rendered. In this example, the null measure value at domain 2 in the Desktop /// series will prevent any data from being rendered at domain 2 for every /// series because it is at the bottom of the stack. /// /// This will also result in an isolated point being rendered for the domain /// value 3 in the Mobile series, because that series also contains a null at /// domain 4. // 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 StackedAreaNullsLineChart extends StatelessWidget { final List> seriesList; final bool? animate; const StackedAreaNullsLineChart(this.seriesList, {this.animate, Key? key}) : super(key: key); /// Creates a [LineChart] with sample data and no transition. factory StackedAreaNullsLineChart.withSampleData() { return StackedAreaNullsLineChart( _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 StackedAreaNullsLineChart.withRandomData() { return StackedAreaNullsLineChart(_createRandomData()); } /// Create random data. static List> _createRandomData() { final random = Random(); final myFakeDesktopData = [ LinearSales(0, random.nextInt(100)), LinearSales(1, random.nextInt(100)), LinearSales(2, null), LinearSales(3, random.nextInt(100)), LinearSales(4, random.nextInt(100)), LinearSales(5, random.nextInt(100)), LinearSales(6, random.nextInt(100)), ]; var myFakeTabletData = [ LinearSales(0, random.nextInt(100)), LinearSales(1, random.nextInt(100)), LinearSales(2, random.nextInt(100)), LinearSales(3, random.nextInt(100)), LinearSales(4, random.nextInt(100)), LinearSales(5, random.nextInt(100)), LinearSales(6, random.nextInt(100)), ]; var myFakeMobileData = [ LinearSales(0, random.nextInt(100)), LinearSales(1, random.nextInt(100)), LinearSales(2, random.nextInt(100)), LinearSales(3, random.nextInt(100)), LinearSales(4, null), LinearSales(5, random.nextInt(100)), LinearSales(6, random.nextInt(100)), ]; return [ charts.Series( id: 'Desktop', colorFn: (_, __) => charts.MaterialPalette.blue.shadeDefault, domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: myFakeDesktopData, ), charts.Series( id: 'Tablet', colorFn: (_, __) => charts.MaterialPalette.red.shadeDefault, domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: myFakeTabletData, ), charts.Series( id: 'Mobile', colorFn: (_, __) => charts.MaterialPalette.green.shadeDefault, domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: myFakeMobileData, ), ]; } // EXCLUDE_FROM_GALLERY_DOCS_END @override Widget build(BuildContext context) { return charts.LineChart(seriesList, defaultRenderer: charts.LineRendererConfig(includeArea: true, stacked: true), animate: animate); } /// Create one series with sample hard coded data. static List> _createSampleData() { final myFakeDesktopData = [ LinearSales(0, 5), LinearSales(1, 15), LinearSales(2, null), LinearSales(3, 75), LinearSales(4, 100), LinearSales(5, 90), LinearSales(6, 75), ]; final myFakeTabletData = [ LinearSales(0, 5), LinearSales(1, 15), LinearSales(2, 25), LinearSales(3, 75), LinearSales(4, 100), LinearSales(5, 90), LinearSales(6, 75), ]; final myFakeMobileData = [ LinearSales(0, 5), LinearSales(1, 15), LinearSales(2, 25), LinearSales(3, 75), LinearSales(4, null), LinearSales(5, 90), LinearSales(6, 75), ]; return [ charts.Series( id: 'Desktop', colorFn: (_, __) => charts.MaterialPalette.blue.shadeDefault, domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: myFakeDesktopData, ), charts.Series( id: 'Tablet', colorFn: (_, __) => charts.MaterialPalette.red.shadeDefault, domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: myFakeTabletData, ), charts.Series( id: 'Mobile', colorFn: (_, __) => charts.MaterialPalette.green.shadeDefault, domainFn: (LinearSales sales, _) => sales.year, measureFn: (LinearSales sales, _) => sales.sales, data: myFakeMobileData, ), ]; } } /// Sample linear data type. class LinearSales { final int year; final int? sales; LinearSales(this.year, this.sales); }