2628f6c425
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.
91 lines
3.3 KiB
Dart
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';
|
|
}
|