タブごとに独立したスタックを持つ

DeclarativeTabsScaffold は、宣言的な更新を維持しながら、各タブのページ一覧を独立して管理します。1つのタブを更新しても、別のタブのスタックは置き換わりません。

タブごとのページ一覧

タブのナビゲーション状態を予測しやすくするため、Map<TabId, List<PageEntry>> を使います。TabId ごとに別々のページ一覧を保持します。

画面単位のオーバーレイ

TabPageKey = (TabId, pageKey) を使い、オーバーレイの状態をタブ内の各画面に限定します。複合キーにより、ある画面の状態が別の画面に混ざるのを防ぎます。

戻る順序の統一

戻る操作は、オーバーレイを閉じ、選択中のタブのスタックの一番上のページを取り除き、先頭タブへ戻り、最後に onBackAtRoot を呼ぶ順に処理します。すべてのタブで同じ順序を保ちます。

タブ構成の基本形

各タブにルートページを用意し、すべてのタブイベントを状態の更新を通じて処理します。pagesByTab のマップ全体を DeclarativeTabsScaffold に渡します。

DeclarativeTabsScaffold

const tabHome = TabId('home');
const tabSettings = TabId('settings');

final pagesByTab = <TabId, List<PageEntry>>{
  tabHome: [const PageEntry(key: 'home', name: '/home')],
  tabSettings: [const PageEntry(key: 'settings', name: '/settings')],
};

return DeclarativeTabsScaffold(
  items: items,
  currentTab: currentTab,
  onSelectTab: _selectTab,
  pagesByTab: pagesByTab,
  setPagesForTab: _setPagesForTab,
  buildPage: _buildTabPage,
);
制約

各タブの pagesByTab[tab] を空にしないでください。 安定したナビゲーションにはルートページが必要です。