Flutter图片轮播插件mj_image_slider的使用

支持的平台

• Flutter Android
• Flutter iOS
• Flutter Web
• Flutter 桌面

安装

在你的 pubspec.yaml 文件中添加 mj_image_slider: 依赖项，并导入它：

import 'package:mj_image_slider/MJOptions.dart';
import 'package:mj_image_slider/mj_image_slider.dart';

如何使用

简单地创建一个 MJImageSlider 小部件，并传递所需的参数：

List<String> images = [
  "assets/images/images_1.jpg",
  "assets/images/images_2.jpg",
  "assets/images/images_3.jpg",
  "assets/images/images_4.jpg",
];

MJImageSlider(
  options: MjOptions(height: 200.0, width: 400.0),
  widgets: [...images.map((e) => Image(image: AssetImage(e))).toList()],
)

参数

你可以通过传递不同的参数来自定义滑块的行为。以下是一些常用的参数：

MJImageSlider(
  options: MjOptions(
    height: 200.0, // 滑块的高度
    width: 400.0, // 滑块的宽度
    aspectRatio: 16 / 9, // 图片的宽高比
    viewportFraction: 0.8, // 当前页面占据视口的比例
    initialPage: 0, // 初始页面
    enableInfiniteScroll: true, // 是否启用无限滚动
    autoPlayInterval: Duration(seconds: 3), // 自动播放间隔时间
    autoPlayAnimationDuration: Duration(milliseconds: 800), // 自动播放动画持续时间
    autoPlayCurve: Curves.fastOutSlowIn, // 自动播放曲线
    onPageChanged: callbackFunction, // 页面改变时的回调函数
    scrollDirection: Axis.horizontal, // 滚动方向
  ),
  widgets: widgets,
)

完整示例

以下是一个完整的示例代码，展示了如何在 Flutter 应用程序中使用 mj_image_slider 插件。

import 'package:flutter/material.dart';
import 'package:mj_image_slider/MJOptions.dart';
import 'package:mj_image_slider/mj_image_slider.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(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

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

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  List<String> images = [
    "assets/images/images_1.jpg",
    "assets/images/images_2.jpg",
    "assets/images/images_3.jpg",
    "assets/images/images_4.jpg",
  ];

  List<String> networkImages = [
    "https://images.unsplash.com/reserve/bOvf94dPRxWu0u3QsPjF_tree.jpg?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=1176&q=80",
    "https://images.unsplash.com/photo-1546587348-d12660c30c50?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=1174&q=80",
    "https://images.unsplash.com/photo-1476514525535-07fb3b4ae5f1?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=1170&q=80",
    "https://images.unsplash.com/photo-1525127752301-99b0b6379811?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=1170&q=80",
  ];

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: SingleChildScrollView(
        child: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Wrap(
            crossAxisAlignment: WrapCrossAlignment.center,
            children: [
              MJImageSlider(
                options: MjOptions(
                  onPageChanged: (i) {},
                  scrollDirection: Axis.vertical,
                  height: 200,
                  width: 400,
                  viewportFraction: 4.0,
                ),
                widgets: [...images.map((e) => Image(image: AssetImage(e))).toList()],
              ),
              const SizedBox(
                width: 32,
              ),
              MJImageSlider(
                options: MjOptions(
                  onPageChanged: (i) {},
                  enableInfiniteScroll: false,
                  autoPlayCurve: Curves.easeInToLinear,
                  height: 200,
                  width: 400,
                  viewportFraction: 1.0,
                ),
                widgets: [...networkImages.map((e) => Image(image: NetworkImage(e))).toList()],
              ),
              const SizedBox(
                width: 32,
              ),
              MJImageSlider(
                options: MjOptions(
                  onPageChanged: (i) {},
                  autoPlayCurve: Curves.easeInExpo,
                  height: 200,
                  width: 400,
                  viewportFraction: 0.8,
                ),
                widgets: [...networkImages.map((e) => Image(image: NetworkImage(e))).toList()],
              ),
            ],
          ),
        ),
      ),
    );
  }
}