Пользовательский ввод во Flutter

В этом разделе будет рассказано, как обрабатывать пользовательский ввод в приложениях Flutter, включая ввод текста, нажатия кнопок, обработку форм и многое другое.


TextField - Ввод текста

TextField — наиболее часто используемый виджет для ввода текста во Flutter.

Пример: Базовое использование TextField

// Простейший TextField
TextField()

// TextField с decoration
TextField(
  decoration: const InputDecoration(
    labelText: Имя пользователя,  // Метка
    hintText: 'Введите имя пользователя',  // Текст подсказки
    prefixIcon: Icon(Icons.person),  // Префиксная иконка
  ),
)

// TextField с рамкой
TextField(
  decoration: InputDecoration(
    border: OutlineInputBorder(  // Внешняя граница
      borderRadius: BorderRadius.circular(8),
    ),
    labelText: Пароль,
  ),
  obscureText: true,  // Скрыть содержимое ввода (сценарий с паролем)
)

// Многострочный ввод текста
TextField(
  maxLines: 3,  // Максимальное количество строк
  decoration: const InputDecoration(
    hintText: 'Пожалуйста, введите многострочный текст',
  ),
)

TextEditingController - контроллер текста

Используя TextEditingController, вы можете читать и управлять содержимым TextField.

< h2 class="example">Пример: использование TextEditingController
class TextFieldExample extends StatefulWidget {
  const TextFieldExample({super.key});

  @override
  State<TextFieldExample> createState() => _TextFieldExampleState();
}

class _TextFieldExampleState extends State<TextFieldExample> {
  // Создать контроллер
  final TextEditingController _controller = TextEditingController();
  String _displayText = '';

  @override
  void dispose() {
    // Освободить контроллер
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        TextField(
          controller: _controller,  // Привязать контроллер
          decoration: const InputDecoration(
            labelText: 'Введите текст',
          ),
          onChanged: (text) {
            // Слушать изменения текста
            print('Текущий ввод: $text');
          },
        ),
        const SizedBox(height: 20),
        // Отобразить введённый текст
        Text('Вы ввели: $_displayText'),
        const SizedBox(height: 20),
        ElevatedButton(
          onPressed: () {
            // Чтение текста
            setState(() {
              _displayText = _controller.text;
            });
          },
          child: const Text('Показать введённый текст'),
        ),
        ElevatedButton(
          onPressed: () {
            // Очистить текст
            _controller.clear();
          },
          child: const Text('Очистить'),
        ),
        ElevatedButton(
          onPressed: () {
            // Установить текст
            _controller.text = 'Предустановленный текст';
          },
          child: const Text('Set text'),
        ),
      ],
    );
  }
}

Управление фокусом

Использование FocusNode позволяет управлять фокусом полей ввода.

Пример: Управление фокусом

class FocusExample extends StatefulWidget {
  const FocusExample({super.key});

  @override
  State<FocusExample> createState() => _FocusExampleState();
}

class _FocusExampleState extends State<FocusExample> {
  final FocusNode _focusNode1 = FocusNode();
  final FocusNode _focusNode2 = FocusNode();

  @override
  void dispose() {
    _focusNode1.dispose();
    _focusNode2.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        TextField(
          focusNode: _focusNode1,
          decoration: const InputDecoration(labelText: 'Поле ввода 1'),
        ),
        const SizedBox(height: 10),
        TextField(
          focusNode: _focusNode2,
          decoration: const InputDecoration(labelText: 'Поле ввода 2'),
        ),
        const SizedBox(height: 20),
        ElevatedButton(
          onPressed: () {
            // Установить фокус на поле ввода 1
            _focusNode1.requestFocus();
          },
          child: const Text('Установить фокус на поле ввода 1'),
        ),
        ElevatedButton(
          onPressed: () {
            // Установить фокус на поле ввода 2
            _focusNode2.requestFocus();
          },
          child: const Text('Установить фокус на поле ввода 2'),
        ),
        ElevatedButton(
          onPressed: () {
            // Убрать фокус
            _focusNode1.unfocus();
            _focusNode2.unfocus();
          },
          child: const Text('Убрать фокус'),
        ),
      ],
    );
  }
}

