2
This commit is contained in:
1 parent
9fbb414ee6
commit
4554f22c87
233 files changed
+147430
-605
No files matched your search
@@ -0,0 +1,172 @@
|
||||
import 'package:flutter/foundation.dart';
|
||||
import 'package:flutter/material.dart';
|
||||
import 'package:flutter/services.dart';
|
||||
import 'package:re_editor/re_editor.dart';
|
||||
|
||||
import '../models/virtual_keyboard_config.dart';
|
||||
|
||||
/// 虚拟小键盘的输入汇聚接口。
|
||||
///
|
||||
/// 键盘组件只负责"按键语义"(文本 / 成对符号 / 编辑器命令 / 命名特殊键),
|
||||
/// 由具体实现决定把语义落到编辑器还是终端上,避免键盘组件per-scope 分叉。
|
||||
///
|
||||
/// 不同作用域对同一语义的支持程度不同,不支持的实现应安全降级为空操作,
|
||||
/// 绝不静默插入无关内容。
|
||||
abstract class VirtualKeyboardSink {
|
||||
/// 发送一段文本(编辑区:插入;终端:写入 PTY)
|
||||
///
|
||||
/// [appendEnter] 仅终端有意义:发送后补一个回车符,实现"输入即执行"
|
||||
void sendText(String text, {bool appendEnter = false});
|
||||
|
||||
/// 成对符号:有选区时包裹选区,无选区时插入并把光标按 [cursorOffset] 偏移
|
||||
void sendPair(String pairText, int cursorOffset);
|
||||
|
||||
/// 编辑器命令(缩进、撤销、光标移动等)
|
||||
void sendCommand(String command);
|
||||
|
||||
/// 命名特殊键(终端:escape / tab / arrowUp / keyC + Ctrl 组合等)
|
||||
void sendNamedKey(String keyName, {KeyboardKeyMods mods = KeyboardKeyMods.none});
|
||||
|
||||
/// 收起软键盘
|
||||
void hideKeyboard();
|
||||
}
|
||||
|
||||
/// 编辑区实现:把按键语义落到 [CodeLineEditingController] 上
|
||||
class EditorKeyboardSink implements VirtualKeyboardSink {
|
||||
final CodeLineEditingController controller;
|
||||
final FocusNode? focusNode;
|
||||
|
||||
EditorKeyboardSink({required this.controller, this.focusNode});
|
||||
|
||||
@override
|
||||
void sendText(String text, {bool appendEnter = false}) {
|
||||
if (text.isEmpty) return;
|
||||
// 编辑区不存在"回车执行"语义,appendEnter 直接忽略(由校验层禁止该组合)
|
||||
controller.replaceSelection(text);
|
||||
}
|
||||
|
||||
@override
|
||||
void sendPair(String pairText, int cursorOffset) {
|
||||
final hasSelection = !controller.selection.isCollapsed &&
|
||||
controller.selection.baseOffset != -1 &&
|
||||
controller.selection.extentOffset != -1;
|
||||
|
||||
if (hasSelection) {
|
||||
final selected = controller.selectedText;
|
||||
if (pairText.length >= 2) {
|
||||
final left = pairText.substring(0, pairText.length ~/ 2);
|
||||
final right = pairText.substring(pairText.length ~/ 2);
|
||||
controller.replaceSelection(left + selected + right);
|
||||
} else {
|
||||
controller.replaceSelection(pairText + selected + pairText);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
controller.replaceSelection(pairText);
|
||||
if (cursorOffset != 0) {
|
||||
final curSel = controller.selection;
|
||||
final targetOffset = (curSel.extentOffset + cursorOffset).clamp(0, controller.extentLine.length);
|
||||
controller.selection = CodeLineSelection.collapsed(
|
||||
index: curSel.extentIndex,
|
||||
offset: targetOffset,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
@override
|
||||
void sendCommand(String command) {
|
||||
final cmd = command.toLowerCase().trim();
|
||||
switch (cmd) {
|
||||
case 'tab':
|
||||
controller.applyIndent();
|
||||
break;
|
||||
case 'untab':
|
||||
case 'outdent':
|
||||
controller.applyOutdent();
|
||||
break;
|
||||
case 'cursor_left':
|
||||
case 'left':
|
||||
controller.moveCursor(AxisDirection.left);
|
||||
break;
|
||||
case 'cursor_right':
|
||||
case 'right':
|
||||
controller.moveCursor(AxisDirection.right);
|
||||
break;
|
||||
case 'cursor_up':
|
||||
case 'up':
|
||||
controller.moveCursor(AxisDirection.up);
|
||||
break;
|
||||
case 'cursor_down':
|
||||
case 'down':
|
||||
controller.moveCursor(AxisDirection.down);
|
||||
break;
|
||||
case 'line_start':
|
||||
case 'home':
|
||||
controller.moveCursorToLineStart();
|
||||
break;
|
||||
case 'line_end':
|
||||
case 'end':
|
||||
controller.moveCursorToLineEnd();
|
||||
break;
|
||||
case 'page_start':
|
||||
controller.moveCursorToPageStart();
|
||||
break;
|
||||
case 'page_end':
|
||||
controller.moveCursorToPageEnd();
|
||||
break;
|
||||
case 'undo':
|
||||
if (controller.canUndo) {
|
||||
controller.undo();
|
||||
}
|
||||
break;
|
||||
case 'redo':
|
||||
if (controller.canRedo) {
|
||||
controller.redo();
|
||||
}
|
||||
break;
|
||||
case 'copy':
|
||||
controller.copy();
|
||||
break;
|
||||
case 'cut':
|
||||
controller.cut();
|
||||
break;
|
||||
case 'paste':
|
||||
controller.paste();
|
||||
break;
|
||||
case 'backspace':
|
||||
case 'delete_backward':
|
||||
controller.deleteBackward();
|
||||
break;
|
||||
case 'delete':
|
||||
case 'delete_forward':
|
||||
controller.deleteForward();
|
||||
break;
|
||||
case 'select_all':
|
||||
controller.selectAll();
|
||||
break;
|
||||
case 'keyboard_hide':
|
||||
case 'hide_keyboard':
|
||||
hideKeyboard();
|
||||
break;
|
||||
default:
|
||||
// 未知命令安全降级为直接输入其命令名称或原文本
|
||||
controller.replaceSelection(command);
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
@override
|
||||
void sendNamedKey(String keyName, {KeyboardKeyMods mods = KeyboardKeyMods.none}) {
|
||||
// 编辑区没有"终端命名键"概念;配置校验已禁止该组合,这里仅作兜底不产生副作用
|
||||
if (kDebugMode) {
|
||||
debugPrint('[VirtualKeyboard] 编辑区不支持命名特殊键: $keyName${mods.isEmpty ? '' : ' ($mods)'}');
|
||||
}
|
||||
}
|
||||
|
||||
@override
|
||||
void hideKeyboard() {
|
||||
focusNode?.unfocus();
|
||||
SystemChannels.textInput.invokeMethod('TextInput.hide');
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user