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)), ), ), ], ); } }