Flutter网格布局插件eazigrid的使用

Flutter网格布局插件eazigrid的使用

简介

Easy dynamic Flutter row to list/grid. Starts out as a row and resizes to a grid - scaling to dimensions of parent widget.

特性

• 父组件宽度必须明确指定。
• 如果父组件高度未指定，则高度会自动缩放以适应父组件。
• 如果将参数 isScrollable 设置为 true，则子项可以垂直滚动。

开始使用

在 pubspec.yaml 文件中添加依赖包：

dependencies:
  flutter:
    sdk: flutter

  ...
  eazigrid: ^[latest_version]

为了处理自动化测试中的溢出问题，在主方法中添加以下行：

EaziGridFlowHandler.handleEaziError();

使用示例

在父组件中声明 EaziGrid，并确保其宽度不为无穷大（见示例）：

EaziGrid(
  isScrollable: true,
  horizontalAlignment: EaziAlignment.start,
  children: [
    for(int i=0; i<=widget.totalItems; i++)
      TestGridItem(itemIndex: i)
  ]
)

组件参数

• isScrollable: 如果设置为 true，则生成的网格可垂直滚动。
• horizontalAlignment: 通过 EaziAlignment 中定义的选项来对齐每一行的子项。
• verticalAlignment: 通过 EaziAlignment 中定义的选项来对齐网格行。
• children: 所有子项必须是具有显式高度和宽度的小部件。

enum EaziAlignment { start, center, end }

其他信息

欢迎提交问题以请求新功能。如果您想贡献代码，请发送一个 Pull Request。

TODO: 🤔 HAVE FUN 😬

完整示例代码

import 'package:eazigrid/eazigrid.dart';
import 'package:flutter/material.dart';

void main() {
  EaziGridFlowHandler.handleEaziError();
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'EaziGrid Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Eazigrid Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title, this.totalItems = 30}) : super(key: key);

  final String title;
  final double totalItems;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: OverflowBox(
        child: Column(children: [
          Expanded(
            child: EaziGrid(
              isScrollable: true,
              horizontalAlignment: EaziAlignment.start,
              children: [
                for (int i = 0; i <= widget.totalItems; i++)
                  TestGridItem(itemIndex: i)
              ],
            ),
          ),
          Text(
            'EaziGrid',
            style: TextStyle(fontSize: 30),
          )
        ]),
      ),
    );
  }
}

class TestGridItem extends StatelessWidget {
  const TestGridItem({
    Key? key,
    required this.itemIndex,
  }) : super(key: key);

  final int itemIndex;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      decoration: BoxDecoration(
          color: Colors.blue, borderRadius: BorderRadius.circular(8)),
      margin: EdgeInsets.all(10),
      padding: EdgeInsets.all(10),
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        crossAxisAlignment: CrossAxisAlignment.center,
        children: [
          Icon(
            Icons.description,
            color: Colors.white,
          ),
          const SizedBox(
            height: 5,
          ),
          Text(
            '$itemIndex\ntest item',
            textAlign: TextAlign.center,
            style: TextStyle(color: Colors.white),
          )
        ],
      ),
    );
  }
}