Пользовательский ввод во 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: 'Пожалуйста, введите многострочный текст',
),
)
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'),
),
],
);
}
}
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('Убрать фокус'),
),
],
);
}
}
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: () {},
)
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'),
],
);
}
}
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}');
},
),
],
);
}
}
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, чтобы интерфейс мог реагировать на действия пользователя.