TerminalUI

TerminalUI 是驅動 UI 執行邏輯的主要實現。

建立 TerminalUI

您可以手動構建 TerminalUI，但推薦的方式是使用 TerminalUIBuilder，它會為您自動配置並設定所需的各種服務。

@Autowired
TerminalUIBuilder builder;

void sample() {
	TerminalUI ui = builder.build();
	// do something with ui
}

配置檢視

TerminalUI 有一個輔助方法 configure(View)，可用於將所需的整合設定到 eventloop 和其他服務中。

TerminalUI ui;

void sample() {
	BoxView view = new BoxView();
	ui.configure(view);
}

執行 UI 迴圈

執行 TerminalUI 執行迴圈是一個阻塞操作。您需要一種方法來退出迴圈，例如透過退出應用。

TerminalUI ui;

void sample() {
	ui.run();
}

退出應用

如果您想使用常規的 CTRL-Q 按鍵組合退出應用，請監聽事件並請求中斷。

@Autowired
Terminal terminal;

void sample() {
	TerminalUI ui = new TerminalUI(terminal);
	BoxView view = new BoxView();
	ui.configure(view);
	ui.setRoot(view, true);
	EventLoop eventLoop = ui.getEventLoop();
	eventLoop.keyEvents()
		.subscribe(event -> {
			if (event.getPlainKey() == Key.q && event.hasCtrl()) {
				eventLoop.dispatch(ShellMessageBuilder.ofInterrupt());
			}
		});
	ui.run();
}

模態檢視

TerminalUI 支援擁有一個活動的模態檢視。模態檢視放置在所有其他檢視的頂部，並接收所有輸入事件。

TerminalUI ui;

void sample() {
	DialogView dialog = new DialogView();
	// set modal
	ui.setModal(dialog);
	// clear modal
	ui.setModal(null);
}

由於檢視不應直接瞭解關於 TerminalUi 的任何資訊，介面 ViewService 公開了模態相關函式。