【Flutter】PageViewで作る!驚くほどスムーズなページ遷移

対象者

  • Flutterを用いたアプリ開発に携わっている人
  • PageViewを使ってページ遷移を実装したいと考えている人
  • PageViewの基本的な使い方やカスタマイズ方法を学びたい人

はじめに

Flutterを使ってアプリ開発を進めているあなたへ。スムーズなページ遷移や見栄えの良いUIが求められるアプリを作成したいとお悩みではないですか?そんな時に役立つのが、PageViewを活用した実装方法です。この記事では、PageViewの基本的な使い方から高度なカスタマイズ方法まで、幅広く解説します。これを読めば、あなたのアプリ開発スキルがさらに向上し、利用者からの評価も上がることでしょう。

PageViewを活用すれば、ユーザーがスワイプ操作で気軽にページを切り替えられるアプリを実現できます。しかも、縦や横方向のスクロール設定や初期表示ページの指定が可能です。さらに、PageControllerを使えば、ページ遷移を柔軟に制御することができます。

また、PageView.builderを利用すれば、動的なページ生成が手軽にできます。これにより、アプリのパフォーマンス向上やコードの簡潔化が期待できます。さらに、PageViewのイベント処理やカスタマイズ方法についても詳しく説明します。これらの知識があれば、機能性とデザイン性を兼ね備えたアプリ開発が可能になります。

この記事を通じて、あなたのアプリ開発の幅が広がり、次のステップへ進む力が身につくことでしょう。ぜひ最後まで読んで、FlutterでPageViewを活用した素晴らしいアプリケーションを作成しましょう。

Flutter PageViewの概要

PageViewは、Flutterでスワイプによるページ切り替えを実現するウィジェットです。複数のページを横に並べて、スワイプすることで次のページや前のページに切り替えることができます。これにより、ユーザーがアプリの機能を直感的に操作できるようになります。

PageViewとは

PageViewは、スクロール可能な領域を持つウィジェットで、主に横方向にスワイプしてページを切り替える動作を実現します。主に画像ギャラリーやチュートリアルなど、連続したコンテンツをスワイプで表示する場面で使用されます。

PageViewは、PageControllerと連携して、ページの遷移やページの状態を制御できます。また、PageView.builderを使って動的にページを生成することも可能です。

PageViewの基本的な使い方

PageViewを使うには、まずウィジェットのリストをchildrenプロパティに渡すことで、ページを作成できます。基本的な使い方は以下のようになります。

PageView(
  children: [
    Container(color: Colors.red),
    Container(color: Colors.green),
    Container(color: Colors.blue),
  ],
)

上記のコードでは、赤、緑、青の背景色を持つ3つのページが作成されます。これらのページは、ユーザーがスワイプすることで切り替えることができます。

さらに、PageControllerを使ってページ遷移を制御したり、onPageChangedでイベント処理を行ったりすることもできます。これらの詳細な使い方は、後述の実装方法やイベント処理に関する項目で説明しています。

PageViewの実装方法

PageViewを実装する際には、いくつかの設定やカスタマイズが可能です。以下では、基本形の実装から始めて、スクロール方向の設定やページが画面に占める割合の設定、初期表示するページの指定方法について説明します。

基本形の実装

PageViewの基本形は、複数のウィジェットをchildrenプロパティに渡すことで実装できます。以下の例では、3つのテキストウィジェットをページとして配置しています。

