Files
pipelines/app/lib/ui/status/run_status_icon.dart
T

103 lines
3.2 KiB
Dart

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import '../adaptive/host.dart';
/// The one status glyph a run row leads with, as the web's `statusIcon`: a
/// single coloured icon whose tooltip and accessible name say the state.
///
/// [state] is the normalised run state (`succeeded`, `failed`, `running`,
/// `waiting`, `queued`, `canceled`, `interrupted`, anything else unknown);
/// [label] is the word a person reads. Colours are the platform's dynamic
/// system colours, so the glyph keeps its contrast in light and dark themes.
class RunStatusIcon extends StatelessWidget {
const RunStatusIcon({
super.key,
required this.state,
required this.label,
this.size = 18,
});
final String state;
final String label;
final double size;
@override
Widget build(BuildContext context) {
final cupertino = usesCupertinoHost(context);
final color = runStatusColor(state).resolveFrom(context);
return Tooltip(
message: label,
child: Semantics(
label: label,
image: true,
excludeSemantics: true,
child: Icon(
cupertino ? _cupertinoIcon(state) : _materialIcon(state),
size: size,
color: color,
),
),
);
}
}
/// The dynamic colour for a run state, shared by every status glyph.
CupertinoDynamicColor runStatusColor(String state) => switch (state) {
'succeeded' => CupertinoColors.systemGreen,
'failed' => CupertinoColors.systemRed,
'running' || 'active' => CupertinoColors.systemBlue,
'waiting' => CupertinoColors.systemTeal,
'interrupted' => CupertinoColors.systemOrange,
_ => CupertinoColors.systemGrey,
};
IconData _materialIcon(String state) => switch (state) {
'succeeded' => Icons.check_circle_outline,
'failed' => Icons.cancel_outlined,
'running' || 'active' => Icons.autorenew,
'canceled' => Icons.block,
'interrupted' => Icons.pause_circle_outline,
'waiting' || 'queued' => Icons.schedule,
_ => Icons.help_outline,
};
IconData _cupertinoIcon(String state) => switch (state) {
'succeeded' => CupertinoIcons.check_mark_circled,
'failed' => CupertinoIcons.xmark_circle,
'running' || 'active' => CupertinoIcons.arrow_2_circlepath,
'canceled' => CupertinoIcons.nosign,
'interrupted' => CupertinoIcons.pause_circle,
'waiting' || 'queued' => CupertinoIcons.clock,
_ => CupertinoIcons.question_circle,
};
/// The run detail's kicker above its title, as the web's `run-kicker`: the
/// status glyph and the state word in the state's colour.
class RunStatusKicker extends StatelessWidget {
const RunStatusKicker({super.key, required this.state, required this.label});
final String state;
final String label;
@override
Widget build(BuildContext context) {
final color = runStatusColor(state).resolveFrom(context);
return Row(
key: const Key('run-status-kicker'),
mainAxisSize: MainAxisSize.min,
children: [
RunStatusIcon(state: state, label: label, size: 16),
const SizedBox(width: 6),
// A long state (`cancel requested`) wraps rather than overflowing a
// 320px pane at 2x text.
Flexible(
child: ExcludeSemantics(
child: Text(label, style: TextStyle(color: color)),
),
),
],
);
}
}