Flutter插件zero_package的介绍与使用

🔥 Awesome Indicator

Features

• AwesomeIndicator.move
• AwesomeIndicator.fill

Support Platforms

• Flutter Android
• Flutter iOS
• Flutter Web
• Flutter Desktop

Usage

添加插件到 pubspec.yaml

dependencies:
  awesome_indicator: ^<latest-version>

导入插件

import 'package:awesome_indicator/awesome_indicator.dart';

AwesomeIndicator

.move

AwesomeIndicator.move(
  controller: _controller,
);

.fill

AwesomeIndicator.fill(
  controller: _controller,
);

参数说明

Required Parameters

• controller

  AwesomeIndicator.type(
    controller: ScrollController(),
  );
  

Optional Parameters

• scrollDirection
  默认值：Axis.horizontal

  AwesomeIndicator.type(
    scrollDirection: Axis.horizontal,
  );
  

• width
  水平模式下为最大宽度；垂直模式下为固定值8。

  AwesomeIndicator.type(
    width: _width,
  );
  

• height
  水平模式下为固定值8；垂直模式下为最大高度。

  AwesomeIndicator.type(
    height: _height,
  );
  

• indicator
  仅在.move模式下有效，范围为0到1。
  默认值：0.35

  AwesomeIndicator.type(
    indicator: 0.35,
  );
  

• color
  指示器颜色。

  AwesomeIndicator.type(
    color: _color,
  );
  

• background
  指示器背景颜色。

  AwesomeIndicator.type(
    background: _background,
  );
  

• gradient
  指示器渐变色。

  AwesomeIndicator.type(
    gradient: _gradient,
  );
  

• backgroundGradient
  背景渐变色。

  AwesomeIndicator.type(
    backgroundGradient: _backgroundGradient,
  );
  

• radius
  圆角半径，默认值为8。

  AwesomeIndicator.type(
    radius: 8,
  );
  

• margin
  指示器的外边距。

  AwesomeIndicator.type(
    margin: const EdgeInsets.zero,
  );
  

• onListener
  监听器回调，返回指示器的比值、像素和滚动方向。

  AwesomeIndicator.type(
    onListener: (int ratio, double pixel, Axis direction) {
      // 指示器比值
      // 指示器像素
      // 滚动方向
    },
  );
  

• isDebug
  是否开启调试日志，默认值为true。

  AwesomeIndicator.type(
    isDebug: true,
  );
  

示例代码

以下是一个完整的示例代码，展示如何使用AwesomeIndicator。

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

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

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

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

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

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

class _MyHomePageState extends State<MyHomePage> {
  late ScrollController _controller;

  [@override](/user/override)
  void initState() {
    super.initState();
    _controller = ScrollController();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Awesome Indicator Example'),
      ),
      body: Stack(
        children: [
          ListView.builder(
            controller: _controller,
            itemCount: 50,
            itemBuilder: (context, index) {
              return ListTile(
                title: Text('Item $index'),
              );
            },
          ),
          Positioned.fill(
            child: Align(
              alignment: Alignment.bottomCenter,
              child: AwesomeIndicator.move(
                controller: _controller,
                scrollDirection: Axis.horizontal,
                color: Colors.red,
                background: Colors.grey.shade300,
                indicator: 0.5,
                height: 8,
                width: 100,
                radius: 4,
                margin: const EdgeInsets.symmetric(horizontal: 16),
                isDebug: false,
              ),
            ),
          ),
        ],
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    _controller.dispose();
    super.dispose();
  }
}