PageView(
  children: [
    Text('Page 1'),
    Text('Page 2'),
    Text('Page 3'),
  ],

スクロール方向の設定

デフォルトでは、PageViewは横方向にスクロールしますが、scrollDirectionプロパティを設定することで、縦方向にスクロールさせることもできます。

PageView(
  scrollDirection: Axis.vertical,
  children: [
    Text('Page 1'),
    Text('Page 2'),
    Text('Page 3'),
  ],
)

ページが画面に占める割合の設定

PageViewでは、viewportFractionプロパティを使って、ページが画面に占める割合を設定することができます。以下の例では、各ページが画面幅の50%を占めるように設定しています。

PageView(
  controller: PageController(viewportFraction: 0.5),
  children: [
    Text('Page 1'),
    Text('Page 2'),
    Text('Page 3'),
  ],
)

初期表示するページの指定

初期表示するページを指定するには、PageControllerのinitialPageプロパティを設定します。以下の例では、2ページ目を初期表示として設定しています。

PageView(
  controller: PageController(initialPage: 1),
  children: [
    Text('Page 1'),
    Text('Page 2'),
    Text('Page 3'),
  ],
)

これらの設定を組み合わせることで、様々なPageViewの実装が可能です。詳細なカスタマイズ方法については、後述の「PageViewのカスタマイズ」で説明します。

PageViewのコントローラー

PageViewのコントローラーについて、その使い方やページ遷移の制御方法について説明します。PageControllerは、PageViewのページ遷移を制御するためのクラスです。これを用いることで、プログラム上からページ遷移を行ったり、ページの状態を取得することができます。

PageControllerの使い方

PageControllerを使うには、まずインスタンスを生成し、PageViewウィジェットのcontrollerプロパティに渡します。以下の例では、PageControllerのインスタンスを作成し、PageViewに適用しています。また、disposeもお忘れなく

PageController _controller = PageController();

PageView(
  controller: _controller,
  children: [
    Text('Page 1'),
    Text('Page 2'),
    Text('Page 3'),
  ],
)

ページ遷移の制御

PageControllerを使ってページ遷移を制御する方法には、animateToPageやjumpToPageがあります。

  • nextPage:次のページに遷移します。
  • previousPage:前のページに遷移します。
  • animateToPage:指定したページにアニメーション付きで遷移します。
  • jumpToPage:指定したページにアニメーションなしで即座に遷移します。

以下の例では、ボタンを押すことで、PageViewが次のページに遷移するようにしています。

ElevatedButton(
  onPressed: () {
    _controller.nextPage(
      duration: Duration(milliseconds: 300),
      curve: Curves.easeInOut,
    );
  },
  child: Text('次のページへ'),
)

また、現在のページインデックスを取得するには、_controller.pageを使用します。ただし、_controller.pageはダブル型で返されるため、整数値に変換する必要があります。以下の例では、現在のページインデックスを表示するテキストウィジェットを実装しています。

var _pageViewInitialized = false;

@override
void initState() {
    super.initState();

    WidgetsBinding.instance.addPostFrameCallback((_) {
      _pageViewInitialized = true;
    });
}

Text(_pageViewInitialized? 'Page: ${_controller.page?.floor()}': '')

ただ、上記の方法はPageViewの初期化が終わる前に実行すると、例外が発生します。
WidgetsBinding.instance.addPostFrameCallbackで初期化終了の変数を設定することで対処しました。initStateとdidChangeDependencies内で変数を変更した場合、例外は発生しました。

これらの方法を組み合わせることで、PageViewのページ遷移を自由に制御することができます。さらに詳しいイベント処理やカスタマイズ方法については、後述の「PageViewでのイベント処理」や「PageViewのカスタマイズ」で説明します。

PageView.builderの利用

PageView.builderは、ページの数が動的である場合や、一度に多くのページを表示する必要がない場合に便利です。これによって、表示が必要になった時だけページを生成することができ、パフォーマンスの向上が期待できます。

itemCountとitemBuilderの設定

PageView.builderを使用するには、itemCountとitemBuilderの2つのプロパティを設定する必要があります。

  • itemCount:ページの総数を指定します。
  • itemBuilder:ページを生成するための関数を指定します。この関数は、ビルドコンテキストとページのインデックスを引数に取り、ウィジェットを返すように実装します。

以下の例では、10ページのPageViewを生成し、各ページにインデックスに基づいたテキストウィジェットを表示しています。

PageView.builder(
  itemCount: 10,
  itemBuilder: (BuildContext context, int index) {
    return Text('ページ ${index + 1}');
  },
)

動的なページ生成

PageView.builderを使うことで、動的にページを生成することができます。例えば、APIからデータを取得し、そのデータに基づいてページを生成する場合などに便利です。以下の例では、APIから取得したデータをもとにPageViewを生成しています。

List<String> apiData = ['ページ1', 'ページ2', 'ページ3']; // APIから取得したデータ

PageView.builder(
  itemCount: apiData.length,
  itemBuilder: (BuildContext context, int index) {
    return Text(apiData[index]);
  },
)

PageView.builderを利用することで、動的にページ数が変わる場合や、大量のページがある場合でも効率的なページ表示が可能になります。次の項目では、PageViewでのイベント処理やカスタマイズ方法について説明します。

PageViewでのイベント処理

PageViewでは、ページ切り替え時にイベント処理を実行することができます。これにより、ユーザーがページを切り替えたタイミングで特定の処理を実行することが可能になります。

onPageChangedを使ったページ切り替え時の処理

PageViewウィジェットには、onPageChangedというコールバックが用意されており、ページが切り替わった際に実行される処理を指定することができます。以下の例では、ページが切り替わった際にコンソールに現在のページインデックスを表示する処理を実装しています。

PageView(
  onPageChanged: (int index) {
    print('現在のページ:$index');
  },
  children: [
    Container(color: Colors.red),
    Container(color: Colors.green),
    Container(color: Colors.blue),
  ],
)

ボタンやドロップダウンリストでのページ切り替え

PageViewでは、ボタンやドロップダウンリストを使ってページを切り替えることもできます。これには、PageControllerを利用して、animateToPageやjumpToPageメソッドを呼び出します。

以下の例では、ボタンを押すことでページを切り替える処理を実装しています。

PageController _controller = PageController();

@override
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(title: Text('PageView Example')),
    body: Column(
      children: [
        Expanded(
          child: PageView(
            controller: _controller,
            children: [
              Container(color: Colors.red),
              Container(color: Colors.green),
              Container(color: Colors.blue),
            ],
          ),
        ),
        Row(
          mainAxisAlignment: MainAxisAlignment.spaceEvenly,
          children: [
            ElevatedButton(
              onPressed: () => _controller.animateToPage(0, duration: Duration(milliseconds: 300), curve: Curves.ease),
              child: Text('ページ1'),
            ),
            ElevatedButton(
              onPressed: () => _controller.animateToPage(1, duration: Duration(milliseconds: 300), curve: Curves.ease),
              child: Text('ページ2'),
            ),
            ElevatedButton(
              onPressed: () => _controller.animateToPage(2, duration: Duration(milliseconds: 300), curve: Curves.ease),
              child: Text('ページ3'),
            ),
          ],
        ),
      ],
    ),
  );
}

