Flutter滑动视图插件slider_view的使用

Flutter滑动视图插件slider_view的使用

slider_view 是一个支持自定义类型模型和多种配置的滑动视图小部件。以下是如何在Flutter项目中使用该插件的详细说明。

特性 ✨

• ⚡ 支持无限滚动
• 🖱 可以通过宽高或宽高比控制布局大小
• 🖲 显示指示器
• 💻 支持桌面端

准备使用 🍭

首先，你需要将 slider_view 添加到你的项目中。打开终端并运行以下命令：

flutter pub add slider_view

使用 📖

以下是一个简单的示例，展示了如何使用 slider_view 插件创建一个滑动视图。

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

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

  final String title;

  [@override](/user/override)
  State<DemoPage> createState() => _DemoPageState();
}

class _DemoPageState extends State<DemoPage> {
  late List<String> characters = [String.fromCharCode(_counter)];
  int _counter = 65;

  void _incrementCounter() {
    setState(() {
      ++_counter;
      characters.add(String.fromCharCode(_counter));
    });
  }

  void _removeCharacter() {
    if (_counter == 65) {
      return;
    }

    setState(() {
      --_counter;
      characters.removeLast();
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(widget.title)),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            SliderView(
              config: SliderViewConfig<String>(
                aspectRatio: 16 / 9,
                models: characters,
                viewportFraction: 0.9, // 设置为1.0以占据整个视口
                itemBuilder: (String e) => Container(
                  margin: const EdgeInsets.symmetric(horizontal: 8),
                  color: Theme.of(context).primaryColor,
                  child: Center(
                    child: Text(e, style: Theme.of(context).textTheme.headlineLarge),
                  ),
                ),
              ),
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineSmall,
            ),
            Wrap(
              alignment: WrapAlignment.center,
              spacing: 20,
              runSpacing: 10,
              children: [
                ElevatedButton(
                  onPressed: _incrementCounter,
                  child: Text(
                    'Increment Counter',
                    style: Theme.of(context).textTheme.labelLarge!.copyWith(color: Colors.white),
                  ),
                ),
                ElevatedButton(
                  onPressed: _removeCharacter,
                  child: Text(
                    'Remove Character',
                    style: Theme.of(context).textTheme.labelLarge!.copyWith(color: Colors.white),
                  ),
                ),
              ],
            )
          ],
        ),
      ),
    );
  }
}

完整示例代码

以下是完整的示例代码，展示了如何在Flutter项目中使用 slider_view 插件。

import 'package:flutter/material.dart';
import 'package:slider_view/slider_view.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 const MaterialApp(
      title: 'slider_view example',
      home: DemoPage(title: 'slider_view example'),
    );
  }
}

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

  final String title;

  [@override](/user/override)
  State<DemoPage> createState() => _DemoPageState();
}

class _DemoPageState extends State<DemoPage> {
  late List<String> characters = [String.fromCharCode(_counter)];
  int _counter = 65;

  void _incrementCounter() {
    setState(() {
      ++_counter;
      characters.add(String.fromCharCode(_counter));
    });
  }

  void _removeCharacter() {
    if (_counter == 65) {
      return;
    }

    setState(() {
      --_counter;
      characters.removeLast();
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(widget.title)),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            SliderView(
              config: SliderViewConfig<String>(
                aspectRatio: 16 / 9,
                models: characters,
                viewportFraction: 0.9, // 设置为1.0以占据整个视口
                itemBuilder: (String e) => Container(
                  margin: const EdgeInsets.symmetric(horizontal: 8),
                  color: Theme.of(context).primaryColor,
                  child: Center(
                    child: Text(e, style: Theme.of(context).textTheme.headlineLarge),
                  ),
                ),
              ),
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineSmall,
            ),
            Wrap(
              alignment: WrapAlignment.center,
              spacing: 20,
              runSpacing: 10,
              children: [
                ElevatedButton(
                  onPressed: _incrementCounter,
                  child: Text(
                    'Increment Counter',
                    style: Theme.of(context).textTheme.labelLarge!.copyWith(color: Colors.white),
                  ),
                ),
                ElevatedButton(
                  onPressed: _removeCharacter,
                  child: Text(
                    'Remove Character',
                    style: Theme.of(context).textTheme.labelLarge!.copyWith(color: Colors.white),
                  ),
                ),
              ],
            )
          ],
        ),
      ),
    );
  }
}