Flutter可扩展数据表格插件expandable_datatable_2的使用

Flutter可扩展数据表格插件expandable_datatable_2的使用

ExpandableDataTable 是一个用于在 Flutter 中处理数据表显示和编辑的库。它可以支持行排序、灵活的列大小、可展开的行、分页、可编辑的行、自定义编辑对话框、自定义分页小部件以及自定义扩展内容。

特性

• 行排序
• 灵活的列大小
• 可展开的行
• 分页
• 可编辑的行
• 自定义编辑对话框
• 自定义分页小部件
• 自定义扩展内容
• 行和头部列的样式

ExpandableDataTable 参数

ExpandableThemeData 参数

使用方法

1. 添加依赖

在 pubspec.yaml 文件中添加 expandable_datatable 作为依赖项。

dependencies:
  expandable_datatable: ^1.0.0

2. 导入包

在你的 Dart 文件中导入 expandable_datatable 包。

import 'package:expandable_datatable/expandable_datatable.dart';

3. 创建数据

创建用于数据表的头部列表和行列表。

List<ExpandableColumn<dynamic>> headers = [
  ExpandableColumn<int>(columnTitle: "ID", columnFlex: 1),
  ExpandableColumn<String>(columnTitle: "First name", columnFlex: 2),
  ExpandableColumn<String>(columnTitle: "Last name", columnFlex: 2),
  ExpandableColumn<String>(columnTitle: "Maiden name", columnFlex: 2),
  ExpandableColumn<int>(columnTitle: "Age", columnFlex: 1),
  ExpandableColumn<String>(columnTitle: "Gender", columnFlex: 2),
  ExpandableColumn<String>(columnTitle: "Email", columnFlex: 4),
];

List<ExpandableRow> rows = userList.map<ExpandableRow>((e) {
  return ExpandableRow(cells: [
    ExpandableCell<int>(columnTitle: "ID", value: e.id),
    ExpandableCell<String>(columnTitle: "First name", value: e.firstName),
    ExpandableCell<String>(columnTitle: "Last name", value: e.lastName),
    ExpandableCell<String>(columnTitle: "Maiden name", value: e.maidenName),
    ExpandableCell<int>(columnTitle: "Age", value: e.age),
    ExpandableCell<String>(columnTitle: "Gender", value: e.gender),
    ExpandableCell<String>(columnTitle: "Email", value: e.email),
  ]);
}).toList();

4. 构建数据表格

在 build 方法中构建 ExpandableDataTable 小部件。

void createDataSource() {...}

[@override](/user/override)
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(
      title: const Text("Expandable Datatable Example"),
    ),
    body: ExpandableTheme(
      data: ExpandableThemeData(
        context,
        rowBorder: const BorderSide(color: Colors.amber),
        expandedBorderColor: Colors.transparent,
        paginationSize: 48,
      ),
      child: ExpandableDataTable(
        rows: rows,
        headers: headers,
        visibleColumnCount: 4,
      ),
    ),
  );
}

示例代码

以下是一个完整的示例代码，展示了如何使用 expandable_datatable 插件。

import 'dart:convert';

import 'package:expandable_datatable/expandable_datatable.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

import 'model/models.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: const HomePage(),
      theme: ThemeData.light(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  List<Users> userList = [];

  late List<ExpandableColumn<dynamic>> headers;
  late List<ExpandableRow> rows;

  bool _isLoading = true;

  void setLoading() {
    setState(() {
      _isLoading = false;
    });
  }

  [@override](/user/override)
  void initState() {
    super.initState();

    fetch();
  }

  void fetch() async {
    userList = await getUsers();

    createDataSource();

    setLoading();
  }

  Future<List<Users>> getUsers() async {
    final String response = await rootBundle.loadString('asset/dumb.json');

    final data = await json.decode(response);

    API apiData = API.fromJson(data);

    if (apiData.users != null) {
      return apiData.users!;
    }

    return [];
  }

  void createDataSource() {
    headers = [
      ExpandableColumn<int>(columnTitle: "ID", columnFlex: 1),
      ExpandableColumn<String>(columnTitle: "First name", columnFlex: 2),
      ExpandableColumn<String>(columnTitle: "Last name", columnFlex: 2),
      ExpandableColumn<String>(columnTitle: "Maiden name", columnFlex: 2),
      ExpandableColumn<int>(columnTitle: "Age", columnFlex: 1),
      ExpandableColumn<String>(columnTitle: "Gender", columnFlex: 1),
      ExpandableColumn<String>(columnTitle: "Email", columnFlex: 4),
    ];

    rows = userList.map<ExpandableRow>((e) {
      return ExpandableRow(cells: [
        ExpandableCell<int>(columnTitle: "ID", value: e.id),
        ExpandableCell<String>(columnTitle: "First name", value: e.firstName),
        ExpandableCell<String>(columnTitle: "Last name", value: e.lastName),
        ExpandableCell<String>(columnTitle: "Maiden name", value: e.maidenName),
        ExpandableCell<int>(columnTitle: "Age", value: e.age),
        ExpandableCell<String>(columnTitle: "Gender", value: e.gender),
        ExpandableCell<String>(columnTitle: "Email", value: e.email),
      ]);
    }).toList();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: SafeArea(
        child: !_isLoading
            ? LayoutBuilder(builder: (context, constraints) {
                int visibleCount = 3;
                if (constraints.maxWidth < 600) {
                  visibleCount = 3;
                } else if (constraints.maxWidth < 800) {
                  visibleCount = 4;
                } else if (constraints.maxWidth < 1000) {
                  visibleCount = 5;
                } else {
                  visibleCount = 6;
                }

                return ExpandableTheme(
                  data: ExpandableThemeData(
                    context,
                    contentPadding: const EdgeInsets.all(20),
                    expandedBorderColor: Colors.transparent,
                    paginationSize: 48,
                    headerHeight: 56,
                    headerColor: Colors.amber[400],
                    headerBorder: const BorderSide(
                      color: Colors.black,
                      width: 1,
                    ),
                    evenRowColor: const Color(0xFFFFFFFF),
                    oddRowColor: Colors.amber[200],
                    rowBorder: const BorderSide(
                      color: Colors.black,
                      width: 0.3,
                    ),
                    rowColor: Colors.green,
                    headerTextMaxLines: 4,
                    headerSortIconColor: const Color(0xFF6c59cf),
                    paginationSelectedFillColor: const Color(0xFF6c59cf),
                    paginationSelectedTextColor: Colors.white,
                  ),
                  child: ExpandableDataTable(
                    headers: headers,
                    rows: rows,
                    multipleExpansion: false,
                    isEditable: false,
                    onRowChanged: (newRow) {
                      print(newRow.cells[01].value);
                    },
                    onPageChanged: (page) {
                      print(page);
                    },
                    renderEditDialog: (row, onSuccess) => _buildEditDialog(row, onSuccess),
                    visibleColumnCount: visibleCount,
                  ),
                );
              })
            : const Center(child: CircularProgressIndicator()),
      ),
    );
  }

  Widget _buildEditDialog(
      ExpandableRow row, Function(ExpandableRow) onSuccess) {
    return AlertDialog(
      title: SizedBox(
        height: 300,
        child: TextButton(
          child: const Text("Change name"),
          onPressed: () {
            row.cells[1].value = "x3";
            onSuccess(row);
          },
        ),
      ),
    );
  }
}