Кнопки и события нажатия

Flutter предоставляет множество компонентов кнопок для обработки нажатий пользователя.

Пример: различные кнопки

// TextButton - текстовая кнопка
TextButton(
  onPressed: () => print('Нажата текстовая кнопка'),
  child: const Text('Текстовая кнопка'),
)

// ElevatedButton - приподнятая кнопка
ElevatedButton(
  onPressed: () => print('Нажата приподнятая кнопка'),
  child: const Text('Отправить'),
)

// OutlinedButton - контурная кнопка
OutlinedButton(
  onPressed: () => print('Нажата контурная кнопка'),
  child: const Text('Отмена'),
)

// IconButton - кнопка с иконкой
IconButton(
  icon: const Icon(Icons.favorite),
  onPressed: () => print('Нажата кнопка с иконкой'),
)

// Кнопка с иконкой
ElevatedButton.icon(
  onPressed: () => print('Нажата кнопка с иконкой'),
  icon: const Icon(Icons.save),
  label: const Text('Сохранить'),
)

// CupertinoButton - кнопка в стиле iOS
CupertinoButton(
  child: const Text('iOS button'),
  onPressed: () {},
)

Switch、Checkbox、Radio

Пример: Switch, Checkbox, Radio Button

class SwitchCheckboxExample extends StatefulWidget {
  const SwitchCheckboxExample({super.key});

  @override
  State<SwitchCheckboxExample> createState() => _SwitchCheckboxExampleState();
}

class _SwitchCheckboxExampleState extends State<SwitchCheckboxExample> {
  bool _switchValue = false;
  bool _checkboxValue = false;
  String _radioValue = 'A';

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        // Switch - переключатель
        Switch(
          value: _switchValue,
          onChanged: (value) {
            setState(() {
              _switchValue = value;
            });
          },
        ),
        Text('Значение переключателя: $_switchValue'),

        // Checkbox - флажок
        Флажок(
          value: _checkboxValue,
          onChanged: (value) {
            setState(() {
              _checkboxValue = value ?? false;
            });
          },
        ),
        Text('Значение флажка: $_checkboxValue'),

        // Radio - радиокнопка
        Row(
          children: [
            Radio<String>(
              value: 'A',
              groupValue: _radioValue,
              onChanged: (value) {
                setState(() {
                  _radioValue = value!;
                });
              },
            ),
            const Text('Вариант A'),
            Radio<String>(
              value: 'B',
              groupValue: _radioValue,
              onChanged: (value) {
                setState(() {
                  _radioValue = value!;
                });
              },
            ),
            const Text('Вариант B'),
          ],
        ),
        Text('Значение переключателя: $_radioValue'),
      ],
    );
  }
}

Slider - Slider

Пример: использование Slider

class SliderExample extends StatefulWidget {
  const SliderExample({super.key});

  @override
  State<SliderExample> createState() => _SliderExampleState();
}

class _SliderExampleState extends State<SliderExample> {
  double _sliderValue = 0.5;

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        Slider(
          value: _sliderValue,  // Текущее значение (0.0-1.0)
          min: 0.0,
          max: 1.0,
          divisions: 10,  // Разделить на 10 тиков
          label: '${(_sliderValue * 100).round()}%',
          onChanged: (value) {
            setState(() {
              _sliderValue = value;
            });
          },
        ),
        Text('Текущее значение: ${(_sliderValue * 100).round()}%'),

        // Слайдер диапазона
        RangeSlider(
          values: const RangeValues(0.3, 0.7),
          min: 0.0,
          max: 1.0,
          onChanged: (values) {
            print('Диапазон: ${values.start} - ${values.end}');
          },
        ),
      ],
    );
  }
}

При обработке пользовательского ввода не забудьте использовать setState для обновления состояния UI, чтобы интерфейс мог реагировать на действия пользователя.

Другие расширения