πŸ“„ README.md

# πŸ“¦ flexible_data_view

A powerful and customizable Flutter widget for displaying data in multiple flexible formats including **ListView**, **GridView**, **Slideshow (PageView)**, and **TableView**. Easily switch between views, customize each card, scroll direction, and even enable auto-slideshow with no external dependencies like `carousel_slider`.

---

## ✨ Features

- βœ… List, Grid, Slideshow (PageView), and Table support
- 🎨 Customizable card widget using `itemBuilder`
- πŸ” Auto-slideshow with configurable interval
- ↕️ Vertical or horizontal scroll direction
- πŸ“ Grid cross-axis customization
- πŸ“Š Table layout with headers and rows
- 🧱 Lightweight and no third-party dependencies

---

## πŸš€ Getting Started

Add the dependency in your `pubspec.yaml`:

```yaml
dependencies:
  flexible_data_view: ^1.0.0

🧩 Usage

Import

import 'package:flexible_data_view/flexible_data_view.dart';

πŸ’‘ Example

FlexibleDataView<String>(
  data: ['Apple', 'Banana', 'Cherry'],
  viewType: ViewType.grid,
  gridCrossAxisCount: 2,
  scrollDirection: Axis.vertical,
  autoSlide: true,
  slideInterval: const Duration(seconds: 3),
  itemBuilder: (item, index) => Card(
    child: Center(
      child: Text(item),
    ),
  ),
)

πŸ—‚ ViewType Options

enum ViewType {
  list,
  grid,
  slideshow,
  table,
}

πŸ“Š Table Example

FlexibleTableView(
  headers: ['Name', 'Age'],
  rows: [
    ['Alice', '25'],
    ['Bob', '30'],
  ],
)

πŸ“Έ Screenshots

List View Grid View Slideshow Table
βœ… βœ… βœ… βœ…

πŸ“ Example Project

Check the full example in the example folder or run:

cd example
flutter run

πŸ§ͺ Run Tests

flutter test

πŸ’Ό Maintainer

Developed & maintained by Md.Rahul Reza πŸ“« For any inquiries, issues, or feature requests, please contact via website.


πŸ“„ License

MIT License


Libraries

flexible_data_view