rivo/tview기술 문서

rivo/tview open-source repository on GitHub

목차 (TOC) (9개 섹션)▾

Usage Hello World Projects using tview Documentation Dependencies Sponsor this Project Backwards-Compatibility Your Feedback Code of Conduct

언어 대체 안내:해당 저장소의 한국어 문서가 제공되지 않아 공식 영문 원본(English)으로 표시됩니다.

빠른 설치

go get github.com/rivo/tview

Rich Interactive Widgets for Terminal UIs

This Go package provides commonly used components for terminal based user interfaces.

Among these components are:

Input forms (including text input, selections, checkboxes, and buttons)
Navigable multi-color text views
Editable multi-line text areas
Sophisticated navigable table views
Flexible tree views
Selectable lists
Images
Grid, Flexbox and page layouts
Modal message windows
An application wrapper

They come with lots of customization options and can be easily extended to fit your needs.

Usage

To add this package to your project:

go get github.com/rivo/tview@master

Hello World

This basic example creates a box titled "Hello, World!" and displays it in your terminal:

package main

import (
	"github.com/rivo/tview"
)

func main() {
	box := tview.NewBox().SetBorder(true).SetTitle("Hello, world!")
	if err := tview.NewApplication().SetRoot(box, true).Run(); err != nil {
		panic(err)
	}
}

Check out the GitHub Wiki for more examples along with screenshots. Or try the examples in the "demos" subdirectory.

For a presentation highlighting this package, compile and run the program found in the "demos/presentation" subdirectory.

Projects using `tview`

Documentation

Refer to https://pkg.go.dev/github.com/rivo/tview for the package's documentation. Also check out the Wiki.

Dependencies

This package is based on github.com/gdamore/tcell (and its dependencies) as well as on github.com/rivo/uniseg.

Become a Sponsor on GitHub to further this project!

Backwards-Compatibility

I try really hard to keep this project backwards compatible. Your software should not break when you upgrade tview. But this also means that some of its shortcomings that were present in the initial versions will remain. Having said that, backwards compatibility may still break when:

a new version of an imported package (most likely tcell) changes in such a way that forces me to make changes in tview as well,
I fix something that I consider a bug, rather than a feature, something that does not work as originally intended,
I make changes to "internal" interfaces such as Primitive. You shouldn't need these interfaces unless you're writing your own primitives for tview. (Yes, I realize these are public interfaces. This has advantages as well as disadvantages. For the time being, it is what it is.)

Your Feedback

Add your issue here on GitHub. Feel free to get in touch if you have any questions.

Code of Conduct

We follow Golang's Code of Conduct which you can find here.

GitHub 공식 원본 저장소에서 아카이브된 문서 미러 · GitHub 저장소 방문

동기화 기준일: 2026-11-07