PageViewでのイベント処理を利用することで、ユーザーの操作に応じてページ切り替え時に様々な処理を実行できます。

Q&A

Q1: PageViewとは何ですか?

A1: PageViewは、Flutterで提供されているウィジェットで、ユーザーがスワイプ操作によってページ間の遷移を行えるようにする機能です。これにより、ユーザーがスムーズに画面を切り替えられるアプリケーションを作成することができます。また、PageViewはスクロール方向の設定やページ間遷移の制御など、柔軟なカスタマイズが可能で、機能性とデザイン性を兼ね備えたアプリ開発に役立ちます。

Q2: PageViewとPageView.builderの違いは何ですか?

A2: PageViewは、固定された数のページを持つウィジェットで、すべてのページが事前に定義されます。一方、PageView.builderは、動的にページを生成するウィジェットで、表示するページの数や内容を実行時に決定できます。大量のページを持つ場合や、ページの内容が動的に変わる場合は、PageView.builderを使用することが推奨されます。

Q3: PageControllerを使ったページ遷移の制御にはどのような利点がありますか?

A3: PageControllerを使用することで、ページ遷移のアニメーションや速度を制御できます。また、特定のページにプログラムでジャンプさせたり、初期表示するページを指定することも可能です。これにより、アプリケーションのナビゲーションがより柔軟かつ直感的になり、ユーザーエクスペリエンスが向上します。

