Flutter 堆叠卡片轮播插件 stacked_cards_carousel 的使用

一个用于在 Flutter 中以堆叠卡片格式显示任意组件的插件。该插件可用于创建视觉上吸引人且交互性强的轮播展示产品、图像或其他类型的内容。

功能

• 以堆叠卡片格式显示任意组件
• 可自定义堆叠层数
• 循环模式以实现连续滚动
• 简单易用的 API

安装

要将此插件添加到您的 Flutter 项目中，请在 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  stacked_cards_carousel: ^1.0.0

然后运行 flutter pub get 来安装它。

使用示例

以下是一个简单的示例，展示了如何使用 StackedCardsCarouselWidget 插件来创建一个堆叠卡片轮播组件。

import 'dart:math';

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: '堆叠卡片轮播演示',
      home: MyHomePage(title: '堆叠卡片轮播演示'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  // 随机颜色生成器
  Color randomColorGenerator() {
    return Color((Random().nextDouble() * 0xFFFFFF).toInt()).withOpacity(1.0);
  }

  // 卡片的高度和宽度
  double height = 300;
  double width = 200;
  
  // 轮播中卡片的数量
  int numberOfItems = 3;
  
  // 存储卡片的列表
  List<Widget> items = [];

  @override
  void initState() {
    // 初始化卡片列表
    for (int i = 0; i < numberOfItems; i++) {
      items.add(
        Container(
          height: height,
          width: width,
          color: randomColorGenerator(),
          child: Center(
            child: Text(
              '卡片 $i',
              style: const TextStyle(color: Colors.white),
            ),
          ),
        ),
      );
    }

    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: StackedCardsCarouselWidget(
          items: items,
        ),
      ),
    );
  }
}

代码解释

1. 导入必要的包

   import 'dart:math';
   import 'package:flutter/material.dart';
   import 'package:stacked_cards_carousel/stacked_cards_carousel.dart';
   

2. 主应用类

   void main() {
     runApp(const MyApp());
   }
   
   class MyApp extends StatelessWidget {
     const MyApp({super.key});
   
     @override
     Widget build(BuildContext context) {
       return const MaterialApp(
         title: '堆叠卡片轮播演示',
         home: MyHomePage(title: '堆叠卡片轮播演示'),
       );
     }
   }
   

3. 主页面类

   class MyHomePage extends StatefulWidget {
     const MyHomePage({super.key, required this.title});
   
     final String title;
   
     @override
     State<MyHomePage> createState() => _MyHomePageState();
   }
   

4. 状态管理类

   class _MyHomePageState extends State<MyHomePage> {
     Color randomColorGenerator() {
       return Color((Random().nextDouble() * 0xFFFFFF).toInt()).withOpacity(1.0);
     }
   
     double height = 300;
     double width = 200;
     int numberOfItems = 3;
     List<Widget> items = [];
   
     @override
     void initState() {
       for (int i = 0; i < numberOfItems; i++) {
         items.add(
           Container(
             height: height,
             width: width,
             color: randomColorGenerator(),
             child: Center(
               child: Text(
                 '卡片 $i',
                 style: const TextStyle(color: Colors.white),
               ),
             ),
           ),
         );
       }
       super.initState();
     }
   
     @override
     Widget build(BuildContext context) {
       return Scaffold(
         appBar: AppBar(
           title: Text(widget.title),
         ),
         body: Center(
           child: StackedCardsCarouselWidget(
             items: items,
           ),
         ),
       );
     }
   }