登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go tview 怎么用 Pages 显示并关闭确认对话框

来源:17golang原创

时间:2026-10-13 14:42:07 135浏览 收藏

Go tview 可以把主界面和确认框放在同一个 Pages 中:主页面先添加且保持可见,打开时用 AddPage("confirm", modal, true, true) 叠加 Modal,并把焦点交给它;关闭时在 SetDoneFunc 中移除 confirm 页面,再恢复主组件焦点。不要为了关闭对话框调用 Application.Stop,那会结束整个应用。

官方地址:https://github.com/rivo/tview

我为下面的示例选择“是否清空草稿区”这个小场景:草稿只是 TextView 中的文字,确认不触碰文件或数据库。我的取舍是保留主组件对象,只给它临时加一层确认框;这样关闭后无需重建输入入口。这个选择是代码设计说明,示例未在本机执行,不冒充使用实测。

主页面保留,确认框作为临时页面

Pages 是应用根节点,main 是草稿 TextView,confirm 是临时 Modal。可见页面按添加顺序绘制;后添加的确认框位于前层。AddPage 的两个布尔参数分别控制是否按 Pages 区域调整尺寸,以及是否可见。本例让 Modal 获得区域,由它自己绘制确认窗口。

我不在这里使用 AddAndSwitchToPage,因为它会切换可见页面;本例需要保留底层草稿画面。页面叠加与整页切换是两个需求,先选择对的容器操作,后面的关闭逻辑会更简单。

Application、Pages、主页面和确认框的静态组成关系
页面叠加结构图:Pages 包含保留的 main 页面与临时 confirm 页面,Modal 包含操作按钮。图是静态结构说明,不是终端截图。

完整示例:打开、确认、取消与恢复焦点

保存下面 main.go。主界面 d 打开确认框,q 退出;确认框的按钮以“取消”在前,“清空”在后,避免默认入口偏向变更操作。Esc 也进入关闭回调,并按取消处理。

package main

import (
    "fmt"
    "os"

    "github.com/gdamore/tcell/v2"
    "github.com/rivo/tview"
)

func main() {
    app := tview.NewApplication()
    pages := tview.NewPages()
    draft := tview.NewTextView().
        SetText("示例草稿内容\n\nd:清空确认  q:退出")
    draft.SetBorder(true).SetTitle("草稿区")

    openConfirm := func() {
        // 已打开时不重复创建同名确认页。
        if pages.HasPage("confirm") {
            return
        }
        modal := tview.NewModal().
            SetText("确定清空示例草稿区吗?").
            AddButtons([]string{"取消", "清空"})
        modal.SetDoneFunc(func(index int, label string) {
            // Esc 的索引为负;只有清空按钮分支修改示例内容。
            if index == 1 {
                draft.SetText("草稿区已清空\n\nd:再次打开确认  q:退出")
            }
            // 关闭的是临时页面,不是整个应用。
            pages.RemovePage("confirm")
            app.SetFocus(draft)
        })
        pages.AddPage("confirm", modal, true, true)
        app.SetFocus(modal)
    }

    draft.SetInputCapture(func(event *tcell.EventKey) *tcell.EventKey {
        // 入口快捷键只安装在主组件,避免抢走对话框按键。
        if event.Key() == tcell.KeyRune {
            switch event.Rune() {
            case 'd':
                openConfirm()
                return nil
            case 'q':
                app.Stop()
                return nil
            }
        }
        return event
    })

    pages.AddPage("main", draft, true, true)
    // 根节点固定为 Pages,主组件只承担实际键盘交互。
    if err := app.SetRoot(pages, true).SetFocus(draft).Run(); err != nil {
        fmt.Fprintln(os.Stderr, err)
        os.Exit(1)
    }
}
# 在空示例目录初始化模块并取得官方主分支依赖。
go mod init example.local/draft-dialog
go get github.com/rivo/tview@master
# 启动交互示例,不删除任何磁盘文件。
go run .

安装后提交或保留 go.mod、go.sum,固定团队解析到的依赖版本。官方主分支 go.mod 当前声明 Go 1.25.0,并使用 tcell/v2;实际安装版本的工具链要求以它自己的模块文件为准。

按代码可推导的预期是:取消或 Esc 保留草稿,清空只更新 TextView 内容,两种路径都会移除 confirm 并把焦点还给 draft。关闭后 d 可以再打开,q 才结束应用。这里不提供伪造运行输出。

关闭回调不要只做业务操作

我会把 Done 回调拆成业务判断与界面收尾:只有清空按钮触发文字修改,关闭页面和恢复焦点则在共同尾部执行。官方 Modal 回调同时用于按钮与 Escape;负索引不能被当成一个普通按钮选择,也不能无条件执行清空。

关闭回调与业务修改、页面移除和焦点恢复的静态对应
关闭责任结构图:Done 回调负责判断动作与共同收尾,RemovePage 作用于 confirm,焦点恢复目标是 draft。连线不表示运行时序。

仅改变草稿文字,并不会移除确认页;仅移除页面,也不应让应用靠偶然焦点状态继续工作。显式 SetFocus(draft) 是本例的清晰约定。若主页面包含多个输入组件,实际项目可以记录打开前的焦点并恢复,而不是永远跳到首个控件。

同样,不要把 Modal.SetFocus 和 Application.SetFocus 混为一谈:前者选择 Modal 内部按钮,后者决定应用把焦点交给哪个组件。本例打开时交给 Modal,关闭时交给 draft。

移除与隐藏,按复用需求选

操作页面状态本例取舍
RemovePage从容器移除命名页面一次确认一次创建,便于更新提示
HidePage保留页面但不可见需要复用实例时可选
ShowPage使已有页面可见配合隐藏方案使用
SwitchToPage显示指定页并隐藏其他页整页导航,不是本例叠加需求

对这个小示例,我更愿意移除临时页:每次确认重新构造提示文本,代码里不需要维护一个隐藏实例的状态。代价是每次创建对象;若对话框复杂或需要保留未完成输入,隐藏复用可能更合适。不要同时混用两套生命周期而忘了 HasPage 判断的含义。

容易漏掉的交互边界

为什么键盘还在影响主界面?先检查打开时是否把焦点交给 Modal,再检查应用级全局捕获器是否拦截了事件。本例只给 draft 安装入口,不另加全局 d、q 捕获。

确认后怎样执行真正的业务任务?本文仅更新示例文本。实际操作要单独处理权限、失败和结果提示;长耗时任务不要堵住 Done 回调。后台结果更新界面应采用 tview 的队列更新机制,不能随意跨 goroutine 改组件。

关闭后需要更换根节点吗?不需要,本例的根始终是 Pages。移除 confirm 即可保留 main 及其对象状态。

我会用四项作为集成检查:主页面对象没被重建;弹框拿到焦点;取消不会触发业务变更;关闭只收起确认页并恢复主交互。Pages 管叠加,Modal 管提示与按钮,业务代码管动作含义,各自职责清楚后,确认框不必变成一次全应用切换。

参考:Pages 实现与接口说明、Modal 回调说明、Application 焦点与更新接口、模块依赖。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>