阅读 1853
Flutter图表库fl_chart的使用解析(二)-折线图

Flutter图表库fl_chart的使用解析(二)-折线图

Simulator Screen Shot - iPhone 12 Pro Max - 2021-05-04 at 00.31.45

image-20210504004155125

image-20210504004207233

image-20210504004219108

附上开发环境:

MacBook-Pro:~ xun$ flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 2.0.3, on macOS 11.2.3 20D91 darwin-x64, locale
    zh-Hans)
[✓] Android toolchain - develop for Android devices (Android SDK version 30.0.1)
[!] Xcode - develop for iOS and macOS
    ! CocoaPods 1.9.1 out of date (1.10.0 is recommended).
        CocoaPods is used to retrieve the iOS and macOS platform side's plugin
        code that responds to your plugin usage on the Dart side.
        Without CocoaPods, plugins will not work on iOS or macOS.
        For more info, see https://flutter.dev/platform-plugins
      To upgrade see
      https://guides.cocoapods.org/using/getting-started.html#installation for
      instructions.
[✓] Chrome - develop for the web
[✓] Android Studio (version 4.1)
[✓] VS Code (version 1.55.2)
[✓] Connected device (2 available)
复制代码

一 基本集成

折线图是一个 Widget,和普通 Widget一样声明即可:

LineChart(
              sampleData(),
            ),
复制代码

LineChart的构造参数是一个LineChartData,其属性如下:

属性名称描述默认值
lineBarsData图表要展示的线的数组,数组的每一位代表一条线。[]
betweenBarsData填充2条图表线之间的区域[]
titlesData坐标,可以设置四个方向的标题FlTitlesData()
axisTitleData标题FlAxisTitleData()
extraLinesData额外的水平和垂直线的图形细节
lineTouchData触摸交互详细信息LineTouchData()
rangeAnnotations在图表后面显示范围注释,请检查RangeAnnotationsRangeAnnotations()
showingTooltipIndicators根据提供的位置(x)显示工具提示,以及LineBarSpot的列表[]
gridData网格数据FlGridData()
borderData边框数据FlBorderData()
minX获取x轴的最小值x,如果为null,从lineBars中读取值null
maxX获取x轴的最大x,如果为null,从lineBars中读取值null
minY获取y轴的最小y,如果为null,从lineBars中读取值null
maxY获取y轴的最大y,如果为null,从lineBars中读取值null
clipData将图表裁剪到边框(防止绘图超出边框)FlClipData.none()
backgroundColor图表后面绘制的背景色null
  /// 配置文件
  LineChartData sampleData() {
    return LineChartData(
      //? 是否可以点击
      lineTouchData: LineTouchData(
        enabled: enableLineTouchData,
      ),
      //? 网格线配置
      gridData: FlGridData(
        show: showGridData,
      ),
      axisTitleData: _buildFlAxisTitleData(),
      //? 标题
      titlesData: _buildTitles(),
      //? 边框
      borderData: _buildBorderData(),
      minX: 0,
      maxX: 14,
      maxY: 6,
      minY: 0,
      //? 线条数据
      lineBarsData: linesBarDatas(),
    );
  }
复制代码

二 线条配置

配置了三条线,所以lineBarsData对应的数组有三个元素。

//? 绿线的配置
LineChartBarData(
        //? 取样点
        spots: [
          FlSpot(1, 1),
          FlSpot(3, 4),
          FlSpot(5, 1.8),
          FlSpot(7, 5),
          FlSpot(10, 2),
          FlSpot(12, 2.2),
          FlSpot(13, 1.8),
        ],
        //? 是否是曲线
        isCurved: isCurved1,
        // curveSmoothness: 0,
        colors: const [
          Color(0x444af699),
        ],
        //? 线的宽度
        barWidth: 4,
        //? 线头是否是圆形
        isStrokeCapRound: true,
        //? 是否显示数据点
        dotData: FlDotData(
          show: false,
        ),
        //? 是否显示线上区域
        aboveBarData: BarAreaData(show: showAboveBarData, colors: [
          const Color(0x444af699),
        ]),
      )
复制代码

看下LineChartBarData属性:

