2. 最初の画面

View と ViewModel を分けて作る

この章のゴール

1

State を作る

freezed で変更できない状態クラス

2

ViewModel を作る

@riverpod の Notifier

3

View を作る

HookConsumerWidget で表示だけ

View と ViewModel の役割

View(画面)

  • 表示とボタン操作だけ
  • 状態は持たない
  • ref.watch で状態を読む

ViewModel

  • 画面の状態(State)を持つ
  • ボタンが押されたときの処理
  • 状態は state = state.copyWith(...) で丸ごと差し替える

flowchart LR
  V["View"] -- "ref.watch(状態)" --> VM["ViewModel"]
  V -- "notifier.addUser()" --> VM
  VM -- "state を更新" --> V

ViewModel と State

lib/ui/user_list/view_model/user_list_view_model.dart
import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';

part 'user_list_view_model.g.dart';
part 'user_list_view_model.freezed.dart';

@freezed
abstract class UserListState with _$UserListState {
  const factory UserListState({
    @Default([]) List<String> names,
    String? errorMessage,
  }) = _UserListState;
}

@riverpod
class UserListViewModel extends _$UserListViewModel {
  @override
  UserListState build() => const UserListState();

  // 追加できたら true
  bool addUser(String name) {
    final trimmed = name.trim();
    if (trimmed.isEmpty) {
      state = state.copyWith(errorMessage: '名前を入力してください');
      return false;
    }
    state = state.copyWith(
      names: [...state.names, trimmed],
      errorMessage: null,
    );
    return true;
  }
}

ポイント

  • @freezed abstract class → copyWith や == が自動生成される
  • @Default(...) で初期値を指定
  • @riverpod → userListViewModelProvider が自動生成される
  • part '...g.dart' / part '...freezed.dart' は生成されるファイル。最初は赤くなっていてよい
dart run build_runner build

View

lib/ui/user_list/view/user_list_page.dart
import 'package:flutter/material.dart';
import 'package:flutter_hooks/flutter_hooks.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/ui/user_list/view_model/user_list_view_model.dart';

class UserListPage extends HookConsumerWidget {
  const UserListPage({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(userListViewModelProvider);
    final notifier = ref.read(userListViewModelProvider.notifier);
    final nameController = useTextEditingController();

    return Scaffold(
      appBar: AppBar(title: const Text('ユーザー一覧')),
      body: Column(
        children: [
          Padding(
            padding: const EdgeInsets.all(16),
            child: Row(
              children: [
                Expanded(
                  child: TextField(
                    controller: nameController,
                    decoration: InputDecoration(
                      labelText: '名前',
                      errorText: state.errorMessage,
                    ),
                  ),
                ),
                const SizedBox(width: 16),
                FilledButton(
                  onPressed: () {
                    if (notifier.addUser(nameController.text)) {
                      nameController.clear();
                    }
                  },
                  child: const Text('追加'),
                ),
              ],
            ),
          ),
          Expanded(
            child: ListView(
              children: [
                for (final name in state.names)
                  ListTile(leading: const Icon(Icons.person), title: Text(name)),
              ],
            ),
          ),
        ],
      ),
    );
  }
}

View のポイント

書き方 意味
ref.watch(provider) 状態を読む。変わったら画面を描き直す
ref.read(provider.notifier) ViewModel のメソッドを呼ぶ
useTextEditingController() 入力欄のコントローラ。後片付けも自動

watch を使わないとどうなる?

watch なし(StatefulWidget + setState)

class _UserListPageState extends State<UserListPage> {
  final _names = <String>[];

  void _add(String name) {
    // データを変えたら、毎回自分で
    // 「描き直して」と頼む必要がある
    setState(() {
      _names.add(name);
    });
  }
  // 削除・編集・読み込み… どこでも setState が必要
}

watch あり(Riverpod)

// View: 読むだけ
final state = ref.watch(userListViewModelProvider);

// ViewModel: state を差し替えるだけ
state = state.copyWith(
  names: [...state.names, trimmed],
);
// → watch している画面が自動で描き直される

watch を使わないときの問題

  • watch なしだと、データを変えるたびに 「画面を更新して」と自分で呼ぶ 必要がある
  • 呼び忘れると「データは変わったのに画面が古いまま」になる。変更箇所が増えるほど漏れやすい
  • ref.read で状態を読んだ場合も同じで、値が変わっても描き直されない → 表示に使う値は必ず ref.watch

アプリに表示する

app.dart の home を const UserListPage() にします。

lib/app.dart
import 'package:flutter/material.dart';
import 'package:motion_app/ui/user_list/view/user_list_page.dart';

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Motion Note',
      theme: ThemeData(colorSchemeSeed: Colors.teal),
      home: const UserListPage(),
    );
  }
}

チェックポイント

CHECK 0 / 4