// ignore_for_file: implementation_imports import 'dart:math'; import 'package:code_editor/l10n/app_localizations.dart'; import 'package:code_editor/utils/dialog_utils.dart'; import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; import 'package:xterm/src/ui/render.dart'; import 'package:xterm/xterm.dart' as xterm; enum _DraggingHandle { none, start, end } /// 终端文字框选交互叠加层 /// 包含双端拖动手柄(Start/End Handle)与高层级浮动上下文操作菜单(复制、粘贴、全选) class TerminalSelectionOverlay extends StatefulWidget { final xterm.Terminal terminal; final xterm.TerminalController controller; final GlobalKey terminalViewKey; final FocusNode focusNode; final Widget child; const TerminalSelectionOverlay({ super.key, required this.terminal, required this.controller, required this.terminalViewKey, required this.focusNode, required this.child, }); @override State createState() => _TerminalSelectionOverlayState(); } class _TerminalSelectionOverlayState extends State { OverlayEntry? _menuOverlayEntry; _DraggingHandle _dragging = _DraggingHandle.none; bool _isScrolling = false; bool _isPointerSelecting = false; Offset? _lastActiveAnchor; @override void initState() { super.initState(); widget.controller.addListener(_onSelectionChanged); } @override void didUpdateWidget(TerminalSelectionOverlay oldWidget) { super.didUpdateWidget(oldWidget); if (oldWidget.controller != widget.controller) { oldWidget.controller.removeListener(_onSelectionChanged); widget.controller.addListener(_onSelectionChanged); } } @override void dispose() { widget.controller.removeListener(_onSelectionChanged); _hideMenu(); super.dispose(); } RenderTerminal? get _renderTerminal { return widget.terminalViewKey.currentState?.renderTerminal; } void _onSelectionChanged() { if (!mounted) return; final selection = widget.controller.selection; if (selection == null || selection.isCollapsed) { _hideMenu(); setState(() {}); return; } // 若非正在拖动手柄或滑动,展示菜单 if (_dragging == _DraggingHandle.none && !_isScrolling && !_isPointerSelecting) { _updateLastActiveAnchorDefault(); _showMenu(); } setState(() {}); } void _updateLastActiveAnchorDefault() { final render = _renderTerminal; final selection = widget.controller.selection; if (render == null || selection == null || selection.isCollapsed) return; final range = selection.normalized; final endOffset = render.getOffset(range.end); final globalEnd = render.localToGlobal( endOffset + Offset(render.cellSize.width, render.cellSize.height), ); _lastActiveAnchor = globalEnd; } void _hideMenu() { _menuOverlayEntry?.remove(); _menuOverlayEntry = null; } void _showMenu([Offset? targetAnchor]) { _hideMenu(); if (!mounted) return; final selection = widget.controller.selection; if (selection == null || selection.isCollapsed) return; final anchor = targetAnchor ?? _lastActiveAnchor; if (anchor == null) return; _lastActiveAnchor = anchor; final overlayState = Overlay.of(context, rootOverlay: true); _menuOverlayEntry = OverlayEntry( builder: (context) { return _TerminalContextMenuWidget( anchor: anchor, onCopy: _handleCopy, onPaste: _handlePaste, onSelectAll: _handleSelectAll, onDismiss: _hideMenu, ); }, ); overlayState.insert(_menuOverlayEntry!); } Future _handleCopy() async { final selection = widget.controller.selection; if (selection == null || selection.isCollapsed) { _hideMenu(); return; } final text = widget.terminal.buffer.getText(selection); await Clipboard.setData(ClipboardData(text: text)); _hideMenu(); widget.controller.clearSelection(); if (mounted) { final l10n = AppLocalizations.of(context); if (l10n != null) { DialogUtils.showSuccessToast(context, l10n.copiedToClipboard); } } } Future _handlePaste() async { _hideMenu(); final data = await Clipboard.getData(Clipboard.kTextPlain); final text = data?.text; if (text != null && text.isNotEmpty) { widget.terminal.paste(text); widget.controller.clearSelection(); } } void _handleSelectAll() { final width = widget.terminal.viewWidth; final height = widget.terminal.buffer.height; widget.controller.setSelection( widget.terminal.buffer.createAnchor(0, 0), widget.terminal.buffer.createAnchor(max(0, width - 1), max(0, height - 1)), mode: xterm.SelectionMode.line, ); WidgetsBinding.instance.addPostFrameCallback((_) { if (mounted) { _updateLastActiveAnchorDefault(); _showMenu(); } }); } // --- 手柄拖拽逻辑 --- void _onStartHandlePanStart(DragStartDetails details) { _dragging = _DraggingHandle.start; _hideMenu(); } void _onStartHandlePanUpdate(DragUpdateDetails details) { final render = _renderTerminal; final selection = widget.controller.selection; if (render == null || selection == null) return; final range = selection.normalized; final localPos = render.globalToLocal(details.globalPosition); final adjusted = Offset(localPos.dx, localPos.dy - render.cellSize.height / 2); final cell = render.getCellOffset(adjusted); // 约束:起始手柄不能越过结束手柄 if (cell.isBefore(range.end) || cell.isEqual(range.end)) { widget.controller.setSelection( widget.terminal.buffer.createAnchorFromOffset(cell), widget.terminal.buffer.createAnchorFromOffset(range.end), ); final newLocal = render.getOffset(cell); _lastActiveAnchor = render.localToGlobal(newLocal + Offset(0, render.cellSize.height)); } } void _onStartHandlePanEnd(DragEndDetails details) { _dragging = _DraggingHandle.none; if (mounted && widget.controller.selection != null && !widget.controller.selection!.isCollapsed) { _showMenu(_lastActiveAnchor); } } void _onEndHandlePanStart(DragStartDetails details) { _dragging = _DraggingHandle.end; _hideMenu(); } void _onEndHandlePanUpdate(DragUpdateDetails details) { final render = _renderTerminal; final selection = widget.controller.selection; if (render == null || selection == null) return; final range = selection.normalized; final localPos = render.globalToLocal(details.globalPosition); final adjusted = Offset(localPos.dx, localPos.dy - render.cellSize.height / 2); final cell = render.getCellOffset(adjusted); // 约束:结束手柄不能移到起始手柄之前 if (cell.isAfter(range.begin) || cell.isEqual(range.begin)) { widget.controller.setSelection( widget.terminal.buffer.createAnchorFromOffset(range.begin), widget.terminal.buffer.createAnchorFromOffset(cell), ); final newLocal = render.getOffset(cell); _lastActiveAnchor = render.localToGlobal( newLocal + Offset(render.cellSize.width, render.cellSize.height), ); } } void _onEndHandlePanEnd(DragEndDetails details) { _dragging = _DraggingHandle.none; if (mounted && widget.controller.selection != null && !widget.controller.selection!.isCollapsed) { _showMenu(_lastActiveAnchor); } } @override Widget build(BuildContext context) { final selection = widget.controller.selection; final hasSelection = selection != null && !selection.isCollapsed; final render = _renderTerminal; Offset? startHandleLocal; Offset? endHandleLocal; if (hasSelection && render != null && render.hasSize) { final range = selection.normalized; final startCellOffset = render.getOffset(range.begin); final endCellOffset = render.getOffset(range.end); final viewportHeight = render.size.height; final viewportWidth = render.size.width; // 起始手柄锚点(字符底部左侧) final rawStartY = startCellOffset.dy + render.cellSize.height; final clampedStartY = rawStartY.clamp(0.0, viewportHeight - 10.0); final clampedStartX = startCellOffset.dx.clamp(0.0, viewportWidth - 20.0); startHandleLocal = Offset(clampedStartX, clampedStartY); // 结束手柄锚点(字符底部右侧) final rawEndY = endCellOffset.dy + render.cellSize.height; final clampedEndY = rawEndY.clamp(0.0, viewportHeight - 10.0); final clampedEndX = (endCellOffset.dx + render.cellSize.width).clamp(0.0, viewportWidth - 20.0); endHandleLocal = Offset(clampedEndX, clampedEndY); } return NotificationListener( onNotification: (notification) { if (notification is ScrollStartNotification) { _isScrolling = true; _hideMenu(); } else if (notification is ScrollUpdateNotification) { if (mounted) setState(() {}); } else if (notification is ScrollEndNotification) { _isScrolling = false; if (hasSelection && mounted && _dragging == _DraggingHandle.none) { _showMenu(_lastActiveAnchor); } } return false; }, child: Listener( onPointerDown: (event) { _isPointerSelecting = true; }, onPointerMove: (event) { if (_isPointerSelecting) { _hideMenu(); } }, onPointerUp: (event) { _isPointerSelecting = false; if (widget.controller.selection != null && !widget.controller.selection!.isCollapsed) { _lastActiveAnchor = event.position; if (_dragging == _DraggingHandle.none && !_isScrolling) { _showMenu(_lastActiveAnchor); } } setState(() {}); }, child: Stack( children: [ widget.child, if (hasSelection && startHandleLocal != null) Positioned( left: startHandleLocal.dx - 32.0, top: startHandleLocal.dy - 10.0, child: _TerminalSelectionHandle( isStart: true, lineHeight: render?.cellSize.height ?? 20.0, onPanStart: _onStartHandlePanStart, onPanUpdate: _onStartHandlePanUpdate, onPanEnd: _onStartHandlePanEnd, ), ), if (hasSelection && endHandleLocal != null) Positioned( left: endHandleLocal.dx - 10.0, top: endHandleLocal.dy - 10.0, child: _TerminalSelectionHandle( isStart: false, lineHeight: render?.cellSize.height ?? 20.0, onPanStart: _onEndHandlePanStart, onPanUpdate: _onEndHandlePanUpdate, onPanEnd: _onEndHandlePanEnd, ), ), ], ), ), ); } } /// 终端选区端点拖动手柄组件(采用与编辑区一致的 Material 水滴造型手柄,兼顾触屏大热区与鼠标拖拽) class _TerminalSelectionHandle extends StatelessWidget { final bool isStart; final double lineHeight; final GestureDragStartCallback onPanStart; final GestureDragUpdateCallback onPanUpdate; final GestureDragEndCallback onPanEnd; const _TerminalSelectionHandle({ required this.isStart, required this.lineHeight, required this.onPanStart, required this.onPanUpdate, required this.onPanEnd, }); @override Widget build(BuildContext context) { final type = isStart ? TextSelectionHandleType.left : TextSelectionHandleType.right; return MouseRegion( cursor: SystemMouseCursors.grab, child: GestureDetector( behavior: HitTestBehavior.opaque, onPanStart: onPanStart, onPanUpdate: onPanUpdate, onPanEnd: onPanEnd, child: Padding( padding: const EdgeInsets.all(10.0), child: materialTextSelectionControls.buildHandle( context, type, lineHeight, ), ), ), ); } } /// 终端高层级浮动上下文菜单(挂载于 Root Overlay) class _TerminalContextMenuWidget extends StatelessWidget { final Offset anchor; final VoidCallback onCopy; final VoidCallback onPaste; final VoidCallback onSelectAll; final VoidCallback onDismiss; const _TerminalContextMenuWidget({ required this.anchor, required this.onCopy, required this.onPaste, required this.onSelectAll, required this.onDismiss, }); @override Widget build(BuildContext context) { final l10n = AppLocalizations.of(context)!; final theme = Theme.of(context); final mediaQuery = MediaQuery.of(context); const menuWidth = 210.0; const menuHeight = 44.0; // 水平居中并限制在屏幕内 final screenWidth = mediaQuery.size.width; final double left = (anchor.dx - menuWidth / 2).clamp(12.0, max(12.0, screenWidth - menuWidth - 12.0)); // 垂直计算:优先位于锚点上方,若贴近屏幕顶端则悬浮于锚点下方 final topThreshold = mediaQuery.padding.top + 48.0; final double top; if (anchor.dy - menuHeight - 12.0 >= topThreshold) { top = anchor.dy - menuHeight - 12.0; } else { top = (anchor.dy + 14.0).clamp(topThreshold, mediaQuery.size.height - menuHeight - 12.0); } return Stack( children: [ // 点击外部空白区域关闭菜单 Positioned.fill( child: GestureDetector( behavior: HitTestBehavior.translucent, onTap: onDismiss, ), ), Positioned( left: left, top: top, child: Material( elevation: 8.0, borderRadius: BorderRadius.circular(10.0), color: theme.colorScheme.surfaceContainerHighest, surfaceTintColor: theme.colorScheme.surfaceTint, clipBehavior: Clip.antiAlias, child: Container( height: menuHeight, padding: const EdgeInsets.symmetric(horizontal: 4.0), decoration: BoxDecoration( borderRadius: BorderRadius.circular(10.0), border: Border.all( color: theme.colorScheme.outlineVariant.withValues(alpha: 0.5), width: 0.8, ), ), child: Row( mainAxisSize: MainAxisSize.min, children: [ _MenuItemButton( label: l10n.copy, icon: Icons.copy_rounded, onPressed: onCopy, ), _buildDivider(theme), _MenuItemButton( label: l10n.paste, icon: Icons.paste_rounded, onPressed: onPaste, ), _buildDivider(theme), _MenuItemButton( label: l10n.selectAll, icon: Icons.select_all_rounded, onPressed: onSelectAll, ), ], ), ), ), ), ], ); } Widget _buildDivider(ThemeData theme) { return Container( width: 1.0, height: 20.0, color: theme.colorScheme.outlineVariant.withValues(alpha: 0.6), ); } } class _MenuItemButton extends StatelessWidget { final String label; final IconData icon; final VoidCallback onPressed; const _MenuItemButton({ required this.label, required this.icon, required this.onPressed, }); @override Widget build(BuildContext context) { final theme = Theme.of(context); return InkWell( onTap: onPressed, borderRadius: BorderRadius.circular(8.0), child: Padding( padding: const EdgeInsets.symmetric(horizontal: 10.0, vertical: 8.0), child: Row( mainAxisSize: MainAxisSize.min, children: [ Icon(icon, size: 16.0, color: theme.colorScheme.primary), const SizedBox(width: 4.0), Text( label, style: TextStyle( fontSize: 13.0, fontWeight: FontWeight.w600, color: theme.colorScheme.onSurface, ), ), ], ), ), ); } }