Основы виджетов Flutter
Виджет — это основной строительный блок Flutter UI.
В Flutter всё является виджетом: от простого текста до сложных макетов страниц — всё состоит из виджетов.
Что такое виджет?
Виджет — это класс Dart, который описывает внешний вид и поведение UI. Каждое приложение Flutter по сути представляет собой древовидную структуру, состоящую из виджетов, называемую деревом виджетов.
Пример: простейший пример виджета
// Определить простой виджет
class HelloWidget extends StatelessWidget {
const HelloWidget({super.key});
@override
Widget build(BuildContext context) {
// Вернуть виджет Text, который отображает "Hello World"
return const Text('Hello World');
}
}
StatelessWidget — компонент без состояния
StatelessWidget — это неизменяемый виджет. После создания его свойства нельзя изменить. Он подходит для сценариев, в которых отображается статическое содержимое, например текст, изображения, иконки и т. д.
Базовая структура
Пример: StatelessWidget Пример
// Определить виджет без состояния
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
// Определить виджет с состоянием
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: [
// Отобразить текущее значение счётчика
Текст(
'Counter: $_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
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(
'Привет, Flutter',
style: TextStyle(
color: theme.colorScheme.onPrimaryContainer,
fontSize: 20,
),
),
);
}
Часто используемые базовые виджеты
Text - отображение текста
Пример: виджет Text
const Text('Привет, мир')
// Текст со стилем
Текст(
'Привет, Flutter',
style: TextStyle(
fontSize: 20,
fontWeight: FontWeight.bold,
color: Colors.blue,
),
)
// Текст с необязательным стилем
Text.rich(
TextSpan(
text: 'Привет ',
children: [
TextSpan(
text: 'Flutter',
style: TextStyle(fontWeight: FontWeight.bold),
),
],
),
)
Значок
Пример: виджет Icon
const Icon(Icons.home) // Иконка дома
const Icon(Icons.star, color: Colors.yellow) // Цветная звезда
const Icon(Icons.settings, size: 48) // Иконка настроек размером 48
Image
Пример: виджет Image
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,
)
Кнопка
Пример: виджет кнопки
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('Сохранить'),
)
Комбинирование виджетов
Мощь Flutter заключается в его способности комбинировать виджеты. Благодаря вложенности простой виджет может построить сложный UI.
Пример: составной виджет
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('Подтвердить'),
),
],
),
],
),
),
);
}
}