// 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. /// Bar chart with example of a legend with customized position, justification, /// desired max rows, padding, and entry text styles. These options are shown as /// an example of how to use the customizations, they do not necessary have to /// be used together in this way. Choosing [end] as the position does not /// require the justification to also be [endDrawArea]. // EXCLUDE_FROM_GALLERY_DOCS_START import 'dart:math'; // EXCLUDE_FROM_GALLERY_DOCS_END import 'package:flutter/material.dart'; import 'package:charts_flutter/flutter.dart' as charts; class LegendOptions extends StatelessWidget { final List seriesList; final bool animate; const LegendOptions(this.seriesList, {this.animate, Key key}) : super(key: key); factory LegendOptions.withSampleData() { return LegendOptions( _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 LegendOptions.withRandomData() { return LegendOptions(_createRandomData()); } /// Create random data. static List> _createRandomData() { final random = Random(); final desktopSalesData = [ OrdinalSales('2014', 5), OrdinalSales('2015', 25), OrdinalSales('2016', 100), OrdinalSales('2017', 75), ]; final tabletSalesData = [ OrdinalSales('2014', random.nextInt(100)), OrdinalSales('2015', random.nextInt(100)), OrdinalSales('2016', random.nextInt(100)), OrdinalSales('2017', random.nextInt(100)), ]; final mobileSalesData = [ OrdinalSales('2014', random.nextInt(100)), OrdinalSales('2015', random.nextInt(100)), OrdinalSales('2016', random.nextInt(100)), OrdinalSales('2017', random.nextInt(100)), ]; final otherSalesData = [ OrdinalSales('2014', random.nextInt(100)), OrdinalSales('2015', random.nextInt(100)), OrdinalSales('2016', random.nextInt(100)), OrdinalSales('2017', random.nextInt(100)), ]; return [ charts.Series( id: 'Desktop', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: desktopSalesData, ), charts.Series( id: 'Tablet', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: tabletSalesData, ), charts.Series( id: 'Mobile', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: mobileSalesData, ), charts.Series( id: 'Other', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: otherSalesData, ), ]; } // EXCLUDE_FROM_GALLERY_DOCS_END @override Widget build(BuildContext context) { return charts.BarChart( seriesList, animate: animate, barGroupingType: charts.BarGroupingType.grouped, // Add the legend behavior to the chart to turn on legends. // This example shows how to change the position and justification of // the legend, in addition to altering the max rows and padding. behaviors: [ charts.SeriesLegend( // Positions for "start" and "end" will be left and right respectively // for widgets with a build context that has directionality ltr. // For rtl, "start" and "end" will be right and left respectively. // Since this example has directionality of ltr, the legend is // positioned on the right side of the chart. position: charts.BehaviorPosition.end, // For a legend that is positioned on the left or right of the chart, // setting the justification for [endDrawArea] is aligned to the // bottom of the chart draw area. outsideJustification: charts.OutsideJustification.endDrawArea, // By default, if the position of the chart is on the left or right of // the chart, [horizontalFirst] is set to false. This means that the // legend entries will grow as new rows first instead of a new column. horizontalFirst: false, // By setting this value to 2, the legend entries will grow up to two // rows before adding a new column. desiredMaxRows: 2, // This defines the padding around each legend entry. cellPadding: const EdgeInsets.only(right: 4.0, bottom: 4.0), // Render the legend entry text with custom styles. entryTextStyle: charts.TextStyleSpec( color: charts.MaterialPalette.purple.shadeDefault, fontFamily: 'Georgia', fontSize: 11), ) ], ); } /// Create series list with multiple series static List> _createSampleData() { final desktopSalesData = [ OrdinalSales('2014', 5), OrdinalSales('2015', 25), OrdinalSales('2016', 100), OrdinalSales('2017', 75), ]; final tabletSalesData = [ OrdinalSales('2014', 25), OrdinalSales('2015', 50), OrdinalSales('2016', 10), OrdinalSales('2017', 20), ]; final mobileSalesData = [ OrdinalSales('2014', 10), OrdinalSales('2015', 15), OrdinalSales('2016', 50), OrdinalSales('2017', 45), ]; final otherSalesData = [ OrdinalSales('2014', 20), OrdinalSales('2015', 35), OrdinalSales('2016', 15), OrdinalSales('2017', 10), ]; return [ charts.Series( id: 'Desktop', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: desktopSalesData, ), charts.Series( id: 'Tablet', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: tabletSalesData, ), charts.Series( id: 'Mobile', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: mobileSalesData, ), charts.Series( id: 'Other', domainFn: (OrdinalSales sales, _) => sales.year, measureFn: (OrdinalSales sales, _) => sales.sales, data: otherSalesData, ), ]; } } /// Sample ordinal data type. class OrdinalSales { final String year; final int sales; OrdinalSales(this.year, this.sales); }