mirror of https://github.com/rivo/tview
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.0 KiB
2.0 KiB
Rich Interactive Widgets for Terminal UIs
This Go package provides commonly needed components for terminal based user interfaces.
Among these components are:
- Input forms (include input fields, drop-down selections, checkboxes, and buttons)
- Navigable multi-color text views
- Sophisticated navigable table views
- Selectable lists
- 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.
Installation
go get github.com/rivo/tview
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.
Documentation
Refer to https://godoc.org/github.com/rivo/tview for the package's documentation.
Dependencies
This package is based on github.com/gdamore/tcell.
Your Feedback
Add your issue here on GitHub. Feel free to get in touch if you have any questions.
Releases
- v0.3 (2018-01-11)
- Added masking to
InputField
and password entry toForm
- Added masking to
- v0.2 (2018-01-10)
- Added
Styles
variable with default colors for primitives.- Completed some missing InputField functions.
- Added
- v0.1 (2018-01-06)
- First Release