Files
pipelines/app/lib/features/terminal/terminal_shortcuts.dart
T
alan 2628f6c425 Copy a terminal selection with Ctrl+C outside Apple platforms
A browser keeps Ctrl+Shift+C for its developer tools, so on Linux and
Windows web nothing copied. With text selected Ctrl+C now copies it (and
clears the selection) instead of interrupting the process; Ctrl+Insert
copies too, and a finished run's read-only output answers the copy keys.
The terminal's options menu names the key.
2026-11-11 00:05:16 +00:00

91 lines
3.3 KiB
Dart

import 'package:flutter/foundation.dart';
import 'package:flutter/services.dart';
/// Whether [event] shows or hides the terminal: Alt+T, Ctrl+T, Cmd+T
/// (Meta+T) or Ctrl+` (Shift allowed only with Ctrl+`). They are global key
/// handlers, so inside the terminal they toggle rather than reaching the
/// shell (whose Ctrl+T, transpose-chars, is then not available) and inside
/// text fields they toggle rather than type.
///
/// A held chord's repeats match too (and are swallowed); only its first
/// press toggles.
bool terminalToggleShortcut(KeyEvent event, HardwareKeyboard keyboard) {
if (event is KeyUpEvent) return false;
final control = keyboard.isControlPressed;
final meta = keyboard.isMetaPressed;
final alt = keyboard.isAltPressed;
if (event.logicalKey == LogicalKeyboardKey.backquote) {
// Cmd+` is the macOS window switcher.
return control && !meta && !alt;
}
// Option+T types a symbol (†) on a Mac, so with Alt the key is also
// recognised by its position.
final t =
event.logicalKey == LogicalKeyboardKey.keyT ||
alt && event.physicalKey == PhysicalKeyboardKey.keyT;
if (!t || keyboard.isShiftPressed) return false;
return [control, meta, alt].where((pressed) => pressed).length == 1;
}
/// The step Ctrl+Tab (1) or Ctrl+Shift+Tab (-1) moves between terminal
/// tabs (again as it repeats), or null for any other key.
int? terminalTabShortcut(KeyEvent event, HardwareKeyboard keyboard) {
if (event is KeyUpEvent ||
event.logicalKey != LogicalKeyboardKey.tab ||
!keyboard.isControlPressed ||
keyboard.isMetaPressed ||
keyboard.isAltPressed) {
return null;
}
return keyboard.isShiftPressed ? -1 : 1;
}
/// The terminal's shortcuts as they work on this platform, for its tooltip
/// and menu. A browser tab never receives Cmd+T, Ctrl+Tab or Ctrl+Shift+Tab
/// (new tab, next and previous tab), nor Ctrl+T outside macOS, where it
/// also opens a tab; native builds get them all.
class TerminalShortcutLabels {
const TerminalShortcutLabels({required this.web, required this.platform});
TerminalShortcutLabels.current()
: web = kIsWeb,
platform = defaultTargetPlatform;
final bool web;
final TargetPlatform platform;
bool get _apple =>
platform == TargetPlatform.macOS || platform == TargetPlatform.iOS;
/// The keys that show or hide the terminal. The Alt chord leads (the
/// button's tooltip names it): every platform and browser delivers it.
List<String> get toggle => [
_apple ? 'Option+T' : 'Alt+T',
if (!web && _apple) 'Cmd+T',
if (!web || _apple) 'Ctrl+T',
'Ctrl+`',
];
/// The keys that move between tabs, or none where the browser keeps them.
List<String> get tabs =>
web ? const [] : const ['Ctrl+Tab', 'Ctrl+Shift+Tab'];
/// The toggle button's tooltip.
String get button => 'Terminal (${toggle.first})';
/// Every shortcut, one per line, for the terminal's menu.
String get summary => [
'Show or hide: ${toggle.join(', ')}',
if (tabs.isNotEmpty) 'Next or previous tab: ${tabs.join(' / ')}',
'Copy selected text: $copy',
].join('\n');
/// The keys that copy the terminal's selected text. A browser keeps
/// Ctrl+Shift+C for its developer tools.
String get copy => _apple
? 'Cmd+C'
: web
? 'Ctrl+C'
: 'Ctrl+C, Ctrl+Shift+C';
}