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');
}
}
// シンプルな 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)
// ステートレスウィジェットを定義
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('増加'),
),
],
);
}
}
// ステートフルウィジェットを定義
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 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),
),
],
),
)
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の設定アイコン
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,
)
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('保存'),
)
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('確認'),
),
],
),
],
),
),
);
}
}
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('確認'),
),
],
),
],
),
),
);
}
}