mirror of
https://github.com/flutter/flutter.git
synced 2025-06-03 00:51:18 +00:00

## Description This PR adds more documentation for `TextEditingController(String text)` constructor and it adds one example. https://github.com/flutter/flutter/pull/96245 was a first improvement to the documentation. https://github.com/flutter/flutter/issues/79495 tried to hide the cursor when an invalid selection is set but it was reverted. https://github.com/flutter/flutter/pull/123777 mitigated the issue of having a default invalid selection: it takes care of setting a proper selection when a text field is focused and its controller selection is not initialized. I will try changing the initial selection in another PR, but It will probably break several existing tests. ## Related Issue Fixes https://github.com/flutter/flutter/issues/95978 ## Tests Adds 1 test for the new example.
62 lines
1.6 KiB
Dart
62 lines
1.6 KiB
Dart
// Copyright 2014 The Flutter Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
import 'package:flutter/material.dart';
|
|
|
|
/// Flutter code sample for [TextEditingController].
|
|
|
|
void main() {
|
|
runApp(const TextEditingControllerExampleApp());
|
|
}
|
|
|
|
class TextEditingControllerExampleApp extends StatelessWidget {
|
|
const TextEditingControllerExampleApp({super.key});
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return const MaterialApp(
|
|
home: TextEditingControllerExample(),
|
|
);
|
|
}
|
|
}
|
|
|
|
class TextEditingControllerExample extends StatefulWidget {
|
|
const TextEditingControllerExample({super.key});
|
|
|
|
@override
|
|
State<TextEditingControllerExample> createState() => _TextEditingControllerExampleState();
|
|
}
|
|
|
|
class _TextEditingControllerExampleState extends State<TextEditingControllerExample> {
|
|
// Create a controller whose initial selection is empty (collapsed) and positioned
|
|
// before the text (offset is 0).
|
|
final TextEditingController _controller = TextEditingController.fromValue(
|
|
const TextEditingValue(
|
|
text: 'Flutter',
|
|
selection: TextSelection.collapsed(offset: 0),
|
|
),
|
|
);
|
|
|
|
@override
|
|
void dispose() {
|
|
_controller.dispose();
|
|
super.dispose();
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return Scaffold(
|
|
body: Container(
|
|
alignment: Alignment.center,
|
|
padding: const EdgeInsets.all(16.0),
|
|
child: TextField(
|
|
controller: _controller,
|
|
autofocus: true,
|
|
decoration: const InputDecoration(filled: true),
|
|
),
|
|
),
|
|
);
|
|
}
|
|
}
|