Flutter轮播图插件sing_swiper的使用

安装

在项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
   sing_swiper: ^0.0.1

flutter_swiper 是 flutter 最强大的轮播插件之一，支持多种布局方式、无限轮播，并且能够在 Android 和 iOS 上完美适配。

基本参数

以下是 Swiper 的一些常用参数及默认值：

分页指示器

分页指示器通过 SwiperPlugin 提供，可以使用 new SwiperPagination() 来展示默认分页指示器。

参数表

自定义分页指示器

如果需要自定义分页指示器，可以这样实现：

new Swiper(
  pagination: new SwiperCustomPagination(
    builder: (BuildContext context, SwiperPluginConfig config) {
      return new Row(
        mainAxisAlignment: MainAxisAlignment.center,
        children: List.generate(config.itemCount, (index) {
          return Container(
            width: 10.0,
            height: 10.0,
            margin: EdgeInsets.symmetric(horizontal: 5.0),
            decoration: BoxDecoration(
              shape: BoxShape.circle,
              color: config.activeIndex == index ? Colors.blue : Colors.grey,
            ),
          );
        }),
      );
    },
  ),
);

控制按钮

控制按钮同样通过 SwiperPlugin 提供，使用 new SwiperControl() 展示默认控制按钮。

参数表

控制器（SwiperController）

SwiperController 用于控制轮播图的当前下标、启动和停止自动播放。创建一个 SwiperController 实例并保存，以便将来使用。

方法

自动播放

自动播放的相关参数：

内建布局

Swiper 提供了多种内置布局方式，方便快速实现不同效果。

示例代码

水平布局（Default）

new Swiper(
  itemBuilder: (BuildContext context, int index) {
    return new Image.network(
      "http://via.placeholder.com/288x188",
      fit: BoxFit.fill,
    );
  },
  itemCount: 10,
  viewportFraction: 0.8,
  scale: 0.9,
)

栈布局（Stack）

new Swiper(
  itemBuilder: (BuildContext context, int index) {
    return new Image.network(
      "http://via.placeholder.com/288x188",
      fit: BoxFit.fill,
    );
  },
  itemCount: 10,
  itemWidth: 300.0,
  layout: SwiperLayout.STACK,
)

扑克牌布局（Tinder）

new Swiper(
  itemBuilder: (BuildContext context, int index) {
    return new Image.network(
      "http://via.placeholder.com/288x188",
      fit: BoxFit.fill,
    );
  },
  itemCount: 10,
  itemWidth: 300.0,
  itemHeight: 400.0,
  layout: SwiperLayout.TINDER,
)

自定义布局

new Swiper(
  layout: SwiperLayout.CUSTOM,
  customLayoutOption: new CustomLayoutOption(
      startIndex: -1,
      stateCount: 3
  ).addRotate([
    -45.0 / 180,
    0.0,
    45.0 / 180
  ]).addTranslate([
    new Offset(-370.0, -40.0),
    new Offset(0.0, 0.0),
    new Offset(370.0, -40.0)
  ]),
  itemWidth: 300.0,
  itemHeight: 200.0,
  itemBuilder: (context, index) {
    return new Container(
      color: Colors.grey,
      child: new Center(
        child: new Text("$index"),
      ),
    );
  },
  itemCount: 10)

完整示例代码

以下是一个完整的示例代码，展示了如何使用 sing_swiper 插件实现轮播图。

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: const MyHomePage(title: 'Flutter Swiper'),
    );
  }
}

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

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(widget.title)),
      body: Center(
        child: Swiper(
          autoplay: true,
          itemCount: 5,
          itemBuilder: (BuildContext context, int index) {
            return Image.network(
              "https://picsum.photos/200/300?random=$index",
              fit: BoxFit.cover,
            );
          },
          pagination: const SwiperPagination(),
          control: const SwiperControl(),
        ),
      ),
    );
  }
}