搜尋套件、儲存庫與 APP 分類

flutter_echarts 封面
套件詳情v2.5.0

flutter_echarts

一個基於 Apache ECharts 的資料視覺化圖表庫,能夠建立進階圖表,例如 WebGL 3D、GIS 地圖等。

AndroidiOSmacOS
近 30 天下載
5490
喜歡數
578
Pub 分數
130

安裝套件

flutter pub add flutter_echarts

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

flutter_echarts 是一個強大的資料視覺化程式庫,基於 Apache ECharts 建構。它讓開發者能夠建立進階圖表,例如 WebGL 3D 視覺化與互動式 GIS 地圖。此套件支援多個平台,包含 Android、iOS 與 macOS,直接在 Flutter 應用中提供豐富且動態的圖表功能。透過簡單的 pub 命令即可實現無縫整合,非常適合需要高效率、功能齊全的資料呈現應用。

適用情境

  • 互動式儀表板
  • 地理空間資料映射
  • 3D 數據可視化
  • 即時分析顯示
  • 移動應用中的複雜圖表渲染

主要特色

  • 支援 WebGL 3D 圖表
  • 內建GIS地圖整合
  • 高效能渲染
  • 跨平台相容性
  • 豐富的圖表類型

適合對象

  • 數據密集型應用
  • 分析平台
  • 移動GIS工具
  • 工程與科學應用程式
  • 企業儀表板開發

使用建議

  • 需要了解 ECharts 設定
  • 由於內建資源,可能會增加應用程式大小
  • 效能取決於裝置硬體
  • 有限的原生 Flutter 小部件整合
  • 初學者的學習曲線更陡峭

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Archiving Note

After many years, this project, as a transitional solution using Webview, has completed its historical mission and is therefore being archived. We recommend Graphic or other native chart libraries as alternatives.

中文

*A Flutter widget to use [Apache ECharts](https://github.com/apache/incubator-echarts) in a reactive way.*

Features

Reactive Updating

The most exciting feature of Flutter widgets and React components is that the view can update reactively when data changes. Thanks to ECharts' data driven architecture, flutter_echarts implements a reactive way to connect charts with data. The charts automatically re-render when data in the option property changes.

Two Way Communication

The onMessage and extraScript properties provide a way to set two-way event communication between Flutter and JavaScript.

Configurable Extensions

ECharts has a lot of extensions. The extensions property allows you to inject the extension scripts as raw strings. In this way, you can copy these scripts to your source code without being confusing by assets dirs.

Installing

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_echarts: #latest version

Now in your Dart code, you can use:

import 'package:flutter_echarts/flutter_echarts.dart';  

Details see pub.dev.

Usage

The flutter_echarts package itself is very simple to use, just like a common statelessWidget:

Details about the option object is in the Echarts docs or Echarts examples.

Container(
  child: Echarts(
  option: '''
    {
      xAxis: {
        type: 'category',
        data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
      },
      yAxis: {
        type: 'value'
      },
      series: [{
        data: [820, 932, 901, 934, 1290, 1330, 1320],
        type: 'line'
      }]
    }
  ''',
  ),
  width: 300,
  height: 250,
)

See the full flutter_echarts_example.

bar boxplot effectScatter funnel gague geo graph heatmap kline line liquid map parallel pie radar scatter wordCloud bar3D line3D sankey scatter3D surface3D themeRiver overlap

Widget Properties

option

String

( required )

ECharts is mainly configured by passing a string value to the JavaScript option property.

You can use jsonEncode() function in dart:convert to convert data in Dart object form:

source: ${jsonEncode(_data1)},

Because JavaScript don't have ''', you can use this operator to reduce some escape operators for quotas:

Echarts(
  option: '''
  
    // option string
    
  ''',
),

To use images in option properties, we suggest the Base64 Data URL :

image: 'data:image/png;base64,iVBORw0KG...',

extraScript

String

JavaScript which will execute after the Echarts.init() and before any chart.setOption(). The widget has a Javascript channel named Messager, so you can use this identifier to send messages from JavaScript to Flutter:

extraScript: '''
  chart.on('click', (params) => {
    if(params.componentType === 'series') {
        Messager.postMessage('anything');
    }
  });
''',

onMessage

void Function(String)?

Function to handle the message sent by Messager.postMessage() in extraScript .

extensions

List<String>

List of strings are from Echarts extensions, such as themes, components, WebGL, and languages. You can download them from the official ECharts extension list. Insert extensions as raw strings:

const liquidPlugin = r'''

  // copy from liquid.min.js

''';

theme

String

You can download built-in ECharts themes or build your own custom themes with the ECharts theme builder. Copy the theme script into the extensions param and register the theme name with this param.

captureAllGestures

bool

( default: false )

Setting captureAllGestures to true is useful when handling 3D rotation and data zoom bars. Note that setting prevents containers like ListViews from reacting to gestures on the charts.

If true, captureHorizontalGestures and captureVerticalGestures are forced true.

captureHorizontalGestures

bool

( default: false )

Only capture horizontal gestures.

captureVerticalGestures

bool

( default: false )

Only capture vertical gestures.

onLoad

void Function(WebViewController)?

The callback when first time the chart is loaded and rendered. You can get the webview controller from this function to do your magic.

reloadAfterInit

bool

( default: false )

If you have trouble in rendering charts in "Movable Widgets"(ListView, SliverView, PageVIew...) on iOS, try setting reloadAfterInit to true .

onWebResourceError

void Function(WebViewController, Exception)?

Handle the web resource error.

Blog

Reactive Echarts Flutter Widget

A performance optimization of Flutter WebView


If you have any suggestions or requests, please open an issue.

The gallery GIF is from chenjiandongx

所屬分類

依賴

依賴清單 1 項

原始碼儲存庫

使用此套件的專案