Q4: ユーザにページ操作させたくないときはどうしますか?

A4: ページビュー内でユーザーによるページ操作を防ぎたい場合、「 PageView(physics: const NeverScrollableScrollPhysics())」を使用する方法が効果的です。これをPageViewのスクロール物理として設定することで、ユーザーによるスワイプ操作を完全に無効にします。この設定は、特定のユーザーインタラクションを制限し、誤操作を防ぐことを目的としています。ユーザーがコンテンツを意図せずにスクロールすることがないようにし、アプリケーションの使用体験を向上させることができます。

まとめ

FlutterのPageViewは、スワイプによるページ遷移を実現するウィジェットです。PageViewの実装方法からカスタマイズ方法まで、本記事では詳しく解説してきました。ここでは、全体をまとめたわかりやすい文章と重要なポイントを箇条書きでご紹介します。

Flutterアプリケーションにおいて、PageViewは、スムーズなページ遷移を可能にし、ユーザーエクスペリエンスを向上させるための重要なウィジェットです。PageViewを使いこなすことで、アプリのナビゲーションがより直感的になり、ユーザーにとって使いやすくなります。

重要なポイント:

  • PageViewの基本形の実装で、単純なページ遷移が実現できる。
  • スクロール方向やページが画面に占める割合など、様々な設定が可能。
  • PageControllerを使って、ページ遷移の制御ができる。
  • PageView.builderを利用して、動的なページ生成が行える。
  • onPageChangedイベントを使って、ページ切り替え時の処理を実装できる。
  • インジケーターやボタンをカスタマイズして、独自のデザインを実現できる。

本記事を参考に、PageViewの実装やカスタマイズを自由に行い、ユーザーにとって魅力的なアプリケーションを開発しましょう。

参考

サンプルコード

横向き・ページ固定

import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorSchemeSeed: Colors.blue,
        useMaterial3: true,
      ),
      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
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final _controller = PageController(
    initialPage: 1,
    viewportFraction: 0.8,
  );

  var _pageViewInitialized = false;

  @override
  void initState() {
    super.initState();

    WidgetsBinding.instance.addPostFrameCallback((_) {
      _pageViewInitialized = true;
    });
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('PageView Example')),
      body: Column(
        children: [
          Expanded(
            child: PageView(
              controller: _controller,
              //  scrollDirection: Axis.vertical,
              onPageChanged: (int index) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(
                  content: Text('Change to Page: $index'),
                  duration: const Duration(milliseconds: 200),
                ));
              },
              children: [
                Container(
                  color: Colors.red,
                  child: Text(_pageViewInitialized
                      ? 'Page: ${_controller.page?.floor()}'
                      : ''),
                ),
                Container(color: Colors.green),
                Container(color: Colors.blue),
              ],
            ),
          ),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              ElevatedButton(
                onPressed: () => _controller.jumpTo(0),
                child: Text('ページ1'),
              ),
              ElevatedButton(
                onPressed: () => _controller.animateToPage(1,
                    duration: Duration(milliseconds: 300), curve: Curves.ease),
                child: Text('ページ2'),
              ),
              ElevatedButton(
                onPressed: () => _controller.animateToPage(2,
                    duration: Duration(milliseconds: 300), curve: Curves.ease),
                child: Text('ページ3'),
              ),
            ],
          ),
        ],
      ),
    );
  }
}

縦スクロール・PageView.builder を使用

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorSchemeSeed: Colors.blue,
        useMaterial3: true,
      ),
      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
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('PageView Example')),
      body: PageView.builder(
        scrollDirection: Axis.vertical,
        itemCount: 10,
        itemBuilder: (BuildContext context, int index) {
          return Text('ページ ${index + 1}');
        },
      ),
    );
  }
}