属性名称描述默认值
show是否显示或隐藏线条True
spots要展示的线条数据点,参考 FlSpot[]
colors线条颜色,如果提供了多种颜色,则将为渐变色[Colors.redAccent]
colorStops获取渐变颜色的停止位置,了解更多null
gradientFrom确定渐变梯度的开始,每个数字应介于0和1之间。阅读更多Offset(0,0)
gradientTo确定渐变的结束,每个数字应介于0和1之间。阅读更多Offset(1,0)
barWidth线条的宽度2.0
isCurved是平滑曲线还是折线false
curveSmoothness曲线角的平滑度半径(当isCurved为true时起作用)0.35
preventCurveOverShooting防止在线性序列点上绘制曲线时出现过冲,请检查此问题false
preventCurveOvershootingThreshold应用防止过冲算法的阈值10.0
isStrokeCapRound确定条形线的起点和终点是直角头还是圆头false
belowBarData线条下面填充,参考BarAreaDataBarAreaData
aboveBarData线条上面填充,参考BarAreaData](github.com/imaNNeoFigh…)BarAreaData
dotData数据点,参考FlDotDataFlDotData()
showingIndicators根据提供的索引显示坐标[]
dashArray破折号偏移量和长度的圆形数组。例如,该数组[5, 10]将导致长5像素的短划线,然后是10像素长的空白。该阵列[5, 10, 5]将导致5像素破折号,10像素破折号,5像素破折号,5像素破折号,10像素破折号等。Null
shadow线条阴影,参见“阴影”阴影()
isStepLineChart如果设置为true,则使用绘制“折线图”样式的图表lineChartStepDatafalse
lineChartStepData保存用于表示步骤折线图的数据,并且仅在[isStepChart]为true时才有效。LineChartStepData()

三 边框配置

图表四个方向的边框,有总显示开关,决定是否显示和隐藏所有,如果开启,又想隐藏个别边框,需要设置透明色。

 //? 边框信息
  FlBorderData _buildBorderData() {
    return FlBorderData(
        show: showBorderData,
        border: Border(
          bottom: showBottomBorder
              ? BorderSide(
                  color: Color(0xff4e4965),
                  width: 4,
                )
              : BorderSide(
                  color: Colors.transparent,
                ),
          left: showLeftBorder
              ? BorderSide(
                  color: Color(0xff4e4965),
                  width: 2,
                )
              : BorderSide(
                  color: Colors.transparent,
                ),
          right: BorderSide(
            color: Colors.transparent,
          ),
          top: BorderSide(
            color: Colors.transparent,
          ),
        ));
  }
复制代码

FlBorderData对应边框信息,有两个参数,show就是显示与隐藏的边框,border是边框数据。

四 坐标轴配置

FlTitlesData可以配置4条坐标轴,也有一个总开关,如果要显示坐标轴,就设为true,然后配置对应位置的数据:

  //? 坐标配置
  FlTitlesData _buildTitles() {
    return FlTitlesData(
      //? 下边标题
      bottomTitles: _buildBottomTitle(),
      //? 左侧标题
      leftTitles: _buildLeftTitle(),
    );
  }
复制代码

每个位置对应的是SideTitles,设置如下:

 SideTitles _buildLeftTitle() {
    return SideTitles(
      showTitles: showlLeftTitles,
      getTextStyles: (value) => const TextStyle(
        color: Color(0xff75729e),
        fontWeight: FontWeight.bold,
        fontSize: 14,
      ),
      getTitles: (value) {
        switch (value.toInt()) {
          case 1:
            return '1m';
          case 2:
            return '2m';
          case 3:
            return '3m';
          case 4:
            return '5m';
          case 5:
            return '6m';
        }
        return '';
      },
      margin: 8,
      reservedSize: 30,
    );
  }
复制代码
属性名称描述默认值
showTitles确定是显示还是隐藏标题false
getTitles该函数可检索相关轴上具有给定值的标题,如果要通过显示大数字的指示符来设置数字格式器,请不要触摸它。defaultGetTitle
reservedSize保留的标题空间,如果设置axisTitleData,这里要留出空间,不然会重叠22
textStyle文字属性TextStyle the style to use for title textTextStyle(color: Colors.black, fontSize: 11)
margin文字和边框的间距6
interval间隔几个坐标显示null
rotateAngle旋转标题的顺时针角度0.0
checkToShowTitle确定以提供的值显示或不显示标题show all

五 标题配置

标题是显示在坐标轴后面的文字标题,每个轴对应一个。

  //? 标题配置
  FlAxisTitleData _buildFlAxisTitleData() {
    return FlAxisTitleData(
      leftTitle: AxisTitle(titleText: "侧轴标题", showTitle: showAxisLeftTitle),
      bottomTitle: AxisTitle(titleText: "底部标题", showTitle: showAxisBottomTitle),
    );
  }
复制代码

六 配置触摸

复制代码
属性名称描述默认值
enabled是否允许触摸行为true
touchTooltipData一个LineTouchTooltipData,它确定如何显示在触摸点的顶部工具提示(表示该工具提示气泡的外观)LineTouchTooltipData
getTouchedSpotIndicator回调的检索列表TouchedSpotIndicatorData由给定列表LineBarSpot用于显示上触摸点的指标defaultTouchedIndicators
touchSpotThreshold触摸精度的阈值10
handleBuiltInTouches如果您想要内置的触摸处理功能,请将其设置为true(在提示的位置上显示工具提示气泡和指示符)true
getTouchLineStart控制线条的起点,默认值是图表的底部defaultGetTouchLineStart
getTouchLineEnd控制线的结束位置,默认为接触点defaultGetTouchLineEnd
touchCallback侦听此回调以检索触摸事件,它提供了LineTouchResponsenull

附上源码

文章分类
Android
文章标签