组件/数据展示引入于 1.3.0

ETerminal 终端

import EUI 1.0

示例与代码

内置命令与历史

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ETerminal { height: 240 width: Math.min(600, parent.width) welcome: qsTr("输入 help、echo hello 或 clear。使用上、下方向键查看历史记录。") }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

自定义命令

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ETerminal { height: 240 welcome: "Try status" width: Math.min(600, parent.width) commandHandler: function(command) { return command === "status" ? "Ready" : "Unknown: " + command } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

异步命令

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ETerminal { height: 240 welcome: "Try any command" width: Math.min(600, parent.width) commandHandler: function(command) { return Promise.resolve("Done: " + command) } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

命令错误

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ETerminal { height: 240 width: Math.min(600, parent.width) commandHandler: function(command) { return Promise.reject("Failed: " + command) } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

自定义提示符

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ETerminal { height: 240 prompt: "eui >" historyLimit: 20 width: Math.min(600, parent.width) }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

promptstring

终端输入行前的提示符。

默认值"$"

welcomestring

显示在终端顶部的说明。

默认值""

historyLimitint

保留的命令与输出记录上限，最少 1 条。

默认值200

commandHandlervar

接收命令字符串，返回结果或 Promise 的处理函数。

默认值null

busybool只读

正在等待命令处理结果，此时阻止重复执行。

默认值state.busy

inputalias只读

终端命令输入框实例。

默认值commandInput

entriesvar只读

终端输出记录数组，包含 command、output、error。

默认值state.entries

信号

签名作用

submitted(string command)

提交命令时触发，command 为输入的命令文字。

completed(string command, string output, bool error)

命令执行结束时触发，command 为命令，output 为输出，error 表示是否出错。

方法

签名作用

clear()

清空组件当前内容或选择。

write(text, error)

向终端追加 text；error 为 true 时按错误输出显示。

execute(command)

执行 command 指定的终端命令。