Одна из главных черт хорошего мобильного приложения – это удобная навигация: пользователи без труда могут перемещаться между страницами.
Flutter обеспечивает невероятно простой механизм создания маршрутов и перемещения между экранами (особенно по сравнению с некоторыми другими фронтенд инструментами).
Читайте также: Как создать свое первое приложение Flutter
Файловая структура проекта
В этом мануале мы рассмотрим пример простого приложения, которое состоит из 4 экранов, файла main.dart и navbar.
* screens 📂 * account_screen.dart * balance_screen.dart * transfer_screen.dart * welcome_screen.dart * main.dart * navbar.dart
Именование маршрутов
В большинстве случаев все маршруты разбиваются на отдельные файлы, но пока мы только изучаем основы навигации и поместим все маршруты main.dart.
В MaterialApp мы можем установить карту routes, которая представляет собой список пар ключ-значение. Каждый элемент на этой карте связывает строковое значение с callback функцией, а она возвращает страницу, которую мы хотим отобразить. Смысл этого в том, чтобы ускорить разработку, позволяя нам использовать что-то вроде ‘welcome_screen’ вместо полного (context) => WelcomeScreen() всякий раз, когда нам нужна новая страница.
Чтобы установить домашнюю страницу приложения, можно использовать свойство home или initialRoute из MaterialApp. По сути они делают одно и то же, но home принимает сам класс, например WelcomeScreen(), а initialRoute берет ключ из нашей карты routes. Использовать оба свойства нельзя, так как это сбивает компилятор с толку.
Вот как выглядит наш main.dart:
import 'package:flutter/material.dart';
import './screens/welcome_screen.dart';
import './screens/account_screen.dart';
import './screens/balance_screen.dart';
import './screens/transfer_screen.dart';
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Navigation Demo',
home: MyHomePage(),
);
}
}
class MyHomePage extends StatefulWidget {
@override
_MyHomePageState createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: WelcomeScreen(),
routes: {
'welcome_screen': (context) => WelcomeScreen(),
'account_screen': (context) => AccountScreen(),
'balance_screen': (context) => BalanceScreen(),
'transfer_screen': (context) => TransferScreen()
});
}
}
Этот код нормально работает, но вы можете оказаться в ситуации, в которой нужно часто вводить каждый из этих маршрутов, а наличие большого количества строк затруднит отладку даже при малейшей опечатке. Кроме того, код стал бы менее уязвимым, если бы каждый ключ сохранялся в переменной статического id в каждом классе и просто имел доступ к этому id. Это также даст нам возможность использовать функцию VSCode под названием IntelliSense и поможет выяснить, почему страница может быть недоступна.
Все экраны в нашем примере одинаковы, за исключением id и текстового виджета. Также мы установим нижнюю панель навигации для виджета, который создадим позже. Так выглядит welcome_screen.dart.
import 'package:flutter/material.dart';
import '../navbar.dart';
class WelcomeScreen extends StatelessWidget {
static const String id = 'welcome_screen';
@override
Widget build(BuildContext context) {
return Scaffold(
body: Center(
bottomNavigationBar: Navbar(),
child: Text('Welcome'),
),
);
}
}
Теперь мы можем заменить простые строки в разделе routes файла main.dart
идентификатором каждого экрана. Обратите внимание, что мы получаем к нему доступ, фактически не вызывая сам класс.
class _MyHomePageState extends State<MyHomePage> {
@override
Widget build(BuildContext context) {
return MaterialApp(initialRoute: WelcomeScreen.id, routes: {
WelcomeScreen.id: (context) => WelcomeScreen(),
AccountScreen.id: (context) => AccountScreen(),
BalanceScreen.id: (context) => BalanceScreen(),
TransferScreen.id: (context) => TransferScreen()
});
}
}
Методы pop и push
В отличие от фронтенда, мобильная маршрутизация основана на «наложении» экранов друг на друга: это значит, что при переходе от экрана приветствия к экрану учетной записи мы на самом деле не меняем страницы, а добавляем следующий экран в стек, закрывая тем самым предыдущую страницу. Чтобы вернуться к экрану приветствия, нам просто нужно уничтожить или сбросить самый верхний слой, и мы найдем под ним уже отрендеренную страницу.
Для этого в Navigator есть несколько различных методов (подробнее о них вы можете почитать здесь). Два основных метода, которые мы рассмотрим, – это pushNamed, который добавляет экран в стек, и pop, который удаляет самый верхний слой. Методу pop нужен только context сборки, а методам push – context и ключ страницы, который установлен в наших маршрутах.
Любой метод, добавленный с помощью Named, предназначен для настройки маршрутов в MaterialApp (в противном случае вместо ключей можно было бы передать сам callback). Взглянем на файл navbar.dart:
import 'package:flutter/material.dart';
import './screens/account_screen.dart';
import './screens/balance_screen.dart';
import './screens/transfer_screen.dart';
class Navbar extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Container(
color: Colors.red,
child: Row(
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: <Widget>[
FlatButton(
onPressed: () => Navigator.pop(context),
child: Icon(Icons.arrow_left, color: Colors.white, size: 40)),
FlatButton(
onPressed: () => Navigator.pushNamed(context, BalanceScreen.id),
child: Icon(Icons.account_balance, color: Colors.white)),
FlatButton(
onPressed: () => Navigator.pushNamed(context, TransferScreen.id),
child: Icon(Icons.sync, color: Colors.white)),
FlatButton(
onPressed: () => Navigator.pushNamed(context, AccountScreen.id),
child: Icon(Icons.account_circle, color: Colors.white)),
],
),
);
}
}
Когда дело касается маршрутизации и навигации, Flutter проявляет себя с наилучшей стороны.
