- Updated LoRa airtime calculations in `lora_airtime_test.dart` to reflect new reference values. - Introduced new tests for LDRO behavior and preamble symbol calculations. - Added `contact_path_width_test.dart` to validate path hash width handling in contacts. - Enhanced `model_changes_test.dart` to ensure legacy data migration works correctly. - Created `remote_node_stats_test.dart` to decode and validate remote node statistics. - Implemented `map_marker_parse_test.dart` for parsing marker text with coordinate validation. - Developed `map_tile_cache_key_test.dart` to ensure API keys are excluded from cache keys. - Added `message_retry_failure_test.dart` to test message retry service behavior on failures. - Extended `path_history_service_test.dart` to preserve learned state across path attempts. - Enhanced `received_image_store_test.dart` to handle concurrent writes and review fixes. - Implemented `repeater_command_service_test.dart` to validate command response handling. - Created `store_tolerant_parsing_test.dart` to ensure stores skip malformed records gracefully. - Cleared untranslated JSON file for localization updates.
164 lines
5.6 KiB
Dart
164 lines
5.6 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;
|
||
|
||
/// 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.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,
|
||
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: 11,
|
||
color: Theme.of(context).colorScheme.tertiary,
|
||
),
|
||
)
|
||
: const SizedBox.shrink(),
|
||
),
|
||
const SizedBox(width: 8),
|
||
Text(
|
||
'$usedBytes / $maxBytes',
|
||
style: TextStyle(fontSize: 11, color: counterColor),
|
||
),
|
||
],
|
||
),
|
||
),
|
||
),
|
||
],
|
||
);
|
||
},
|
||
);
|
||
}
|
||
}
|