【Flutter】 タブで画面を切り替える方法

Fultterでタブで画面を切り替える方法を紹介します。
画面をタブで整理するなら、DefaultTabController、TabBar、TabBarViewを使うのが最適です。
また、記事の後半でTabControllerを使うパターンも紹介しています。

Version

• Flutter 2.8.1
• Dart 2.15.1

使い方３ステップ

①DefaultTabControllerを設定

まずはDefaultTabControllerでタブを表示するページを囲みます。
そしてlengthプロパティにタブの数を設定します。これは必須です。

home: DefaultTabController(
        length: 3,
        child: Scaffold(
          appBar: AppBar(
            title: const Text('タブ画面移動サンプル'),
          ),
        ),
      ),

②TabBarを設定

次にTabBarを使って、ユーザーが画面の切り替えに使うタブを設定します。 TabBarはTabのリストを取得します。タブにはTextやアイコンなどを設定できます。

home: DefaultTabController(
        length: 3,
        child: Scaffold(
          appBar: AppBar(
            title: const Text('タブ画面移動サンプル'),
            bottom: const TabBar(
              tabs: <Widget>[
                Tab(icon: Icon(Icons.cloud_outlined)),
                Tab(icon: Icon(Icons.beach_access_sharp)),
                Tab(icon: Icon(Icons.brightness_5_sharp)),
              ],
            ),
          ),
        ),
      ),

③TabBarViewを設定

最後にTabBarViewを使って、各タブに対応するコンテンツを設定します。
TabBarで設定したタブと１対１で対応させます。
今回はTextを表示させていますがここに別のページを設定することもできます。

home: DefaultTabController(
        length: 3,
        child: Scaffold(
          appBar: AppBar(
            title: const Text('タブ画面移動サンプル'),
            bottom: const TabBar(
              tabs: <Widget>[
                Tab(icon: Icon(Icons.cloud_outlined)),
                Tab(icon: Icon(Icons.beach_access_sharp)),
                Tab(icon: Icon(Icons.brightness_5_sharp)),
              ],
            ),
          ),
          body: const TabBarView(
            children: <Widget>[
              Center(child: Text('くもり', style: TextStyle(fontSize: 50))),
              Center(child: Text('雨', style: TextStyle(fontSize: 50))),
              Center(child: Text('晴れ', style: TextStyle(fontSize: 50))),
            ],
          ),
        ),
      ),

コード全文

サンプルアプリのソースコードです。まずはこれをコピペして動かしてみてから中身を調べていくとわかりやすいと思います！

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(
      home: DefaultTabController(
        length: 3,
        child: Scaffold(
          appBar: AppBar(
            title: const Text('タブ画面移動サンプル'),
            bottom: const TabBar(tabs: <Widget>[
              Tab(icon: Icon(Icons.cloud_outlined)),
              Tab(icon: Icon(Icons.beach_access_sharp)),
              Tab(icon: Icon(Icons.brightness_5_sharp)),
            ]),
          ),
          body: const TabBarView(
            children: <Widget>[
              Center(child: Text('くもり', style: TextStyle(fontSize: 50))),
              Center(child: Text('雨', style: TextStyle(fontSize: 50))),
              Center(child: Text('晴れ', style: TextStyle(fontSize: 50))),
            ],
          ),
        ),
      ),
    );
  }
}

【参考】DefaultTabControllerを使わないパターン

タブはDefaultTabControllerを使わないで実装することも可能です。
その場合DefaultTabControllerの代わりにTabControllerを使います。
以下では、同じサンプルアプリをTabControllerを使って実装してみます。

①TabControllerを設定

Stateの部分を以下のように変更してTabControllerのインスタンス_tabControllerを定義します。

class _MyHomePageState extends State<MyHomePage> with TickerProviderStateMixin {
  late TabController _tabController;

  @override
  void initState() {
    super.initState();
    _tabController = TabController(length: 3, vsync: this);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('タブ画面移動サンプル'),
      ),
    );
  }
}

②TabBarを設定

次にTabBarを使って、ユーザーが画面の切り替えに使うタブを設定します。
ここでやっていることは、このページの前半で説明したDefaultTabControllerを使うパターンの②とほぼ同じです。
controllerプロパティに①で定義した_tabControllerを設定するところだけ違うので注意してください。

return Scaffold(
      appBar: AppBar(
        title: const Text('タブ画面移動サンプル'),
        bottom: TabBar(
          controller: _tabController,
          tabs: const <Widget>[
            Tab(icon: Icon(Icons.cloud_outlined)),
            Tab(icon: Icon(Icons.beach_access_sharp)),
            Tab(icon: Icon(Icons.brightness_5_sharp)),
          ],
        ),
      ),
    );

③TabBarViewを設定

最後にTabBarViewを使って、各タブに対応するコンテンツを設定します。
やっていることは、このページの前半で説明したDefaultTabControllerを使うパターンの③とほぼ同じです。
ここでもcontrollerプロパティに①で作った_tabControllerを設定します。

return Scaffold(
      appBar: AppBar(
        title: const Text('タブ画面移動サンプル'),
        bottom: TabBar(
          controller: _tabController,
          tabs: const <Widget>[
            Tab(icon: Icon(Icons.cloud_outlined)),
            Tab(icon: Icon(Icons.beach_access_sharp)),
            Tab(icon: Icon(Icons.brightness_5_sharp)),
          ],
        ),
      ),
      body: TabBarView(
        controller: _tabController,
        children: const <Widget>[
          Center(child: Text('くもり', style: TextStyle(fontSize: 50))),
          Center(child: Text('雨', style: TextStyle(fontSize: 50))),
          Center(child: Text('晴れ', style: TextStyle(fontSize: 50))),
        ],
      ),
    );

コード全文

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 const MaterialApp(
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key}) : super(key: key);

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> with TickerProviderStateMixin {
  late TabController _tabController;

  @override
  void initState() {
    super.initState();
    _tabController = TabController(length: 3, vsync: this);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('タブ画面移動サンプル'),
        bottom: TabBar(
          controller: _tabController,
          tabs: const <Widget>[
            Tab(icon: Icon(Icons.cloud_outlined)),
            Tab(icon: Icon(Icons.beach_access_sharp)),
            Tab(icon: Icon(Icons.brightness_5_sharp)),
          ],
        ),
      ),
      body: TabBarView(
        controller: _tabController,
        children: const <Widget>[
          Center(child: Text('くもり', style: TextStyle(fontSize: 50))),
          Center(child: Text('雨', style: TextStyle(fontSize: 50))),
          Center(child: Text('晴れ', style: TextStyle(fontSize: 50))),
        ],
      ),
    );
  }
}

さいごに

いかがでしたでしょうか。
タブの利用は奥が深く細かいカスタマイズが可能ですが、本記事では核となる最低限の使い方だけを紹介しました。
参考にしていただけたら幸いです。

参考

https://api.flutter.dev/flutter/material/DefaultTabController-class.html https://api.flutter.dev/flutter/material/TabBar-class.html