Основы виджетов Flutter

Виджет — это основной строительный блок Flutter UI.

В Flutter всё является виджетом: от простого текста до сложных макетов страниц — всё состоит из виджетов.


Что такое виджет?

Виджет — это класс Dart, который описывает внешний вид и поведение UI. Каждое приложение Flutter по сути представляет собой древовидную структуру, состоящую из виджетов, называемую деревом виджетов.

Пример: простейший пример виджета

import 'package:flutter/material.dart';

// Определить простой виджет
class HelloWidget extends StatelessWidget {
  const HelloWidget({super.key});

  @override
  Widget build(BuildContext context) {
    // Вернуть виджет Text, который отображает "Hello World"
    return const Text('Hello World');
  }
}

StatelessWidget — компонент без состояния

StatelessWidget — это неизменяемый виджет. После создания его свойства нельзя изменить. Он подходит для сценариев, в которых отображается статическое содержимое, например текст, изображения, иконки и т. д.

Базовая структура

Пример: 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)

Применимые сценарии

  • Отображение статического текста
  • Отображение изображения
  • Отображение иконки
  • Макет, который не меняется со временем

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: [
        // Отобразить текущее значение счётчика
        Текст(
          '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

@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(
      'Привет, 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

// Использовать Material Icons
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.

Пример: составной виджет

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('Подтвердить'),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}
Другие расширения