【お知らせ】みんプロ式Flutter講座は2026年4月末をもって新規販売を終了いたしました。詳しくはこちら →

Flutter3.16以降(Material3以降)はListTile#trailingにサイズ指定が必要に

このページには広告が含まれる場合があります。

 

2023年11月にFlutterのSDKのバージョンが3.16にアップデートされ、Flutterアプリを作る際に(性格にはMaterialAppで作る際に)使用するデフォルトのデザインガイドライン(Google先生が推奨するデザインガイドラインである「マテリアルデザイン」)のバージョンが「Material 2」から「Material 3」に変更されました。

これによって、Flutterのバージョン3.16以前で作っていたプロジェクトを3.16にアップデート後にビルドすると、何もコードを変更していないのに見た目が変わってしまうという現象が起こってしまいますが、

リスト形式のデータを表示させるための便利なWidgetである「ListTile」の「trailing」属性(タイトルの後ろに表示させるWidget:以下画像ご参照)について、

Flutter3.16未満では、空Containerを設置してもエラーにならなったのですが、Flutter3.16以降(Material3以降)では、

Trailing widget consumes entire tile width. Please use a sized widget, or consider replacing ListTile with a custom widget

というランタイムエラーが発生してしまいます。

このエラーが発生した場合は、エラーメッセージに

Please use a sized widget, or consider replacing ListTile with a custom widget.
(サイズ指定されたWidgetを使うか、ListTileを別のカスタムWidgetに代えてください)

とあるように、trailingに設定するWidgetに以下のようにサイズを指定してやると解消します。

(ちなみに、Iconはデフォルトでサイズが24.0に設定されているので、明示的に設定する必要はありません)

なぜ、Flutter3.16未満(Material2以下)では大丈夫で、Flutter3.16以降(Material3以降)ではエラーになるのかは解明できていませんが、おそらく、エラーメッセージにAssertionで表示されている

tileWidth != trailingSize.width || tileWidth = 0.0

が新たに付与されたのではないかと思われます。

 

(詳しくは、以下の動画で説明していますので、よろしければご覧ください)

こんな記事も読まれています

GAMBO(願望) 願望実現・目標達成の
17秒 / 68秒ワーク
GAMBO(願望) 引き寄せ難民だったぼくの挫折経験から生まれた誰でもできる願望実現サポートアプリ。かの有名な17秒/68秒ワークを独自の視覚化メソッドで簡単実践。
App Store / Google Play 詳しく見る →
Meiso(瞑想) 鐘音と自然音で
5分からのマインドフルネス
Meiso(瞑想) 初心者でも“迷わず続けられる”ことにこだわった、完全無料の瞑想アプリ。画面のガイドに従うだけで呼吸のリズムが整い、最短5分から瞑想を実践できます。
App Store / Google Play 詳しく見る →
小学生からの英検®単語 A ふりがな・音声付き
英検単語1日5分トレーニング
小学生からの英検®単語 ありそうでなかった!ふりがな付き英検®単語トレーニングアプリ!1日たった5分!スキマ時間を活用して、英検®頻出単語を効率的に習得。お子様の一人学習にも安心設計。
App Store / Google Play 詳しく見る →
オボエルンジャー レトロゲームで
nバック脳トレ
オボエルンジャー 科学的脳力開発法「Nバック課題」をファミコン風8bitレトロゲームにアレンジした新感覚脳トレアプリ。記憶力・感情コントロール力・集中力の向上に。
App Store / Google Play 詳しく見る →
ゴイコイコイ 超高速フラッシュカードで
語彙習得
ゴイコイコイ 日常語1400語を視覚的に学べる、高速読み上げフラッシュカード式の語彙トレーニングアプリ。知育教室で行われるフラッシュカード学習を、家庭で“手軽に・安価に・正確に”再現。
App Store / Google Play 詳しく見る →

TOP