Flutter Widget 基礎

Widget は Flutter UI の基本的な構成要素です。

Flutter では、すべてが Widget であり、単純なテキストから複雑なページレイアウトまで、すべて Widget を組み合わせて作られています。


Widget とは?

Widget は UI の外観と動作を記述する Dart クラスです。すべての Flutter アプリは本質的に Widget で構成されたツリー構造であり、Widget ツリーと呼ばれます。

例:最も簡単な Widget サンプル

import 'package:flutter/material.dart';

// シンプルな Widget を定義
class HelloWidget extends StatelessWidget {
  const HelloWidget({super.key});

  @override
  Widget build(BuildContext context) {
    // Text Widget を返し、"Hello World" を表示
    return const Text('Hello World');
  }
}

StatelessWidget - ステートレスウィジェット

StatelessWidget は不変の Widget であり、一度作成するとそのプロパティを変更することはできません。テキスト、画像、アイコンなどの静的コンテンツを表示するシーンに適しています。

基本構造

例:StatelessWidget サンプル

import 'package:flutter/material.dart';

// ステートレスウィジェットを定義
class MyTextWidget extends StatelessWidget {
  // コンストラクタの引数(不変のプロパティ)
  final String text;
  final Color textColor;
  final double fontSize;

  // const コンストラクタを使用
  const MyTextWidget({
    super.key,
    required this.text,
    this.textColor = Colors.black,
    this.fontSize = 16.0,
  });

  @override
  Widget build(BuildContext context) {
    // build メソッドは別の Widget を返す
    return Text(
      text,
      style: TextStyle(
        color: textColor,
        fontSize: fontSize,
      ),
    );
  }
}

// 使用例
// MyTextWidget(text: 'Hello', textColor: Colors.red)

適用シーン

  • 静的テキストの表示
  • 画像の表示
  • アイコンの表示
  • 時間とともに変化しないレイアウト

StatefulWidget - ステートフルウィジェット

StatefulWidget は可変の Widget であり、内部データの変化に応じて UI を更新できます。ユーザー操作やデータ変化に応答する必要があるシーンに適しています。

基本構造

例:StatefulWidget サンプル

import 'package:flutter/material.dart';

// ステートフルウィジェットを定義
class CounterWidget extends StatefulWidget {
  const CounterWidget({super.key});

  @override
  State<CounterWidget> createState() => _CounterWidgetState();
}

// State クラスは可変状態を保持
class _CounterWidgetState extends State<CounterWidget> {
  // カウンターの状態
  int _count = 0;

  // カウンターを増やすメソッド
  void _increment() {
    // setState を呼び出してフレームワークに状態が変更されたことを通知
    setState(() {
      _count++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        // 現在のカウントを表示
        Text(
          'カウンター: $_count',
          style: const TextStyle(fontSize: 24),
        ),
        const SizedBox(height: 16),
        // 増加ボタン
        ElevatedButton(
          onPressed: _increment,
          child: const Text('増加'),
        ),
      ],
    );
  }
}

setState メソッド

StatefulWidget では、状態が変化した場合、必ずsetStateメソッドを呼び出して Flutter に UI の再構築を通知する必要があります。

状態を変更しても setState を呼び出さない場合、UI は更新されません。これは、Flutter が setState を通じて Widget を再構築する必要があるかどうかを判断するためです。

適用シーン

  • カウンター、タイマーなどの動的データ
  • フォーム入力
  • リスト項目の追加・削除・変更
  • ユーザー操作への応答

build メソッド

すべての Widget は必ずbuildメソッドを実装する必要があります。このメソッドは Widget ツリーの一部を返します。

基本ルール

ルール説明
戻り値Widget を返す必要があり、null を返すことはできません
引数BuildContext パラメータを受け取り、Widget ツリー内の位置を表します
呼び出しタイミング初回構築時、親 Widget の再構築時、状態変化時

例:build メソッドのサンプル

@override
Widget build(BuildContext context) {
  // BuildContext はテーマ、テーマなどの情報にアクセスする機能を提供
  // 例: 現在のテーマカラーを取得する
  final theme = Theme.of(context);

  // Widget を返す
  return Container(
    padding: const EdgeInsets.all(16.0),
    decoration: BoxDecoration(
      color: theme.colorScheme.primaryContainer,
      borderRadius: BorderRadius.circular(8),
    ),
    child: Text(
      'Hello Flutter',
      style: TextStyle(
        color: theme.colorScheme.onPrimaryContainer,
        fontSize: 20,
      ),
    ),
  );
}

よく使う基本 Widget

Text - テキスト表示

例:Text Widget

// 基本テキスト
const Text('Hello World')

// スタイル付きテキスト
Text(
  'Hello Flutter',
  style: TextStyle(
    fontSize: 20,
    fontWeight: FontWeight.bold,
    color: Colors.blue,
  ),
)

// オプションのスタイルを持つテキスト
Text.rich(
  TextSpan(
    text: 'Hello ',
    children: [
      TextSpan(
        text: 'Flutter',
        style: TextStyle(fontWeight: FontWeight.bold),
      ),
    ],
  ),
)

Icon - アイコン

例:Icon Widget

// Material Icons を使用
const Icon(Icons.home)              // ホームアイコン
const Icon(Icons.star, color: Colors.yellow)  // 色付きの星
const Icon(Icons.settings, size: 48)  // サイズ48の設定アイコン

Image - 画像

例:Image Widget

// ネットワークから画像を読み込み
Image.network('https://example.com/image.png')

// ローカルリソースから画像を読み込み
Image.asset('assets/images/logo.png')

// ファイルから画像を読み込み
Image.file(File('path/to/image.png'))

// パラメータ付きの画像
Image.network(
  'https://example.com/image.png',
  width: 200,
  height: 200,
  fit: BoxFit.cover,
)

Button - ボタン

例:ボタン Widget

// テキストボタン
TextButton(
  onPressed: () { /* クリックを処理 */ },
  child: const Text('テキストボタン'),
)

// フローティングボタン
FloatingActionButton(
  onPressed: () { /* クリックを処理 */ },
  child: const Icon(Icons.add),
)

// ElevatedButton - 影付きのボタン
ElevatedButton(
  onPressed: () { /* クリックを処理 */ },
  child: const Text('送信'),
)

// アイコン付きのボタン
ElevatedButton.icon(
  onPressed: () { /* クリックを処理 */ },
  icon: const Icon(Icons.save),
  label: const Text('保存'),
)

Widget の組み合わせ

Flutter の強力な点は、Widget を組み合わせられることです。ネストすることで、単純な Widget から複雑な UI を構築できます。

例:Widget の組み合わせ

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

  @override
  Widget build(BuildContext context) {
    return Card(
      // Card は Material Design のカードコンポーネント
      elevation: 4,  // 影の深さ
      child: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            // タイトル
            const Text(
              'カードタイトル',
              style: TextStyle(
                fontSize: 20,
                fontWeight: FontWeight.bold,
              ),
            ),
            const SizedBox(height: 8),
            // 説明テキスト
            const Text(
              'これはカードの説明内容で、複数行のテキストを含めることができます。',
            ),
            const SizedBox(height: 16),
            // ボタン行
            Row(
              mainAxisAlignment: MainAxisAlignment.end,
              children: [
                TextButton(
                  onPressed: () {},
                  child: const Text('キャンセル'),
                ),
                const SizedBox(width: 8),
                ElevatedButton(
                  onPressed: () {},
                  child: const Text('確認'),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}
その他の拡張