- Extract reusable widgets (chat composer/send pipeline, message bubble frame, reaction chips, path map scaffold, radio settings dialog, translation settings section, map POI clusters, nav tiles, etc.) and slim down the screens that used them - Map: hide/remove markers with restore, confirm before setting node location, POI clustering, semantics labels - Map cache: cancellable downloads and a bulk tile limit - Repeater: unsaved-changes guard, CLI search/copy/share transcript, framed-command debug preview, disconnected banner - Confirm before clearing chats and debug logs - Keep cached unread totals in sync on per-contact/channel updates - Move remaining hardcoded strings into l10n and translate the 98 new keys into all 17 non-English locales
169 lines
5.7 KiB
Dart
169 lines
5.7 KiB
Dart
import 'dart:convert';
|
||
|
||
import 'package:flutter/material.dart';
|
||
import 'package:flutter/services.dart';
|
||
|
||
import '../helpers/utf8_length_limiter.dart';
|
||
|
||
/// A [TextField] that displays a live UTF-8 byte counter.
|
||
///
|
||
/// The counter appears below the field once the user starts typing and changes
|
||
/// colour as the limit is approached (orange at 70 %, error-red at 90 %).
|
||
///
|
||
/// All standard [TextField] behaviour (focus nodes, input actions, decoration
|
||
/// overrides, etc.) is forwarded so the widget can be dropped into any screen.
|
||
class ByteCountedTextField extends StatelessWidget {
|
||
/// Maximum number of UTF-8 bytes allowed.
|
||
final int maxBytes;
|
||
|
||
/// Controller for the text field.
|
||
final TextEditingController controller;
|
||
|
||
/// Optional focus node forwarded to the inner [TextField].
|
||
final FocusNode? focusNode;
|
||
|
||
/// Whether the inner [TextField] requests focus when first built.
|
||
final bool autofocus;
|
||
|
||
/// Hint text shown when the field is empty.
|
||
final String? hintText;
|
||
|
||
/// Keyboard action button (defaults to [TextInputAction.send]).
|
||
final TextInputAction textInputAction;
|
||
|
||
/// Called when the user submits via the keyboard action button.
|
||
final ValueChanged<String>? onSubmitted;
|
||
|
||
/// Additional [TextInputFormatter]s applied *before* the byte limiter.
|
||
final List<TextInputFormatter> extraFormatters;
|
||
|
||
/// Text capitalisation forwarded to the inner [TextField].
|
||
final TextCapitalization textCapitalization;
|
||
|
||
/// Optional full [InputDecoration] override. When provided, [hintText] is
|
||
/// ignored – set it inside the decoration instead.
|
||
final InputDecoration? decoration;
|
||
|
||
/// Ratio (0–1) at which the counter turns the warning colour (default 0.7).
|
||
final double warningThreshold;
|
||
|
||
/// Ratio (0–1) at which the counter turns the error colour (default 0.9).
|
||
final double errorThreshold;
|
||
|
||
/// Whether to hide the counter when the field is empty (default `true`).
|
||
final bool hideCounterWhenEmpty;
|
||
|
||
/// Optional encoder function to transform text before byte counting/limiting.
|
||
/// If provided, byte limits and counters will use the encoded text length.
|
||
final String Function(String)? encoder;
|
||
|
||
/// Optional byte count above which [softLimitNote] is shown next to the
|
||
/// counter (the text is still allowed up to [maxBytes]).
|
||
final int? softLimitBytes;
|
||
final String? softLimitNote;
|
||
|
||
const ByteCountedTextField({
|
||
super.key,
|
||
required this.maxBytes,
|
||
required this.controller,
|
||
this.focusNode,
|
||
this.autofocus = false,
|
||
this.hintText,
|
||
this.textInputAction = TextInputAction.send,
|
||
this.onSubmitted,
|
||
this.extraFormatters = const [],
|
||
this.textCapitalization = TextCapitalization.sentences,
|
||
this.decoration,
|
||
this.warningThreshold = 0.7,
|
||
this.errorThreshold = 0.9,
|
||
this.hideCounterWhenEmpty = true,
|
||
this.encoder,
|
||
this.softLimitBytes,
|
||
this.softLimitNote,
|
||
});
|
||
|
||
@override
|
||
Widget build(BuildContext context) {
|
||
return ValueListenableBuilder<TextEditingValue>(
|
||
valueListenable: controller,
|
||
builder: (context, value, _) {
|
||
final effectiveText = encoder != null
|
||
? encoder!(value.text)
|
||
: value.text;
|
||
final usedBytes = utf8.encode(effectiveText).length;
|
||
final ratio = maxBytes > 0 ? usedBytes / maxBytes : 0.0;
|
||
final showCounter = !(hideCounterWhenEmpty && value.text.isEmpty);
|
||
final showSoftLimitNote =
|
||
softLimitNote != null &&
|
||
softLimitBytes != null &&
|
||
usedBytes > softLimitBytes!;
|
||
|
||
final counterColor = ratio > errorThreshold
|
||
? Theme.of(context).colorScheme.error
|
||
: ratio > warningThreshold
|
||
? Theme.of(context).colorScheme.tertiary
|
||
: Theme.of(context).colorScheme.onSurfaceVariant;
|
||
|
||
return Column(
|
||
mainAxisSize: MainAxisSize.min,
|
||
crossAxisAlignment: CrossAxisAlignment.stretch,
|
||
children: [
|
||
TextField(
|
||
maxLines: null,
|
||
controller: controller,
|
||
focusNode: focusNode,
|
||
autofocus: autofocus,
|
||
inputFormatters: [
|
||
...extraFormatters,
|
||
Utf8LengthLimitingTextInputFormatter(
|
||
maxBytes,
|
||
encoder: encoder,
|
||
),
|
||
],
|
||
textCapitalization: textCapitalization,
|
||
decoration:
|
||
decoration ??
|
||
InputDecoration(
|
||
hintText: hintText,
|
||
border: const OutlineInputBorder(),
|
||
contentPadding: const EdgeInsets.symmetric(
|
||
horizontal: 16,
|
||
vertical: 12,
|
||
),
|
||
),
|
||
textInputAction: textInputAction,
|
||
onSubmitted: onSubmitted,
|
||
),
|
||
Opacity(
|
||
opacity: showCounter ? 1 : 0,
|
||
child: Padding(
|
||
padding: const EdgeInsets.only(top: 4, right: 4),
|
||
child: Row(
|
||
children: [
|
||
Expanded(
|
||
child: showSoftLimitNote
|
||
? Text(
|
||
softLimitNote!,
|
||
style: TextStyle(
|
||
fontSize: 12,
|
||
color: Theme.of(context).colorScheme.tertiary,
|
||
),
|
||
)
|
||
: const SizedBox.shrink(),
|
||
),
|
||
const SizedBox(width: 8),
|
||
Text(
|
||
'$usedBytes / $maxBytes',
|
||
style: TextStyle(fontSize: 12, color: counterColor),
|
||
),
|
||
],
|
||
),
|
||
),
|
||
),
|
||
],
|
||
);
|
||
},
|
||
);
|
||
}
|
||
}
|